Updated on 2024-06-07 GMT+08:00

Querying Tags of a DB Instance

Function

This API is used to query tags of a DB instance.

  • Before calling an API, you need to understand the API in Authentication.

URI

  • URI format

    GET /v3/{project_id}/instances/{instance_id}/tags

  • Parameter description
    Table 1 Parameters

    Parameter

    Mandatory

    Description

    project_id

    Yes

    Project ID of a tenant in a region.

    To obtain it, refer to Obtaining a Project ID.

    instance_id

    Yes

    Instance ID.

Request

  • Request parameters

    None

  • URI example

    GET https://rds.ap-southeast-1.myhuaweicloud.com/v3/0483b6b16e954cb88930a360d2c4e663/instances/ab67f50938cb4d189cc2163ca0098fe7in03/tags

Response

  • Normal response
    Table 2 Parameters

    Parameter

    Type

    Description

    tags

    Array of objects

    Tag list. If there is no tag added for the instance, an empty array is returned.

    For details, see Table 3.

    Table 3 tags field data structure description

    Parameter

    Type

    Description

    key

    String

    Tag key.

    value

    String

    Tag value.

    tag_type

    String

    Tag type.

    Enumerated values: user and system

  • Example normal response
    {
         "tags": [{
            "key": "keyName",
            "value": "keyValue",
            "tag_type": "user"
            }]
    }
  • Abnormal response

    For details, see Abnormal Request Results.

Status Code

Error Code

For details, see Error Codes.