文档首页/应用身份管理服务 OneAccess/API参考/API/管理类接口/应用侧角色管理/新增应用侧角色 - CreateAppRole
更新时间：2025-11-03 GMT+08:00
查看PDF
分享

新增应用侧角色 - CreateAppRole

功能介绍

新增应用侧角色。

接口约束

null

URI

POST /api/v2/tenant/applications/{application_id}/role

表1 路径参数

参数

是否必选

参数类型

描述

application_id

是

String

应用id。

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

Content-Type

是

String

该字段内容填为“application/json;charset=utf8”。

Authorization

是

String

认证凭据，值：Bearer {access_token}，access_token通过“获取访问凭据”接口获取。

表3 请求Body参数

参数

是否必选

参数类型

描述

code

是

String

角色代码，应用内唯一。

name

否

String

角色名称。

响应参数

状态码：200

表4 响应Body参数

参数

参数类型

描述

role_id

String

角色id。

状态码：400

表5 响应Body参数

参数

参数类型

描述

error_code

String

错误编号。

error_msg

String

错误详情。

请求示例

根据应用id新增应用侧角色，角色代码为admin1,角色名称为管理员1。

POST https://{domain_name}/api/v2/tenant/applications/{application_id}/role

Authorization: Bearer 334963fc-1e4a-473b-9096-52a929140...

{
    "code": "admin1",
    "name": "管理员1"
}

响应示例

状态码：200

角色id。

{
  "role_id" : "20220420140745089-23E4-DFF0A1900"
}

状态码

状态码

描述

200

角色id。

400

请求失败。

错误码

请参见错误码。

相关文档