用户组

控制用户与群组的成员关系映射，根据组织群组来调节用户的可见性和访问权限

---

查询用户的群组列表

GET

/api/v1/user/{id}/group

授权

UserHttpBearer

使用现有不透明令牌进行身份验证

类型HTTP (bearer)

参数

路径参数

id*

用户ID

类型integer

必填

格式"int64"

查询参数

groupId

类型integer

格式"int64"

groupName

类型string

createdBy

类型integer

格式"int64"

createdDate

类型string

格式"date-time"

pageNo

页面数据大小，默认为1，最大值为100000

类型integer

格式"int32"

最大值100000

最小值1

pageSize

页面数据大小，默认为10，最大值为2000

类型integer

格式"int32"

最大值2000

最小值1

orderBy

排序字段

类型string

orderSort

排序方法

类型string

有效值

"ASC""DESC"

filters[0].key

筛选字段名称

类型string

filters[0].op

筛选条件（等于、不等于、大于等）

类型string

有效值

"GREATER_THAN""LESS_THAN""GREATER_THAN_EQUAL""LESS_THAN_EQUAL""EQUAL""NOT_EQUAL""MATCH""MATCH_END""NOT_MATCH""NOT_MATCH_END""IN""NOT_IN""IS_NULL""IS_NOT_NULL"

filters[0].value

筛选值

类型object

filters[1].key

筛选字段名称

类型string

filters[1].op

筛选条件（等于、不等于、大于等）

类型string

有效值

"GREATER_THAN""LESS_THAN""GREATER_THAN_EQUAL""LESS_THAN_EQUAL""EQUAL""NOT_EQUAL""MATCH""MATCH_END""NOT_MATCH""NOT_MATCH_END""IN""NOT_IN""IS_NULL""IS_NOT_NULL"

filters[1].value

筛选值

类型object

filters[2].key

筛选字段名称

类型string

filters[2].op

筛选条件（等于、不等于、大于等）

类型string

有效值

"GREATER_THAN""LESS_THAN""GREATER_THAN_EQUAL""LESS_THAN_EQUAL""EQUAL""NOT_EQUAL""MATCH""MATCH_END""NOT_MATCH""NOT_MATCH_END""IN""NOT_IN""IS_NULL""IS_NOT_NULL"

filters[2].value

筛选值

类型object

infoScope

查询信息范围

类型string

有效值

"BASIC""DETAIL"

响应

成功

Content-Type

*/*

"string"

GET

/api/v1/user/{id}/group

试验场

授权

UserHttpBearer

变量

键

值

id*

groupId

groupName

createdBy

createdDate

pageNo

pageSize

orderBy

orderSort

filters[0].key

filters[0].op

filters[0].value

filters[1].key

filters[1].op

filters[1].value

filters[2].key

filters[2].op

filters[2].value

infoScope

示例

cURL

JavaScript

PHP

Python

---

替换用户的群组

PUT

/api/v1/user/{id}/group

授权

UserHttpBearer

使用现有不透明令牌进行身份验证

类型HTTP (bearer)

参数

路径参数

id*

用户ID

类型integer

必填

格式"int64"

请求体

application/json

[

0

]

响应

成功

Content-Type

*/*

"string"

PUT

/api/v1/user/{id}/group

试验场

授权

UserHttpBearer

变量

键

值

id*

主体

示例

cURL

JavaScript

PHP

Python

---

将用户添加到群组

POST

/api/v1/user/{id}/group

授权

UserHttpBearer

使用现有不透明令牌进行身份验证

类型HTTP (bearer)

参数

路径参数

id*

用户ID

类型integer

必填

格式"int64"

请求体

application/json

[

0

]

响应

成功

Content-Type

*/*

"string"

POST

/api/v1/user/{id}/group

试验场

授权

UserHttpBearer

变量

键

值

id*

主体

示例

cURL

JavaScript

PHP

Python

---

将用户从群组中移除

DELETE

/api/v1/user/{id}/group

授权

UserHttpBearer

使用现有不透明令牌进行身份验证

类型HTTP (bearer)

参数

路径参数

id*

用户ID

类型integer

必填

格式"int64"

查询参数

groupIds*

群组ID

类型array

必填

最大项数200

最小项数0

唯一项true

响应

成功

Content-Type

*/*

"string"

DELETE

/api/v1/user/{id}/group

试验场

授权

UserHttpBearer

变量

键

值

id*

groupIds*

示例

cURL

JavaScript

PHP

Python

---