ListTagResources - 获取标签资源列表

获取标签资源列表。

调试

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

授权信息

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

请求语法

GET /v2/openapi/listtagresources HTTP/1.1

请求参数

名称类型必填描述示例值
MaxResultsinteger

返回标签资源的最大个数,取值范围为 0~200。不设置此参数或者设置为 0 时,则默认值为 100。

20
ResourceTypestring

资源类型。

instance:实例。

instance
ResourceIdsarray

资源 ID 列表(即实例名称列表)。

string

资源 ID(即实例名称)。

instance-test
Tagsarray<object>

标签列表。

object

标签。

Keystring

标签键。

Owner
Valuestring

标签值。

Tester
NextTokenstring

查询凭证(Token),取值为上一次 API 调用返回的 NextToken 参数值。从 NextToken 开始按字典序返回资源标签列表。第一次调用此接口时,设置为空。

CAESCG15aC1xxxxx

返回参数

名称类型描述示例值
object

返回结构体。

requestIdstring

请求 ID,可用于排查和定位问题。

31D8120C-AC52-5CA9-BE4A-E4C6316E19AD
NextTokenstring

当预期返回的标签资源总数大于设置的 MaxResults 时,将作为查询后续页的凭证。只有当资源标签未全部返回时,此参数才有值。

CAESCG15aC1xxxxx
MaxResultsinteger

本次请求返回标签资源的最大个数。

20
TagResourcesarray<object>

标签列表。

TagResourceobject

标签对象。

TagKeystring

标签键。

Owner
TagValuestring

标签值。

Tester
ResourceIdstring

资源 ID(即实例名称)。

instance-test
ResourceTypestring

资源类型。

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-20API 内部配置变更,不影响调用查看变更详情