Cloud SQL Admin API 错误消息

本页面列出了 Cloud SQL Admin API 错误代码。

错误类	错误代码	错误消息
`400 - BAD_REQUEST`	`INVALID_REQUEST`	传入请求包含无效的数据。
	`INVALID_MASTERSLAVE_APP`	创建或更新实例时，请求包含无效的主要或次要应用 ID。
	`ERROR_NON_EXISTENT_APP_ID`	应用 ID 不存在。实例无法与应用连接。
	`ERROR_APP_REGION`	App Engine 应用位于不同的地理区域。
	`INVALID_OPERATION`	操作对此实例无效。
	`PROJECT_NAME_MISMATCH`	操作未能创建目标实例，因为它的项目名称与指定的来源实例名称不同。
	`ERROR_GCE_ZONE_REGION`	Compute Engine 区域位于不同的地理区域。
	`ERROR_UNRECOGNIZED_GCE_ZONE`	请求包含无法识别的 Compute Engine 可用区。
	`ERROR_BOTH_GCE_ZONE_GAE_APP_SPECIFIED`	在创建或更新实例时，系统为位置偏好同时指定了 Compute Engine 可用区和 App Engine 应用 ID。操作仅使用了其中一项。
	`ERROR_SSL_CERTIFICATE_COMMON_NAME`	通用名称只能包含字母数字字符、英文句点、短划线、空格和下划线。空格不能出现在开头或末尾。长度不能超过 64 个字符。
	`ERROR_SSL_CERTIFICATE_COMMON_NAME_ALREADY_EXISTS`	操作未能生成客户端证书，因为存在其他共用相同名称的证书。
	`ERROR_BINLOG_COORDINATES_VERIFICATION`	用于克隆实例的二进制日志坐标对源实例无效。
	`ERROR_BINLOG_INVALID_FILE_NAME`	用于克隆实例的二进制日志文件名为空或无效。
	`ERROR_BINLOG_INVALID_OFFSET`	用于克隆实例的二进制日志位置为空或无效。
	`ERROR_BINLOG_NOT_ENABLED`	未启用二进制日志或二进制日志记录的实例不允许使用请求的操作。
	`ERROR_INVALID_CLONE_SOURCE_PROJECT`	来源 Cloud SQL 实例的项目与请求网址上的项目不匹配。
	`ERROR_INVALID_CLONE_DESTINATION_PROJECT`	目标 Cloud SQL 实例的项目与请求网址上的项目不匹配。
	`ERROR_BACKUP_NOT_FOUND`	系统找不到成功的备份。需要备份才能执行此操作。
	`ERROR_ADDING_ON_PREMISES_CONFIG`	系统无法为给定的实例类型添加本地配置。
	`ERROR_ON_PREMISES_INSTANCE_INVALID_OPERATION`	请求的操作对本地实例无效。
	`ERROR_ON_PREMISES_INSTANCE_WITH_NO_HOST_PORT`	需要使用 `host:port` 来配置本地实例。
	`ERROR_ON_PREMISES_INSTANCE_WITH_SSL_CONFIG`	本地实例不能使用 SSL 配置。
	`ERROR_REPLICA_CONFIGURATION_MISSING_MASTER_INSTANCE_NAME`	副本配置不包含要用于复制的主实例名称。
	`ERROR_REPLICA_CONFIGURATION_MISSING_DUMP_FILE_PATH`	从本地主实例复制时，副本配置不包含转储文件路径。
	`ERROR_REPLICA_CONFIGURATION_MISSING_USERNAME`	从本地主实例复制时，副本配置不包含用户名（用于复制连接）。
	`ERROR_REPLICA_CONFIGURATION_MISSING_PASSWORD`	从本地主实例复制时，副本配置不包含密码（用于复制连接）。
	`ERROR_READ_REPLICA_SOURCE_TARGET_REGION_MISMATCH`	读取副本必须与来源实例位于同一区域。
	`ERROR_INVALID_PROJECT`	请求中指定的项目无效。
	`ERROR_MATCHING_SOURCE_DESTINATION_INSTANCE_NAME`	正在创建的实例不能与来源实例同名。
	`ERROR_INVALID_READ_REPLICA_PROJECT`	包含读取副本的项目与请求网址上的项目不匹配。
	`ERROR_READ_REPLICA_INVALID_OPERATION`	请求的操作对读取副本无效。
	`ERROR_REPLICA_INVALID_OPERATION`	请求的操作对读取副本无效。
	`ERROR_REPLICATION_MASTER_INVALID_OPERATION`	请求的操作对复制主实例无效。
	`ERROR_DISALLOWED_ENABLING_BACKUPS_FOR_READ_REPLICA`	无法为读取副本启用备份。
	`ERROR_INVALID_READ_REPLICA_ACTIVATION_POLICY`	读取副本未指定为“ALWAYS”。
	`ERROR_INVALID_INSTANCE_TYPE_CLOUDSQL`	非副本的 Cloud SQL 实例不能具有关联的主实例名称。
	`ERROR_INVALID_INSTANCE_TYPE_READ_REPLICA`	读取副本实例必须具有关联的主实例。
	`ERROR_INVALID_INSTANCE_PROPERTY_DATABASE_REPLICATION_ENABLED`	数据库复制设置仅用于读取副本。
	`ERROR_DISALLOWED_DISABLED_DATABASE_REPLICATION_ON_REPLICA_CREATION`	创建读取副本时，必须启用数据库复制标志。
	`ERROR_EXPORT_UNKNOWN_FILE_TYPE`	导出文件类型未知。
	`ERROR_EXPORT_SQL_DATABASE_COUNT`	操作要求您在导出 SQL 文件时仅指定一个数据库和一个表。
	`ERROR_EXPORT_CSV_DATABASE_COUNT`	操作要求您在导出 CSV 文件时最多指定一个数据库。
	`ERROR_IMPORT_UNKNOWN_FILE_TYPE`	导入文件类型未知。
	`ERROR_DATABASE_TYPE_UNSUPPORTED_FOR_REPLICATION`	此数据库类型不支持复制和克隆操作。
	`ERROR_DATABASE_TYPE_UNSUPPORTED_FOR_READ_REPLICA`	此数据库类型不支持读取副本。
	`ERROR_READ_REPLICA_INCOMPATIBLE_DATABASE_TYPES`	要复制的来源实例和目标实例的数据库版本不兼容。
	`ERROR_INSTANCES_INCOMPATIBLE_FOR_REPLICATION`	要复制的来源实例和目标实例不兼容。
	`ERROR_UNSUPPORTED_PUBLIC_KEY`	提供的公钥使用了无效或不受支持的格式。
	`ERROR_INVALID_BACKUP_RUN_STATUS`	备用运行状态对给定的请求无效。
	`ERROR_FAILOVER_REPLICA_ALREADY_EXISTS`	已存在故障切换副本。
	`ERROR_INVALID_FAILOVER_REPLICA_OPERATION`	故障切换副本不允许请求的操作。
	`ERROR_FAILOVER_REPLICA_AND_MASTER_IN_SAME_ZONE`	故障切换副本必须位于与主实例不同的可用区中。
	`ERROR_NO_FAILOVER_REPLICA`	请求的操作需要故障切换副本。
	`ERROR_EXPORT_CSV_SELECT_QUERY_SIZE_EXCEED_LIMIT`	`Select` 查询超出了 CSV 导出操作的大小限制。
	`ERROR_INVALID_HA_MASTER_OPERATION`	请求的操作对高可用性主实例无效。
	`ERROR_INVALID_HAS_REPLICA_OPERATION`	请求的操作对包含副本的实例无效。
	`ERROR_INSTANCE_NAME_CONFLICT`	已存在使用指定名称的实例。
	`ERROR_BACKUP_SIZE_EXCEEDS_INSTANCE_SIZE`	无法将备份恢复到存储空间大小小于备份大小的实例。
	`ERROR_INVALID_PRIMARY_IP_RANGE`	主数据库的 IP 地址位于不受支持的 IP 地址范围内。不支持非 RFC 1918 IP。如需设置副本，请更改主服务器的 IP 地址。
	`ERROR_INVALID_REPLICA_REGION_TOPOLOGY`	所请求的操作会导致副本链中的区域依赖关系形成循环。
	`ERROR_REPLICA_DEPTH_LIMIT_EXCEEDED`	请求的操作会导致层叠副本的深度超出 4 级的限制。
	`ERROR_DISALLOWED_UPDATING_EXTERNAL_SERVER_REPLICA_REPLICATION_STATE`	不允许更新外部服务器副本实例的复制状态设置。请改用 stopReplica 或 startReplica API。
	`ERROR_DISALLOWED_UPDATING_EXTERNAL_SERVER_REPLICA_REPLICATION_STATE`	不允许更新外部服务器副本实例的复制状态设置。请改用 stopReplica 或 startReplica API。
	`ERROR_EXTERNAL_SERVER_REPLICA_GTID_MODE`	外部服务器副本必须具有 gtid_mode=ON，才能具有只读副本。
	`ERROR_PITR_BACKUP_RUN_NOT_DELETABLE`	此升级备份无法删除，因为它处于实例的时间点恢复保留期限内。如果您调整了保留期限或停用了时间点恢复功能，则可以更早删除日志。
	`ERROR_PROTECTED_INSTANCE_DELETION_FAILURE`	实例已受保护。请停用删除保护，然后重试。如需停用删除保护，请将 deletionProtectionEnabled 设置为 false，以更新实例设置。
	`ERROR_READ_REPLICA_UNDER_EXTERNAL_SERVER_REPLICA_NOT_SYNCED`	要创建读取副本，必须在外部服务器副本上完成初始同步。

