列出策略
功能介绍
列出组织中的所有策略。如果指定了资源ID,例如组织单元ID或账号ID,则将获得该资源已绑定的策略列表。此操作只能由组织的管理账号或作为服务委托管理员的成员账号调用。
URI
GET /v1/organizations/policies
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
attached_entity_id |
否 |
String |
根、组织单元或账号的唯一标识符(ID)。 最大长度:100 |
limit |
否 |
Integer |
页面中最大结果数量。 最小值:1 最大值:2000 缺省值:200 |
marker |
否 |
String |
分页标记。 最小长度:4 最大长度:400 |
请求参数
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
X-Security-Token |
否 |
String |
如果正在使用临时安全凭据,则此header是必需的,该值是临时安全凭据的安全令牌(会话令牌)。 最小值:1 |
X-Language |
否 |
String |
选择接口返回的信息的语言 枚举值:
|
响应参数
状态码: 200
参数 |
参数类型 |
描述 |
---|---|---|
policies |
Array of PolicySummaryDto objects |
组织中的策略列表。 |
page_info |
PageInfoDto object |
分页信息 |
参数 |
参数类型 |
描述 |
---|---|---|
is_builtin |
Boolean |
一个布尔值,指示指定的策略是否为系统策略。如果为true,即为系统策略,则可以将策略附加到根、组织单元或账号,但不能编辑它。 |
description |
String |
策略说明。 最大长度:512 |
id |
String |
策略的唯一标识符(ID)。 最小长度:1 最大长度:130 |
urn |
String |
策略的统一资源名称。 最小长度:1 最大长度:1500 |
name |
String |
策略的名称。 最小长度:1 最大长度:64 |
type |
String |
策略的类型,service_control_policy:服务控制策略;tag_policy:标签策略。 最小长度:1 最大长度:64 |
请求示例
列出策略
GET https://{hostname}/v1/organizations/policies
响应示例
状态码: 200
Successful.
{ "policies" : [ { "is_builtin" : true, "description" : "NFZ", "id" : "p-M5lVaiMgFXD6Hmq6o4dvqbGk", "urn" : "string", "name" : "9`P41WII9Yn]", "type" : "service_control_policy" } ], "page_info" : { "next_marker" : "ou-taowxgy4xbme6m4x3c2iijbxw7yj8fcw", "current_count" : 100 } }
状态码
状态码 |
描述 |
---|---|
200 |
Successful. |
错误码
请参见错误码。