This page lists Cloud SQL Admin API error codes.
| Error class | Error code | Error message |
|---|---|---|
400 - BAD_REQUEST | INVALID_REQUEST | The incoming request contained invalid data. |
INVALID_MASTERSLAVE_APP | Request contains invalid primary/secondary application IDs when creating or updating an instance. | |
ERROR_NON_EXISTENT_APP_ID | Failed to associate the instance with non-existent app ID. | |
ERROR_APP_REGION | The App Engine app is in a different geographical region. | |
INVALID_OPERATION | This operation isn"t valid for this instance. | |
PROJECT_NAME_MISMATCH | 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 | Request contains an unrecognized Compute Engine zone when creating or updating an instance. | |
ERROR_BOTH_GCE_ZONE_GAE_APP_SPECIFIED | Both Compute Engine zone and App Engine application ID are specified for location preference when creating or updating an instance. | |
ERROR_SSL_CERTIFICATE_COMMON_NAME | The common name can only contain alphanumeric characters, periods, dashes, spaces, and underscores. Spaces can't appear in the beginning or the end. The length can't exceed 64 characters. | |
ERROR_SSL_CERTIFICATE_COMMON_NAME_ALREADY_EXISTS | Failed to generate client certificate because there exists another certificate with the same common name. | |
ERROR_BINLOG_COORDINATES_VERIFICATION | Binary log coordinates used for cloning an instance are invalid with respect to the source instance. | |
ERROR_BINLOG_INVALID_FILE_NAME | Binary log file name used for cloning an instance is either empty or is invalid. | |
ERROR_BINLOG_INVALID_OFFSET | Binary log position used for cloning an instance is either empty or invalid. | |
ERROR_BINLOG_NOT_ENABLED | The requested operation is not allowed with an instance that does not have binary log enabled. | |
ERROR_INVALID_CLONE_SOURCE_PROJECT | Project for the source Cloud SQL instance does not match the project on the request URL. | |
ERROR_INVALID_CLONE_DESTINATION_PROJECT | Project for the destination Cloud SQL instance does not match the project on the request URL. | |
ERROR_BACKUP_NOT_FOUND | Successful backup required for carrying out the operation was not found. | |
ERROR_ADDING_ON_PREMISES_CONFIG | Cannot add on-premises config for the given instance type. | |
ERROR_ON_PREMISES_INSTANCE_INVALID_OPERATION | The requested operation is not 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 have SSL configuration. | |
ERROR_REPLICA_CONFIGURATION_MISSING_MASTER_INSTANCE_NAME | Replica configuration does not contain the master instance name from which to replicate. | |
ERROR_REPLICA_CONFIGURATION_MISSING_DUMP_FILE_PATH | Replica configuration does not contain the dump file path when replicating from an on-premises master. | |
ERROR_REPLICA_CONFIGURATION_MISSING_USERNAME | Replica configuration does not contain the username (to use for the replication connection) when replicating from an on-premises master. | |
ERROR_REPLICA_CONFIGURATION_MISSING_PASSWORD | Replica configuration does not contain the password (to use for the replication connection) when replicating from an on-premises master. | |
ERROR_READ_REPLICA_SOURCE_TARGET_REGION_MISMATCH | Read replica should be in the same region as that of the source instance. | |
ERROR_INVALID_PROJECT | 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 | Project for the read replica instance does not match the project on the request URL. | |
ERROR_READ_REPLICA_INVALID_OPERATION | The requested operation is not valid for a read-replica instance. | |
ERROR_REPLICA_INVALID_OPERATION | The requested operation is not valid for a read-replica instance. | |
ERROR_REPLICATION_MASTER_INVALID_OPERATION | The requested operation is not valid for a replication master instance. | |
ERROR_DISALLOWED_ENABLING_BACKUPS_FOR_READ_REPLICA | Backups can't be enabled for read replica instances. | |
ERROR_INVALID_READ_REPLICA_ACTIVATION_POLICY | Read replica instance can only have 'ALWAYS' as activation policy. | |
ERROR_INVALID_INSTANCE_TYPE_CLOUDSQL | A Cloud SQL instance that is not a replica can't have an associated master instance name. | |
ERROR_INVALID_INSTANCE_TYPE_READ_REPLICA | A read replica instance must have an associated master instance. | |
ERROR_INVALID_INSTANCE_PROPERTY_DATABASE_REPLICATION_ENABLED | Database replication setting can't be set for instance of type other than read replica. | |
ERROR_DISALLOWED_DISABLED_DATABASE_REPLICATION_ON_REPLICA_CREATION | Database replication can't be turned off when creating a read replica. | |
ERROR_EXPORT_UNKNOWN_FILE_TYPE | Unknown export file type. | |
ERROR_EXPORT_SQL_DATABASE_COUNT | Exactly one database should be specified when exporting a SQL file and a table is also specified. | |
ERROR_EXPORT_CSV_DATABASE_COUNT | At most one database should be specified when exporting a CSV file. | |
ERROR_IMPORT_UNKNOWN_FILE_TYPE | Unknown import file type. | |
ERROR_DATABASE_TYPE_UNSUPPORTED_FOR_REPLICATION | Replication (and cloning) is not supported for this database type. | |
ERROR_DATABASE_TYPE_UNSUPPORTED_FOR_READ_REPLICA | Read replica is not supported for this database type. | |
ERROR_READ_REPLICA_INCOMPATIBLE_DATABASE_TYPES | Database versions of source and target instance are incompatible for replication. | |
ERROR_INSTANCES_INCOMPATIBLE_FOR_REPLICATION | Source and target instance are incompatible for replication. | |
ERROR_UNSUPPORTED_PUBLIC_KEY | Provided public key was in an invalid or unsupported format. | |
ERROR_INVALID_BACKUP_RUN_STATUS | The backup run status is not valid for the given request. | |
ERROR_FAILOVER_REPLICA_ALREADY_EXISTS | A failover replica already exists. | |
ERROR_INVALID_FAILOVER_REPLICA_OPERATION | Requested operation is not 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 | Requested operation requires a failover replica. | |
ERROR_EXPORT_CSV_SELECT_QUERY_SIZE_EXCEED_LIMIT | The Select query exceeds the size limit for CSV export operation. | |
ERROR_INVALID_HA_MASTER_OPERATION | The requested operation is not valid for a HA master instance. | |
ERROR_INVALID_HAS_REPLICA_OPERATION | The requested operation is not valid for an instance that has a replica. |
| Error class | Error code | Error message |
|---|---|---|
403 - FORBIDDEN | NOT_AUTHORIZED | The client is not authorized to make this request. |
INVALID_BILLING_ACCOUNT_STATE | The billing account is not in good standing; therefore no new instance can be created. | |
ERROR_GCS_BUCKET_PERMISSION_DENIAL | The service account does not have the required permissions for the bucket. |
| Error class | Error code | Error message |
|---|---|---|
404 - NOT_FOUND | INSTANCE_DOES_NOT_EXIST | The Cloud SQL instance does not 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 does not exist. | |
BACKUP_RUN_DOES_NOT_EXIST | The backup run does not exist. | |
SSL_CERTIFICATE_DOES_NOT_EXIST | The SSL certificate does not exist. |
| Error class | Error code | Error message |
|---|---|---|
409 - CONFLICT | INVALID_STATE | The instance or operation is not in an appropriate state to handle the request. |
OPERATION_IN_PROGRESS | Operation failed because another operation was already in progress. |
| Error class | Error code | Error message |
|---|---|---|
409 - DUPLICATE | INSTANCE_ALREADY_EXISTS | The Cloud SQL instance already exists. When you delete an instance, you can't reuse the name of the deleted instance until one week from the deletion date. |
| Error class | Error code | Error message |
|---|---|---|
412 - PRECONDITION_FAILED | STALE_DATA | Condition does not match. |
| Error class | Error code | Error message |
|---|---|---|
422 - INVALID_VALUE | INVALID_INSTANCE_PROPERTY | Invalid instance property. |
ERROR_INVALID_FLAG_DATABASE_TYPE | Flag requested can't be set on this database type. | |
ERROR_INVALID_FLAG_VALUE | Value requested is not valid. |
| Error class | Error code | Error message |
|---|---|---|
429 - LIMIT_EXCEEDED | ERROR_MAX_INSTANCE_PER_LABEL | Failed to create instance because the project or creator has reached the max instance per project/creator limit. |
ERROR_MAX_APP_IDS | 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 | Failed to create instance because the project or creator has reached the max free instances per project/creator limit. | |
ERROR_MAX_CLIENT_SSL_CERTIFICATES | 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 | Service temporarily unavailable. |
ERROR_SPECKLE_RPC | Service temporarily unavailable. | |
ERROR_BILLING_RPC | Service temporarily unavailable. | |
ERROR_UNKNOWN | The operation finished in an unknown state. | |
POOL_DOES_NOT_EXIST | Service temporarily unavailable. | |
ERROR_APPCONFIG_RPC | Service temporarily unavailable. | |
RETRY_TRANSIENT_ERROR | Service temporarily unavailable. This is most likely a transient error. Retry the operation. | |
ERROR_IP_MANAGEMENT_OPERATION | Service temporarily unavailable. This is most likely a transient error. Retry the operation. | |
ERROR_GCE_BOOT_DISK_CREATION_FAILURE | Instance creation failed to create a boot disk. | |
ERROR_GCE_DATA_DISK_CREATION_FAILURE | Instance creation failed to create a data disk. | |
ERROR_GCE_TMP_DISK_CREATION_FAILURE | Instance creation failed to create a tmp disk. | |
ERROR_GCE_IP_CREATION_FAILURE | Instance creation failed to obtain an IP address. | |
ERROR_GCE_VM_CREATION_FAILURE | Instance creation failed to create a VM. | |
ERROR_GCE_STOCKOUT | The zone or region does not 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 is not supported. |
UNSUPPORTED_V2_OPERATION | The requested operation is not supported on Cloud SQL instances. | |
ERROR_DISK_ENCRYPTION_UNSUPPORTED | Disk encryption with a KMS key is not supported for the requested operation. |