更新时间：2025-10-28 GMT+08:00
获取云手机连接信息 - BatchShowPhoneConnectInfos
功能介绍
获取云手机连接信息。
授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见权限和授权项。
URI
POST /v1/{project_id}/cloud-phone/phones/batch-connection
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
project_id |
是 |
String |
项目id。 |
请求参数
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
X-Auth-Token |
是 |
String |
用户Token。 通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
phone_ids |
是 |
Array of strings |
phone_id数组，单次请求最大限制10 |
|
client_type |
是 |
String |
申请接入的客户端类型
|
响应参数
状态码：200
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
request_id |
String |
请求的唯一标识ID。 |
|
connect_infos |
Array of ConnectInfo objects |
云手机接入信息列表 |
|
errors |
Array of ConnectErrorInfo objects |
错误信息 |
请求示例
获取云手机连接信息
POST https://{CPHEndpoint}/v1/{project_id}/cloud-phone/phones/batch-connection
{
"client_type" : "ANDROID",
"phone_ids" : [ "1564567b8bab40f34711234cb80d8574", "1234567b8bab40ffb711234cb80d0234", "1234567b8bab40ffb711234cb8654321" ]
}
响应示例
状态码：200
OK
{
"request_id" : "70bb40bef50e4a14b116a5a527fd7432",
"connect_infos" : [ {
"phone_id" : "1564567b8bab40f34711234cb80d8574",
"access_info" : {
"access_ip" : "213.32.43.22",
"intranet_ip" : "192.168.0.25",
"access_ipv6" : "2001:db8:a583:b62:e5ea:4a6b:de7b:f97d",
"access_port" : 14308,
"session_id" : "9864567a7bab40f34711234cb8087474",
"timestamp" : "122478329742",
"ticket" : "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
}
} ],
"errors" : [ {
"phone_id" : "1234567b8bab40ffb711234cb80d0234",
"error_code" : "CPS.0018",
"error_msg" : "Access info not found."
}, {
"phone_id" : "1234567b8bab40ffb711234cb8654321",
"error_code" : "CPS.0005",
"error_msg" : "Phone not found."
} ]
}
状态码
|
状态码 |
描述 |
|---|---|
|
200 |
OK |
错误码
请参见错误码。
父主题： 手机实例管理
