查询指定组织策略 - ShowOrganizationPolicy
功能介绍
查询指定组织策略
授权信息
账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。
- 如果使用角色与策略授权,具体权限要求请参见权限和授权项。
- 如果使用身份策略授权,当前API调用无需身份策略权限。
URI
GET /v3/{project_id}/organization-policies/{organization_policy_id}
请求参数
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| X-Auth-Token | 是 | String | 参数解释: 用户Token。 通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。 约束限制: 不涉及 取值范围: 不涉及 默认取值: 不涉及 |
响应参数
状态码:200
| 参数 | 参数类型 | 描述 |
|---|---|---|
| policy | OrganizationPolicy object | 参数解释: 组织策略详情对象,包含策略ID、名称、类型、调度规则等完整配置信息 取值范围: 不涉及 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| id | String | 参数解释: 组织策略ID,获取方法可参考查询组织策略列表 取值范围: UUID,形式为32个十六进制数字 |
| name | String | 参数解释: 组织策略名称 取值范围: 1-64个字符组成的字符串 |
| description | String | 参数解释: 组织策略描述 取值范围: 0-255个字符组成的字符串 |
| operation_type | String | 参数解释: 组织策略类型 取值范围: |
| domain_id | String | 参数解释: 组织策略所属账号ID 取值范围: 不涉及 |
| policy_name | String | 参数解释: 策略名称 取值范围: 1-64个字符组成的字符串 |
| policy_enabled | Boolean | 参数解释: 策略是否启用 取值范围: |
| policy_operation_definition | PolicyoODResp object | 参数解释: 策略定义,备份和复制里面的具体字段各不相同,和策略的保持一致 取值范围: 不涉及 |
| policy_trigger | 参数解释: 策略执行时间规则,定义任务的触发时间和频率 取值范围: 不涉及 | |
| status | String | 参数解释: 组织策略状态 取值范围: 有updating,deleting和available三种状态 updating:更新中,表示目前组织策略状态正在更新 deleting:删除中,表示目前组织策略正在被删除 available:可用状态,表示目前没有对组织策略的操作,可以正常使用 |
| domain_name | String | 参数解释: 组织策略所属账号 取值范围: 不涉及 |
| effective_scope | String | 参数解释: 组织策略生效范围 取值范围: 0-255个字符组成的字符串 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| day_backups | Integer | 参数解释: 保留日备个数 取值范围: 取值为0到100 |
| destination_project_id | String | 参数解释: 复制的目标区域项目ID 取值范围: 不涉及 |
| destination_region | String | 参数解释: 复制的目标区域 取值范围: 长度为0~255个字符,只能由字母、数字、“_”、“-”组成 |
| enable_acceleration | Boolean | 参数解释: 跨region复制时,是否启用加速从而缩短复制的时间。 取值范围: |
| max_backups | Integer | 参数解释: 单个备份对象自动备份的最大备份数 取值范围: 取值为-1或1-99999。默认取值不涉及。-1代表不按备份数清理。如果该字段和retention_duration_days字段同时为空,备份会永久保留 |
| month_backups | Integer | 参数解释: 保留月备个数 取值范围: 取值为0到100 |
| retention_duration_days | Integer | 参数解释: 备份保留时长,单位天 取值范围: -1代表不按时间清理,最长支持99999天 |
| timezone | String | 参数解释: 用户所在时区,格式形如UTC+08:00 取值范围: 不涉及 |
| week_backups | Integer | 参数解释: 保留周备个数,该备份不受保留最大备份数限制 取值范围: 取值为0到100 |
| year_backups | Integer | 参数解释: 保留年备个数,该备份不受保留最大备份数限制 取值范围: 取值为0到100 |
| full_backup_interval | Integer | 参数解释: 每间隔多少次执行一次全量备份 取值范围: 当取值为 -1 时,不执行全量备份。取值范围[-1, 100] |
| advanced_retention_rules | 参数解释: 按照时间的高级保留策略相关参数 取值范围: 不涉及 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| weekly_retention_rules | 参数解释: 周备备份的保留策略 取值范围: 不涉及 | |
| monthly_retention_rules | 参数解释: 月备备份的保留策略 取值范围: 不涉及 | |
| yearly_retention_rules | 参数解释: 年备备份的保留策略 取值范围: 不涉及 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| days_of_week | Array of strings | 参数解释: 设置每个星期中的指定天为周备备份 取值范围: MO:周一 TU:周二 WE:周三 TH:周四 FR:周五 SA:周六 SU:周日 |
| retention_duration_periods | Integer | 参数解释: 周备的保留时间 取值范围: 取值范围为1-5200,以及-1,单位为周,-1代表周备策略不启用 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| retention_type | String | 参数解释: 月备规则的类型 取值范围: WEEKLY:按周设置月备规则 MONTHLY:按月设置月备规则 |
| retention_weeks | Array of strings | 参数解释: 将每月第几个星期的备份设置为月备备份 取值范围: FIRST:第一个 SECOND:第二个 THIRD:第三个 FOURTH:第四个 LAST:最后一个 |
| days_of_week | Array of strings | 参数解释: 设置选中的星期中的指定天的备份为月备备份 取值范围: MO:周一 TU:周二 WE:周三 TH:周四 FR:周五 SA:周六 SU:周日 |
| days_of_month | Array of integers | 参数解释: 表示将每个月中的指定天设置为月备备份 取值范围: 取值范围为1-28和-1,-1代表每个月的最后一天 |
| retention_duration_periods | Integer | 参数解释: 月备备份的保留时间 取值范围: 取值范围为1-1200,以及-1,单位为月,-1代表月备策略不启用 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| retention_type | String | 参数解释: 年备规则的类型 取值范围: WEEKLY:按周设置月备规则 MONTHLY:按月设置月备规则 |
| retention_months | Array of strings | 参数解释: 将每年中指定月份的备份设置为年备备份 取值范围: JANUARY:一月 FEBRUARY:二月 MARCH:三月 APRIL:四月 MAY:五月 JUNE:六月 JULY:七月 AUGUST:八月 SEPTEMBER:九月 OCTOBER:十月 NOVEMBER:十一月 DECEMBER:十二月 |
| retention_weeks | Array of strings | 参数解释: 将选中月份的第几个星期的备份设置为年备备份 取值范围: FIRST:第一个 SECOND:第二个 THIRD:第三个 FOURTH:第四个 LAST:最后一个 |
| days_of_month | Array of integers | 参数解释: 表示将选中月份的指定天的备份设置为年备备份 取值范围: 取值范围为1-28和-1,-1代表每个月的最后一天,需要与retention_months共同设置 |
| days_of_week | Array of strings | 参数解释: 设置指定月份的指定星期中的指定天的备份为年备备份 取值范围: MO:周一 TU:周二 WE:周三 TH:周四 FR:周五 SA:周六 SU:周日 |
| retention_duration_periods | Integer | 参数解释: 年备备份的保留时间 取值范围: 取值范围为1-100,以及-1,单位为年,-1代表年备策略不启用 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| pattern | Array of strings | 参数解释: 调度规则,限制24条规则,可参照iCalendar RFC 2445规范中的事件规则,但仅支持FREQ、BYDAY、BYHOUR、BYMINUTE、INTERVAL等参数,其中FREQ仅支持WEEKLY和DAILY,BYDAY支持一周七天(MO、TU、WE、TH、FR、SA、SU),BYHOUR支持0-23小时,BYMINUTE支持0-59分钟,并且间隔不能小于一小时,一天最大24个时间点。例如,周一到周天,每天UTC时间的14:00调度,其规则为:'FREQ=WEEKLY;BYDAY=MO,TU,WE,TH,FR,SA,SU;BYHOUR=14;BYMINUTE=00'。例如:某个地区的时间为 UTC+8,如果在该地区每天14:00调度,则在14点基础上减8,其规则为'FREQ=DAILY;INTERVAL=1;BYHOUR=6;BYMINUTE=00' 取值范围: 不涉及 |
| start_window_minutes | Integer | 参数解释: 启动时间窗口大小 取值范围: 60-480 |
请求示例
查询指定组织策略。
GET https://{endpoint}/v3/{project_id}/organization-policies/{organization_policy_id} 响应示例
状态码:200
{
"policy" : {
"id" : "5f5dd325-d7d1-4693-9d97-db37ecb91696",
"name" : "organization-policies_create_test",
"operation_type" : "backup",
"domain_id" : "0ae13f008700d53f0fb4c01200e79660",
"policy_name" : "policy_create_test",
"policy_operation_definition" : {
"max_backups" : -1,
"retention_duration_days" : -1,
"day_backups" : 0,
"week_backups" : 0,
"month_backups" : 0,
"year_backups" : 0,
"timezone" : "UTC+08:00",
"full_backup_interval" : -1
},
"policy_enabled" : false,
"policy_trigger" : {
"properties" : {
"pattern" : [ "FREQ=WEEKLY;BYDAY=MO,TU,WE,TH,FR,SA,SU;BYHOUR=14;BYMINUTE=00" ],
"start_window_minutes" : 60
}
},
"status" : "available",
"effective_scope" : "o-dgit8w537q7np40f9i22j9ieotkuxbjq"
}
} 状态码
| 状态码 | 描述 |
|---|---|
| 200 | OK |
错误码
请参见错误码。