Querying Resource Tags Recorded by the Resource Recorder
Function
Querying resource tags recorded by the resource recorder in the current account
Calling Method
For details, see Calling APIs.
URI
GET /v1/resource-manager/domains/{domain_id}/tracked-resources/tags
| Parameter | Mandatory | Type | Description |
|---|---|---|---|
| domain_id | Yes | String | Specifies the account ID. Maximum: 36 |
| Parameter | Mandatory | Type | Description |
|---|---|---|---|
| key | No | String | Specifies the name of the tag key. Maximum: 128 |
| marker | No | String | Specifies the pagination parameter. You can use the marker value in a subsequent call to request the next set of list items. Minimum: 4 Maximum: 400 |
| limit | No | Integer | Specifies the maximum number of resources to return. Minimum: 1 Maximum: 200 Default: 100 |
| resource_deleted | No | Boolean | Indicating whether deleted resources need to be returned. This parameter is set to false by default. Default: false |
Request Parameters
| Parameter | Mandatory | Type | Description |
|---|---|---|---|
| X-Auth-Token | No | String | Specifies the invoker's token. |
| X-Security-Token | No | String | Specifies a temporary security credential. This parameter is mandatory when you make an API call using a temporary security credential. |
Response Parameters
Status code: 200
| Parameter | Type | Description |
|---|---|---|
| tags | Array of TagEntity objects | Specifies tags. |
| page_info | PageInfo object | Specifies the pagination object. |
| Parameter | Type | Description |
|---|---|---|
| key | String | Specifies the tag key. |
| value | Array of strings | Specifies tag values. |
| Parameter | Type | Description |
|---|---|---|
| current_count | Integer | Specifies the resource quantity on the current page. Minimum: 0 Maximum: 200 |
| next_marker | String | Specifies the marker value of the next page. Minimum: 4 Maximum: 400 |
Status code: 400
| Parameter | Type | Description |
|---|---|---|
| error_code | String | Specifies the error code. |
| error_msg | String | Specifies the error message. |
Status code: 403
| Parameter | Type | Description |
|---|---|---|
| error_code | String | Specifies the error code. |
| error_msg | String | Specifies the error message. |
Status code: 500
| Parameter | Type | Description |
|---|---|---|
| error_code | String | Specifies the error code. |
| error_msg | String | Specifies the error message. |
Example Requests
Querying resource tags recorded by the resource recorder in the current account
GET https://{endpoint}/v1/resource-manager/domains/{domain_id}/tracked-resources/tags Example Responses
Status code: 200
Operation succeeded.
{
"tags" : [ {
"key" : "chloe",
"value" : [ "a", "b" ]
} ]
} Status Codes
| Status Code | Description |
|---|---|
| 200 | Operation succeeded. |
| 400 | Invalid parameter. |
| 403 | User authentication failed. |
| 500 | Server error. |
Error Codes
See Error Codes.
Feedback
Was this page helpful?
Provide feedbackThank you very much for your feedback. We will continue working to improve the documentation.