doc-exports/docs/ddm/api-ref/en-us_topic_0000002298949892.html

Querying Instance Tags (a V3 API)

Function

This API is used to query instance tags.

Constraints

None

URI

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

Table 1 Path parameters

Parameter	Mandatory	Type	Description
project_id	Yes	String	Project ID of a tenant in a region
instance_id	Yes	String	Instance ID

Request Parameters

Table 2 Request header parameters

Parameter	Mandatory	Type	Description
X-Auth-Token	Yes	String	User token. You can obtain the token by calling the IAM API used to obtain a user token.

Example Request

Querying instance tags

GET https://ddm.eu-de.otc.t-systems.com/v3/74f57817ca8f42e19318eb0e0ad41d18/instances/2f0324a93859487eb5566d75951fcd2din09/tags

Response

• Normal response

Table 3 Response body parameters

Parameter	Type	Description
tags	Array of QueryInstanceTagInfo objects	Tag list

Table 4 QueryInstanceTagInfo

Parameter	Type	Description
key	String	Tag key
value	String	Tag value

• Normal response example

{
  "tags": [
    {
      "key": "test",
      "value": "1"
    }
  ]
}

• Abnormal response

  For details, see Abnormal Request Results.

Status Codes

• Normal

  200

• Abnormal

  For details, see Status Codes.

Error Codes

For details, see Error Codes.

Parent topic: Tag Management