Create Role¶
创建角色。
请求格式¶
POST https://{apigw-address}/app-portal-service/v2.3/role/create
请求参数（URI）¶
名称 |
位置（Path/Query） |
必需/可选 |
数据类型 |
描述 |
|---|---|---|---|---|
orgId |
Query |
必需 |
String |
OU ID。如何获取 orgId 信息 >> |
请求参数（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=yourOrgId
method: POST
{
"name": "test",
"description": "test"
}
返回示例¶
{
"code": 0,
"message": "OK",
"data": "your_role_id"
}