调用ListTagValues查询指定标签键对应的标签值。
本文将提供一个示例,在cn-hangzhou
地域,查询标签键k1
对应的标签值。返回结果显示:标签键k1
对应的标签值为v1
。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | ListTagValues |
要执行的操作。取值:ListTagValues。 |
RegionId | String | 是 | cn-hangzhou |
资源所属的地域ID。 |
Key | String | 是 | k1 |
标签键。 |
NextToken | String | 否 | caeba0bbb2be03f84eb48b699f0a**** |
下一个查询开始的Token。 |
PageSize | Integer | 否 | 50 |
分页时每页显示的标签值个数。 最大值:1000。默认值:50。 |
ResourceType | String | 否 | ALIYUN::ECS::INSTANCE |
资源类型。详情请参见支持标签API的资源类型。 |
关于公共请求参数的详情,请参见公共参数。
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
NextToken | String | caeba0bbb2be03f84eb48b699f0a**** |
下一个查询开始的Token。 如果NextToken为空,表示没有下一个。 |
RequestId | String | 8989CA7E-D2E0-4B6D-8282-311106E80150 |
请求ID。 |
Values | List | v1 |
标签值信息。 |
示例
请求示例
https://tag.aliyuncs.com/?Action=ListTagValues
&RegionId=cn-hangzhou
&Key=k1
&<公共请求参数>
正常返回示例
XML
格式
<ListTagValuesResponse>
<NextToken></NextToken>
<RequestId>8989CA7E-D2E0-4B6D-8282-311106E80150</RequestId>
<Values>
<Value>v1</Value>
</Values>
</ListTagValuesResponse>
JSON
格式
{
"NextToken": "",
"RequestId": "8989CA7E-D2E0-4B6D-8282-311106E80150",
"Values": {
"Value": [
"v1"
]
}
}
错误码
HttpCode | 错误码 | 错误信息 | 描述 |
---|---|---|---|
403 | Invalid.NextToken | The parameter NextToken is invalid. | NextToken参数非法。 |
404 | Missing.TagKey | Tag.N.Value has been specified and you must specify Tag.N.Key. | 一对键值对,对应的TagValue缺失相同N的TagKey。 |
404 | MissingParameter.TagKey | You must specify TagKey. | 标签键参数不可为空。 |
403 | NoPermission.Operator | The user is not authorized to operate on the specified resource. | 该用户没有权限操作。 |
403 | NoPermissionKey.Operator | You are not authorized to operate the tag key. | 该用户没有操作此标签键权限。 |
403 | InvalidParameter.ResourceType | The ResourceType parameter is invalid. | 资源类型参数非法。 |
403 | InvalidParameter.TagKey | The Tag.N.Key parameter is invalid. | 标签键参数非法。 |
访问错误中心查看更多错误码。
在文档使用中是否遇到以下问题
更多建议
匿名提交