Cloud SQL Admin API error messages

This page lists Cloud SQL Admin API error codes.

Error classError codeError message
400 - BAD_REQUESTINVALID_REQUESTThe incoming request contains invalid data.
INVALID_MASTERSLAVE_APPThe request contains invalid primary or secondary application IDs when creating or updating an instance.
ERROR_NON_EXISTENT_APP_IDThe application ID does not exist. The instance could not be connected with an application.
ERROR_APP_REGIONThe App Engine app is in a different geographical region.
INVALID_OPERATIONThe operation isn't valid for this instance.
PROJECT_NAME_MISMATCHThe operation failed 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_ZONEThe request contains an unrecognized Compute Engine zone.
ERROR_BOTH_GCE_ZONE_GAE_APP_SPECIFIEDThe 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_NAMEThe 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_EXISTSThe operation failed to generate a client certificate because another certificate with the same common name exists.
ERROR_BINLOG_COORDINATES_VERIFICATIONThe binary log coordinates used for cloning an instance are invalid in relation to the source instance.
ERROR_BINLOG_INVALID_FILE_NAMEThe binary log filename used for cloning an instance is either empty or invalid.
ERROR_BINLOG_INVALID_OFFSETThe binary log position used for cloning an instance is either empty or invalid.
ERROR_BINLOG_NOT_ENABLEDThe requested operation isn't allowed with an instance that doesn't have a binary log or binary logging enabled.
ERROR_INVALID_CLONE_SOURCE_PROJECTThe project for the source Cloud SQL instance doesn't match the project on the request URL.
ERROR_INVALID_CLONE_DESTINATION_PROJECTThe project for the destination Cloud SQL instance doesn't match the project on the request URL.
ERROR_BACKUP_NOT_FOUNDThe system can't find a successful backup. A backup is required to carry out the operation.
ERROR_ADDING_ON_PREMISES_CONFIGThe system can't add the on-premises configuration for the given instance type.
ERROR_ON_PREMISES_INSTANCE_INVALID_OPERATIONThe requested operation isn't 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 use the SSL configuration.
ERROR_REPLICA_CONFIGURATION_MISSING_MASTER_INSTANCE_NAMEThe replica configuration doesn't contain the master instance name to use for replication.
ERROR_REPLICA_CONFIGURATION_MISSING_DUMP_FILE_PATHThe replica configuration doesn't contain the dump file path when replicating from an on-premises master.
ERROR_REPLICA_CONFIGURATION_MISSING_USERNAMEThe replica configuration doesn't contain the username (to use for the replication connection) when replicating from an on-premises master.
ERROR_REPLICA_CONFIGURATION_MISSING_PASSWORDThe 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_MISMATCHThe read replica must be in the same region as that of the source instance.
ERROR_INVALID_PROJECTThe project 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_PROJECTThe project containing the read replica doesn't match the project on the request URL.
ERROR_READ_REPLICA_INVALID_OPERATIONThe requested operation isn't valid for a read replica.
ERROR_REPLICA_INVALID_OPERATIONThe requested operation isn't valid for a read replica.
ERROR_REPLICATION_MASTER_INVALID_OPERATIONThe requested operation isn't valid for a replication master instance.
ERROR_DISALLOWED_ENABLING_BACKUPS_FOR_READ_REPLICAA backup can't be enabled for read replicas.
ERROR_INVALID_READ_REPLICA_ACTIVATION_POLICYThe read replica is not specified as 'ALWAYS'.
ERROR_INVALID_INSTANCE_TYPE_CLOUDSQLA Cloud SQL instance that isn't a replica can't have an associated master instance name.
ERROR_INVALID_INSTANCE_TYPE_READ_REPLICAA read replica must have an associated master instance.
ERROR_INVALID_INSTANCE_PROPERTY_DATABASE_REPLICATION_ENABLEDThe database replication setting is only used on a read replica.
ERROR_DISALLOWED_DISABLED_DATABASE_REPLICATION_ON_REPLICA_CREATIONThe database replication flag must be enabled when creating a read replica.
ERROR_EXPORT_UNKNOWN_FILE_TYPEThe export file type is unknown.
ERROR_EXPORT_SQL_DATABASE_COUNTThe operation requires that you specify exactly one database and one table when exporting a SQL file.
ERROR_EXPORT_CSV_DATABASE_COUNTThe operation requires that you specify, at most, one database when exporting a CSV file.
ERROR_IMPORT_UNKNOWN_FILE_TYPEThe import file type is unknown.
ERROR_DATABASE_TYPE_UNSUPPORTED_FOR_REPLICATIONThe replication and cloning operations aren't supported for this database type.
ERROR_DATABASE_TYPE_UNSUPPORTED_FOR_READ_REPLICAThe read replica isn't supported for this database type.
ERROR_READ_REPLICA_INCOMPATIBLE_DATABASE_TYPESThe database versions for the source and target instances are incompatible for replication.
ERROR_INSTANCES_INCOMPATIBLE_FOR_REPLICATIONThe source and target instances are incompatible for replication.
ERROR_UNSUPPORTED_PUBLIC_KEYThe provided public key uses an invalid or unsupported format.
ERROR_INVALID_BACKUP_RUN_STATUSThe backup run status isn't valid for the given request.
ERROR_FAILOVER_REPLICA_ALREADY_EXISTSA failover replica already exists.
ERROR_INVALID_FAILOVER_REPLICA_OPERATIONThe requested operation isn't 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_REPLICAThe requested operation requires a failover replica.
ERROR_EXPORT_CSV_SELECT_QUERY_SIZE_EXCEED_LIMITThe Select query exceeds the size limit for the CSV export operation.
ERROR_INVALID_HA_MASTER_OPERATIONThe requested operation isn't valid for an HA master instance.
ERROR_INVALID_HAS_REPLICA_OPERATIONThe requested operation isn't valid for an instance that has a replica.
ERROR_INSTANCE_NAME_CONFLICTThere is an existing instance with the given name.
ERROR_BACKUP_SIZE_EXCEEDS_INSTANCE_SIZERestore from backup can't be done to the instance with storage size smaller than the backup size.
ERROR_INVALID_PRIMARY_IP_RANGEThe 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_TOPOLOGYRequested operation would cause circular region dependency in replica chain.
ERROR_REPLICA_DEPTH_LIMIT_EXCEEDEDRequested operation would cause exceeding the limit of 4 levels on the depth of cascading replicas.
ERROR_DISALLOWED_UPDATING_EXTERNAL_SERVER_REPLICA_REPLICATION_STATEUpdating 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_STATEUpdating 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_MODEExternal server replica must have gtid_mode=ON in order to have a read replica.
ERROR_PITR_BACKUP_RUN_NOT_DELETABLEThis 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_FAILUREThe 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_SYNCEDTo have a read replica, there must be an initial sync completed on the external server replica.

