1
0
forked from docs/doc-exports
doc-exports/docs/deh/api-ref/deh_05_0903.html
Hasko, Vladimir ba34ad4eaa initial import of DEH API
Reviewed-by: gtema <artem.goncharov@gmail.com>
Co-authored-by: Hasko, Vladimir <vladimir.hasko@t-systems.com>
Co-committed-by: Hasko, Vladimir <vladimir.hasko@t-systems.com>
2022-09-07 10:09:05 +00:00

8.4 KiB

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.

For details about how to obtain the project ID, see Obtaining Required Information.

dedicated_host_id

String

Yes

Specifies the DeH ID.

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

Request

  • Request parameters

    None

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

Response

  • Response parameters
    Table 2 Response parameters

    Parameter

    Type

    Description

    tags

    Array of objects

    Specifies the list of tags.

    Table 3 resource_tag field description

    Parameter

    Type

    Description

    key

    String

    Specifies the tag key.

    value

    String

    Specifies the tag value.

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

Status Code

See Status Codes.