Cloud SQL Admin API error messages

This page lists Cloud SQL Admin API error codes.

Error class Error codeError message
400 - BAD_REQUESTINVALID_REQUESTThe incoming request contained invalid data.
INVALID_MASTERSLAVE_APPRequest contains invalid primary/secondary application IDs when creating or updating an instance.
ERROR_NON_EXISTENT_APP_IDFailed to associate the instance with non-existent app ID.
ERROR_APP_REGIONThe App Engine app is in a different geographical region.
INVALID_OPERATIONThis operation isn"t valid for this instance.
PROJECT_NAME_MISMATCHFailed to create the target instance because it has a different project name from the source instance name specified.
ERROR_GCE_ZONE_REGIONThe Compute Engine zone is in a different geographical region.
ERROR_UNRECOGNIZED_GCE_ZONERequest contains an unrecognized Compute Engine zone when creating or updating an instance.
ERROR_BOTH_GCE_ZONE_GAE_APP_SPECIFIEDBoth Compute Engine zone and App Engine application ID are specified for location preference when creating or updating an instance.
ERROR_SSL_CERTIFICATE_COMMON_NAMEThe 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_EXISTSFailed to generate client certificate because there exists another certificate with the same common name.
ERROR_BINLOG_COORDINATES_VERIFICATIONBinary log coordinates used for cloning an instance are invalid with respect to the source instance.
ERROR_BINLOG_INVALID_FILE_NAMEBinary log file name used for cloning an instance is either empty or is invalid.
ERROR_BINLOG_INVALID_OFFSETBinary log position used for cloning an instance is either empty or invalid.
ERROR_BINLOG_NOT_ENABLEDThe requested operation is not allowed with an instance that does not have binary log enabled.
ERROR_INVALID_CLONE_SOURCE_PROJECTProject for the source Cloud SQL instance does not match the project on the request URL.
ERROR_INVALID_CLONE_DESTINATION_PROJECTProject for the destination Cloud SQL instance does not match the project on the request URL.
ERROR_BACKUP_NOT_FOUNDSuccessful backup required for carrying out the operation was not found.
ERROR_ADDING_ON_PREMISES_CONFIGCannot add on-premises config for the given instance type.
ERROR_ON_PREMISES_INSTANCE_INVALID_OPERATIONThe requested operation is not valid for an on-premises instance.
ERROR_ON_PREMISES_INSTANCE_WITH_NO_HOST_PORTAn on-premises instance needs to be configured with a host:port.
ERROR_ON_PREMISES_INSTANCE_WITH_SSL_CONFIGAn on-premises instance can't have SSL configuration.
ERROR_REPLICA_CONFIGURATION_MISSING_MASTER_INSTANCE_NAMEReplica configuration does not contain the master instance name from which to replicate.
ERROR_REPLICA_CONFIGURATION_MISSING_DUMP_FILE_PATHReplica configuration does not contain the dump file path when replicating from an on-premises master.
ERROR_REPLICA_CONFIGURATION_MISSING_USERNAMEReplica configuration does not contain the username (to use for the replication connection) when replicating from an on-premises master.
ERROR_REPLICA_CONFIGURATION_MISSING_PASSWORDReplica 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_MISMATCHRead replica should be in the same region as that of the source instance.
ERROR_INVALID_PROJECTProject specified in the request is invalid.
ERROR_MATCHING_SOURCE_DESTINATION_INSTANCE_NAMEThe instance being created can't have the same name as the source instance.
ERROR_INVALID_READ_REPLICA_PROJECTProject for the read replica instance does not match the project on the request URL.
ERROR_READ_REPLICA_INVALID_OPERATIONThe requested operation is not valid for a read-replica instance.
ERROR_REPLICA_INVALID_OPERATIONThe requested operation is not valid for a read-replica instance.
ERROR_REPLICATION_MASTER_INVALID_OPERATIONThe requested operation is not valid for a replication master instance.
ERROR_DISALLOWED_ENABLING_BACKUPS_FOR_READ_REPLICABackups can't be enabled for read replica instances.
ERROR_INVALID_READ_REPLICA_ACTIVATION_POLICYRead replica instance can only have 'ALWAYS' as activation policy.
ERROR_INVALID_INSTANCE_TYPE_CLOUDSQLA Cloud SQL instance that is not a replica can't have an associated master instance name.
ERROR_INVALID_INSTANCE_TYPE_READ_REPLICAA 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_TYPEUnknown export file type.
ERROR_EXPORT_SQL_DATABASE_COUNTExactly one database should be specified when exporting a SQL file and a table is also specified.
ERROR_EXPORT_CSV_DATABASE_COUNTAt most one database should be specified when exporting a CSV file.
ERROR_IMPORT_UNKNOWN_FILE_TYPEUnknown import file type.
ERROR_DATABASE_TYPE_UNSUPPORTED_FOR_REPLICATIONReplication (and cloning) is not supported for this database type.
ERROR_DATABASE_TYPE_UNSUPPORTED_FOR_READ_REPLICARead replica is not supported for this database type.
ERROR_READ_REPLICA_INCOMPATIBLE_DATABASE_TYPESDatabase versions of source and target instance are incompatible for replication.
ERROR_INSTANCES_INCOMPATIBLE_FOR_REPLICATIONSource and target instance are incompatible for replication.
ERROR_UNSUPPORTED_PUBLIC_KEYProvided public key was in an invalid or unsupported format.
ERROR_INVALID_BACKUP_RUN_STATUSThe backup run status is not valid for the given request.
ERROR_FAILOVER_REPLICA_ALREADY_EXISTSA failover replica already exists.
ERROR_INVALID_FAILOVER_REPLICA_OPERATIONRequested operation is not allowed for a failover replica.
ERROR_FAILOVER_REPLICA_AND_MASTER_IN_SAME_ZONEThe failover replica must be in a different zone than the master instance.
ERROR_NO_FAILOVER_REPLICARequested operation requires a failover replica.
ERROR_EXPORT_CSV_SELECT_QUERY_SIZE_EXCEED_LIMITThe Select query exceeds the size limit for CSV export operation.
ERROR_INVALID_HA_MASTER_OPERATIONThe requested operation is not valid for a HA master instance.
ERROR_INVALID_HAS_REPLICA_OPERATIONThe requested operation is not valid for an instance that has a replica.

