调用DescribeTagValueList接口查询指定标签键对应的标签值列表。
本文将提供一个示例,查询标签键tagKey1对应的标签值列表,返回结果显示标签值为tagValue1和tagValue2。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
| 名称 | 类型 | 是否必选 | 示例值 | 描述 |
|---|---|---|---|---|
| Action | String | 是 | DescribeTagValueList |
要执行的操作,取值:DescribeTagValueList。 |
| TagKey | String | 是 | tagKey1 |
标签键。 关于如何获取标签键,请参见DescribeTagKeyList。 |
| PageNumber | Integer | 否 | 1 |
页码。 起始值:1,默认值:1。 |
| PageSize | Integer | 否 | 10 |
分页时每页显示的数据行数。 取值范围:1~100。起始值:1。默认值:50。 |
关于公共请求参数的详情,请参见公共参数。
返回数据
| 名称 | 类型 | 示例值 | 描述 |
|---|---|---|---|
| RequestId | String | B04B8CF3-4489-432D-83BA-6F128E4F2295 |
请求ID。 |
| Message | String | The specified resource is not found. |
错误信息。 |
| Code | String | 200 |
状态码。 说明 200表示成功。
|
| Success | Boolean | true |
操作是否成功。取值:
|
| TagValues | List | ["tagValue1", "tagValue2"] |
标签值列表。 |
示例
请求示例
http(s)://[Endpoint]/?Action=DescribeTagValueList
&TagKey=tagKey1
&<公共请求参数>
正常返回示例
XML格式
<DescribeTagValueListResponse>
<RequestId>9AF637BA-6617-41FE-A0FA-3301521377A4</RequestId>
<TagValues>
<TagValue>tagValue1</TagValue>
<TagValue>tagValue2</TagValue>
</TagValues>
<Success>true</Success>
<Code>200</Code>
</DescribeTagValueListResponse>
JSON格式
{
"RequestId": "9AF637BA-6617-41FE-A0FA-3301521377A4",
"TagValues": {
"TagValue": [
"tagValue1",
"tagValue2"
]
},
"Success": true,
"Code": 200
}
错误码
| HttpCode | 错误码 | 错误信息 | 描述 |
|---|---|---|---|
| 404 | ResourceNotFound | The specified resource is not found. | 未找到指定资源。 |
访问错误中心查看更多错误码。