手机实例管理-华为云

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

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

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

云手机服务器 CPH-导出云手机数据:响应参数

响应参数状态码： 200 表5 响应Body参数参数参数类型描述 request_id String 请求的唯一标识ID。 jobs Array of PhoneJob objects 任务信息。表6 PhoneJob 参数参数类型描述 phone_id String 云手机的唯一标识ID，云手机相关任务包含此字段。 job_id String 任务的唯一标识。 error_code String 错误码。 error_msg String 错误说明。

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

云手机服务器 CPH-导出云手机数据:请求示例

请求示例将手机数据导出到obs桶 POST https://{CPH Endpoint}/v1/{project_id}/cloud-phone/phones/batch-storage { "storage_infos" : [ { "phone_id" : "1234567b8bab40ffb711234cb80d0234", "include_files" : [ "/data/app", "/data/local", "/data/media" ], "exclude_files" : [ "/data/app/com.xx.xx-*" ], "bucket_name" : "mybucket", "object_path" : "myimage/v1/xxxxx.tar" } ] }

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

云手机服务器 CPH-导出云手机数据:请求参数

请求参数表2 请求Header参数参数是否必选参数类型描述 X-Auth-Token 是 String 用户Token。通过调用 IAM 服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。表3 请求Body参数参数是否必选参数类型描述 storage_infos 是 Array of StorageInfo objects 待导出数据的云手机信息。表4 StorageInfo 参数是否必选参数类型描述 phone_id 是 String 云手机ID。 include_files 是 Array of strings 需要导出数据的存储路径，绝对路径，最大长度4096字节。仅支持导出/data和、cache目录下的数据。目前只支持大小写字母、数字、小数点（.）、斜线（/）、中划线（-）、下划线（_）、加号（+）、井号（#）、星号（*）、等号这些字符。 exclude_files 否 Array of strings 不能导出数据的存储路径。exclude_files优先级比include_files高，如果冲突，exclude_files生效。路径要求同include_files。 bucket_name 是 String 导出数据存储的OBS桶名。合法的OBS桶名，3-63个字符，只能由小写字母、数字、中划线（-）和小数点（.）组成。 object_path 是 String 导出数据存储的OBS路径名。符合OBS的路径名规范，最大长度1024字符。目前只支持大小写字母、数字、小数点（.）、斜线（/）、中划线（-）、下划线（_）、加号（+）、井号（#）、等号这些字符。

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

云手机服务器 CPH-重启云手机:响应示例

响应示例状态码： 200 OK { "request_id" : "6837531fd3f54550927b930180a706bf", "jobs" : [ { "phone_id" : "1234567b8bab40ffb711234cb80d0234", "job_id" : "1564567b8bab40f34711234cb80d0123" }, { "phone_id" : "1678567b8bab40f93711234cb80d0764", "error_code" : "CPS.0004", "error_msg" : "Parameter: phone_id is invalid." } ] }

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

云手机服务器 CPH-重启云手机:响应参数

响应参数状态码： 200 表5 响应Body参数参数参数类型描述 request_id String 请求的唯一标识ID。 jobs Array of PhoneJob objects 任务信息。表6 PhoneJob 参数参数类型描述 phone_id String 云手机的唯一标识ID，云手机相关任务包含此字段。 job_id String 任务的唯一标识。 error_code String 错误码。 error_msg String 错误说明。

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

云手机服务器 CPH-重启云手机:请求示例

请求示例重启云手机，选择更换镜像和属性 POST https://{CPH Endpoint}/v1/{project_id}/cloud-phone/phones/batch-restart { "phones" : [ { "phone_id" : "a7f3a1c5258347d6b6f1def79e11f2bc", "property" : "{\"sys.prop.writephonenum\":\"13666666666\",\"sys.prop.writeimsi\":\"460021624617113\",\"sys.prop.writewifissid\":\"test_wifi\"}" }, { "phone_id" : "1678567b8bab40f93711234cb80d0764", "property" : "{\"sys.prop.writephonenum\":\"13666666666\",\"sys.prop.writeimsi\":\"460021624617113\",\"sys.prop.writewifissid\":\"test_wifi\"}" } ], "image_id" : "1564567b8bab40f34711234cb80d8574" }

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

云手机服务器 CPH-重启云手机:请求参数

请求参数表2 请求Header参数参数是否必选参数类型描述 X-Auth-Token 是 String 用户Token。通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。表3 请求Body参数参数是否必选参数类型描述 image_id 否 String 云手机镜像。 phones 是 Array of PhoneProperty objects 云手机列表。表4 PhoneProperty 参数是否必选参数类型描述 phone_id 是 String 云手机id。 property 否 String 云手机属性列表，为Json格式字符串。

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

云服务器内容精选

手机实例管理

7*24

备案

专业服务

退订

建议反馈

售前咨询热线