设置用户属性组值

版本 4.0.23.4

按优先级顺序为一组组的用户属性定义值。

此函数为由用户群组定义的用户属性定义所有值。这是一项全局设置，可能会影响系统中的所有用户。此函数会替换指定用户属性的所有现有组值定义。

指定用户的用户属性的值按以下顺序搜索以下位置：

  1. 用户的帐号设置
  2. 用户所属的群组
  3. 用户属性的默认值（如果有）

用户可能是多个群组的成员，为该用户属性定义了不同的值。group_values 参数中的项顺序决定了该用户优先使用哪个组。数组索引最低。

指示组值的选择优先级的另一种方法是将数值分配给数组中每个组值对象的“rank”属性。最低“排名”值胜出。如果您使用此方法，必须为数组中的每个组值对象分配一个排名值。

如需为单个用户设置用户属性值，请参阅设置用户属性用户值。 如需为群组的所有成员设置用户属性值，请参阅设置用户属性组值。

请求

POST /user_attributes/{user_attribute_id}/group_values
数据类型
说明
请求
HTTP 请求
路径
HTTP 路径
展开 HTTPPath 定义...
user_attribute_id
字符串
用户属性的 ID
body
HTTP 正文
展开 HTTPBody 定义...
展开 UserAttributeGroupValue 定义...
可以
对象
当前用户可以对此对象执行的操作
id
字符串
此组-属性关系的唯一 ID
group_id
字符串
群组 ID
user_attribute_id
字符串
用户属性的 ID
值已隐藏
布尔值
如果值为 true，“值”字段将为 null，因为属性设置禁止访问此值
rank
整数
为用户解析价值的优先顺序
值
字符串
群组的用户属性值

响应

200：组值数组。

数据类型
说明
（数组）
可以
对象
当前用户可以对此对象执行的操作
id
字符串
此组-属性关系的唯一 ID
group_id
字符串
群组 ID
user_attribute_id
字符串
用户属性的 ID
值已隐藏
布尔值
如果值为 true，“值”字段将为 null，因为属性设置禁止访问此值
rank
整数
为用户解析价值的优先顺序
值
字符串
群组的用户属性值

400：错误请求

数据类型
说明
（对象）
消息
字符串
错误详情
文档网址
字符串
文档链接

404：未找到

数据类型
说明
（对象）
消息
字符串
错误详情
文档网址
字符串
文档链接

409：资源已存在

数据类型
说明
（对象）
消息
字符串
错误详情
文档网址
字符串
文档链接

422：验证错误

数据类型
说明
（对象）
消息
字符串
错误详情
展开 ValidationErrorDetail 定义...
字段
字符串
出错的字段
代码
字符串
错误代码
消息
字符串
错误信息消息
文档网址
字符串
文档链接
文档网址
字符串
文档链接

429：请求数过多

数据类型
说明
（对象）
消息
字符串
错误详情
文档网址
字符串
文档链接