Cloud SQL Admin API

API for Cloud SQL instance management.

Service: sqladmin.googleapis.com

Service endpoint

A service endpoint is a base URL that specifies the network address of an API service. One service might have multiple service endpoints. This service has the following service endpoint and all URIs below are relative to this service endpoint:

  • https://sqladmin.googleapis.com

REST Resource: v1beta4.backupRuns

Methods
deleteDELETE /sql/v1beta4/projects/{project}/instances/{instance}/backupRuns/{id}
Deletes the backup taken by a backup run.
getGET /sql/v1beta4/projects/{project}/instances/{instance}/backupRuns/{id}
Retrieves a resource containing information about a backup run.
insertPOST /sql/v1beta4/projects/{project}/instances/{instance}/backupRuns
Creates a new backup run on demand.
listGET /sql/v1beta4/projects/{project}/instances/{instance}/backupRuns
Lists all backup runs associated with the project or a given instance and configuration in the reverse chronological order of the backup initiation time.

REST Resource: v1beta4.backups

Methods
createBackupPOST /sql/v1beta4/{parent=projects/*}/backups
Creates a backup for a Cloud SQL instance.
deleteBackupDELETE /sql/v1beta4/{name=projects/*/backups/*}
Deletes the backup.
getBackupGET /sql/v1beta4/{name=projects/*/backups/*}
Retrieves a resource containing information about a backup.
listBackupsGET /sql/v1beta4/{parent=projects/*}/backups
Lists all backups associated with the project.
updateBackupPATCH /sql/v1beta4/{backup.name=projects/*/backups/*}
Updates the retention period and the description of the backup.

REST Resource: v1beta4.connect

Methods
generateEphemeralCertPOST /sql/v1beta4/projects/{project}/instances/{instance}:generateEphemeralCert
Generates a short-lived X509 certificate containing the provided public key and signed by a private key specific to the target instance.
getGET /sql/v1beta4/projects/{project}/instances/{instance}/connectSettings
Retrieves connect settings about a Cloud SQL instance.

REST Resource: v1beta4.databases

Methods
deleteDELETE /sql/v1beta4/projects/{project}/instances/{instance}/databases/{database}
Deletes a database from a Cloud SQL instance.
getGET /sql/v1beta4/projects/{project}/instances/{instance}/databases/{database}
Retrieves a resource containing information about a database inside a Cloud SQL instance.
insertPOST /sql/v1beta4/projects/{project}/instances/{instance}/databases
Inserts a resource containing information about a database inside a Cloud SQL instance.
listGET /sql/v1beta4/projects/{project}/instances/{instance}/databases
Lists databases in the specified Cloud SQL instance.
patchPATCH /sql/v1beta4/projects/{project}/instances/{instance}/databases/{database}
Partially updates a resource containing information about a database inside a Cloud SQL instance.
updatePUT /sql/v1beta4/projects/{project}/instances/{instance}/databases/{database}
Updates a resource containing information about a database inside a Cloud SQL instance.

REST Resource: v1beta4.flags

Methods
listGET /sql/v1beta4/flags
Lists all available database flags for Cloud SQL instances.

REST Resource: v1beta4.instances

Methods
addServerCaPOST /sql/v1beta4/projects/{project}/instances/{instance}/addServerCa
Add a new trusted Certificate Authority (CA) version for the specified instance.
clonePOST /sql/v1beta4/projects/{project}/instances/{instance}/clone
Creates a Cloud SQL instance as a clone of the source instance.
deleteDELETE /sql/v1beta4/projects/{project}/instances/{instance}
Deletes a Cloud SQL instance.
demotePOST /sql/v1beta4/projects/{project}/instances/{instance}/demote
Demotes a standalone instance to be a Cloud SQL read replica for an external database server.
demoteMasterPOST /sql/v1beta4/projects/{project}/instances/{instance}/demoteMaster
Demotes a standalone instance to be a Cloud SQL read replica for an external database server. This includes supporting setting up replication from large external databases.
exportPOST /sql/v1beta4/projects/{project}/instances/{instance}/export
Exports data from a Cloud SQL instance to a Cloud Storage bucket as a SQL dump or CSV file.
failoverPOST /sql/v1beta4/projects/{project}/instances/{instance}/failover
Initiates a manual failover of a high availability (HA) primary instance to a standby instance, which becomes the primary instance.
getGET /sql/v1beta4/projects/{project}/instances/{instance}
Retrieves a resource containing information about a Cloud SQL instance.
importPOST /sql/v1beta4/projects/{project}/instances/{instance}/import
Imports data into a Cloud SQL instance from a SQL dump or CSV file in Cloud Storage.
insertPOST /sql/v1beta4/projects/{project}/instances
Creates a new Cloud SQL instance.
listGET /sql/v1beta4/projects/{project}/instances
Lists instances under a given project.
listServerCasGET /sql/v1beta4/projects/{project}/instances/{instance}/listServerCas
Lists all of the trusted Certificate Authorities (CAs) for the specified instance.
patchPATCH /sql/v1beta4/projects/{project}/instances/{instance}
Partially updates settings of a Cloud SQL instance by merging the request with the current configuration.
promoteReplicaPOST /sql/v1beta4/projects/{project}/instances/{instance}/promoteReplica
Promotes the read replica instance to be a standalone Cloud SQL instance.
resetSslConfigPOST /sql/v1beta4/projects/{project}/instances/{instance}/resetSslConfig
Deletes all client certificates and generates a new server SSL certificate for the instance.
restartPOST /sql/v1beta4/projects/{project}/instances/{instance}/restart
Restarts a Cloud SQL instance.
restoreBackupPOST /sql/v1beta4/projects/{project}/instances/{instance}/restoreBackup
Restores a backup of a Cloud SQL instance.
rotateServerCaPOST /sql/v1beta4/projects/{project}/instances/{instance}/rotateServerCa
Rotates the server certificate to one signed by the Certificate Authority (CA) version previously added with the addServerCA method.
startReplicaPOST /sql/v1beta4/projects/{project}/instances/{instance}/startReplica
Starts the replication in the read replica instance.
stopReplicaPOST /sql/v1beta4/projects/{project}/instances/{instance}/stopReplica
Stops the replication in the read replica instance.
truncateLogPOST /sql/v1beta4/projects/{project}/instances/{instance}/truncateLog
Truncate MySQL general and slow query log tables MySQL only.
updatePUT /sql/v1beta4/projects/{project}/instances/{instance}
Updates settings of a Cloud SQL instance.

REST Resource: v1beta4.operations

Methods
getGET /sql/v1beta4/projects/{project}/operations/{operation}
Retrieves an instance operation that has been performed on an instance.
listGET /sql/v1beta4/projects/{project}/operations
Lists all instance operations that have been performed on the given Cloud SQL instance in the reverse chronological order of the start time.

REST Resource: v1beta4.projects.instances

Methods
rescheduleMaintenancePOST /sql/v1beta4/projects/{project}/instances/{instance}/rescheduleMaintenance
Reschedules the maintenance on the given instance.
startExternalSyncPOST /sql/v1beta4/projects/{project}/instances/{instance}/startExternalSync
Start External primary instance migration.
verifyExternalSyncSettingsPOST /sql/v1beta4/projects/{project}/instances/{instance}/verifyExternalSyncSettings
Verify External primary instance external sync settings.

REST Resource: v1beta4.sslCerts

Methods
createEphemeralPOST /sql/v1beta4/projects/{project}/instances/{instance}/createEphemeral
Generates a short-lived X509 certificate containing the provided public key and signed by a private key specific to the target instance.
deleteDELETE /sql/v1beta4/projects/{project}/instances/{instance}/sslCerts/{sha1Fingerprint}
Deletes the SSL certificate.
getGET /sql/v1beta4/projects/{project}/instances/{instance}/sslCerts/{sha1Fingerprint}
Retrieves a particular SSL certificate.
insertPOST /sql/v1beta4/projects/{project}/instances/{instance}/sslCerts
Creates an SSL certificate and returns it along with the private key and server certificate authority.
listGET /sql/v1beta4/projects/{project}/instances/{instance}/sslCerts
Lists all of the current SSL certificates for the instance.

REST Resource: v1beta4.tiers

Methods
listGET /sql/v1beta4/projects/{project}/tiers
Lists all available machine types (tiers) for Cloud SQL, for example, db-custom-1-3840.

REST Resource: v1beta4.users

Methods
deleteDELETE /sql/v1beta4/projects/{project}/instances/{instance}/users
Deletes a user from a Cloud SQL instance.
getGET /sql/v1beta4/projects/{project}/instances/{instance}/users/{name}
Retrieves a resource containing information about a user.
insertPOST /sql/v1beta4/projects/{project}/instances/{instance}/users
Creates a new user in a Cloud SQL instance.
listGET /sql/v1beta4/projects/{project}/instances/{instance}/users
Lists users in the specified Cloud SQL instance.
updatePUT /sql/v1beta4/projects/{project}/instances/{instance}/users
Updates an existing user in a Cloud SQL instance.

REST Resource: v1.Backups

Methods
CreateBackupPOST /v1/{parent=projects/*}/backups
Creates a backup for a Cloud SQL instance.
DeleteBackupDELETE /v1/{name=projects/*/backups/*}
Deletes the backup.
GetBackupGET /v1/{name=projects/*/backups/*}
Retrieves a resource containing information about a backup.
ListBackupsGET /v1/{parent=projects/*}/backups
Lists all backups associated with the project.
UpdateBackupPATCH /v1/{backup.name=projects/*/backups/*}
Updates the retention period and description of the backup.

REST Resource: v1.backupRuns

Methods
deleteDELETE /v1/projects/{project}/instances/{instance}/backupRuns/{id}
Deletes the backup taken by a backup run.
getGET /v1/projects/{project}/instances/{instance}/backupRuns/{id}
Retrieves a resource containing information about a backup run.
insertPOST /v1/projects/{project}/instances/{instance}/backupRuns
Creates a new backup run on demand.
listGET /v1/projects/{project}/instances/{instance}/backupRuns
Lists all backup runs associated with the project or a given instance and configuration in the reverse chronological order of the backup initiation time.

REST Resource: v1.connect

Methods
generateEphemeralCertPOST /v1/projects/{project}/instances/{instance}:generateEphemeralCert
Generates a short-lived X509 certificate containing the provided public key and signed by a private key specific to the target instance.
getGET /v1/projects/{project}/instances/{instance}/connectSettings
Retrieves connect settings about a Cloud SQL instance.

REST Resource: v1.databases

Methods
deleteDELETE /v1/projects/{project}/instances/{instance}/databases/{database}
Deletes a database from a Cloud SQL instance.
getGET /v1/projects/{project}/instances/{instance}/databases/{database}
Retrieves a resource containing information about a database inside a Cloud SQL instance.
insertPOST /v1/projects/{project}/instances/{instance}/databases
Inserts a resource containing information about a database inside a Cloud SQL instance.
listGET /v1/projects/{project}/instances/{instance}/databases
Lists databases in the specified Cloud SQL instance.
patchPATCH /v1/projects/{project}/instances/{instance}/databases/{database}
Partially updates a resource containing information about a database inside a Cloud SQL instance.
updatePUT /v1/projects/{project}/instances/{instance}/databases/{database}
Updates a resource containing information about a database inside a Cloud SQL instance.

REST Resource: v1.flags

Methods
listGET /v1/flags
Lists all available database flags for Cloud SQL instances.

REST Resource: v1.instances

Methods
addServerCaPOST /v1/projects/{project}/instances/{instance}/addServerCa
Adds a new trusted Certificate Authority (CA) version for the specified instance.
clonePOST /v1/projects/{project}/instances/{instance}/clone
Creates a Cloud SQL instance as a clone of the source instance.
deleteDELETE /v1/projects/{project}/instances/{instance}
Deletes a Cloud SQL instance.
demotePOST /v1/projects/{project}/instances/{instance}/demote
Demotes a standalone instance to be a Cloud SQL read replica for an external database server.
demoteMasterPOST /v1/projects/{project}/instances/{instance}/demoteMaster
Demotes a standalone instance to be a Cloud SQL read replica for an external database server. This includes supporting setting up replication from large external databases.
exportPOST /v1/projects/{project}/instances/{instance}/export
Exports data from a Cloud SQL instance to a Cloud Storage bucket as a SQL dump or CSV file.
failoverPOST /v1/projects/{project}/instances/{instance}/failover
Initiates a manual failover of a high availability (HA) primary instance to a standby instance, which becomes the primary instance.
getGET /v1/projects/{project}/instances/{instance}
Retrieves a resource containing information about a Cloud SQL instance.
importPOST /v1/projects/{project}/instances/{instance}/import
Imports data into a Cloud SQL instance from a SQL dump or CSV file in Cloud Storage.
insertPOST /v1/projects/{project}/instances
Creates a new Cloud SQL instance.
listGET /v1/projects/{project}/instances
Lists instances under a given project.
listServerCasGET /v1/projects/{project}/instances/{instance}/listServerCas
Lists all of the trusted Certificate Authorities (CAs) for the specified instance.
patchPATCH /v1/projects/{project}/instances/{instance}
Partially updates settings of a Cloud SQL instance by merging the request with the current configuration.
promoteReplicaPOST /v1/projects/{project}/instances/{instance}/promoteReplica
Promotes the read replica instance to be a standalone Cloud SQL instance.
resetSslConfigPOST /v1/projects/{project}/instances/{instance}/resetSslConfig
Deletes all client certificates and generates a new server SSL certificate for the instance.
restartPOST /v1/projects/{project}/instances/{instance}/restart
Restarts a Cloud SQL instance.
restoreBackupPOST /v1/projects/{project}/instances/{instance}/restoreBackup
Restores a backup of a Cloud SQL instance.
rotateServerCaPOST /v1/projects/{project}/instances/{instance}/rotateServerCa
Rotates the server certificate to one signed by the Certificate Authority (CA) version previously added with the addServerCA method.
startReplicaPOST /v1/projects/{project}/instances/{instance}/startReplica
Starts the replication in the read replica instance.
stopReplicaPOST /v1/projects/{project}/instances/{instance}/stopReplica
Stops the replication in the read replica instance.
truncateLogPOST /v1/projects/{project}/instances/{instance}/truncateLog
Truncate MySQL general and slow query log tables MySQL only.
updatePUT /v1/projects/{project}/instances/{instance}
Updates settings of a Cloud SQL instance.

REST Resource: v1.operations

Methods
getGET /v1/projects/{project}/operations/{operation}
Retrieves an instance operation that has been performed on an instance.
listGET /v1/projects/{project}/operations
Lists all instance operations that have been performed on the given Cloud SQL instance in the reverse chronological order of the start time.

REST Resource: v1.projects.instances

Methods
rescheduleMaintenancePOST /v1/projects/{project}/instances/{instance}/rescheduleMaintenance
Reschedules the maintenance on the given instance.
startExternalSyncPOST /v1/projects/{project}/instances/{instance}/startExternalSync
Start External primary instance migration.
verifyExternalSyncSettingsPOST /v1/projects/{project}/instances/{instance}/verifyExternalSyncSettings
Verify External primary instance external sync settings.

REST Resource: v1.sslCerts

Methods
createEphemeralPOST /v1/projects/{project}/instances/{instance}/createEphemeral
Generates a short-lived X509 certificate containing the provided public key and signed by a private key specific to the target instance.
deleteDELETE /v1/projects/{project}/instances/{instance}/sslCerts/{sha1Fingerprint}
Deletes the SSL certificate.
getGET /v1/projects/{project}/instances/{instance}/sslCerts/{sha1Fingerprint}
Retrieves a particular SSL certificate.
insertPOST /v1/projects/{project}/instances/{instance}/sslCerts
Creates an SSL certificate and returns it along with the private key and server certificate authority.
listGET /v1/projects/{project}/instances/{instance}/sslCerts
Lists all of the current SSL certificates for the instance.

REST Resource: v1.tiers

Methods
listGET /v1/projects/{project}/tiers
Lists all available machine types (tiers) for Cloud SQL, for example, db-custom-1-3840.

REST Resource: v1.users

Methods
deleteDELETE /v1/projects/{project}/instances/{instance}/users
Deletes a user from a Cloud SQL instance.
getGET /v1/projects/{project}/instances/{instance}/users/{name}
Retrieves a resource containing information about a user.
insertPOST /v1/projects/{project}/instances/{instance}/users
Creates a new user in a Cloud SQL instance.
listGET /v1/projects/{project}/instances/{instance}/users
Lists users in the specified Cloud SQL instance.
updatePUT /v1/projects/{project}/instances/{instance}/users
Updates an existing user in a Cloud SQL instance.