调用ListTagValues查询指定标签键对应的标签值。
使用说明
本文将提供一个示例,查询标签键k1对应的标签值。返回结果显示:标签键k1对应的标签值为v1。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | ListTagValues | 要执行的操作。取值:ListTagValues。 |
NextToken | String | 否 | TGlzdFJlc291cm**** | 下一个查询开始的Token。 |
MaxResults | Integer | 否 | 10 | 单次请求返回结果的最大条数。 取值范围:1~100。默认值:10。 |
ResourceType | String | 是 | Account | 资源类型。 取值:Account,表示资源目录的成员。 |
TagKey | String | 是 | k1 | 标签键,用于查询的过滤条件。 |
ValueFilter | String | 否 | v1 | 模糊查询的标签值。 |
关于公共请求参数的详情,请参见公共参数。
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
NextToken | String | TGlzdFJlc291cm**** | 根据NextToken判断是否具备下一个查询开始的Token。取值:
|
RequestId | String | DC09A6AA-2713-4E10-A2E9-E6C5C43A8842 | 请求ID。 |
Tags | Array of Tag | 标签值信息。 |
|
Value | String | v1 | 标签值。 |
示例
请求示例
https://resourcemanager.aliyuncs.com/?Action=ListTagValues
&ResourceType=Account
&TagKey=k1
&<公共请求参数>
正常返回示例
XML
格式
HTTP/1.1 200 OK
Content-Type:application/xml
<ListTagValuesResponse>
<NextToken>TGlzdFJlc291cm****</NextToken>
<RequestId>DC09A6AA-2713-4E10-A2E9-E6C5C43A8842</RequestId>
<Tags>
<Value>v1</Value>
</Tags>
</ListTagValuesResponse>
JSON
格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"NextToken" : "TGlzdFJlc291cm****",
"RequestId" : "DC09A6AA-2713-4E10-A2E9-E6C5C43A8842",
"Tags" : [ {
"Value" : "v1"
} ]
}
错误码
访问错误中心查看更多错误码。