• Key Management Service

kms
  1. Help Center
  2. Key Management Service
  3. API Reference
  4. APIs
  5. Querying Project Tags

Querying Project Tags

Function

This API enables you to query all tag sets of a specified project.

URI

  • URI format

    GET /v1.0/{project_id}/kms/tags

  • Parameter description

    Parameter

    Type

    Mandatory

    Description

    project_id

    string

    Yes

    Project ID

Requests

Request parameters

None

Responses

Response parameters

Parameter

Type

Mandatory

Description

tags

JSONArray

Yes

list of tags, including tag keys and tag values.
  • key indicates the tag key. a CMK can have a maximum of 10 keys, and each of them is unique and cannot be empty. A key cannot have duplicate values. The value of key contains a maximum of 36 characters.
  • value indicates the tag value. Each tag value can contain a maximum of 43 characters. The relationship between values is AND.

Examples

The following example describes how to query project tags.

  • Example request

    None

  • Example response
    {            "tags": [
                 { 
                   "key": "key1",
                   "values": [
                       "value1",
                       "value2"
                     ]
                  },
                 {
                   "key": "key2",
                   "values": [
                       "value1",
                       "value2"
                    ]
            }
    ]
    }
    or
    {    
           "error": {        
                  "error_code": "KMS.XXXX",        
                  "error_msg": "XXX"     
         } 
    }

Status Codes

Table 1 lists the normal status code returned by the response.
Table 1 Status codes

Status Code

Status

Description

200

OK

Request processed successfully.

Exception status code. For details, see Status Codes.