ListUserTags
更新时间 2026-05-25 17:48:03
最近更新时间: 2026-05-25 17:48:03
本节主要介绍ListUserTags。
此操作用来列出指定IAM用户的标签。
请求参数
| 名称 | 描述 | 是否必须 |
|---|---|---|
| Action | ListUserTags。 | 是 |
| Version | 请求版本。 取值 ：2010-05-08。默认值为2010-05-08。 |
否 |
| UserName | 查询用户的用户名。 类型 ：字符串 取值 ：1~64个字符组成，字符只能包含字母、数字或特殊字符，字母不区分大小写，特殊字符只能是：下划线（_）、中划线（-）、逗号（,）、句点（.）、加号（+）、等号（=）和at符号（@）。 |
是 |
| Marker | 分页标识。还有需要返回的标签时，上条响应结果中会返回该参数。查看未显示标签时，请求参数中需要携带此参数。 类型 ：字符串 取值 ：与上条响应中返回的结果值相同。 |
否 |
| MaxItems | 设置响应中最多返回的条数。如果存在超出您指定的返回项，则IsTruncated响应元素为true，表示需要再次发送请求查看未显示的项。查看未显示的项时，需要携带响应参数Marker的值。 类型 ：整型 取值 ：1~1000，默认值为100。 |
否 |
响应结果
名称 描述 IsTruncated 标签是否已经都返回：
true：有未返回的标签。
false：已经返回所有的标签。
Marker 分页标识。当IsTruncated是true时，该项存在，其值用于下一次请求的参数Marker的取值。 Tags.member.Key 标签键。 Tags.member.Value 标签值。
请求示例
列出IAM用户名为test的标签。
POST / HTTP/1.1
Authorization: signatureValue
x-amz-date: 20260518T055950Z
x-amz-content-sha256: UNSIGNED-PAYLOAD
Content-Type: application/octet-stream
Content-Length: 80
Host: oos-cn-iam.ctyunapi.cn
Action=ListUserTags&Version=2010-05-08&UserName=test&Marker=test_key1&MaxItems=3
响应示例
HTTP/1.1 200 OK
x-amz-request-id: 588bd769deb74aad
Content-Type: text/xml
Content-Length: 421
Date: Mon, 18 May 2026 05:59:50 GMT
Server: CTYUN
<ListUserTagsResponse>
<ListUserTagsResult>
<Tags>
<member>
<Key>test_key1</Key>
<Value>test_value1</Value>
</member>
<member>
<Key>test_key2</Key>
<Value>test_value2</Value>
</member>
<member>
<Key>test_key3</Key>
<Value>test_value3</Value>
</member>
</Tags>
<IsTruncated>true</IsTruncated>
<Marker>test_key4</Marker>
</ListUserTagsResult>
<ResponseMetadata>
<RequestId>588bd769deb74aad</RequestId>
</ResponseMetadata>
</ListUserTagsResponse>
