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.

Authorization

Your account has all of the permissions required to call all APIs, but IAM users must have the required permissions specifically assigned. For the specific permissions required, see Permissions and Supported Actions.

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"
        }
    ]
}