Querying Project Tags
Function
This API is used to query all tags of a resource type in a specified region.
Calling Method
For details, see Calling APIs.
URI
GET /v2/{project_id}/{resource_type}/tags
| Parameter | Mandatory | Type | Description |
|---|---|---|---|
| project_id | Yes | String | Specifies the project ID.For details about how to obtain the project ID, see Obtaining the Project ID. |
| resource_type | Yes | String | Specifies the resource type. The type can be the following: smn_topic: topic smn_sms: SMS smn_application: mobile push |
Request Parameters
| Parameter | Mandatory | Type | Description |
|---|---|---|---|
| X-Auth-Token | Yes | String | Specifies a user token. It can be obtained by calling an IAM API. The value of X-Subject-Token in the response header is the user token. |
Response Parameters
Status code: 200
| Parameter | Type | Description |
|---|---|---|
| tags | Array of ResourceTags objects | Specifies resource tags. |
| Parameter | Type | Description |
|---|---|---|
| key | String | Specifies the tag key.
|
| values | Array of strings | Specifies the tag values.
|
Status code: 400
| Parameter | Type | Description |
|---|---|---|
| request_id | String | Specifies the request ID, which is unique. |
| code | String | Specifies the error code. |
| message | String | Describes the error message. |
Status code: 403
| Parameter | Type | Description |
|---|---|---|
| request_id | String | Specifies the request ID, which is unique. |
| code | String | Specifies the error code. |
| message | String | Describes the error message. |
Status code: 404
| Parameter | Type | Description |
|---|---|---|
| request_id | String | Specifies the request ID, which is unique. |
| code | String | Specifies the error code. |
| message | String | Describes the error message. |
Status code: 500
| Parameter | Type | Description |
|---|---|---|
| request_id | String | Specifies the request ID, which is unique. |
| code | String | Specifies the error code. |
| message | String | Describes the error message. |
Example Requests
Querying project tags
GET https://{SMN_Endpoint}/v2/{project_id}/{resource_type}/tags
null Example Responses
Status code: 200
OK
{
"tags" : [ {
"key" : "key1",
"values" : [ "value1", "value2" ]
}, {
"key" : "key2",
"values" : [ "value1", "value2" ]
} ]
} Status Codes
| Status Code | Description |
|---|---|
| 200 | OK |
| 400 | Bad Request |
| 403 | Unauthorized |
| 404 | Not Found |
| 500 | Internal 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.