获取用户标签值 - ListUserTagValue
功能介绍
获取用户标签值。
授权信息
账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限,具体权限要求请参见权限和授权项。
URI
GET /v1/{project_id}/tags/value
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
project_id | 是 | String | 参数解释: 项目ID。获取方法请参见获取项目ID。 约束限制: 不涉及 取值范围: 不涉及 默认取值: 不涉及 |
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
type | 是 | String | 参数解释: 标签类型,分为用户标签及用户组标签。 约束限制: 不涉及 取值范围:
默认取值: 不涉及 |
offset | 否 | Integer | 参数解释: 分页查询偏移量。 约束限制: 不涉及 取值范围: [0,1000] 默认取值: 0 |
limit | 否 | Integer | 参数解释: 返回条目数。 约束限制: 不涉及 取值范围: [1,1000] 默认取值: 10 |
请求参数
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
X-Auth-Token | 是 | String | 参数解释: 用户Token。通过调用IAM服务获取IAM用户Token接口获取,接口返回的响应消息头中“X-Subject-Token”就是需要获取的用户Token。 约束限制: 不涉及 取值范围: 不涉及 默认取值: 不涉及 |
响应参数
状态码:200
参数 | 参数类型 | 描述 |
|---|---|---|
count | Integer | 参数解释: 数据总量。 取值范围: 不涉及 |
page_data | Array of UserTagValueItemVO objects | 数据。 |
参数 | 参数类型 | 描述 |
|---|---|---|
user_id | String | 参数解释: 用户Id。 取值范围: 不涉及 |
account_name | String | 参数解释: 用户名。 取值范围: 不涉及 |
type | String | 参数解释: 标签类型。 取值范围:
|
tag_values | Map<String,Array<String>> | 参数解释: 用户标签值。 取值范围: 不涉及 |
tag_value_info | Map<String,UserTagValueVo> | 标签值信息。 |
参数 | 参数类型 | 描述 |
|---|---|---|
user_id | String | 参数解释: 用户或用户组ID。 取值范围: 不涉及 |
account_name | String | 参数解释: 用户或用户组名称。 取值范围: 不涉及 |
type | String | 参数解释: 标签类型。 取值范围:
|
from_type | String | 参数解释: 来源类型。 取值范围:
|
group_path | Array of strings | 参数解释: 用户组级别路径。 取值范围: 不涉及 |
create_date | Integer | 参数解释: 创建时间戳。 取值范围: 不涉及 |
update_date | Integer | 参数解释: 更新时间戳。 取值范围: 不涉及 |
value_type | String | 参数解释: 默认标签值类型。 取值范围:
|
value | Array of strings | 参数解释: 枚举值。 取值范围: 不涉及 |
请求示例
获取用户标签值。
GET https://{endpoint}/v1/{project_id}/tags?type=user 响应示例
无
状态码
状态码 | 描述 |
|---|---|
200 | 用户标签列表。 |
错误码
请参见错误码。

