ListTagResources - 查询标签列表

查询一个或多个EAIS资源已经绑定的标签列表。

接口说明

请求中至少指定以下任一参数,以确定查询对象。

  • ResourceId.N
  • Tag.N(Tag.N.Key 与 Tag.N.Value)

同时指定 Tag.N 和 ResourceId.N 参数时,返回结果中仅包含同时满足这两个条件的 EAIS 资源。

调试

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

授权信息

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

请求参数

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

资源所属的地域 ID。您可以调用 DescribeRegions 查看最新的阿里云地域列表。

cn-hangzhou
NextTokenstring

下一个查询开始 Token。

caeba0bbb2be03f84eb48b699f0a4884
ResourceTypestring

资源类型定义。目前取值仅支持instance

instance
ResourceIdarray

资源 ID,最多 50 个子项。

string

资源 ID。

eais-hzs4h26yyt5xkcke****
Tagarray<object>

标签列表,最多包含 20 个子项。

object

标签对象。

Keystring

标签键。限制:

  • 不能为空。
  • 最多支持 128 个字符。
  • 不能以 aliyun 或 acs:开头。
  • 不能包含 http://和 https://。
TestKey
Valuestring

标签值。限制:

  • 最多支持 128 个字符。
  • 不能以 aliyun 或 acs:开头。
  • 不能包含 http://和 https://。
TestValue

返回参数

名称类型描述示例值
object

Schema of Response

RequestIdstring

请求 ID。

F23AEEC7-4D98-4657-A104-02692701****
NextTokenstring

下一个查询开始 Token。NextToken 为空说明为最后一个。

caeba0bbb2be03f84eb48b699f0a4885
TagResourcesarray<object>

由资源及其标签组成的集合,包含了资源 ID、资源类型和标签键值等信息。

TagResourceobject

资源及标签信息对象。

TagKeystring

标签键。

TestKey
TagValuestring

标签值。

TestValue
ResourceIdstring

资源 ID。

eais-hzs4h26yyt5xkcke****
ResourceTypestring

资源类型。

instance

示例

正常返回示例

JSON格式

{
  "RequestId": "F23AEEC7-4D98-4657-A104-02692701****",
  "NextToken": "caeba0bbb2be03f84eb48b699f0a4885",
  "TagResources": [
    {
      "TagKey": "TestKey",
      "TagValue": "TestValue",
      "ResourceId": "eais-hzs4h26yyt5xkcke****",
      "ResourceType": "instance"
    }
  ]
}

错误码

HTTP status code错误码错误信息描述
400MissingParameter.ResourceIdOrTagEither ResourceId or Tag must be specified.ResourceId和Tag至少有一个必填。
400InvalidNextTokenThe NextToken is invalid.NextToken参数非法。
400NumberExceed.ResourceIdsThe maximum number of ResourceIds is exceeded. The maximum is 50.传入的资源ID数量达到上限,最多支持50个。
400MissingParameter.ResourceIdsYou must specify ResourceIds.ResourceId不能为空。
400Duplicate.ResourceIdThe request contains duplicated ResourceId.ResourceId不能重复。
400NumberExceed.TagsThe maximum number of Tags is exceeded. The maximum is 20.传入的Tag数量达到上限,最多支持20个。
400Duplicate.TagKeyThe Tag.N.Key contains a duplicated key.传入的TagKey重复。
400InvalidResourceId.NotFoundThe ResourceId does not exist.ResourceId不存在。
400InvalidParameter.TagKeyThe specified Tag.n.Key is invalid.TagKey为非法值。
400InvalidParameter.TagValueThe specified Tag.n.Value is invalid.TagValue为非法值。

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