Error class Error codeError message
403 - FORBIDDENNOT_AUTHORIZEDThe client is not authorized to make this request.
INVALID_BILLING_ACCOUNT_STATEThe billing account is not in good standing; therefore no new instance can be created.
ERROR_GCS_BUCKET_PERMISSION_DENIALThe service account does not have the required permissions for the bucket.

Error class Error codeError message
404 - NOT_FOUNDINSTANCE_DOES_NOT_EXISTThe Cloud SQL instance does not exist.
ERROR_INVALID_FLAG_NAMEThe requested flag is either misspelled or unsupported by Cloud SQL.
OPERATION_DOES_NOT_EXISTThe Cloud SQL instance operation does not exist.
BACKUP_RUN_DOES_NOT_EXISTThe backup run does not exist.
SSL_CERTIFICATE_DOES_NOT_EXISTThe SSL certificate does not exist.

Error class Error codeError message
409 - CONFLICTINVALID_STATEThe instance or operation is not in an appropriate state to handle the request.
OPERATION_IN_PROGRESSOperation failed because another operation was already in progress.

Error class Error codeError message
409 - DUPLICATEINSTANCE_ALREADY_EXISTSThe 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 codeError message
412 - PRECONDITION_FAILEDSTALE_DATACondition does not match.

Error class Error codeError message
422 - INVALID_VALUEINVALID_INSTANCE_PROPERTYInvalid instance property.
ERROR_INVALID_FLAG_DATABASE_TYPEFlag requested can't be set on this database type.
ERROR_INVALID_FLAG_VALUEValue requested is not valid.

Error class Error codeError message
429 - LIMIT_EXCEEDEDERROR_MAX_INSTANCE_PER_LABELFailed to create instance because the project or creator has reached the max instance per project/creator limit.
ERROR_MAX_APP_IDSFailed 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_LABELFailed to create instance because the project or creator has reached the max free instances per project/creator limit.
ERROR_MAX_CLIENT_SSL_CERTIFICATESFailed to create a client SSL certificate because you have created the maximum number of certificates allowed.

Error class Error codeError message
500 - BACKEND_ERRORSERVER_EXCEPTIONService temporarily unavailable.
ERROR_SPECKLE_RPCService temporarily unavailable.
ERROR_BILLING_RPCService temporarily unavailable.
ERROR_UNKNOWNThe operation finished in an unknown state.
POOL_DOES_NOT_EXISTService temporarily unavailable.
ERROR_APPCONFIG_RPCService temporarily unavailable.
RETRY_TRANSIENT_ERRORService temporarily unavailable. This is most likely a transient error. Retry the operation.
ERROR_IP_MANAGEMENT_OPERATIONService temporarily unavailable. This is most likely a transient error. Retry the operation.
ERROR_GCE_BOOT_DISK_CREATION_FAILUREInstance creation failed to create a boot disk.
ERROR_GCE_DATA_DISK_CREATION_FAILUREInstance creation failed to create a data disk.
ERROR_GCE_TMP_DISK_CREATION_FAILUREInstance creation failed to create a tmp disk.
ERROR_GCE_IP_CREATION_FAILUREInstance creation failed to obtain an IP address.
ERROR_GCE_VM_CREATION_FAILUREInstance creation failed to create a VM.
ERROR_GCE_STOCKOUTThe zone or region does not have sufficient resources to handle the request at the moment.
ERROR_GCE_QUOTA_EXCEEDEDThe requested resource is unavailable at the moment.

Error class Error codeError message
501 - UNSUPPORTED_METHODUNSUPPORTED_OPERATIONThe requested operation is not supported.
UNSUPPORTED_V2_OPERATIONThe requested operation is not supported on Cloud SQL instances.
ERROR_DISK_ENCRYPTION_UNSUPPORTEDDisk encryption with a KMS key is not supported for the requested operation.