Querying Resource Tags

This API is used to obtain the resource tag list.

For details, see Calling APIs.

Each account has all the permissions required to call all APIs, but IAM users must be assigned the required permissions.

If you are using role/policy-based authorization, see Permissions Policies and Supported Actions for details on the required permissions.
If you are using identity policy-based authorization, the following identity policy-based permissions are required.
Action

Access Level

Resource Type (*: required)

Condition Key

Alias

Dependencies
asm:mesh:listTagsForResource

List

mesh *

g:EnterpriseProjectId

g:ResourceTag/<tag-key>

-

-

Action	Access Level	Resource Type (*: required)	Condition Key	Alias	Dependencies
asm:mesh:listTagsForResource	List	mesh *	g:EnterpriseProjectId g:ResourceTag/<tag-key>	-	-

GET /v2/{projectid}/{resourcetype}/{resourceid}/tags

**Table 1** Path Parameters
Parameter	Mandatory	Type	Description
projectid	Yes	String	Project ID
resourcetype	Yes	String	You need to specify asm-mesh, or the query cannot be performed.
resourceid	Yes	String	Mesh ID

**Table 2** Request header parameters
Parameter	Mandatory	Type	Description
X-Auth-Token	Yes	String	API calling can be authenticated using a token or AK/SK. If you use a token, this parameter is mandatory and must be set to the token.

Status code: 200

**Table 3** Response body parameters
Parameter	Type	Description
tags	Array of resource_tag objects	Tag list This field is mandatory when the tenant permission is used. For the op_service permission, choose either this field or sys_tags.
sys_tags	Array of resource_tag objects	System tag list Only used for system tags

**Table 4** resource_tag
Parameter	Type	Description
key	String	Key. It can contain a maximum of 128 characters. The key must comply with specifications described in 3.1 Character Set Specifications for Key.
value	String	Value. Each value can contain a maximum of 255 characters. The value must comply with specifications described in 3.2 Character Set Specifications for Value.

Status code: 400

**Table 5** Response body parameters
Parameter	Type	Description
errorCode	String	Error code

Status code: 404

**Table 6** Response body parameters
Parameter	Type	Description
errorCode	String	Error code

Status code: 500

**Table 7** Response body parameters
Parameter	Type	Description
errorCode	String	Error code

None

None

Status Code	Description
200	The resource tag list is obtained.
400	Failed to obtain the resource tag list due to incorrect parameters.
404	No resources were found.
500	Internal error.

Parent topic: Tag APIs

Thank you very much for your feedback. We will continue working to improve the documentation.See the reply and handling status in My Cloud VOC.

The system is busy. Please try again later.

For any further questions, feel free to contact us through the chatbot.