全部产品
Search

搜索本产品

    边缘节点服务ENS：ListTagResources - 查询资源已经绑定的标签列表

    文档中心

    边缘节点服务ENS：ListTagResources - 查询资源已经绑定的标签列表

    更新时间：Oct 09, 2026

    查询一个或多个ENS资源（目前只支持实例资源）已经绑定的标签列表。

    调试

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

    调试

    授权信息

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

    • 操作：是指具体的权限点。

    • 访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。

    • 资源类型：是指操作中支持授权的资源类型。具体说明如下：

      • 对于必选的资源类型，用前面加 * 表示。

      • 对于不支持资源级授权的操作，用全部资源表示。

    • 条件关键字：是指云产品自身定义的条件关键字。

    • 关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

    操作

    访问级别

    资源类型

    条件关键字

    关联操作

    ens:ListTagResources

    list

    *全部资源

    *

    		 无 无

    请求参数

    名称

    类型

    必填

    描述

    示例值
    ResourceType

    string

    是

    资源类型定义。取值：instance（实例）

    枚举值：

    • vswitch :

      交换机

    • armserver :

      ARM 服务器

    • disk :

      磁盘

    • instance :

      ENS 实例

    • natgateway :

      NAT 网关

    • eip :

      弹性公网 IP

    • network :

      网络

    instance
    ResourceId

    array

    否

    资源 ID，n 的取值范围为 [1, 50]

    ResourceId 与 Tag 至少须指定一个，否则服务返回 MissingParameter.ResourceIdsOrTags。

    string

    否

    资源 ID。

    i-t252vwg7cib00ky8g0q
    NextToken

    string

    否

    下一个查询开始的 Token。

    153ba0bbb2be03f84eb48b699f0a4123
    Tag

    array<object>

    否

    标签列表。

    ResourceId 与 Tag 至少须指定一个，否则服务返回 MissingParameter.ResourceIdsOrTags。

    object

    否

    资源的标签。

    Key

    string

    否

    实例的标签键。N 的取值范围为 1~20。

    • 不能以aliyun、acs:、http://或https://开头。

    • 最多支持 64 个字符。

    • 不允许传入空字符串。

    team
    Value

    string

    否

    Topic 的标签值。Key 和 Value 值必须同时输入或同时不输入。若同时输入表示根据 Tag 过滤符合条件的 Topic，若不输入表示查询所有 Topic。

    • N 的取值范围为 1~20。

    • 如果输入该值，取值允许为空字符串。

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

    tagValue

    返回参数

    名称

    类型

    描述

    示例值

    object

    Schema of Response

    RequestId

    string

    唯一请求 ID。

    C78D9B61-69D8-5655-A312-A15DA5EA5D5E
    TagResources

    array<object>

    标签资源集合

    object

    资源的标签列表。

    ResourceId

    string

    关联资源的 ID。

    i-5zy93g7z1hnkdmav84joxyzgn
    ResourceType

    string

    资源类型。

    instance
    TagKey

    string

    实例的标签键。

    test_tag_key-2
    TagValue

    string

    标签值。

    CLUSTER
    NextToken

    string

    下一个查询开始的 Token。

    abcfeg368547ccdef

    示例

    正常返回示例

    JSON格式

    {
  "RequestId": "C78D9B61-69D8-5655-A312-A15DA5EA5D5E",
  "TagResources": [
    {
      "ResourceId": "i-5zy93g7z1hnkdmav84joxyzgn",
      "ResourceType": "instance",
      "TagKey": "test_tag_key-2",
      "TagValue": "CLUSTER"
    }
  ],
  "NextToken": "abcfeg368547ccdef"
}

    错误码

    HTTP status code

    错误码

    错误信息

    描述
    400 CallInterface Call Interface Happen Error. 接口调用出错。
    400 NoPermission Permission denied.
    400 InvalidParameter.%s The specified field %s invalid. Please check it again.
    403 NoPermission The operator is not permission for this operate

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

    变更历史

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