调用ListRamUsers获取未导入指定实例下的RAM用户列表。
接口说明
一个RAM用户可以作为坐席导入到多个实例下，但是一个坐席只能指向一个RAM账户，如果我们在实例下创建坐席，实际上是创建了一个RAM账户的，此时如果想创建一个新的实例又不想创建多余的RAM账户，就可以调用ListRamUsers接口获取未导入实例下的RAM用户列表，然后再调用导入RAM用户的接口将RAM用户导入到实例下。这样可以避免过多的创建RAM账户，造成资源浪费。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
调试授权信息
当前API暂无授权信息透出。
请求参数
| 名称 | 类型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| InstanceId | string | 是 | 实例ID。 | ccc-test |
| SearchPattern | string | 否 | 根据坐席登录名或坐席展示名进行模糊匹配，非必填，默认为空，为空表示不过滤。 | agent |
| PageNumber | integer | 是 | 分页序号，范围1-1000。 | 1 |
| PageSize | integer | 是 | 分页大小，范围1-100。 | 10 |
返回参数
示例
正常返回示例
JSON格式
{
"Code": "OK",
"HttpStatusCode": 200,
"Message": "无",
"RequestId": "24753D71-C91D-1A38-A8AD-372BF12453F6",
"Data": {
"PageNumber": 1,
"PageSize": 10,
"TotalCount": 100,
"List": [
{
"DisplayName": "测试账号",
"Email": "username@example.com",
"LoginName": "agent",
"Mobile": "1382114****",
"AliyunUid": 0,
"Primary": true,
"RamId": "28036411123456****"
}
]
}
}错误码
| HTTP status code | 错误码 | 错误信息 | 描述 |
|---|---|---|---|
| 400 | Parameter.Maximum | The parameter %s must be less than or equal to %s. | 参数必须小于或等于系统规定的最大值。 |
| 400 | Parameter.Minimum | The parameter %s must be greater than or equal to %s. | 参数必须大于或等于系统规定的最小值。 |
| 404 | NotExists.InstanceId | The specified instance %s does not exist. | 指定的呼叫中心实例不存在。 |
访问错误中心查看更多错误码。