• Cloud Server Backup Service

csbs
  1. Help Center
  2. Cloud Server Backup Service
  3. API Reference
  4. API Description
  5. Tag Management
  6. Querying the Project Tags of a Backup Policy

Querying the Project Tags of a Backup Policy

Function

This API is used to query a tenant's tag set in a specific region and of a specific instance type.

TMS uses this API to list tags created by a tenant to facilitate tag creation and resource filtering on the console.

URI

  • URI format

    GET /v1/{project_id}/csbs_backup_policy/tags

  • Request header

    Parameter

    Mandatory

    Type

    Description

    Content-type

    MIME type of the body in the request

    Yes

    application/json

    X-Auth-Token

    User token

    Yes

    -

  • Parameter description

    Parameter

    Mandatory

    Type

    Description

    project_id

    Yes

    String

    Project ID

Request

  • Element description

None

  • Example request
    GET /v1/{project_id}/csbs_backup_policy/tags

Response

  • Element description

    Parameter

    Type

    Description

    tags

    List<tag>

    Tag list

    Keys in the tag list must be unique.

  • Parameter description of field tag

    Parameter

    Type

    Description

    key

    String

    Tag key

    It consists of up to 36 characters.

    It cannot be an empty string.

    It can contain only letters, digits, hyphens (-), and underscores (_).

    values

    List<String>

    List of tag values

    It consists of up to 43 characters.

    It can be an empty string.

    It can contain only letters, digits, hyphens (-), and underscores (_).

  • Example response
    {
        "tags": [
        {
            "key": "key1",
            "values": [
                "value1",
                "value2"
            ]
        },
        {
            "key": "key2",
            "values": [
                "value1",
                "value2"
            ]
        }
        ]
    }

Status Codes

  • Normal

    Status Code

    Description

    200

    OK

  • Abnormal

    Status Code

    Description

    400

    Invalid parameters.

    401

    Authentication failed.

    403

    You do not have permission to perform this operation.

    404

    The requested resource was not found.

    500

    A system exception occurs.

Error Codes

For details, see Error Codes.