文档首页/ 云手机服务器 CPH/ API参考/ 云手机服务器API/ 手机实例管理/ 查询云手机详情 - ShowCloudPhoneDetail
更新时间：2025-10-28 GMT+08:00
在线调试
CLI示例
查看PDF
分享

查询云手机详情 - ShowCloudPhoneDetail

功能介绍

查询云手机的详细信息。

授权信息

账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见权限和授权项。

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

错误码

请参见错误码。

父主题： 手机实例管理