调用ListTagResources按标签查询资源列表-表格存储-阿里云

获取标签资源列表。

调试

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

授权信息

当前API暂无授权信息透出。

请求语法

GET /v2/openapi/listtagresources HTTP/1.1

请求参数

名称	类型	必填	描述	示例值
MaxResults	integer	否	返回标签资源的最大个数，取值范围为 0~200。不设置此参数或者设置为 0 时，则默认值为 100。	20
ResourceType	string	否	资源类型。 instance：实例。	instance
ResourceIds	array	否	资源 ID 列表（即实例名称列表）。
	string	否	资源 ID（即实例名称）。	instance-test
Tags	array<object>	否	标签列表。
	object	否	标签。
Key	string	否	标签键。	Owner
Value	string	否	标签值。	Tester
NextToken	string	否	查询凭证（Token），取值为上一次 API 调用返回的 NextToken 参数值。从 NextToken 开始按字典序返回资源标签列表。第一次调用此接口时，设置为空。	CAESCG15aC1xxxxx

返回参数

名称	类型	描述	示例值
	object	返回结构体。
requestId	string	请求 ID，可用于排查和定位问题。	31D8120C-AC52-5CA9-BE4A-E4C6316E19AD
NextToken	string	当预期返回的标签资源总数大于设置的 MaxResults 时，将作为查询后续页的凭证。只有当资源标签未全部返回时，此参数才有值。	CAESCG15aC1xxxxx
MaxResults	integer	本次请求返回标签资源的最大个数。	20
TagResources	array<object>	标签列表。
TagResource	object	标签对象。
TagKey	string	标签键。	Owner
TagValue	string	标签值。	Tester
ResourceId	string	资源 ID（即实例名称）。	instance-test
ResourceType	string	资源类型。	ALIYUN::OTS::INSTANCE

示例

正常返回示例

JSON格式

{
  "requestId": "31D8120C-AC52-5CA9-BE4A-E4C6316E19AD",
  "NextToken": "CAESCG15aC1xxxxx",
  "MaxResults": 20,
  "TagResources": [
    {
      "TagKey": "Owner",
      "TagValue": "Tester",
      "ResourceId": "instance-test",
      "ResourceType": "ALIYUN::OTS::INSTANCE"
    }
  ]
}

错误码

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

变更历史

变更时间	变更内容概要	操作
2024-02-20	API 内部配置变更，不影响调用	查看变更详情