Error classError codeError message
403 - FORBIDDENNOT_AUTHORIZEDThe client isn't authorized to make this request.
INVALID_BILLING_ACCOUNT_STATEThe billing account has an issue. A new instance can't be created until the billing issue is resolved.
ERROR_GCS_BUCKET_PERMISSION_DENIALThe service account doesn't have the required permissions for the bucket.

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

Error classError codeError message
409 - CONFLICTINVALID_STATEThe instance or operation isn't in an appropriate state to handle the request.
OPERATION_IN_PROGRESSThe operation failed because another operation was already in progress.

Error classError codeError message
412 - PRECONDITION_FAILEDSTALE_DATAThe condition doesn't match.

Error classError codeError message
422 - INVALID_VALUEINVALID_INSTANCE_PROPERTYThe instance property is invalid.
ERROR_INVALID_FLAG_DATABASE_TYPEThe flag requested can't be set on this database type.
ERROR_INVALID_FLAG_VALUEThe requested value isn't valid.

Error classError codeError message
429 - LIMIT_EXCEEDEDERROR_MAX_INSTANCE_PER_LABELThe operation failed to create an instance because the project has reached the maximum instance per project limit.
ERROR_MAX_APP_IDSThe 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_LABELThe 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_CERTIFICATESThe operation failed to create a client SSL certificate because you have created the maximum number of certificates allowed.

Error classError codeError message
500 - BACKEND_ERRORSERVER_EXCEPTIONThe service is temporarily unavailable.
ERROR_SPECKLE_RPCThe service is temporarily unavailable.
ERROR_BILLING_RPCThe service is temporarily unavailable.
ERROR_UNKNOWNThe operation finished in an unknown state.
POOL_DOES_NOT_EXISTThe service is temporarily unavailable.
ERROR_APPCONFIG_RPCThe service is temporarily unavailable.
RETRY_TRANSIENT_ERRORThe service is temporarily unavailable. This is most likely a momentary error. Retry the operation.
ERROR_IP_MANAGEMENT_OPERATIONThe service is temporarily unavailable. This is most likely a momentary error. Retry the operation.
ERROR_GCE_BOOT_DISK_CREATION_FAILUREThe instance creation operation failed to create a boot disk.
ERROR_GCE_DATA_DISK_CREATION_FAILUREThe instance creation operation failed to create a data disk.
ERROR_GCE_TMP_DISK_CREATION_FAILUREThe instance creation operation failed to create a tmp disk.
ERROR_GCE_IP_CREATION_FAILUREThe instance creation operation failed to obtain an IP address.
ERROR_GCE_VM_CREATION_FAILUREThe instance creation operation failed to create a VM.
ERROR_GCE_STOCKOUTThe zone or region doesn't have sufficient resources to handle the request at the moment.
ERROR_GCE_QUOTA_EXCEEDEDThe requested resource is unavailable at the moment.

Error classError codeError message
501 - UNSUPPORTED_METHODUNSUPPORTED_OPERATIONThe requested operation isn't supported.
UNSUPPORTED_V2_OPERATIONThe requested operation isn't supported on Cloud SQL instances.
ERROR_DISK_ENCRYPTION_UNSUPPORTEDThe disk encryption with a KMS key isn't supported for the requested operation.