全部产品
阿里云办公

角色列表

更新时间:2018-07-13 18:50:14

(ListRoles)

描述

获取调用此API的账号所能管理的角色

  1. 管理员角色调用返回 管理员/技能组组长/坐席
  2. 技能组组长角色调用返回 技能组组长/坐席
  3. 坐席角色调用返回 坐席

请求参数

名称 类型 是否必须 描述
Action String 系统规定参数,ListRoles
InstanceId String 待获取角色列表的呼叫中心实例的ID

返回参数

名称 类型 是否必须 描述
Roles List\ 一个呼叫中心实例的所有角色列表。
      RoleId String 角色ID,系统自动生成的唯一标示符
      InstanceId String 角色所归属的呼叫中心实例。
      RoleName String 角色名称
      RoleDescription String 角色描述

请求示例

  1. https://ccc.cn-shanghai.aliyuncs.com/?
  2. &Action=ListRoles
  3. &InstanceId=9cfad875-6260-4a53-ab6e-b13e3fb31f7d
  4. &<公共请求参数>

返回示例

  1. {
  2. "HttpStatusCode":200,
  3. "RequestId":"711D948F-C616-4E23-8573-0F260513CE09",
  4. "Success":true,
  5. "Code":"OK",
  6. "Roles":{
  7. "Role":[
  8. {
  9. "RoleName":"SKILL_GROUP_ADMIN",
  10. "InstanceId":"9cfad875-6260-4a53-ab6e-b13e3fb31f7d",
  11. "RoleDescription":"技能组组长",
  12. "RoleId":"42d97cec-386b-4770-ad7b-0e6a4e665c74"
  13. },
  14. {
  15. "RoleName":"AGENT",
  16. "InstanceId":"9cfad875-6260-4a53-ab6e-b13e3fb31f7d",
  17. "RoleDescription":"坐席",
  18. "RoleId":"4c2e158e-ddd9-464a-a3fc-338eca10277c"
  19. },
  20. {
  21. "RoleName":"ADMIN",
  22. "InstanceId":"9cfad875-6260-4a53-ab6e-b13e3fb31f7d",
  23. "RoleDescription":"管理员",
  24. "RoleId":"59a3d864-2f98-4f5e-84ec-c1ea13af93f3"
  25. }
  26. ]
  27. }
  28. }

错误码

错误代码 描述 Http状态码 语义
NotExist.Instance “Call center instance ‘%s’ does not exist” 404 呼叫中心实例不存在,请确认实例ID是否正确,或者实例是否已被删除。
NoPermission.User “User ‘%s’ has no permission to ‘%s’ (Role = ‘%3’)” 403 当前用户没有权限进行角色相关的操作。请通过呼叫中心控制台为用户进行授权。