Querying Resource Tags¶

Function¶

You can use this API to query tags of a specific resource.

GET /v2.0/resources/{resource_id}/tags

**Table 1** Parameter description¶
Parameter	Mandatory	Type	Description
resource_id	Yes	String	Specifies the resource ID.

**Table 2** Query parameters¶
Parameter	Mandatory	Type	Description
project_id	No	String	Specifies the project ID. This parameter is mandatory for region-level resources.
resource_type	Yes	String	Specifies the resource type.

**Table 3** Header parameters¶
Parameter	Mandatory	Type	Description
X-Auth-Token	Yes	String	Specifies the user token. TMS is a global service. So you need to set scope to domain when calling an IAM API to obtain a user token. The value of X-Subject-Token in the response header is the user token.

Status code: 200

**Table 4** Body parameters¶
Parameter	Type	Description
tags	Array of TagVo objects	Specifies resource tags.

**Table 5** TagVo¶
Parameter	Type	Description
key	String	Specifies the key. It can contain up to 36 characters. The key cannot be empty. Only digits, letters, hyphens (-), at signs (@), and underscores (_) are allowed.
value	String	Specifies the value. Each value contains a maximum of 43 Unicode characters and can be an empty string. Only digits, letters, hyphens (-), at signs (@), and underscores (_) are allowed.

Querying tags of a resource

GET https://{Endpoint}/v2.0/resources/xxxx/tags?project_id=xxxx&resource_type=disk

Status code: 200

Successful operation

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

last updated: 2025-02-13 16:04 UTC - commit: ec1616a32d88242efd3e55ad5f07c909b7471752