手机实例管理-华为云

云手机服务器 CPH-获取云手机连接信息:请求参数

请求参数表2 请求Header参数参数是否必选参数类型描述 X-Auth-Token 是 String 用户Token。通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。表3 请求Body参数参数是否必选参数类型描述 phone_ids 是 Array of strings phone_id数组，单次请求最大限制10 client_type 是 String 申请接入的客户端类型 ANDROID: 安卓平台SDK WINDOWS: Windows平台SDK H5_MOBILE: H5移动端SDK H5_PC: H5 PC端SDK IOS: iOS平台SDK 枚举值： ANDROID WINDOWS H5_MOBILE H5_PC IOS

云手机服务器 CPH 手机实例管理

云手机服务器 CPH-获取云手机连接信息:响应参数

响应参数状态码： 200 表4 响应Body参数参数参数类型描述 request_id String 请求的唯一标识ID。 connect_infos Array of ConnectInfo objects 云手机接入信息列表 errors Array of ConnectErrorInfo objects 错误信息表5 ConnectInfo 参数参数类型描述 phone_id String 云手机的唯一标识。 access_info access_info object 云手机接入信息表6 access_info 参数参数类型描述 access_ip String 云手机实例的访问IP intranet_ip String 云手机实例的内网访问IP access_ipv6 String 云手机服务器IPv6 IP access_port String 云手机实例的访问端口 session_id String 本次接入的会话ID timestamp String 时间戳 ticket String 签名令牌表7 ConnectErrorInfo 参数参数类型描述 phone_id String 云手机的唯一标识ID。 error_code String 错误码。 error_msg String 错误说明。

云手机服务器 CPH 手机实例管理

云手机服务器 CPH-获取云手机连接信息:请求示例

请求示例获取云手机连接信息 POST https://{CPHEndpoint}/v1/{project_id}/cloud-phone/phones/batch-connection { "client_type" : "ANDROID", "phone_ids" : [ "1564567b8bab40f34711234cb80d8574", "1234567b8bab40ffb711234cb80d0234", "1234567b8bab40ffb711234cb8654321z" ] }

云手机服务器 CPH 手机实例管理

云手机服务器 CPH-获取云手机连接信息:响应示例

响应示例状态码： 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." } ] }

云手机服务器 CPH 手机实例管理

云手机服务 KOOPHONE-云手机实例管理概述

云手机实例管理概述在云手机实例管理页面，实例列表区域可以查看到实例详细信息。单击实例列表右上方设置按钮，可自定义实例列表展示参数，必选与可选项详见表1。表1 参数说明参数是否必选参数说明云手机名称/ID 是云手机名称：购买云手机时自定义的云手机名称。云手机ID：系统会给云手机实例分配一个实例ID，用于标记该实例。区域是云手机的物理数据中心所在的位置，区域不同即物理数据中心距离用户的物理距离不同，网络延迟不同。规格信息是云手机的规格信息，包含vCPU、内存等。运行状态是包含已停止、运行中、下线中、启动中、已关机。登录状态否包含已登录、未登录。已登录指云机正在串流，未登录指云机无串流。分配状态否包含已分配、未分配。用户名否管理员为成员配置的账号名。账号名否管理员为成员设置的账号名。计费模式是显示包年/包月、按需计费，以及剩余到期时间或状态信息。正常状态：显示距离到期时间的倒计时（包年/包月）；云手机实例创建时间（按需计费）。到期冻结状态：显示已冻结以及距离删除时间的倒计时。公安冻结状态：显示已冻结（违规）。违规冻结状态：显示已冻结（违规）以及距离删除时间的倒计时。您可以选择一台或多台云手机实例进行重启、开机、关机、续费、退订、应用卸载、删除。关于应用卸载的详细请参见应用卸载。云手机ID，单击可切换为：云手机名称、区域、规格信息、用户名等参数。在搜索栏输入对应参数可进行筛选，或者单击运行状态旁的筛选按钮进行筛选。单击右侧搜索按钮，可筛选出对应过滤条件的实例信息。单击右上角的，可刷新到所有实例的最新信息。父主题：云手机实例管理

云手机服务 KOOPHONE 云手机实例管理

云手机服务器 CPH-查询手机镜像:响应参数

响应参数状态码： 200 表4 响应Body参数参数参数类型描述 request_id String 请求的唯一标识ID。 phone_images Array of PhoneImage objects 手机镜像信息。表5 PhoneImage 参数参数类型描述 image_name String 手机镜像名称，不超过128个字节。 os_type String 镜像操作系统类型，不超过16个字节。 is_public Integer 镜像类型。 1：公有镜像 2 ：私有镜像 os_name String 手机操作系统，不超过36个字节。 image_label String 镜像适用的云手机规格。 cloud_phone：适用于physical.rx1.xlarge 类型云手机服务器 cloud_phone_1620：适用于physical.kg1.4xlarge.cp类型云手机服务器 cloud_game：适用于physical.rx1.xlarge.cg 类型云手游服务器 cloud_game_1620：适用于physical.kg1.4xlarge.cg 类型云手游服务器 qemu_phone：适用于physical.rx1.xlarge 类型云手机服务器中 qemu类型云手机规格 image_id String 手机镜像唯一标识ID，不超过32个字节。

云手机服务器 CPH 手机实例管理

云手机服务器 CPH-查询手机镜像:响应示例

