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

说明
  • 管理员角色调用返回：管理员/技能组组长/坐席
  • 技能组组长角色调用返回：技能组组长/坐席
  • 坐席角色调用返回：坐席

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String 是 ListRoles

系统规定参数。取值：ListRoles。

InstanceId String 是 9cfad875-6260-4a53-ab6e-b13e3fb31f7d

待获取角色列表的呼叫中心实例的ID

返回数据

名称 类型 示例值 描述
Code String OK

响应码
HttpStatusCode Integer 200

HTTP状态码
Message String 无

响应信息
RequestId String 711D948F-C616-4E23-8573-0F260513CE09

请求ID
Roles

一个呼叫中心实例的所有角色列表
Role

一个呼叫中心实例的所有角色列表
InstanceId String 9cfad875-6260-4a53-ab6e-b13e3fb31f7d

角色所归属的呼叫中心实例
RoleDescription String 技能组组长

角色描述
RoleId String 42d97cec-386b-4770-ad7b-0e6a4e665c74

角色ID，系统自动生成的唯一标示符
RoleName String SKILL_GROUP_ADMIN

角色名称
Success Boolean true

是否成功

示例

请求示例


http(s)://ccc.cn-shanghai.aliyuncs.com/?Action=ListRoles
&InstanceId=9cfad875-6260-4a53-ab6e-b13e3fb31f7d
&<公共请求参数>

正常返回示例

XML 格式 

<ListRolesResponse>
      <HttpStatusCode>200</HttpStatusCode>
      <RequestId>711D948F-C616-4E23-8573-0F260513CE09</RequestId>
      <Success>true</Success>
      <Code>OK</Code>
      <Roles>
            <Role>
                  <RoleName>SKILL_GROUP_ADMIN</RoleName>
                  <InstanceId>9cfad875-6260-4a53-ab6e-b13e3fb31f7d</InstanceId>
                  <RoleDescription>技能组组长</RoleDescription>
                  <RoleId>42d97cec-386b-4770-ad7b-0e6a4e665c74</RoleId>
            </Role>
            <Role>
                  <RoleName>AGENT</RoleName>
                  <InstanceId>9cfad875-6260-4a53-ab6e-b13e3fb31f7d</InstanceId>
                  <RoleDescription>坐席</RoleDescription>
                  <RoleId>4c2e158e-ddd9-464a-a3fc-338eca10277c</RoleId>
            </Role>
            <Role>
                  <RoleName>ADMIN</RoleName>
                  <InstanceId>9cfad875-6260-4a53-ab6e-b13e3fb31f7d</InstanceId>
                  <RoleDescription>管理员</RoleDescription>
                  <RoleId>59a3d864-2f98-4f5e-84ec-c1ea13af93f3</RoleId>
            </Role>
      </Roles>
</ListRolesResponse>

JSON 格式 

{
	"HttpStatusCode":200,
	"RequestId":"711D948F-C616-4E23-8573-0F260513CE09",
	"Success":true,
	"Code":"OK",
	"Roles":{
		"Role":[
			{
				"RoleName":"SKILL_GROUP_ADMIN",
				"InstanceId":"9cfad875-6260-4a53-ab6e-b13e3fb31f7d",
				"RoleDescription":"技能组组长",
				"RoleId":"42d97cec-386b-4770-ad7b-0e6a4e665c74"
			},
			{
				"RoleName":"AGENT",
				"InstanceId":"9cfad875-6260-4a53-ab6e-b13e3fb31f7d",
				"RoleDescription":"坐席",
				"RoleId":"4c2e158e-ddd9-464a-a3fc-338eca10277c"
			},
			{
				"RoleName":"ADMIN",
				"InstanceId":"9cfad875-6260-4a53-ab6e-b13e3fb31f7d",
				"RoleDescription":"管理员",
				"RoleId":"59a3d864-2f98-4f5e-84ec-c1ea13af93f3"
			}
		]
	}
}

错误码

访问错误中心查看更多错误码。