查询云手机详情

接口说明

根据云机id查询云手机实例的详细信息。


推荐使用API Explorer调试

API Explorer支持接口在线可视化调用,同时自动生成动态代码示例,搭配OpenAPI SDK无需计算签名实现接口快速集成。

URL

POST https://ecloud.10086.cn/api/openapi-cloudphone/api/v1/zycloudphone/resource/zh/phones/detail

请求参数

Body

参数名称
类型
必填
描述
req
OpenapiCloudPhoneDetailReq
是

req

id
string
是

云手机ID

请求示例

POST https://ecloud.10086.cn/api/openapi-cloudphone/api/v1/zycloudphone/resource/zh/phones/detail
{
	"id":"1899654129611276290"
}

返回参数

返回码:200
OK
参数名称
类型
描述
body
CloudPhoneDetailDto

响应体

attribute
CloudPhoneAttributeDto

云手机属性

byte_os_mainkeys
integer(int32)

隐藏虚拟按键,默认为1。0为不隐藏,1为隐藏。

disable_status_bar
integer(int32)

是否禁用状态栏,默认为0。1禁用,0不禁用。

gsm_operator_alpha
string

网络运营商名称,默认为CMCC

gsm_operator_iso_country
string

网络运营商国家代码,默认为cn

gsm_operator_numeric
string

网络提供商的标识码,默认为46000

gsm_sim_operator_alpha
string

SIM卡的运营商,默认为CMCC

gsm_sim_operator_iso_country
string

SIM卡归属国家,默认为cn

gsm_sim_operator_numeric
string

SIM卡提供商的标识码,默认为46000

phoneId
string

云手机实例ID

ro_byte_os_non_root
integer(int32)

是否非root,默认为1。1为没有root权限,0为有root权限。

ro_byte_os_notification_disable
integer(int32)

是否禁用消息通知,默认为0。1禁用,0不禁用。

ro_byte_os_toast_enable
integer(int32)

是否启用Toast消息提示框,默认为0。1为启用,0为不启用。

ro_horizontal_screen
integer(int32)

是否横屏显示,默认为0。1为有横屏显示,0为没有横屏显示。

ro_install_auto
integer(int32)

是否在App安装时自动确认安装,默认为0。1为确认,0为不确认

ro_permission_changed
integer(int32)

是否在安装app时自动赋予App请求的所有权限,默认为0。1赋予,0不赋予。

sys_prop_imeid
string

MEID(Mobile Equipment Identifier)是用于标识CDMA(Code Division Multiple Access)移动设备的唯⼀标识符

sys_prop_writeimsi
string

IMSI(International Mobile Subscriber Identity,国际移动用户识别码)

sys_prop_writephonenum
string

手机号码

sys_prop_writewifibssid
string

是在无线局域⽹(WLAN)中⽤于唯⼀标识基本服务集(BSS)的MAC地址

sys_prop_writewifissid
string

无线网络名称

bandwidth
integer(int32)

带宽上限

bindStatus
integer(int32)

绑定状态

endTime
string(date-time)

到期时间

errorMsg
string

错误信息,状态为99时使用

fps
integer(int32)

帧率

hostId
string

云手机所在节点ID

id
string

云手机ID

imgId
string

镜像Id

imgParentId
string

父镜像ID

imgVersion
string

镜像版本

innerIpv4
string

云手机内网IPV4

ipv4
string

云手机IPV4

ipv6
string

云手机IPV6

name
string

云手机名称

orderNo
string

订单编号(MOP-T)

osName
string

系统名称

podId
string

容器ID

podName
string

容器名称

poolId
string

资源池ID

ports
<HostPortDto> array

云手机使用端口列表

containerPort
integer(int32)

容器端口

name
string

端口名称(用途)

port
integer(int32)

主机端口

protocol
string

端口协议(TCP/UDP)

resolution
integer(int32)

分辨率

signalUrl
string

信令地址

specs
string

云手机规格

startTime
string(date-time)

开通时间

status
integer(int32)

云手机状态(0已禁用、1正在开通、2运行中、3已关机、4已冻结、5已过期、6正在启动、7正在关机、8正在重启、9正在初始化、99异常)

volumeId
string

绑定的云硬盘ID

errorCode
string

错误编码

errorMessage
string

错误信息

requestId
string

请求id

state
string

状态值

返回示例

返回码:200
OK
{
	"errorCode":"00000000",
	"errorMessage":"请求成功",
	"requestId":"67febda2-02ec-4ba1-9da1-9a80dead0b42",
	"state":"OK",
	"body":{
		"id":"1899654129611276290",
		"name":"cp-b8db7408684c48d885c95d748bb5942b",
		"status":3,
		"specs":"2406131734452992",
		"bandwidth":null,
		"poolId":"CIDC-RP-45",
		"imgVersion":"image_3.3.4",
		"imgId":"99",
		"osName":"aosp11",
		"startTime":"2025-03-12 10:50:08",
		"endTime":"2025-04-12 10:50:08",
		"orderNo":"MOP-O-25031221100896",
		"errorMsg":null,
		"podId":"1899651767307960322",
		"podName":"pod-4bzb-e7668b34e24542c08d3185626733f745",
		"ipv4":"10.251.137.225",
		"ipv6":null,
		"innerIpv4":"192.168.0.3",
		"ports":[
			{
				"protocol":"UDP",
				"port":50392,
				"containerPort":10001,
				"name":null
			},
			{
				"protocol":"UDP",
				"port":50393,
				"containerPort":10002,
				"name":null
			},
			{
				"protocol":"UDP",
				"port":50394,
				"containerPort":10003,
				"name":null
			},
			{
				"protocol":"UDP",
				"port":50395,
				"containerPort":10004,
				"name":null
			},
			{
				"protocol":"TCP",
				"port":40098,
				"containerPort":5555,
				"name":null
			}
		],
		"fps":30,
		"resolution":720,
		"attribute":{
			"phoneId":null,
			"byte_os_mainkeys":1,
			"disable_status_bar":0,
			"ro_permission_changed":0,
			"ro_install_auto":0,
			"ro_byte_os_non_root":1,
			"ro_byte_os_notification_disable":0,
			"ro_byte_os_toast_enable":0,
			"sys_prop_writeimsi":null,
			"sys_prop_imeid":null,
			"sys_prop_writephonenum":null,
			"sys_prop_writewifissid":null,
			"sys_prop_writewifibssid":null,
			"gsm_sim_operator_iso_country":"cn",
			"gsm_sim_operator_numeric":"46000",
			"gsm_sim_operator_alpha":"CMCC",
			"gsm_operator_iso_country":"cn",
			"gsm_operator_numeric":"46000",
			"gsm_operator_alpha":"CMCC",
			"ro_horizontal_screen":0
		},
		"volumeId":"d3fb433d-b910-4297-854e-531acc297cd9",
		"bindStatus":0,
		"phoneModelAttr":null,
		"signalUrl":"wss://ecloud.10086.cn:31015/api/query/zycloudphone/ws/signal"
	}
}
本文档内容整理自移动云官方帮助中心(查看原文),仅供参考。