This page lists Cloud SQL Admin API error codes.
| Error class | Error code | Error message |
|---|---|---|
400 - BAD_REQUEST
|
INVALID_REQUEST
|
The incoming request contains invalid data. |
| |
INVALID_MASTERSLAVE_APP
|
The request contains invalid primary or secondary application IDs when creating or updating an instance. |
| |
ERROR_NON_EXISTENT_APP_ID
|
The application ID does not exist. The instance could not be connected with an application. |
| |
ERROR_APP_REGION
|
The App Engine app is in a different geographical region. |
| |
INVALID_OPERATION
|
The operation isn't valid for this instance. |
| |
PROJECT_NAME_MISMATCH
|
The operation failed to create the target instance because it has a different project name from the source instance name specified. |
| |
ERROR_GCE_ZONE_REGION
|
The Compute Engine zone is in a different geographical region. |
| |
ERROR_UNRECOGNIZED_GCE_ZONE
|
The request contains an unrecognized Compute Engine zone. |
| |
ERROR_BOTH_GCE_ZONE_GAE_APP_SPECIFIED
|
The Compute Engine zone and the App Engine application ID are both specified for location preference when creating or updating an instance. The operation only uses one or the other. |
| |
ERROR_SSL_CERTIFICATE_COMMON_NAME
|
The common name can contain only alphanumeric characters, periods, dashes, spaces, and underscores. Spaces can't appear at the beginning or the end. The length can't exceed 64 characters. |
| |
ERROR_SSL_CERTIFICATE_COMMON_NAME_ALREADY_EXISTS
|
The operation failed to generate a client certificate because another certificate with the same common name exists. |
| |
ERROR_BINLOG_COORDINATES_VERIFICATION
|
The binary log coordinates used for cloning an instance are invalid in relation to the source instance. |
| |
ERROR_BINLOG_INVALID_FILE_NAME
|
The binary log filename used for cloning an instance is either empty or invalid. |
| |
ERROR_BINLOG_INVALID_OFFSET
|
The binary log position used for cloning an instance is either empty or invalid. |
| |
ERROR_BINLOG_NOT_ENABLED
|
The requested operation isn't allowed with an instance that doesn't have a binary log or binary logging enabled. |
| |
ERROR_INVALID_CLONE_SOURCE_PROJECT
|
The project for the source Cloud SQL instance doesn't match the project on the request URL. |
| |
ERROR_INVALID_CLONE_DESTINATION_PROJECT
|
The project for the destination Cloud SQL instance doesn't match the project on the request URL. |
| |
ERROR_BACKUP_NOT_FOUND
|
The system can't find a successful backup. A backup is required to carry out the operation. |
| |
ERROR_ADDING_ON_PREMISES_CONFIG
|
The system can't add the on-premises configuration for the given instance type. |
| |
ERROR_ON_PREMISES_INSTANCE_INVALID_OPERATION
|
The requested operation isn't valid for an on-premises instance. |
| |
ERROR_ON_PREMISES_INSTANCE_WITH_NO_HOST_PORT
|
An on-premises instance needs to be configured with a host:port
. |
| |
ERROR_ON_PREMISES_INSTANCE_WITH_SSL_CONFIG
|
An on-premises instance can't use the SSL configuration. |
| |
ERROR_REPLICA_CONFIGURATION_MISSING_MASTER_INSTANCE_NAME
|
The replica configuration doesn't contain the master instance name to use for replication. |
| |
ERROR_REPLICA_CONFIGURATION_MISSING_DUMP_FILE_PATH
|
The replica configuration doesn't contain the dump file path when replicating from an on-premises master. |
| |
ERROR_REPLICA_CONFIGURATION_MISSING_USERNAME
|
The replica configuration doesn't contain the username (to use for the replication connection) when replicating from an on-premises master. |
| |
ERROR_REPLICA_CONFIGURATION_MISSING_PASSWORD
|
The replica configuration doesn't contain the password (to use for the replication connection) when replicating from an on-premises master. |
| |
ERROR_READ_REPLICA_SOURCE_TARGET_REGION_MISMATCH
|
The read replica must be in the same region as that of the source instance. |
| |
ERROR_INVALID_PROJECT
|
The project specified in the request is invalid. |
| |
ERROR_MATCHING_SOURCE_DESTINATION_INSTANCE_NAME
|
The instance being created can't have the same name as the source instance. |
| |
ERROR_INVALID_READ_REPLICA_PROJECT
|
The project containing the read replica doesn't match the project on the request URL. |
| |
ERROR_READ_REPLICA_INVALID_OPERATION
|
The requested operation isn't valid for a read replica. |
| |
ERROR_REPLICA_INVALID_OPERATION
|
The requested operation isn't valid for a read replica. |
| |
ERROR_REPLICATION_MASTER_INVALID_OPERATION
|
The requested operation isn't valid for a replication master instance. |
| |
ERROR_DISALLOWED_ENABLING_BACKUPS_FOR_READ_REPLICA
|
A backup can't be enabled for read replicas. |
| |
ERROR_INVALID_READ_REPLICA_ACTIVATION_POLICY
|
The read replica is not specified as 'ALWAYS'. |
| |
ERROR_INVALID_INSTANCE_TYPE_CLOUDSQL
|
A Cloud SQL instance that isn't a replica can't have an associated master instance name. |
| |
ERROR_INVALID_INSTANCE_TYPE_READ_REPLICA
|
A read replica must have an associated master instance. |
| |
ERROR_INVALID_INSTANCE_PROPERTY_DATABASE_REPLICATION_ENABLED
|
The database replication setting is only used on a read replica. |
| |
ERROR_DISALLOWED_DISABLED_DATABASE_REPLICATION_ON_REPLICA_CREATION
|
The database replication flag must be enabled when creating a read replica. |
| |
ERROR_EXPORT_UNKNOWN_FILE_TYPE
|
The export file type is unknown. |
| |
ERROR_EXPORT_SQL_DATABASE_COUNT
|
The operation requires that you specify exactly one database and one table when exporting a SQL file. |
| |
ERROR_EXPORT_CSV_DATABASE_COUNT
|
The operation requires that you specify, at most, one database when exporting a CSV file. |
| |
ERROR_IMPORT_UNKNOWN_FILE_TYPE
|
The import file type is unknown. |
| |
ERROR_DATABASE_TYPE_UNSUPPORTED_FOR_REPLICATION
|
The replication and cloning operations aren't supported for this database type. |
| |
ERROR_DATABASE_TYPE_UNSUPPORTED_FOR_READ_REPLICA
|
The read replica isn't supported for this database type. |
| |
ERROR_READ_REPLICA_INCOMPATIBLE_DATABASE_TYPES
|
The database versions for the source and target instances are incompatible for replication. |
| |
ERROR_INSTANCES_INCOMPATIBLE_FOR_REPLICATION
|
The source and target instances are incompatible for replication. |
| |
ERROR_UNSUPPORTED_PUBLIC_KEY
|
The provided public key uses an invalid or unsupported format. |
| |
ERROR_INVALID_BACKUP_RUN_STATUS
|
The backup run status isn't valid for the given request. |
| |
ERROR_FAILOVER_REPLICA_ALREADY_EXISTS
|
A failover replica already exists. |
| |
ERROR_INVALID_FAILOVER_REPLICA_OPERATION
|
The requested operation isn't allowed for a failover replica. |
| |
ERROR_FAILOVER_REPLICA_AND_MASTER_IN_SAME_ZONE
|
The failover replica must be in a different zone than the master instance. |
| |
ERROR_NO_FAILOVER_REPLICA
|
The requested operation requires a failover replica. |
| |
ERROR_EXPORT_CSV_SELECT_QUERY_SIZE_EXCEED_LIMIT
|
The Select
query exceeds the size limit for the CSV
export operation. |
| |
ERROR_INVALID_HA_MASTER_OPERATION
|
The requested operation isn't valid for an HA master instance. |
| |
ERROR_INVALID_HAS_REPLICA_OPERATION
|
The requested operation isn't valid for an instance that has a replica. |
| |
ERROR_INSTANCE_NAME_CONFLICT
|
There is an existing instance with the given name. |
| |
ERROR_BACKUP_SIZE_EXCEEDS_INSTANCE_SIZE
|
Restore from backup can't be done to the instance with storage size smaller than the backup size. |
| |
ERROR_INVALID_PRIMARY_IP_RANGE
|
The IP address of the primary database is in an unsupported IP address range. Non-RFC 1918 IPs are not supported. To set up replicas, change the IP address of the primary server. |
| |
ERROR_INVALID_REPLICA_REGION_TOPOLOGY
|
Requested operation would cause circular region dependency in replica chain. |
| |
ERROR_REPLICA_DEPTH_LIMIT_EXCEEDED
|
Requested operation would cause exceeding the limit of 4 levels on the depth of cascading replicas. |
| |
ERROR_DISALLOWED_UPDATING_EXTERNAL_SERVER_REPLICA_REPLICATION_STATE
|
Updating the replication state setting of an external server replica instance isn't allowed. Use the stopReplica or startReplica API instead. |
| |
ERROR_DISALLOWED_UPDATING_EXTERNAL_SERVER_REPLICA_REPLICATION_STATE
|
Updating the replication state setting of an external server replica instance isn't allowed. Use the stopReplica or startReplica API instead. |
| |
ERROR_EXTERNAL_SERVER_REPLICA_GTID_MODE
|
External server replica must have gtid_mode=ON in order to have a read replica. |
| |
ERROR_PITR_BACKUP_RUN_NOT_DELETABLE
|
This upgrade backup cannot be deleted because it's within the point-in-time recovery retention period for the instance. You can delete it earlier if you adjust the retention period or disable point-in-time recovery. |
| |
ERROR_PROTECTED_INSTANCE_DELETION_FAILURE
|
The instance is protected. Please disable the deletion protection and try again. To disable deletion protection, update the instance settings with deletionProtectionEnabled set to false. |
| |
ERROR_READ_REPLICA_UNDER_EXTERNAL_SERVER_REPLICA_NOT_SYNCED
|
To have a read replica, there must be an initial sync completed on the external server replica. |
| Error class | Error code | Error message |
|---|---|---|
403 - FORBIDDEN
|
NOT_AUTHORIZED
|
The client isn't authorized to make this request. |
| |
INVALID_BILLING_ACCOUNT_STATE
|
The billing account has an issue. A new instance can't be created until the billing issue is resolved. |
| |
ERROR_GCS_BUCKET_PERMISSION_DENIAL
|
The service account doesn't have the required permissions for the bucket. |
| Error class | Error code | Error message |
|---|---|---|
404 - NOT_FOUND
|
INSTANCE_DOES_NOT_EXIST
|
The Cloud SQL instance doesn't exist. |
| |
ERROR_INVALID_FLAG_NAME
|
The requested flag is either misspelled or unsupported by Cloud SQL. |
| |
OPERATION_DOES_NOT_EXIST
|
The Cloud SQL instance operation doesn't exist. |
| |
BACKUP_RUN_DOES_NOT_EXIST
|
The backup run doesn't exist. |
| |
SSL_CERTIFICATE_DOES_NOT_EXIST
|
The SSL certificate doesn't exist. |
| Error class | Error code | Error message |
|---|---|---|
409 - CONFLICT
|
INVALID_STATE
|
The instance or operation isn't in an appropriate state to handle the request. |
| |
OPERATION_IN_PROGRESS
|
The operation failed because another operation was already in progress. |
| Error class | Error code | Error message |
|---|---|---|
412 - PRECONDITION_FAILED
|
STALE_DATA
|
The condition doesn't match. |
| Error class | Error code | Error message |
|---|---|---|
422 - INVALID_VALUE
|
INVALID_INSTANCE_PROPERTY
|
The instance property is invalid. |
| |
ERROR_INVALID_FLAG_DATABASE_TYPE
|
The flag requested can't be set on this database type. |
| |
ERROR_INVALID_FLAG_VALUE
|
The requested value isn't valid. |
| Error class | Error code | Error message |
|---|---|---|
429 - LIMIT_EXCEEDED
|
ERROR_MAX_INSTANCE_PER_LABEL
|
The operation failed to create an instance because the project has reached the maximum instance per project limit. |
| |
ERROR_MAX_APP_IDS
|
The operation failed to update an instance because it exceeded the maximum number of application IDs that can be attached to the instance. |
| |
ERROR_MAX_FREE_INSTANCE_PER_LABEL
|
The operation failed to create an instance because the project or creator has reached the maximum free instances per project or creator limit. |
| |
ERROR_MAX_CLIENT_SSL_CERTIFICATES
|
The operation failed to create a client SSL certificate because you have created the maximum number of certificates allowed. |
| Error class | Error code | Error message |
|---|---|---|
500 - BACKEND_ERROR
|
SERVER_EXCEPTION
|
The service is temporarily unavailable. |
| |
ERROR_SPECKLE_RPC
|
The service is temporarily unavailable. |
| |
ERROR_BILLING_RPC
|
The service is temporarily unavailable. |
| |
ERROR_UNKNOWN
|
The operation finished in an unknown state. |
| |
POOL_DOES_NOT_EXIST
|
The service is temporarily unavailable. |
| |
ERROR_APPCONFIG_RPC
|
The service is temporarily unavailable. |
| |
RETRY_TRANSIENT_ERROR
|
The service is temporarily unavailable. This is most likely a momentary error. Retry the operation. |
| |
ERROR_IP_MANAGEMENT_OPERATION
|
The service is temporarily unavailable. This is most likely a momentary error. Retry the operation. |
| |
ERROR_GCE_BOOT_DISK_CREATION_FAILURE
|
The instance creation operation failed to create a boot disk. |
| |
ERROR_GCE_DATA_DISK_CREATION_FAILURE
|
The instance creation operation failed to create a data disk. |
| |
ERROR_GCE_TMP_DISK_CREATION_FAILURE
|
The instance creation operation failed to create a tmp disk. |
| |
ERROR_GCE_IP_CREATION_FAILURE
|
The instance creation operation failed to obtain an IP address. |
| |
ERROR_GCE_VM_CREATION_FAILURE
|
The instance creation operation failed to create a VM. |
| |
ERROR_GCE_STOCKOUT
|
The zone or region doesn't have sufficient resources to handle the request at the moment. |
| |
ERROR_GCE_QUOTA_EXCEEDED
|
The requested resource is unavailable at the moment. |
| Error class | Error code | Error message |
|---|---|---|
501 - UNSUPPORTED_METHOD
|
UNSUPPORTED_OPERATION
|
The requested operation isn't supported. |
| |
UNSUPPORTED_V2_OPERATION
|
The requested operation isn't supported on Cloud SQL instances. |
| |
ERROR_DISK_ENCRYPTION_UNSUPPORTED
|
The disk encryption with a KMS key isn't supported for the requested operation. |
