You can call this operation to query tag values.

Debugging

Alibaba Cloud provides OpenAPI Explorer to simplify API usage. You can use OpenAPI Explorer to search for API operations, call API operations, and dynamically generate SDK sample code.

Request parameters

Parameter Type Required Example Description
Action String Yes DescribeTagValueList

The operation that you want to perform. Set the value to DescribeTagValueList.
TagKey String Yes tagKey1

The name of the tag key corresponding to the tag value that you want to query.
PageNumber Integer No 1

The number of the page to return.

Pages start from page 1. Default value: 1.
PageSize Integer No 10

The number of entries to return on each page.

Valid values: 1 to 100. Default value: 50.

Response parameters

Parameter Type Example Description
RequestId String B04B8CF3-4489-432D-83BA-6F128E4F2295

The ID of the request.
Message String success

The error message.

Note If the status code 200 is returned, no error occurs.
Code String 200

The HTTP status code.

Note A value of 200 indicates that the call is successful.
Success Boolean true

Indicates whether the call is successful. A value of true indicates that the call is successful. A value of false indicates that the call has failed.

TagValues List tagValue1

The list of the tag values returned.
TagValue

The tag value returned.

Examples

Sample requests


http(s)://[Endpoint]/? Action=DescribeTagValueList
&TagKey=tagKey1
&<Common request parameters>

Sample success responses

XML format 

<RequestId>9AF637BA-6617-41FE-A0FA-3301521377A4</RequestId>
<TagValues>
    <TagValue>tagValue1</TagValue>
    <TagValue>tagValue2</TagValue>
</TagValues>
<Success>true</Success>
<Code>200</Code>

JSON format 

{
	"RequestId":"9AF637BA-6617-41FE-A0FA-3301521377A4",
	"TagValues":{
		"TagValue":[
			"tagValue1",
			"tagValue2"
		]
	},
	"Success":true,
	"Code":200
}

Error codes

For a list of error codes, visit the API Error Center.