错误类	错误代码	错误消息
`403 - FORBIDDEN`	`NOT_AUTHORIZED`	该客户端无权发出此请求。
	`INVALID_BILLING_ACCOUNT_STATE`	结算账号存在问题。在解决结算问题之前无法创建新实例。
	`ERROR_GCS_BUCKET_PERMISSION_DENIAL`	服务账号没有所需的存储桶权限。

错误类	错误代码	错误消息
`404 - NOT_FOUND`	`INSTANCE_DOES_NOT_EXIST`	Cloud SQL 实例不存在。
	`ERROR_INVALID_FLAG_NAME`	请求的标志有拼写错误或不受 Cloud SQL 支持。
	`OPERATION_DOES_NOT_EXIST`	Cloud SQL 实例操作不存在。
	`BACKUP_RUN_DOES_NOT_EXIST`	备份运行不存在。
	`SSL_CERTIFICATE_DOES_NOT_EXIST`	SSL 证书不存在。

错误类	错误代码	错误消息
`409 - CONFLICT`	`INVALID_STATE`	实例或操作未处于适当的状态，无法处理请求。
	`OPERATION_IN_PROGRESS`	操作失败，因为已有其他操作正在进行中。

错误类	错误代码	错误消息
`412 - PRECONDITION_FAILED`	`STALE_DATA`	条件不匹配。

