功能介绍
分页查询 云手机 ，云手机列表按照创建时间进行降序排列。分页查询可以指定offset以及limit。如果不存在云手机，则返回空列表。
调试
您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。
URI
GET /v1/{project_id}/cloud-phone/phones
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
project_id |
是 |
String |
项目id。 |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
offset |
否 |
Integer |
偏移量为一个大于0小于资源总个数的整数，表示查询该偏移量后面的所有的资源数，默认值为0。 |
|
limit |
否 |
Integer |
每页返回的资源个数。取值范围：1~100（默认值为100），一般设置为10、20、50。 |
|
phone_name |
否 |
String |
云手机名称，支持模糊查询。 |
|
server_id |
否 |
String |
云手机服务器的唯一标识。 |
|
status |
否 |
Integer |
云手机状态。
|
|
type |
否 |
Integer |
云手机类型。
|
请求参数
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
X-Auth-Token |
是 |
String |
用户Token。 通过调用 IAM 服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 |
响应参数
状态码： 200
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
phones |
云手机信息。 |
|
|
request_id |
String |
请求的唯一标识ID。 |
|
count |
Integer |
实例总数。 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
phone_name |
String |
云手机的名称，不超过65个字符。 |
|
server_id |
String |
云手机所在的服务器ID，不超过32个字节。 |
|
phone_id |
String |
云手机的唯一标识，不超过32个字节。 |
|
phone_model_name |
String |
云手机规格名称，不超过64个字节。 |
|
image_id |
String |
云手机 镜像 ID，不超过32个字节。 |
|
vnc_enable |
String |
云手机是否开启VNC服务。
|
|
status |
Integer |
云手机状态。
|
|
type |
Integer |
云手机类型。
|
|
metadata |
订单以及产品相关信息。 |
|
|
create_time |
String |
创建时间， 时间格式为UTC。 |
|
update_time |
String |
更新时间， 时间格式为UTC。 |
请求示例
查询手机列表
GET https://{CPH Endpoint}/v1/{project_id}/cloud-phone/phones
响应示例
状态码： 200
OK
{
"request_id" : "6a63a18b8bab40ffb71ebd9cb80d0085",
"count" : 1,
"phones" : [ {
"phone_name" : "mobile-0001",
"server_id" : "88b8449b896f3a4f0ad57222dd91909",
"phone_id" : "1234567b8bab40ffb711234cb80d0234",
"phone_model_name" : "AOSP-1U4G15G-001",
"image_id" : "88b8449b896f3a4f0ad57222dd91909",
"vnc_enable" : "true",
"status" : 2,
"type" : 0,
"metadata" : {
"order_id" : "CS1710111105S8IPB",
"product_id" : "00301-25217-0--0"
},
"create_time" : "2017-10-10T00:00:00Z",
"update_time" : "2018-10-10T00:00:00Z"
} ]
}
状态码
|
状态码 |
描述 |
|---|---|
|
200 |
OK |
错误码
请参见错误码。
