Querying Tags of All Transit Subnets in a Specified Project
Function
This API is used to query tags of all transit subnets of a tenant in a project.
TMS uses this API to list tags of all transit subnets, and provides tag association when users tag or filter transit subnets.
Calling Method
For details, see Calling APIs.
URI
GET /v3/{project_id}/transit-subnets/tags
Parameter |
Mandatory |
Type |
Description |
---|---|---|---|
project_id |
Yes |
String |
Specifies the project ID. |
Request Parameters
Parameter |
Mandatory |
Type |
Description |
---|---|---|---|
X-Auth-Token |
Yes |
String |
User token. It is a response to the API for obtaining a user token. This API is the only one that does not require authentication. The value of X-Subject-Token in the response header is the token value. |
Response Parameters
Status code: 200
Parameter |
Type |
Description |
---|---|---|
request_id |
String |
Specifies the request ID. |
tags |
Array of Tags objects |
Specifies the tags. |
Parameter |
Type |
Description |
---|---|---|
key |
String |
Specifies the tag key. A key can contain up to 128 Unicode characters. (The system does not verify key when searching for resources.) key cannot be left blank or be an empty string. key cannot contain spaces. Before using the value of key, delete spaces before and after the value. |
values |
Array of strings |
Specifies the list of tag values. Each value can contain a maximum of 255 Unicode characters and cannot contain spaces. Before verification and use, delete spaces before and after the value. The value can be an empty array but cannot be left blank. If values is not specified, any parameter value can be queried. All values of a tag key are in the OR relationship. The system verifies the length, but not the character set of values when searching for resources. |
Example Requests
GET https://{Endpoint}/v3/cfa563efb77d4b6d9960781d82530fd8/transit-subnets/tags
Example Responses
Status code: 200
Query operation succeeded.
{ "request_id" : "36479272a29de0be0a8a8b294c02ab7a", "tags" : [ { "key" : "keys", "values" : [ "value" ] }, { "key" : "key3", "values" : [ "value3" ] }, { "key" : "key1", "values" : [ "value1" ] }, { "key" : "key2", "values" : [ "value2" ] } ] }
Status Codes
Status Code |
Description |
---|---|
200 |
Query operation succeeded. |
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.See the reply and handling status in My Cloud VOC.
For any further questions, feel free to contact us through the chatbot.
Chatbot