调用ListPolicies查询标签策略列表。
使用说明
单账号模式下,当前登录账号可以查询本账号下创建的全部标签策略列表。多账号模式下,资源目录管理账号可以查询整个资源目录下创建的全部标签策略列表。关于标签策略模式的更多信息,请参见标签策略模式。
本文将提供一个示例,在单账号模式下,查询当前登录账号的全部标签策略列表。返回结果显示,存在两条标签策略。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | ListPolicies |
要执行的操作。取值:ListPolicies。 |
RegionId | String | 否 | cn-shanghai |
地域ID。取值:cn-shanghai。 |
MaxResult | Integer | 否 | 50 |
分页时每页显示的数据条数。 默认值:50。最大值:1000。 |
NextToken | String | 否 | caeba0bbb2be03f84eb48b699f0a**** |
下一个查询开始的Token。 |
UserType | String | 否 | USER |
标签策略模式。用于查询的过滤条件。取值:
关于标签策略模式的更多信息,请参见标签策略模式。 说明 参数取值不区分大小写。
|
PolicyIds.N | String | 否 | p-557cb141331f41c7**** |
标签策略ID列表。用于查询的过滤条件。 |
PolicyNames.N | String | 否 | test |
标签策略名称列表。用于查询的过滤条件。 |
关于公共请求参数的详情,请参见公共参数。
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
RequestId | String | 72477CFF-5B24-5E30-9861-3DD9C4BD46E5 |
请求ID。 |
NextToken | String | caeba0bbb2be03f84eb48b699f0a**** |
根据
|
PolicyList | Array of Policy |
标签策略列表。 |
|
PolicyName | String | example |
标签策略名称。 |
PolicyDesc | String | This is a tag policy example. |
标签策略描述。 |
PolicyContent | String | {\"tags\":{\"CostCenter\":{\"tag_value\":{\"@@assign\":[\"Beijing\",\"Shanghai\"]},\"tag_key\":{\"@@assign\":\"CostCenter\"}}}} |
标签策略内容。 |
PolicyId | String | p-de62a0bf400e4b69**** |
标签策略ID。 |
UserType | String | USER |
标签策略模式。取值:
关于标签策略模式的更多信息,请参见标签策略模式。 |
示例
请求示例
https://tag.aliyuncs.com/?Action=ListPolicies
&RegionId=cn-shanghai
&<公共请求参数>
正常返回示例
XML
格式
HTTP/1.1 200 OK
Content-Type:application/xml
<ListPoliciesResponse>
<RequestId>72477CFF-5B24-5E30-9861-3DD9C4BD46E5</RequestId>
<PolicyList>
<PolicyDesc>This is a tag policy example.</PolicyDesc>
<PolicyName>example</PolicyName>
<UserType>USER</UserType>
<PolicyId>p-de62a0bf400e4b69****</PolicyId>
<PolicyContent>{"tags":{"CostCenter":{"tag_value":{"@@assign":["Beijing","Shanghai"]},"tag_key":{"@@assign":"CostCenter"}}}}</PolicyContent>
</PolicyList>
<PolicyList>
<PolicyDesc>This is a tag policy example.</PolicyDesc>
<PolicyName>test</PolicyName>
<UserType>USER</UserType>
<PolicyId>p-557cb141331f41c7****</PolicyId>
<PolicyContent>{"tags":{"k1":{"tag_value":{"@@assign":["v1"]},"tag_key":{"@@assign":"k1"}}}}</PolicyContent>
</PolicyList>
</ListPoliciesResponse>
JSON
格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"RequestId" : "72477CFF-5B24-5E30-9861-3DD9C4BD46E5",
"PolicyList" : [ {
"PolicyDesc" : "This is a tag policy example.",
"PolicyName" : "example",
"UserType" : "USER",
"PolicyId" : "p-de62a0bf400e4b69****",
"PolicyContent" : "{\"tags\":{\"CostCenter\":{\"tag_value\":{\"@@assign\":[\"Beijing\",\"Shanghai\"]},\"tag_key\":{\"@@assign\":\"CostCenter\"}}}}"
}, {
"PolicyDesc" : "This is a tag policy example.",
"PolicyName" : "test",
"UserType" : "USER",
"PolicyId" : "p-557cb141331f41c7****",
"PolicyContent" : "{\"tags\":{\"k1\":{\"tag_value\":{\"@@assign\":[\"v1\"]},\"tag_key\":{\"@@assign\":\"k1\"}}}}"
} ]
}
错误码
访问错误中心查看更多错误码。