调用ListControlPolicies查询管控策略列表。
本文将提供一个示例,查询资源目录内的系统管控策略列表。返回结果显示,该资源目录内只有一条名为FullAliyunAccess
的系统管控策略。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | ListControlPolicies | 要执行的操作。取值:ListControlPolicies。 |
PolicyType | String | 否 | System | 管控策略类型。取值:
|
PageNumber | Integer | 否 | 1 | 页码。 起始值:1。默认值:1。 |
PageSize | Integer | 否 | 10 | 分页时每页显示的数据条数。 取值范围:1~100。默认值:10。 |
Language | String | 否 | zh-CN | 指定返回结果中管控策略描述的语言。取值:
说明 该参数仅在系统管控策略时有效。 |
关于公共请求参数的详情,请参见公共参数。
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
TotalCount | Integer | 1 | 管控策略数量。 |
RequestId | String | 9424A34C-3471-45AD-B6AB-924BBDFE42F9 | 请求ID。 |
PageSize | Integer | 10 | 分页时每页显示的数据条数。 |
PageNumber | Integer | 1 | 页码。 |
ControlPolicies | Array of ControlPolicy | 管控策略列表。 |
|
ControlPolicy | |||
UpdateDate | String | 2020-08-05T06:32:24Z | 管控策略更新时间。 |
Description | String | 支持阿里云所有操作的系统管控策略 | 管控策略描述。 |
EffectScope | String | All | 管控策略生效范围。取值:
|
AttachmentCount | String | 44 | 管控策略被引用的次数。 |
PolicyName | String | FullAliyunAccess | 管控策略名称。 |
PolicyId | String | cp-FullAliyunAccess | 管控策略ID。 |
CreateDate | String | 2020-08-05T06:32:24Z | 管控策略创建时间。 |
PolicyType | String | System | 管控策略类型。取值:
|
示例
请求示例
https://resourcemanager.aliyuncs.com/?Action=ListControlPolicies
&PolicyType=System
&<公共请求参数>
正常返回示例
XML
格式
HTTP/1.1 200 OK
Content-Type:application/xml
<?xml version="1.0" encoding="UTF-8" ?>
<ListControlPoliciesResponse>
<TotalCount>1</TotalCount>
<RequestId>9424A34C-3471-45AD-B6AB-924BBDFE42F9</RequestId>
<PageSize>10</PageSize>
<PageNumber>1</PageNumber>
<ControlPolicies>
<ControlPolicy>
<PolicyType>System</PolicyType>
<UpdateDate>2020-08-05T06:32:24Z</UpdateDate>
<Description>支持阿里云所有操作的系统管控策略</Description>
<AttachmentCount>44</AttachmentCount>
<PolicyName>FullAliyunAccess</PolicyName>
<CreateDate>2020-08-05T06:32:24Z</CreateDate>
<PolicyId>cp-FullAliyunAccess</PolicyId>
<EffectScope>All</EffectScope>
</ControlPolicy>
</ControlPolicies>
</ListControlPoliciesResponse>
JSON
格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"TotalCount" : 1,
"RequestId" : "9424A34C-3471-45AD-B6AB-924BBDFE42F9",
"PageSize" : 10,
"PageNumber" : 1,
"ControlPolicies" : {
"ControlPolicy" : [ {
"PolicyType" : "System",
"UpdateDate" : "2020-08-05T06:32:24Z",
"Description" : "支持阿里云所有操作的系统管控策略",
"AttachmentCount" : 44,
"PolicyName" : "FullAliyunAccess",
"CreateDate" : "2020-08-05T06:32:24Z",
"PolicyId" : "cp-FullAliyunAccess",
"EffectScope" : "All"
} ]
}
}
错误码
访问错误中心查看更多错误码。