查询自动备份策略
URI
GET /v3/{project_id}/instances/{instance_id}/backups/policy
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
project_id |
是 |
String |
租户在某一Region下的project ID。 获取方法请参见获取项目ID。 |
instance_id |
是 |
String |
实例ID,严格匹配UUID规则。 |
请求参数
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
X-Auth-Token |
是 |
String |
用户Token。 通过调用IAM服务获取用户Token接口获取。 请求响应成功后在响应消息头中包含的“X-Subject-Token”的值即为Token值。 |
X-Language |
否 |
String |
请求语言类型。默认en-us。 取值范围:
|
响应参数
状态码: 200
参数 |
参数类型 |
描述 |
---|---|---|
backup_policy |
BackupPolicy object |
备份策略信息。 |
参数 |
参数类型 |
描述 |
---|---|---|
keep_days |
Integer |
指定已生成的备份文件可以保存的天数。取值范围:1~732。您也可以联系客服申请开通最大保留天数为3660。
|
start_time |
String |
备份时间段。自动备份将在该时间段内触发。 取值范围:格式必须为hh:mm-HH:MM且有效,当前时间指UTC时间。 |
period |
String |
备份周期配置。自动备份将在每星期指定的天进行。 取值范围:格式为逗号隔开的数字,数字加1表示自动备份的星期。 取值示例:1,2,3,4,5,6,7则表示备份周期配置为星期二、星期三、星期四、星期五、星期六、星期日、星期一。 |
retention_num_backup_level1 |
Integer |
一级备份保留数量。当一级备份开关开启时,返回此参数。 |
状态码: 400
参数 |
参数类型 |
描述 |
---|---|---|
error_code |
String |
错误码。 |
error_msg |
String |
错误消息。 |
状态码: 500
参数 |
参数类型 |
描述 |
---|---|---|
error_code |
String |
错误码。 |
error_msg |
String |
错误消息。 |
请求示例
查询实例的自动备份策略。
GET https://{endpoint}/v3/619d3e78f61b4be68bc5aa0b59edcf7b/instances/61a4ea66210545909d74a05c27a7179ein07/backups/policy
响应示例
状态码: 200
Success.
{ "backup_policy" : { "keep_days" : "7,", "start_time" : "19:00-20:00", "period" : "1,2", "retention_num_backup_level1" : 1 } }
状态码
请参见状态码。
错误码
请参见错误码。