Queries the tags that are added to resources in a template or stack in an Alibaba Cloud region.
Operation description
- To specify the query object, specify ResourceId or Tag in the request. Tag consists of Key and Value.
- If you specify Tag and ResourceId, ROS resources that match both the parameters are returned.
This topic provides an example on how to query the tags that are added to a stack. In this example, the stack ID is 6bc589b5-9c02-4944-8fc3-f3624234****
. The stack is deployed in the China (Hangzhou) region.
Debugging
Authorization information
Request parameters
Parameter | Type | Required | Description | Example |
---|---|---|---|---|
RegionId | string | Yes | The region ID of the tag. You can call the DescribeRegions operation to query the most recent region list. | cn-hangzhou |
ResourceType | string | Yes | The type of the resource. Valid values:
| stack |
NextToken | string | No | The pagination token that is used in the next request to retrieve a new page of results. | caeba0bbb2be03f84eb48b699f0***** |
ResourceId | array | No | The IDs of the resources. | |
string | No | The ID of the resource. You can specify up to 50 resource IDs. Note
If you set ResourceType to stackgroup, you must set ResourceId to the name of the stack group.
| 6bc589b5-9c02-4944-8fc3-f3624234**** | |
Tag | array<object> | No | The tags of the resources. You can specify up to 20 tags. | |
object | No | The tag of the resource. | ||
Key | string | No | The tag key of the resource. You can specify up to 20 tag keys. The tag key cannot be an empty string. | FinanceDept |
Value | string | No | The tag value of the resource. You can specify up to 20 tag values. The tag value can be an empty string. | FinanceJoshua |
For more information about common request parameters, see Common parameters.
Response parameters
Examples
Sample success responses
JSON
format
{
"NextToken": "caeba0bbb2be03f84eb48b699f0*****",
"RequestId": "C429473A-5C66-4661-B5F8-4F900CD4330A",
"TagResources": [
{
"ResourceType": "stack",
"TagValue": "TayValue1",
"ResourceId": "c754d2a4-28f1-46df-b557-9586173a****",
"TagKey": "TagKey1"
}
]
}
Error codes
For a list of error codes, visit the Service error codes.
Change history
Change time | Summary of changes | Operation |
---|