新增站点角色
更新时间：2021-09-06
接口描述
本接口用于新增 AIPAGE 站点自定义角色，最终返回操作结果。
注意事项
- authorization header 签名时必须签名 host 头部，同时推荐签名所有 x-bce 开头 header。
请求结构
POST /v{version}/role?clientToken={clientToken}&siteId={siteId} HTTP/1.1
Host: aipage.baidubce.com
Authorization: authorization string
Body: {"name": "role name", "acl": "1,2,3"}请求头域
除公共头域外，无其它特殊头域。
请求参数
| 参数名称 | 类型 | 是否必需 | 参数位置 | 描述 |
|---|---|---|---|---|
| version | String | 是 | URL参数 | API版本号 |
| clientToken | String | 是 | URL参数 | 幂等性Token，是一个长度不超过64位的ASCII字符串，详见幂等性。 |
| siteId | String | 是 | URL参数 | 站点 ID |
| name | String | 是 | Body参数 | 角色名称 |
| acl | String | 是 | Body参数 | 角色权限列表，多个英文逗号隔开，权限ID参考下表 |
系统角色ID说明
| 权限说明 | 权限ID |
|---|---|
| 设计、发布、预览网站 | 1 |
| 站点管理 | 3 |
| 内容管理 | 4 |
| 互动管理 | 5 |
| 用户管理 | 6 |
| 开发者中心 | 7 |
| 系统配置 | 8 |
| 会员管理 | 9 |
| 预约管理 | 10 |
| 电商管理 | 11 |
| 客服管理 | 12 |
| 应用中心 | 14 |
| 搜索优化 | 15 |
| 编辑小程序 | 100 |
| 发布审核小程序 | 300 |
| 小程序管理 | 500 |
更细粒度的功能权限ID参考站点后台自定义角色配置接口。
响应头域
除公共头域外，无其它特殊头域。
响应参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| success | Boolean | 是否操作成功 |
请求示例
POST https://aipage.baidubce.com/v1/role?siteId=71b6bedb-7827-4ac9-9d20-5c08ca2f0c0f&clientToken=3A8d84403d-a94b-40ce-9d6a-f6225dd26676
Host: aipage.baidubce.com
Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2015-08-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
Content-Type: application/json;charset=UTF-8
Body:
{"name": "自定义角色", "acl": "1,3,5"}响应示例
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Date: Wed, 08 Jul 2015 03:28:11 GMT
x-bce-request-id: d8752367-38e8-45e4-b4c7-e53be3137ce5
Server: BWS
{
"success": true,
"result": {
"aclNames": "设计、发布、预览网站、站点管理、互动管理",
"name": "自定义角色",
"createdAt": {
"fn": "NOW",
"args": []
},
"updatedAt": {
"fn": "NOW",
"args": []
},
"deletedAt": "1970-01-01T00:00:00.000Z",
"id": "42955978-a862-423e-9616-0854e28b75ce",
"siteId": "99f4f0ed-79f8-4426-9b43-650fdc364af4",
"acl": "1,3,5"
}
}