列出绑定到指定资源的标签 - ListTagResources

功能介绍

列出绑定到指定资源的标签。当前支持为权限集添加标签。此操作只能由组织的管理账号或作为服务委托管理员的成员账号调用。

授权信息

账号根用户具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备如下身份策略权限，更多的权限说明请参见权限和授权项。

授权项	访问级别	资源类型（*为必须）	条件键	别名	依赖的授权项
IdentityCenter:tags:list	List	instance *	-	-	organizations:delegatedAdministrators:list
permissionSet *	g:ResourceTag/<tag-key>

授权项

访问级别

资源类型（*为必须）

条件键

别名

依赖的授权项

IdentityCenter:tags:list

List

instance *

organizations:delegatedAdministrators:list

permissionSet *

g:ResourceTag/<tag-key>

URI

GET /v1/instances/{resource_type}/{resource_id}/tags

表1 路径参数
参数	是否必选	参数类型	描述
resource_type	是	String	资源类型。枚举值： identitycenter:permissionset（权限集）
resource_id	是	String	权限集的唯一标识符（ID）。最大长度：130

表2 Query参数
参数	是否必选	参数类型	描述
limit	否	Integer	每个请求返回的最大结果数。最小值：1 最大值：100 缺省值：100
marker	否	String	分页标记。最小长度：24 最大长度：24

请求参数

表3 请求Header参数
参数	是否必选	参数类型	描述
X-Security-Token	否	String	如果正在使用临时安全凭据，则此header是必需的，该值是临时安全凭据的安全令牌（会话令牌）。最大长度：2048

响应参数

状态码： 200

表4 响应Body参数
参数	参数类型	描述
tags	Array of objects	标签列表。
page_info	Object	包含分页信息的对象。

表5 tags
参数	参数类型	描述
key	String	标签的键。最小长度：1 最大长度：128
value	String	标签的值，可以为空字符串，但不能为null。最小长度：0 最大长度：255

表6 page_info
参数	参数类型	描述
next_marker	String	如果存在，则表示可用的输出比当前响应中包含的输出多。在对操作的后续调用中，在标签请求参数中使用此值，以获取输出的下一部分。您应该重复此操作，直到next_marker响应元素返回为null。
current_count	Integer	本页返回条目数量。

请求示例

列出绑定到指定资源的标签。

GET https://{hostname}/v1/instances/{resource_type}/{resource_id}/tags

响应示例

状态码： 200

Successful.

{
  "tags" : [ {
    "key" : "auto09230Uv5key",
    "value" : "auto0923XXFmvalue"
  } ],
  "page_info" : {
    "next_marker" : "5f13d2346712e4890abc5678",
    "current_count" : 10
  }
}