创建群组。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
授权信息
当前API暂无授权信息透出。
请求语法
POST /v2/group/create HTTP/1.1
请求参数
名称 | 类型 | 必填 | 描述 | 示例值 |
---|---|---|---|---|
body | object | 否 | 请求体参数。 | |
group_name | string | 是 | 群组名,长度 1~128 个字符 | test group |
description | string | 否 | 描述信息,长度 0~1024 个字符 | test group description |
is_root | boolean | 否 | 是否是根群组,根群组不能加入其他任何群组,一般用于组织架构的顶层组织 | false |
parent_group_id | string | 否 | 需要加入的父群组 ID,传入此字段时,创建完群组后,系统会将此群组自动加入到指定的父群组 | 2e43ec8427dd45f19431b7504649a1b3 |
返回参数
示例
正常返回示例
JSON
格式
{
"domain_id": "bj1",
"group_id": "b45c0c0c373c41ec9ebb5c85a025a08f",
"group_name": "test group",
"description": "created by system",
"created_at": 1670573504600,
"updated_at": 1670573504600,
"creator": "c9b7a5aa04d14ae3867fdc886fa01da4",
"is_sync": true
}
错误码
访问错误中心查看更多错误码。