Create Role


创建角色。

请求格式


POST https://{apigw-address}/app-portal-service/v2.3/role/create

请求参数(Query)


名称 必需/可选 数据类型 描述
orgId 必需 String 组织 ID。

请求参数(Body)


名称 必需/可选 数据类型 描述
name 必需 String 角色名称。
description 必需 String 角色描述。

响应参数


名称 数据类型 描述
data String 角色 ID。

错误码


代码 描述
31400 OU ID、角色名称或角色描述为空。
31403 服务账号无权创建角色。
31404 OU ID 不存在或 OU 无权访问应用。
31408 角色名称已存在。

示例

请求示例


url: https://{apigw-address}/app-portal-service/v2.3/role/create?orgId=your_org_id
method: POST
{
  "name": "test",
  "description": "test"
}

返回示例


{
  "code": 0,
  "message": "OK",
  "data": "your_role_id"
}