批量新建/修改通行组

批量新建/修改通行组,最大可创建256个组。

支持创建和更新组信息,如group_id不存在则创建组信息,如group_id存在则更新组信息.

请求路径

/v2/group

请求方式

POST

  • 请求体: application/json

字段
类型
必填
字段释义

group_list

Object array

N

组信息列表

组信息字段:

字段
类型
必填
字段释义

group_id

String

Y

由提交端设置的唯一标识,不可重复,长度上限128字节

name

String

Y

组名称,内容长度1~128字节,不可重复

type

Int

N

组类型,1:员工组, 2:访客组, 5: 黑名单组;默认:1

rule_id

String

N

绑定的通行规则id,若该字段不存在 则不绑定通行规则

请求示例:

批量创建一个name员工组1的通行组,其group_id设定为1,type1(员工组),但不绑定策略,即rule_id为空。一个name员工组2的通行组,其group_id设定为2,type1(员工组),但不绑定策略,即rule_id为空。

/v2/group

{
    "group_list": [
        {
            "name": "员工组1",
            "type": 1,
            "group_id": "1",
            "rule_id": ""
        },
        {
            "name": "员工组2",
            "type": 1,
            "group_id": "2",
            "rule_id": ""
        }
    ]
}

返回示例

{
    "data": {
        "errors": []
    },
    "code": 200,
    "msg": "OK"
}

Last updated