Querying Tags in a Specified Project
Description
This API is used to query all tags of instances in a specified project.
URI
| Name | Type | IN | Mandatory | Description |
|---|---|---|---|---|
| X-Auth-Token | string | header | Yes | Definition User token obtained from IAM. For details, see Authentication. Constraints N/A Range N/A Default Value N/A |
| project_id | string | path | Yes | Definition Project ID of a tenant in a region. To obtain the project ID, see Obtaining a Project ID. Constraints N/A Range N/A Default Value N/A |
Request Parameters
None
Response Parameters
- Parameter description
Table 2 Parameter description Name
Mandatory
Type
Description
tags
Yes
Array of objects
The tag list. For more information, see Table 3.
Table 3 tags field data structure description Name
Mandatory
Type
Description
key
Yes
String
The tag key.
- The key cannot be empty and contains 1 to 128 single-byte characters.
- The key can contain UTF-8 letters (including Chinese characters), digits, spaces, and the following characters: _.:/=+-@
- Do not enter labels starting with _sys_, which are system labels.
Character set: 0-9, A-Z, a-z, "_", and "-".
values
Yes
Array of strings
Lists the tag values.
- The value can contain UTF-8 letters (including Chinese characters), digits, spaces, and the following characters: _.:/=+-@
- The value can be empty or null and contains 0 to 255 single-byte characters.
Character set: 0-9, A-Z, a-z, "_", and "-".
- Example Responses
{ "tags": [ { "key": "key1", "values": [ "value1", "value2" ] }, { "key": "key2", "values": [ "value1", "value2" ] } ] }
Status Code
For more information, see Status Code.
Error Code
For more information, see Error Code.