更新时间:2024-11-27 GMT+08:00
分享

查询云手机详情

功能介绍

查询云手机的详细信息。

调试

您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。

URI

GET /v1/{project_id}/cloud-phone/phones/{phone_id}

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

项目id。

phone_id

String

云手机id。

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

用户Token。

通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。

响应参数

状态码: 200

表3 响应Body参数

参数

参数类型

描述

request_id

String

请求的唯一标识ID,不超过32个字节。

phone_name

String

云手机名称,不超过65个字符。

server_id

String

云手机服务器ID,不超过32个字节。

phone_id

String

云手机的唯一标识,不超过32个字节。

image_id

String

云手机镜像ID,不超过32个字节。

image_version

String

镜像版本。

vnc_enable

String

云手机是否开启VNC服务(过期)

  • true:开启

  • false:关闭

phone_model_name

String

云手机规格名称,不超过64个字节。

status

Integer

云手机状态。

  • 1:创建中

  • 2:运行中

  • 3:重置中

  • 4:重启中

  • 6:冻结

  • 7:正在关机

  • 8:已关机

  • -5:重置失败

  • -6:重启失败

  • -7:手机异常

  • -8:创建失败

  • -9:关机失败

access_infos

Array of PhoneAccessInfo objects

云手机访问信息。

property

String

云手机属性字符串,不超过2048个字节。

metadata

metadata object

订单以及产品相关信息。

phone_data_volume

PhoneDataVolume object

云手机数据盘信息。

imei

String

imei码。

type

Integer

云手机类型。

  • 0:普通云手机

traffic_type

String

手机路由类型。

  • direct:默认路由

  • routing:路由到编码容器

volume_mode

Integer

手机物理磁盘是否独立。

  • 0:不独立

  • 1:独立

availability_zone

String

云手机服务器所在的可用区。如上海一可用区1为cn-east-3a。

has_encrypt

Boolean

当前手机是否开启文件级加密。

create_time

String

创建时间,

时间格式为UTC,YYYY-MM-DDTHH:MM:SSZ。

update_time

String

更新时间,

时间格式为UTC,YYYY-MM-DDTHH:MM:SSZ。

表4 PhoneAccessInfo

参数

参数类型

描述

type

String

自定义端口类型,不超过16个字节。

device_ip

String

云手机IP(过期)。

phone_ip

String

云手机IP。

listen_port

Integer

服务监听端口。

access_ip

String

云手机服务器的访问IP(过期)。

public_ip

String

云手机服务器的公网IP,如果端口设置了非公网访问,该字段返回空字符串。

intranet_ip

String

云手机服务器的内网IP(过期)。

server_ip

String

云手机服务器的内网IP。

access_port

Integer

服务映射到公网的访问端口。

phone_ipv6

String

云手机IPv6 IP,新增字段。

server_ipv6

String

云手机服务器IPv6 IP,新增字段。

表5 metadata

参数

参数类型

描述

order_id

String

订单ID,不超过64个字节。

product_id

String

产品ID,不超过64个字节。

表6 PhoneDataVolume

参数

参数类型

描述

volume_type

String

云手机数据盘类型。

volume_size

Integer

云手机数据盘大小。

请求示例

查询手机详情

GET https://{CPH Endpoint}/v1/{project_id}/cloud-phone/phones/1564567b8bab40f34711234cb80d8574

响应示例

状态码: 200

OK

{
  "request_id" : "70bb40bef50e4a14b116a5a527fd7432",
  "phone_name" : "mobile-0049",
  "server_id" : "88b8449b896f3a4f0ad57222dd91909",
  "phone_id" : "1564567b8bab40f34711234cb80d8574",
  "image_id" : "88b8449b896f3a4f0ad57222dd91909",
  "phone_model_name" : "aphs1.large.2.aosp",
  "image_version" : "AOSP 7.0",
  "status" : 2,
  "imei" : 869287243397729,
  "type" : 0,
  "availability_zone" : "xxxxxx",
  "traffic_type" : "direct",
  "volume_mode" : 0,
  "phone_data_volume" : {
    "volume_type" : "GPSSD",
    "volume_size" : 10
  },
  "access_infos" : [ {
    "type" : "server1",
    "device_ip" : "10.237.0.61",
    "phone_ip" : "10.237.0.61",
    "listen_port" : 38080,
    "access_ip" : "213.32.43.210",
    "public_ip" : "213.32.43.210",
    "intranet_ip" : "172.31.0.123",
    "server_ip" : "172.31.0.123",
    "access_port" : 14308,
    "phone_ipv6" : "fd00::aed:3d",
    "server_ipv6" : "2001:db8:a583:b62:e5ea:4a6b:de7b:f97d"
  }, {
    "type" : "server2",
    "device_ip" : "10.237.0.61",
    "phone_ip" : "10.237.0.61",
    "listen_port" : 38081,
    "access_ip" : "213.32.43.210",
    "public_ip" : "213.32.43.210",
    "intranet_ip" : "172.31.0.123",
    "server_ip" : "172.31.0.123",
    "access_port" : 14328,
    "phone_ipv6" : "fd00::aed:3d",
    "server_ipv6" : "2001:db8:a583:b62:e5ea:4a6b:de7b:f97d"
  } ],
  "property" : "{\"sys.prop.writephonenum\":\"13666666666\",\"sys.prop.writeimsi\":\"460021624617113\",\"sys.prop.writewifissid\":\"test_wifi\"}",
  "metadata" : {
    "order_id" : "CS1710111105S8IPB",
    "product_id" : "00301-25217-0--0"
  },
  "create_time" : "2017-10-10T00:00:00Z",
  "update_time" : "2018-11-12T00:00:00Z"
}

状态码

状态码

描述

200

OK

错误码

请参见错误码

相关文档