错误类	错误代码	错误消息
`422 - INVALID_VALUE`	`INVALID_INSTANCE_PROPERTY`	实例属性无效。
	`ERROR_INVALID_FLAG_DATABASE_TYPE`	不能对此数据库类型设置请求的标志。
	`ERROR_INVALID_FLAG_VALUE`	请求的值无效。

错误类	错误代码	错误消息
`429 - LIMIT_EXCEEDED`	`ERROR_MAX_INSTANCE_PER_LABEL`	操作未能创建实例，因为项目已达到每个项目允许的实例数上限。
	`ERROR_MAX_APP_IDS`	操作未能更新实例，因为它超出了可以附加到实例的应用 ID 数上限。
	`ERROR_MAX_FREE_INSTANCE_PER_LABEL`	操作未能创建实例，因为项目或创建者已达到每个项目或创建者可创建的免费实例数上限。
	`ERROR_MAX_CLIENT_SSL_CERTIFICATES`	操作未能创建客户端 SSL 证书，因为您已创建允许的证书数上限。

错误类	错误代码	错误消息
`500 - BACKEND_ERROR`	`SERVER_EXCEPTION`	服务暂时不可用。
	`ERROR_SPECKLE_RPC`	服务暂时不可用。
	`ERROR_BILLING_RPC`	服务暂时不可用。
	`ERROR_UNKNOWN`	操作在未知状态下完成。
	`POOL_DOES_NOT_EXIST`	服务暂时不可用。
	`ERROR_APPCONFIG_RPC`	服务暂时不可用。
	`RETRY_TRANSIENT_ERROR`	服务暂时不可用。这很可能是暂时性错误。重试该操作。
	`ERROR_IP_MANAGEMENT_OPERATION`	服务暂时不可用。这很可能是暂时性错误。重试该操作。
	`ERROR_GCE_BOOT_DISK_CREATION_FAILURE`	实例创建操作未能创建启动磁盘。
	`ERROR_GCE_DATA_DISK_CREATION_FAILURE`	实例创建操作未能创建数据磁盘。
	`ERROR_GCE_TMP_DISK_CREATION_FAILURE`	实例创建操作未能创建 tmp 磁盘。
	`ERROR_GCE_IP_CREATION_FAILURE`	实例创建操作未能获取 IP 地址。
	`ERROR_GCE_VM_CREATION_FAILURE`	实例创建操作未能创建虚拟机。
	`ERROR_GCE_STOCKOUT`	可用区或区域目前没有足够的资源来处理请求。
	`ERROR_GCE_QUOTA_EXCEEDED`	请求的资源目前不可用。

错误类	错误代码	错误消息
`501 - UNSUPPORTED_METHOD`	`UNSUPPORTED_OPERATION`	请求的操作不受支持。
	`UNSUPPORTED_V2_OPERATION`	Cloud SQL 实例不支持请求的操作。
	`ERROR_DISK_ENCRYPTION_UNSUPPORTED`	请求的操作不支持使用 KMS 密钥进行磁盘加密。