全部产品
Search
文档中心

访问控制:ListTagResources - 查询云资源的标签列表

更新时间:Jul 31, 2025

查询云资源(RAM角色、权限策略)绑定的标签列表。

调试

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

授权信息

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

请求参数

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

资源类型。

枚举值:
  • roleRAM角色
  • policy权限策略
role
ResourceNamesarray

资源名称列表,一次最多支持输入 50 个资源名称。

string

资源名称。

role1
Tagarray<object>

标签列表。一次最多支持输入 20 个标签。

object

标签。

Keystring

标签键。最多支持 128 个字符。

t1
Valuestring

标签值。最多支持 256 个字符。

v1
PageSizeinteger

分页查询时设置的每页行数。取值范围:1~100。

100
NextTokenstring

下一页查询开始的 Token。

GY/oWREsOP1bPHGcHGrXfYX7UG1k9KqWFYThNDPx1UX26PbWOIu2CMqqiMr68H/K

返回参数

名称类型描述示例值
object

返回结果。

RequestIdstring

请求 ID。

5CCE804C-6450-49A7-B1DB-2460F7A97416
TagResourcesarray<object>

云资源绑定的标签列表。

TagResourcesobject

云资源绑定的标签。

ResourceNamestring

资源名称。

role1
ResourceTypestring

资源类型。

枚举值:
  • roleRAM角色
  • policy权限策略
role
TagKeystring

标签键。

t1
TagValuestring

标签值。

v1
NextTokenstring

下一页查询开始的 Token。

GY/oWREsOP1bPHGcHGrXfYX7UG1k9KqWFYThNDPx1UX26PbWOIu2CMqqiMr68H/K

示例

正常返回示例

JSON格式

{
  "RequestId": "5CCE804C-6450-49A7-B1DB-2460F7A97416",
  "TagResources": [
    {
      "ResourceName": "role1",
      "ResourceType": "role",
      "TagKey": "t1",
      "TagValue": "v1"
    }
  ],
  "NextToken": "GY/oWREsOP1bPHGcHGrXfYX7UG1k9KqWFYThNDPx1UX26PbWOIu2CMqqiMr68H/K"
}

错误码

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