Updated on 2024-04-16 GMT+08:00

Querying Tags of a DeH

Function

  • This API is used to query tags of a DeH.
  • Tag Management Service (TMS) uses this API to query all tags of a DeH.

URI

GET /v1.0/{project_id}/dedicated-host-tags/{dedicated_host_id}/tags

Table 1 describes the parameters.

Table 1 Parameters description

Parameter

Type

Mandatory

Description

project_id

String

Yes

Specifies the project ID.

dedicated_host_id

String

Yes

Specifies the DeH ID.

You can obtain the value from the DeH console or using the API in Querying DeHs.

Request

None

Response

Table 2 Response parameters

Parameter

Type

Description

tags

Array of objects

Specifies the list of tags.

For details, see Table 3.

Table 3 tag field description

Parameter

Type

Description

key

String

Specifies the tag key.

value

String

Specifies the tag value.

Example Request

Query the tags of the DeH 74259164-e63a-4ad9-9c77-a1bd2c9aa187.

GET https://{Endpoint}/v1.0/9c53a566cb3443ab910cf0daebca90c4/dedicated-host-tags/74259164-e63a-4ad9-9c77-a1bd2c9aa187/tags

Example Response

{
    "tags": [
        {
            "key": "key1", 
            "value": "value1"
        },
        {
            "key": "key2", 
            "value": "value2"
        }
    ]
}

Status Code

See Status Codes.