调用CreateBackup接口为PolarDB集群创建全量快照备份。
说明
- 每个集群最多可以同时存在3个手动创建的备份。
- 若出现错误提示
Exceeding the daily backup times of this DB cluster
,表明您的集群中已存在3个手动创建的备份,请删除备份后再使用该接口。 - 调用该接口后,会在后台创建备份任务,若数据量较大,花费的时间可能较长,请耐心等待。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 否 | CreateBackup |
系统规定参数,取值为CreateBackup。 |
DBClusterId | String | 是 | pc-************* |
集群ID。 |
ClientToken | String | 否 | 6000170000591aed949d0f54a343f1a4233c1e7d1c5c****** |
用于保证请求的幂等性,防止重复提交请求。由客户端生成该参数值,保证在不同请求间唯一,大小写敏感、不超过64个ASCII字符。 |
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
BackupJobId | String | 11111111 |
备份集ID。 |
RequestId | String | F3322AFE-083E-4D77-A074-421301****** |
请求ID。 |
示例
请求示例
http(s)://polardb.aliyuncs.com/?Action=CreateBackup
&DBClusterId=pc-*************
&<公共请求参数>
正常返回示例
XML
格式
<CreateBackupResponse>
<RequestId>F3322AFE-083E-4D77-A074-421301******</RequestId>
<BackupJobId>11111111</BackupJobId>
</CreateBackupResponse>
JSON
格式
{
"RequestId": "F3322AFE-083E-4D77-A074-421301******",
"BackupJobId": 11111111
}
错误码
访问错误中心查看更多错误码。