Queries the tag values of resources within the management account or a member of a resource directory by using the management account of the resource directory or a delegated administrator account of Resource Center.
Debugging
Authorization information
Request parameters
Parameter | Type | Required | Description | Example |
---|---|---|---|---|
Scope | string | No | The search scope. You can set the value to one of the following items:
| rd-r4**** |
MaxResults | integer | No | The maximum number of entries to return on each page. Valid values: 1 to 100. Default value: 20. | 10 |
NextToken | string | No | The pagination token that is used in the next request to retrieve a new page of results. If the total number of entries returned for the current request exceeds the value of the | eyJzZWFyY2hBZnRlcnMiOlsiMTAwMTU2Nzk4MTU1OSJd**** |
TagKey | string | Yes | The tag key. | test_key |
TagValue | string | No | The tag value. | test_value |
MatchType | string | No | The matching mode. Valid values:
| Equals |
Response parameters
Examples
Sample success responses
JSON
format
{
"NextToken": "eyJzZWFyY2hBZnRlcnMiOlsiMTAwMTU2Nzk4MTU1OSJd****",
"TagValues": [
"test_value"
],
"RequestId": "36A3D9BE-B607-5993-B546-7E19EF65DC00"
}
Error codes
HTTP status code | Error code | Error message | Description |
---|---|---|---|
400 | NoPermission | You are not authorized to perform this operation. | You are not authorized to perform the operation. |
400 | InvalidParameter.MaxResults | The specified parameter MaxResults is not valid. | The MaxResults parameter is invalid. |
400 | MultiAccountServiceNotEnabled | Multi account ResourceCenter service is not enabled. | The Resource Meta Center (RMC) service is not activated. |
404 | NotExists.ResourceDirectory | The resource directory for the account is not enabled. | No resource directory is enabled for the account. |
404 | NotExists.ResourceDirectory.FolderId | The specified folder does not exist. | The specified folder does not exist. |
409 | NoPermission.ResourceDirectory.MemberAccount | ResourceDirectory Member Account is not authorized to perform this operation. | You are not allowed to use a member of a resource directory to perform this operation. Use the management account of the resource directory to perform the operation. |
409 | InvalidParameter.Scope | The Scope is invalid. | The Scope parameter is invalid |
409 | InvalidParameter.MatchType | The specified parameter MatchType is not valid. | The MatchType parameter is invalid. |
For a list of error codes, visit the Service error codes.
Change history
Change time | Summary of changes | Operation | ||||||||
---|---|---|---|---|---|---|---|---|---|---|
2023-05-05 | The Error code has changed | see changesets | ||||||||
|