响应示例状态码： 200 OK { "phone_images" : [ { "image_name" : "AOSP", "os_type" : "aosp", "is_public" : 1, "os_name" : "AOSP7.1.1", "image_label" : "cloud_game", "image_id" : "20032420200401a60b0003a99684b8ea" }, { "image_name" : "AOSP", "os_type" : "aosp", "is_public" : 1, "os_name" : "AOSP7.1.1", "image_label" : "cloud_phone", "image_id" : "20032120200330a20b000eae5b8c01e6" }, { "image_name" : "AOSP", "os_type" : "aosp", "is_public" : 1, "os_name" : "AOSP7.0.0", "image_label" : "qemu_phone", "image_id" : "be4d231e44d2a4ccf612660a473fe1e3" } ], "request_id" : "5aac6ab146ba76e5b12a3d00a03a9869" }

云手机服务器 CPH 手机实例管理

云手机服务器 CPH-查询云手机列表:URI

URI GET /v1/{project_id}/cloud-phone/phones 表1 路径参数参数是否必选参数类型描述 project_id 是 String 项目id。表2 Query参数参数是否必选参数类型描述 offset 否 Integer 偏移量为一个大于0小于资源总个数的整数，表示查询该偏移量后面的所有的资源数，默认值为0。 limit 否 Integer 每页返回的资源个数。取值范围：1~200（默认值为200），一般设置为10、20、50。 phone_name 否 String 云手机名称，支持模糊查询。 server_id 否 String 云手机服务器的唯一标识。 status 否 Integer 云手机状态。 1：创建中 2：运行中 3：重置中 4：重启中 6：冻结 7：正在关机 8：已关机 -5：重置失败 -6：重启失败 -7：手机异常 -8：创建失败 -9：关机失败 type 否 Integer 云手机类型。 0：普通云手机

云手机服务器 CPH 手机实例管理

云手机服务器 CPH-查询云手机列表:响应参数

响应参数状态码： 200 表4 响应Body参数参数参数类型描述 phones Array of Phone objects 云手机信息。 request_id String 请求的唯一标识ID。 count Integer 实例总数。表5 Phone 参数参数类型描述 phone_name String 云手机的名称，不超过65个字符。 server_id String 云手机所在的服务器ID，不超过32个字节。 phone_id String 云手机的唯一标识，不超过32个字节。 phone_model_name String 云手机规格名称，不超过64个字节。 image_id String 云手机镜像ID，不超过32个字节。 image_version String 镜像版本。 vnc_enable String 云手机是否开启VNC服务。 true：开启 false：不开启 status Integer 云手机状态。 0: 创建中 1：创建中 2：运行中 3：重置中 4：重启中 6：冻结 7：正在关机 8：已关机 -5：重置失败 -6：重启失败 -7：手机异常 -8：创建失败 -9：关机失败 type Integer 云手机类型。 0：普通云手机 1：试玩云手机 imei String imei码。 traffic_type String 手机路由类型。 direct：默认路由 routing：路由到编码容器 volume_mode Integer 手机物理磁盘是否独立。 0：不独立 1：独立 availability_zone String 云手机服务器所在的可用区。 metadata metadata object 订单以及产品相关信息。 create_time String 创建时间，时间格式为UTC。 update_time String 更新时间，时间格式为UTC。表6 metadata 参数参数类型描述 order_id String 订单ID，不超过64个字节。 product_id String 产品ID，不超过64个字节。

云手机服务器 CPH 手机实例管理

云手机服务器 CPH-查询云手机列表:响应示例

响应示例状态码： 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_version" : "AOSP 7.0", "image_id" : "88b8449b896f3a4f0ad57222dd91909", "vnc_enable" : "true", "status" : 2, "type" : 0, "imei" : "869287243397729", "availability_zone" : "cn-southwest-242b", "traffic_type" : "direct", "volume_mode" : 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" } ] }

云手机服务器 CPH 手机实例管理

云手机服务器 CPH-批量控制:约束与限制

约束与限制 CPH服务对批量控制风险与安全进行如下约束：目前支持的控制命令： shell：在云手机设备中启动远程交互式shell。 install：将软件包安装到云手机系统。 uninstall：从云手机系统中移除软件包。 push：将文件或者文件夹从本地设备复制到云手机设备上。控制命令数据和指令不当，会造成云手机故障并无法恢复。如果需要执行install、push命令，则需要严格按照操作步骤进行设置，并独立构建批量控制APK数据桶与其他数据隔离。如果需要执行install、push命令，文件必须为tar格式，压缩的文件路径按照AOSP（Android Open Source Project）的目录结构放置。同一台云手机服务器，文件推送任务耗时与文件推送任务个数成正比。

云手机服务器 CPH 云手机实例管理

云手机服务器 CPH-查询云手机详情:响应参数

响应参数状态码： 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码。 traffic_type String 手机路由类型。 direct：默认路由 routing：路由到编码容器 volume_mode Integer 手机物理磁盘是否独立。 0：不独立 1：独立 availability_zone String 云手机服务器所在的可用区。 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 云手机数据盘大小。

云手机服务器 CPH 手机实例管理

云手机服务器 CPH-查询云手机详情:响应示例

响应示例状态码： 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, "availability_zone" : "cn-southwest-242b", "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" }

云手机服务器 CPH 手机实例管理

云手机服务器 CPH-修改云手机名称:请求参数

请求参数表2 请求Header参数参数是否必选参数类型描述 X-Auth-Token 是 String 用户Token。通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。表3 请求Body参数参数是否必选参数类型描述 phone_name 是 String 云手机名称，必须为小写字母（a-z）、大写字母（A-Z）、数字（0-9）、中文字符、中划线-、下划线_，且不得超过60个字符。

云手机服务器 CPH 手机实例管理

云服务器内容精选

手机实例管理

7*24

备案

专业服务

退订

建议反馈

售前咨询热线