4.6 策略
4.6.2 查询策略列表
"type" : "time",
"id" : "d67269a6-5369-42d7-8150-5254bd446328", "name" : "default"
},
"operation_definition" : { "retention_duration_days" : 1, "year_backups" : 0,
"operation_type" : "backup",
"id" : "cbb3ce6f-3332-4e7c-b98e-77290d8471ff"
}}
您可以在API Explorer中调试该接口。
URI
GET /v3/{project_id}/policies
表4-243 路径参数
参数 是否必选 参数类型 描述
project_id 是 String 项目ID
表4-244 Query 参数
参数 是否必选 参数类型 描述
operation_typ
e 否 String 策略类型：备份（backup）、
复制(replication) 枚举值：
● backup
● replication
vault_id 否 String 存储库ID
请求参数
表4-245 请求 Header 参数
参数 是否必选 参数类型 描述
X-Auth-Token 是 String 用户Token。 通过调用IAM服务 获取用户Token接口获取（响应 消息头中X-Subject-Token的 值）。
响应参数
状态码： 200
表4-246 响应 Body 参数
参数 参数类型 描述
policies Array of Policy objects
count Integer 策略总数
表4-247 Policy
参数 参数类型 描述
enabled Boolean 策略是否启用
id String 策略ID
name String 策略名称
operation_def
inition PolicyoODCre
ate object 策略属性
参数 参数类型 描述 operation_typ
e String 保护类型：备份（backup）、复制
(replication)。
枚举值：
● backup trigger PolicyTrigger
Resp object 策略时间调度规则 associated_va
ults Array of PolicyAssocia teVault objects
关联的存储库
表4-248 PolicyoODCreate
参数 参数类型 描述
day_backups Integer 保留日备个数，该备份不受保留最大备份数限 制。取值为0到100。若选择该参数，则timezone 也必选。
最小值：0 最大值：100 destination_pr
oject_id String 复制的目标项目ID，仅在跨区域复制时才会使用 并且必须指定。
destination_re
gion String 复制的目标区域，仅在跨区域复制时才会使用并
且必须指定。长度限制：0- 255，只能由字母、
数字、“_”、“-”组成 enable_accele
ration Boolean 跨区域复制时，是否启用加速从而缩减复制的时 间，如果不指定，默认不启用加速。
max_backups Integer 单个备份对象自动备份的最大备份数。取值为-1 或0-99999。-1代表不按备份数清理。若该字段
ps Integer 保留月备个数，该备份不受保留最大备份数限
制。取值为0到100。若选择该参数，则timezone 也必选。
最小值：0 最大值：100
参数 参数类型 描述 retention_dur
ation_days Integer 备份保留时长，单位天。最长支持99999天。-1 代表不按时间清理。若该字段和max_backups 参 数同时为空，备份会永久保留。
最小值：1 最大值：99999 缺省值：-1
timezone String 用户所在时区,格式形如UTC+08:00, 若选择年 备，月备，周备，日备中任一参数，则该参数不 能为空。
week_backups Integer 保留周备个数，该备份不受保留最大备份数限 制。取值为0到100。若选择该参数，则timezone 也必选。
year_backups Integer 保留年备个数，该备份不受保留最大备份数限 制。取值为0到100。若选择该参数，则timezone 也必选。
最小值：0 最大值：100
表4-249 PolicyTriggerResp
参数 参数类型 描述
id String 调度器id
name String 调度器名称
properties PolicyTrigger PropertiesRe sp object
调度器属性
type String 调度器类型,目前只支持 time: 定时调度。
枚举值：
● time
表4-250 PolicyTriggerPropertiesResp
参数 参数类型 描述
pattern Array of
strings 调度器的调度策略，长度限制为10240个字符，
参照iCalendar RFC 2445规范，但仅支持FREQ、
BYDAY、BYHOUR、BYMINUTE四个参数，其中
start_time String 调度器开始时间，例如："2020-01-08 09:59:49"
表4-251 PolicyAssociateVault
参数 参数类型 描述
destination_v
ault_id String 关联的远端存储库ID vault_id String 存储库ID
请求示例
GET https://{endpoint}/v3/{project_id}/policies
响应示例
状态码： 200 OK
{ "policies" : [ { "name" : "policy001", "associated_vaults" : [ ], "enabled" : true, "trigger" : { "properties" : {
"pattern" : [ "FREQ=WEEKLY;BYDAY=MO,TU,WE,TH,FR,SA,SU;BYHOUR=14;BYMINUTE=00" ], "start_time" : "2019-05-08 06:57:05"
},
"type" : "time",
"id" : "d67269a6-5369-42d7-8150-5254bd446328", "name" : "default"
},
"operation_definition" : { "retention_duration_days" : 1, "year_backups" : 0,
"operation_type" : "backup",
"id" : "cbb3ce6f-3332-4e7c-b98e-77290d8471ff"
} ], "count" : 10 }
状态码
状态码 描述
200 OK
错误码
请参见错误码。