Queries the mapping between applications and tags.
Try it now
Test
RAM authorization
|
Action |
Access level |
Resource type |
Condition key |
Dependent action |
|
sae:ListTagResources |
get |
*All Resource
|
None | None |
Request syntax
GET /tags HTTP/1.1
Request parameters
|
Parameter |
Type |
Required |
Description |
Example |
| RegionId |
string |
Yes |
The region ID. |
cn-beijing |
| ResourceType |
string |
Yes |
The resource type. Only |
application |
| NextToken |
string |
No |
The pagination token. A single query returns up to 50 results. If the total number of results exceeds 50, a NextToken is returned. You can use this token in the next query to retrieve the remaining results. |
A2RN |
| ResourceIds |
string |
No |
The resource IDs. You can specify multiple resource IDs separated by commas (,). This parameter is required if you do not specify the Tags parameter. |
["d42921c4-5433-4abd-8075-0e536f8b****"] |
| Tags |
string |
No |
The tag key-value pairs. This parameter is required if you do not specify the ResourceIds parameter.
Tag keys and values are case-sensitive. If you specify multiple tags, multiple tags are created and bound to the specified resource at the same time. A tag key on a resource can map to only one tag value. If you add a tag with an existing key, the tag value is updated to the new value. The key and value cannot start with |
[{"key":"k1","value":"v1"}] |
Response elements
|
Element |
Type |
Description |
Example |
|
object |
The response data. |
||
| RequestId |
string |
The request ID. |
7414187F-4F59-4585-9BCF-5F0804E4**** |
| Message |
string |
The additional information.
|
success |
| TraceId |
string |
The trace ID. You can use this ID to precisely query the call information. |
0bc5f84e15916043198032146d**** |
| Data |
object |
The returned data. |
|
| NextToken |
string |
The pagination token. A single query returns up to 50 results. If the total number of results exceeds 50, a NextToken is returned. You can use this token in the next query to retrieve the remaining results. |
"" |
| TagResources |
array<object> |
The mapping between applications and tags. |
|
|
object |
The returned data. |
||
| ResourceType |
string |
The resource type. Only |
ALIYUN::SAE::APPLICATION |
| TagValue |
string |
The tag value. |
v1 |
| ResourceId |
string |
The application ID. |
d42921c4-5433-4abd-8075-0e536f8b**** |
| TagKey |
string |
The tag key. |
k1 |
| ErrorCode |
string |
The error code.
|
InvalidParameter.Obviously |
| Code |
string |
The API status code or POP error code. Valid values:
|
200 |
| Success |
boolean |
Indicates whether the mapping between applications and tags was successfully queried. Valid values:
|
true |
Examples
Success response
JSON format
{
"RequestId": "7414187F-4F59-4585-9BCF-5F0804E4****",
"Message": "success",
"TraceId": "0bc5f84e15916043198032146d****",
"Data": {
"NextToken": "\"\"",
"TagResources": [
{
"ResourceType": "ALIYUN::SAE::APPLICATION",
"TagValue": "v1",
"ResourceId": "d42921c4-5433-4abd-8075-0e536f8b****",
"TagKey": "k1"
}
]
},
"ErrorCode": "InvalidParameter.Obviously",
"Code": "200",
"Success": true
}
Error codes
|
HTTP status code |
Error code |
Error message |
Description |
|---|---|---|---|
| 400 | InvalidParameter.Obviously | The specified parameter is invalid {%s}. | Invalid parameter {%s}. |
| 400 | InvalidResourceType.NotFound | The specified resource type is not supported. | The specified resource type is not supported. |
| 400 | NumberExceed.Tags | The specified parameter Tags count exceed. | The resource tags have reached the upper limit. |
| 400 | Invalid.Param.Tag.Scope | The specified parameter is invalid: tag scope. | The scope parameter is invalid. |
| 400 | No.Permission | The account has no permission. | The account does not have the operation permission. |
| 400 | NumberExceed.ResourceIds | The number of resource IDs cannot exceed 50. | The number of resource IDs cannot exceed 50. |
See Error Codes for a complete list.
Release notes
See Release Notes for a complete list.