使用ListTagResources查询轻量资源已绑定的标签信息-轻量应用服务器-阿里云

调用ListTagResources查询一个或多个轻量资源（实例、快照、磁盘、镜像、命令、防火墙规则）已经绑定的标签信息。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用前面加 * 表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

swas-open:ListTagResources

list

*全部资源

*

无

请求参数

名称	类型	必填	描述	示例值
RegionId	string	是	地域 ID。	cn-hangzhou
ClientToken	string	否	保证请求幂等性。从您的客户端生成一个参数值，确保不同请求间该参数值唯一。ClientToken 只支持 ASCII 字符，且不能超过 64 个字符。更多信息，请参见如何保证幂等性。	123e4567-e89b-12d3-a456-426655440000
NextToken	string	否	下一个查询开始 Token。	AAAAAV3MpHK1AP0pfERHZN5pu6nOc1nj4M9UaAZ/I8db***
ResourceType	string	是	资源类型，取值范围： instance：实例。 snapshot：快照。 customimage：镜像。 command：命令。 firewallrule：防火墙规则。 disk：磁盘。	instance
ResourceId	array	否	资源 ID，最多 50 个资源 ID。
	string	否	轻量资源 ID。	s-bw526m1vi6x20c6g****
Tag	array<object>	否	标签列表，最多包含 20 个标签。
	object	否	资源所绑定的标签。
Key	string	否	轻量资源的标签键。标签键长度的取值范围：1~64。	TestKey
Value	string	否	轻量资源的标签值。标签值长度的取值范围：1~64。	TestValue

返回参数

名称	类型	描述	示例值
	object	返回结果。
NextToken	string	下一个查询开始 Token，NextToken 为空说明没有下一个。	AAAAAV3MpHK1AP0pfERHZN5pu6nOc1nj4M9UaAZ/I8db***
RequestId	string	请求 ID。	20758A-585D-4A41-A9B2-28DA8F4F534F
TagResources	object
TagResource	array<object>	由轻量资源及其标签组成的集合，包含了资源 ID、资源类型和标签键值等信息。
	object	轻量资源及其标签。
ResourceType	string	资源类型。可能值： instance：实例。 snapshot：快照。 customimage：自定义镜像。 command：命令。 firewallrule：防火墙规则。 disk：磁盘。	instance
TagValue	string	标签值。	TestValue
ResourceId	string	资源 ID。	s-bw526m1vi6x20c6g****
TagKey	string	标签键。	TestKey

示例

正常返回示例

JSON格式

{
  "NextToken": "AAAAAV3MpHK1AP0pfERHZN5pu6nOc1nj4M9UaAZ/I8db***",
  "RequestId": "20758A-585D-4A41-A9B2-28DA8F4F534F\t",
  "TagResources": {
    "TagResource": [
      {
        "ResourceType": "instance",
        "TagValue": "TestValue",
        "ResourceId": "s-bw526m1vi6x20c6g****\n",
        "TagKey": "TestKey"
      }
    ]
  }
}

错误码

访问错误中心查看更多错误码。

变更历史

更多信息，参考变更详情。