华为云用户手册

响应示例 状态码： 200 OK { "encode_servers" : [ { "encode_server_name" : "ENCODE_SERVER_2", "encode_server_id" : "00b00d1b35094f13b360cdfe15a9bfee", "encode_server_ip" : "10.237.0.233", "encode_server_ipv6" : "fd00::aed:e9", "server_id" : "26fef5ef8f484e5fbd3d3974134b8091", "keypair_name" : "keyPair2", "type" : 0, "status" : 1, "access_infos" : [ { "listen_port" : 6902, "intranet_ip" : "172.31.240.115", "access_port" : 6902, "access_ip" : "10.154.119.231", "server_ip" : "172.31.240.115", "server_ipv6" : "2001:db8:a583:b62:e5ea:4a6b:de7b:f97d", "public_ip" : "10.154.119.231", "type" : "port1" }, { "listen_port" : 6903, "intranet_ip" : "172.31.240.115", "access_port" : 6903, "access_ip" : "172.31.240.115", "server_ip" : "172.31.240.115", "server_ipv6" : "2001:db8:a583:b62:e5ea:4a6b:de7b:f97d", "public_ip" : "", "type" : "port2" }, { "listen_port" : 6900, "intranet_ip" : "172.31.240.115", "access_port" : 6900, "access_ip" : "172.31.240.115", "server_ip" : "172.31.240.115", "server_ipv6" : "2001:db8:a583:b62:e5ea:4a6b:de7b:f97d", "public_ip" : "", "type" : "port3" }, { "listen_port" : 6901, "intranet_ip" : "172.31.240.115", "server_ipv6" : "2001:db8:a583:b62:e5ea:4a6b:de7b:f97d", "access_port" : 6901, "access_ip" : "100.68.0.235", "server_ip" : "172.31.240.115", "public_ip" : "100.68.0.235", "type" : "port4" } ] } ], "request_id" : "4faba0b7f7cb4e829b18773718289b99"}

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 request_id String 请求的唯一标识ID。 server_models Array of ServerModel objects 云手机服务器的规格信息。 表5 ServerModel 参数 参数类型 描述 server_model_name String 云手机服务器的规格名称，不超过64字节。 server_type String 云手机服务器的型号，如Hi1616。不超过32字节。 cpu Integer 云手机服务器的CPU核数。 memory Integer 云手机服务器的内存大小，单位G。 extend_spec extend_spec object 云手机服务器的属性描述，不超过512个字节。 product_type Integer 产品类型。 0：云手机 1：云手游 free_size Integer 服务器磁盘的免费配额，单位G。 表6 extend_spec 参数 参数类型 描述 cpu String 云手机服务器cpu类型。 memory String 云手机服务器内存类型。 disk String 云手机服务器磁盘类型。 network_interface String 云手机服务器网络类型。 gpu String 云手机服务器gpu类型。 bms_flavor String 云手机服务器bms规格。 gpu_count Integer 云手机服务器gpu数量。 numa_count Integer 云手机服务器numa数量。 os_volume os_volume object 云盘服务器操作系统盘信息，本地盘服务器不返回 表7 os_volume 参数 参数类型 描述 size Integer 操作系统盘大小 volume_type String 操作系统盘类型

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 request_id String 请求的唯一标识ID。 encode_servers Array of EncodeServer objects 编码服务信息。 表5 EncodeServer 参数 参数类型 描述 encode_server_name String 编码服务的名称，不大于64个字节。 encode_server_id String 编码服务的唯一标识ID，不大于32个字节。 encode_server_ip String 编码服务IP地址。 server_id String 云手机服务器ID，不大于32个字节。 keypair_name String 编码服务登录密钥名称。 type Integer 编码服务类型。 0：服务器 1：容器 status Integer 编码服务状态。 1：运行中 2：异常 3：重启中 0、4、5：创建中 access_infos Array of EncodeServerAccessInfo objects 编码服务的访问信息。 encode_server_ipv6 String 编码服务IPv6地址。 表6 EncodeServerAccessInfo 参数 参数类型 描述 listen_port Integer 编码服务监听端口。 access_ip String 编码服务访问的公网IP（过期）。 intranet_ip String 编码服务访问的内网IP（过期）。 public_ip String 编码服务访问的公网IP（新增）。 server_ip String 编码服务访问的内网IP（新增）。 access_port Integer 编码服务公网的访问端口。 type String 编码服务的端口类型，取值如下： adb：云手机的ADB端口 vnc：云手机的VNC端口 cph_app_server：云游戏客户端接入端 cph_h5_server：云游戏H5 web网页接入端口 其他值：用户自定义端口 server_ipv6 String 编码服务访问的内网IPv6 IP（新增）。

URI GET /v1/{project_id}/cloud-phone/encode-servers 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目id。 表2 Query参数 参数 是否必选 参数类型 描述 offset 否 Integer 偏移量为一个大于等于0整数，表示查询该偏移量后面的所有的资源数，默认值为0。 limit 否 Integer 每页返回的资源个数。取值范围：1~100（默认值为100），一般设置为10、20、50。 type 否 Integer 编码服务类型。 0：服务器 1：容器 status 否 Integer 状态列表。 1：运行中 2：异常 3：重启中 4：冻结 5：关机 100、1014、0：创建中 server_id 否 String 云手机服务器的唯一标识。

具体步骤 Token认证，具体操作请参考认证鉴权。 查询云手机列表。发送“GET https://{CPH Endpoint}/v1/{project_id}/cloud-phone/phones?offset=0&limit=100”。 在Request Header中增加“X-Auth-Token”。 请求响应成功后，返回request_id和phones。 若请求失败，则会返回错误码及对应的错误描述信息，详细错误码请参考错误码。 重启云手机。发送“POST https://{CPH Endpoint}/v1/{project_id}/cloud-phone/phones/batch-restart”。 在Request Header中增加“X-Auth-Token”。 在Request Body中传入参数如下： { "phones": [ { "phone_id": "a7f3a1c5258347d6b6f1def79e11f2bc" } ]} 请求响应成功后，返回request_id和 jobs。 若请求失败，则会返回错误码及对应的错误描述信息，详细错误码请参考错误码。 查询任务列表。发送“GET https://{CPH Endpoint}/v1/{project_id}/cloud-phone/jobs?request_id={request_id}”。 在Request Header中增加“X-Auth-Token”。 请求响应成功后，返回request_id和jobs状态列表。 { "request_id": "6a63a18b8bab40ffb71ebd9cb80d0085", "jobs": [ { "phone_id": "1234567b8bab40ffb711234cb80d0234", "server_id": "1e223c8e-3ad0-4bf0-a837-bc90d4f91d01", "node_id": "1e223c8e-3ad0-4bf0-a837-bc90d4f91d01", "job_id": "1564567b8bab40f34711234cb80d0123", "begin_time": "2017-10-25T00:00:00Z", "end_time": "2017-12-26T00:00:00Z", "status": 2, "error_code": "", "error_msg": "" }, …… ]} 若请求失败，则会返回错误码及对应的错误描述信息，详细错误码请参考错误码。

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 request_id String 请求的唯一标识ID。 job_id String 任务的唯一标识。 begin_time String 任务处理开始时间，时间格式为UTC，YYYY-MM-DDTHH:MM:SSZ。 end_time String 任务处理结束时间，时间格式为UTC，YYYY-MM-DDTHH:MM:SSZ。 status Integer 任务状态。 1： 运行中 2： 成功 -1： 失败 phone_id String 云手机的唯一标识，云手机相关任务包含此字段。 server_id String 云手机服务器的唯一标识ID，云手机服务器相关任务包含此字段。 error_msg String 任务错误码说明。 error_code String 任务错误码。 execute_msg String 任务执行返回内容，最长1024个字节。

响应示例 状态码： 200 OK { "error_msg" : null, "execute_msg" : null, "job_id" : "6837531fd3f54550927b930180a706bf", "phone_id" : "9b28fbe50ded4060b8149a47e55dba82", "end_time" : "2019-04-26T07:00:06Z", "begin_time" : "2019-04-26T07:00:00Z", "error_code" : null, "request_id" : "2676a3b4f7df49c297c6775989806d32", "status" : 2}

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 request_id String 请求的唯一标识ID。 phone_models Array of PhoneModel objects 云手机的规格信息。 表5 PhoneModel 参数 参数类型 描述 server_model_name String 云手机服务器的规格名称，不超过64个字节。 phone_model_name String 云手机的规格名称，不超过64个字节。 status Integer 规格状态。 1 表示正常使用状态 0 表示已下线状态 已下线的规格不可用来购买云手机服务器 cpu Integer CPU核数。 memory Integer 内存大小，单位：MB。 disk Integer 系统存储大小，单位：GiB。 resolution String 分辨率，不超过16个字节。 extend_spec String 扩展描述，不超过512个字节。 spec_code String 规格名称，不超过64个字节。 phone_capacity Integer 当前云手机规格包含的云手机个数。 image_label String 镜像类型，只支持如下类型： qemu_phone cloud_phone cloud_phone_1620 cloud_game cloud_game_1620 product_type Integer 产品类型。 0：云手机 1：云手游 phone_model_version Integer 规格版本： 0：规格1.0 1：规格2.0 dpi Integer 每英寸点数。 fps String 渲染帧率。 volume_mode Integer 手机物理磁盘是否独立。 0：不独立 1：独立 render_fps Integer 渲染帧率。 stream_fps Integer 出流帧率。

响应示例 状态码： 200 OK { "phone_models" : [ { "server_model_name" : "physical.rx1.xlarge", "phone_model_name" : "rx1.cp.c60.d32.e1v1.qemu", "status" : 1, "cpu" : 2, "memory" : 3072, "disk" : 32, "resolution" : "540x960", "render_fps" : 60, "stream_fps" : 60, "extend_spec" : "{\"eip_count\": 1, \"vip_count\":1, \"emulator_type\":0, \"bms_image_id\":\"72460777-7fcb-4cae-8bb5-62d93be86bd7\",\"core_bind_strategy\":\"lxc_qemu_common_hosted_c60\", \"sd_disk\": 1}", "spec_code" : "rx1.cp.c60.d32.e1v1.qemu", "phone_capacity" : 60, "image_label" : "qemu_phone", "product_type" : 0 }, { "server_model_name" : "physical.rx1.xlarge", "phone_model_name" : "rx1.cp.c60.d10.e1v1", "status" : 1, "cpu" : 2, "memory" : 3584, "disk" : 10, "resolution" : "720x1280", "render_fps" : 60, "stream_fps" : 60, "extend_spec" : "{\"eip_count\": 1, \"vip_count\":1, \"emulator_type\":1,\"thinpool_size_g\":70, \"sharepool_size_g\":650,\"max_share_disk_size_g\":50,\"encode_server_spec\": {\"cpu\": 2,\"memory\": 14448,\"disk\": 10,\"image_id\":\"coderserver_v2.5\", \"port_num\":0},\"core_bind_strategy\":\"common_hosted_c60\"}", "spec_code" : "rx1.cp.c60.d10.e1v1", "phone_capacity" : 60, "image_label" : "cloud_phone", "product_type" : 0 } ], "request_id" : "e0dd77cb688743468599487ca2a1c738"}

URI GET /v1/{project_id}/cloud-phone/phone-models 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目id。 表2 Query参数 参数 是否必选 参数类型 描述 status 否 Integer 规格状态 0：下线状态 1：正常使用 不传该参数表示查询所有状态的规格。 offset 否 Integer 偏移量为一个大于等于0整数，表示查询该偏移量后面的所有的资源数，默认值为0。 limit 否 Integer 每页返回的资源个数。取值范围：1~100（默认值为100），一般设置为10、20、50。

请求示例 将共享存储文件推送到服务器列表中的服务器上，文件来自于obs桶 POST https://{CPH Endpoint}/v1/{project_id}/cloud-phone/phones/share-files{ "bucket_name" : "bucketA", "object_path" : "my_apps/test.tar", "server_ids" : [ "1234567b8bab40ffb711234cb80d0234", "1678567b8bab40f93711234cb80d0764" ]}

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。 通过调用 IAM 服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 表3 请求Body参数 参数 是否必选 参数类型 描述 bucket_name 是 String 合法的OBS桶名，3-63个字符，只能由小写字母、数字、中划线（-）和小数点组成。仅推送共享存储接口使用。 object_path 是 String 合法的OBS对象路径，最大长度1024字符。仅支持大小写字母、数字、小数点（.）、斜线（/）、中划线（-）、下划线（_）、加号（+）、井号（#）、等号等这些字符。推送的文件只支持tar文件类型。推送时，按tar文件解压后的文件目录结构推送到手机。当前只支持/data和/cache目录推送。仅推送共享存储接口使用。 server_ids 是 Array of strings 云手机服务器ID列表。

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

响应示例 状态码： 200 OK { "request_id" : "6837531fd3f54550927b930180a706bf", "jobs" : [ { "server_id" : "1234567b8bab40ffb711234cb80d0234", "job_id" : "1564567b8bab40f34711234cb80d0123" }, { "server_id" : "1678567b8bab40f93711234cb80d0764", "job_id" : "1564567b8bab40f34711234cb80d5678" } ]}

请求示例 向手机列表中的手机同步执行shell命令，命令为ls -l /system POST https://{CPH Endpoint}/v1/{project_id}/cloud-phone/phones/sync-commands{ "command" : "shell", "content" : "ls -l /system", "phone_ids" : [ "1234567b8bab40ffb711234cb80d0234", "1678567b8bab40f93711234cb80d0764" ]}

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 request_id String 请求的唯一标识ID。 jobs Array of RunSyncCommandJob objects 任务列表。 表5 RunSyncCommandJob 参数 参数类型 描述 phone_id String 云手机的唯一标识，云手机相关任务包含此字段。 job_id String 任务的唯一标识。 status Integer 任务状态 2：成功 1：运行中 -1：失败 error_code String 任务错误码。 error_msg String 任务错误码说明。 execute_msg String 任务执行返回内容，最长1024字节。

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。 通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 表3 请求Body参数 参数 是否必选 参数类型 描述 command 是 String ADB命令，固定填写shell。 content 是 String 待执行的命令。 最大长度为1024字节，只支持大小写字母、数字、下划线（_）、点（.）、斜线（/）、冒号（:）、中划线（-）。 phone_ids 否 Array of strings 云手机ID列表。 server_ids参数不存在时必选，同时存在只处理phone_ids。最多支持传入15个phone_id。 server_ids 否 Array of strings 云手机服务器ID列表。 phone_ids参数不存在时必选，同时存在只处理phone_ids。

响应示例 状态码： 200 OK { "request_id" : "6837531fd3f54550927b930180a706bf", "jobs" : [ { "phone_id" : "1234567b8bab40ffb711234cb80d0234", "job_id" : "3fc17538866a4ff3a014d8bc6aaa4b69", "status" : -1, "error_code" : "CPS.0191", "error_msg" : "Run command failed.", "execute_msg" : "ls: cannot access '/system': No such file or directory" }, { "phone_id" : "1678567b8bab40f93711234cb80d0764", "job_id" : "1564567b8bab40f34711234cb80d5678", "status" : 2, "error_code" : "", "error_msg" : "", "execute_msg" : "xxxxx" } ]}

响应参数 状态码： 200 表6 响应Body参数 参数 参数类型 描述 resources Array of Resource objects 资源列表。 total_count Integer 资源总数。 表7 Resource 参数 参数类型 描述 resource_id String 资源ID。 resource_detail String 资源详情。 resource_name String 资源名称。 tags Array of Tag objects 标签列表。 表8 Tag 参数 参数类型 描述 key String 键。 最大长度127个unicode字符。 不能为空，可以包含任意语种字母、数字、空格和_.：=+-@，不能以_sys_开头。 value String 值列表。 每个值最大长度255个unicode字符。 不能为空，可以包含任意语种字母、数字、空格和_.：=+-@，但首尾不能含有空格。

响应示例 状态码： 200 ok { "resources" : [ { "resource_detail" : null, "resource_id" : "cdfs_cefs_wesas_12_dsad", "resource_name" : "resouece1", "tags" : [ { "key" : "key1", "value" : "value1" }, { "key" : "key2", "value" : "value1" } ] } ], "total_count" : 1000}

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。 通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 表3 请求Body参数 参数 是否必选 参数类型 描述 action 是 String 操作标识（仅限于filter，count）：filter（过滤），count(查询总条数)。 为filter时表示分页查询，为count只需按照条件将总条数返回即可。 offset 否 String 索引位置， 从offset指定的下一条数据开始查询。 查询第一页数据时，不需要传入此参数，查询后续页码数据时，将查询前一页数据时响应体中的值带入此参数。action为count时无此参数。action为filter时，默认为0，必须为数字，且不能为负数。 limit 否 String 查询记录数。 action为count时无此参数。 action为filter时，默认为1000。limit最多为1000，不能为负数，最小值为1。 without_any_tag 否 Boolean 不包含任意一个标签，该字段为true时查询所有不带标签的资源。 tags 否 Array of Tags objects 最多包含10个key，每个key最多包含10个value，结构体不能缺失。key不能为空或者空字符串。key不能重复，同一个key中value不能重复，不同key对应的资源之间为与的关系。 matches 否 Array of Match objects 搜索字段。 key为要匹配的字段，当前只支持resource_name。 value为匹配的值，当前为精确匹配。 表4 Tags 参数 是否必选 参数类型 描述 key 是 String 键。 最大长度127个unicode字符。 key不能为空。 values 是 Array of strings 值列表。 最多10个value。 value不允许重复。 每个值最大长度255个unicode字符。 如果values为空则表示any_value。 value之间为或的关系。 表5 Match 参数 是否必选 参数类型 描述 key 是 String 键。 当前key的参数值只能取“resource_name”，此时value的参数值为资源名称。 value 是 String 值。 当前key的参数值只能取“resource_name”，此时value的参数值为资源名称。

请求示例 查询资源实例数量 Post https://{CPH Endpoint}/v1/{project_id}/{resource_type}/resource_instances/action{ "action" : "count", "tags" : [ { "key" : "key1", "values" : [ "value1", "value2" ] }, { "key" : "key2", "values" : [ "value1", "value2" ] } ], "matches" : [ { "key" : "resource_name", "value" : "resource1" } ]} 查询资源实例列表 Post https://{CPH Endpoint}/v1/{project_id}/{resource_type}/resource_instances/action{ "offset" : "100", "limit" : "100", "action" : "filter", "tags" : [ { "key" : "key1", "values" : [ "value1", "value2" ] }, { "key" : "key2", "values" : [ "value1", "value2" ] } ], "matches" : [ { "key" : "resource_name", "value" : "resource1" } ]}

URI GET /v1/{project_id}/cloud-phone/images 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目id。 表2 Query参数 参数 是否必选 参数类型 描述 image_type 否 String 镜像类型。 private：私有镜像 share：共享镜像 status 否 Integer 镜像状态。 0：CREATING 创建中 1：PRODUCTION 生产态，可使用 2：CREATE_FAILED 创建失败 offset 否 Integer 偏移量为一个大于等于0整数，表示查询该偏移量后面的所有的资源数，默认值为0。 limit 否 Integer 每页返回的资源个数。取值范围：1~100（默认值为100），一般设置为10、20、50。 image_id 否 String 镜像id image_name 否 String 镜像名称 create_since 否 Long 起始时间 create_until 否 Long 截止时间 src_project_id 否 String 共享镜像账号的projectId

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 image_infos Array of ListImagesView objects 镜像详情 total Integer 总条数 request_id String 请求的唯一标识ID。 表5 ListImagesView 参数 参数类型 描述 domain_id String 镜像所属租户 image_name String 镜像名称 update_time String 镜像更新时间 create_time String 镜像创建时间 image_size Long 镜像大小，单位byte project_id String project_id（当image_type为private时，才会返回此字段) image_id String 镜像ID image_version String 镜像AOSP版本 image_type String 镜像类型 私有镜像：private 共享镜像：share status Integer 镜像状态。 0：CREATING 创建中 1：PRODUCTION 生产态，可使用 2：CREATE_FAILED 创建失败 src_project_id String 共享镜像账号的projectId（当image_type为share时，才会返回此字段)

响应示例 状态码： 200 OK { "image_infos" : [ { "domain_id" : "4a2a9967e4514c388a4c945efcbab9d6", "image_name" : "cph-private-image", "update_time" : "2024-04-11T06:38:21Z", "create_time" : "2024-04-11T06:38:21Z", "image_size" : 1306150912, "project_id" : "3a63a229aa6e47bab2153b44a7f3f50d", "image_id" : "23030320230421e300221a2000004433", "image_version" : "AOSP 9.0", "image_type" : "private", "status" : 1 } ], "total" : 1, "request_id" : "bff458ad55f24751b0b226119ab4f9fd"}

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

响应示例 状态码： 200 OK { "request_id" : "6837531fd3f54550927b930180a706bf", "jobs" : [ { "phone_id" : "1234567b8bab40ffb711234cb80d0234", "job_id" : "1564567b8bab40f34711234cb80d0123" }, { "phone_id" : "1678567b8bab40f93711234cb80d0764", "job_id" : "1564567b8bab40f34711234cb80d5678" } ]}

请求示例 在云手机中安装apk POST https://{CPH Endpoint}/v1/{project_id}/cloud-phone/phones/commands{ "command" : "install", "content" : "-t -r obs://push-bucket/my_apps/test.apk", "phone_ids" : [ "1234567b8bab40ffb711234cb80d0234", "1678567b8bab40f93711234cb80d0764" ]} 在云手机中安装多apk POST https://{CPH Endpoint}/v1/{project_id}/cloud-phone/phones/commands{ "command" : "install-multiple", "content" : "-t -r obs://push-bucket/my_apps/test_part1.apk obs://push-bucket/my_apps/test_part_2.apk obs://push-bucket/my_apps/test_part3.apk", "phone_ids" : [ "1234567b8bab40ffb711234cb80d0234", "1678567b8bab40f93711234cb80d0764" ]}

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。 通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 表3 请求Body参数 参数 是否必选 参数类型 描述 command 是 String 安装单apk场景填写install，多apk场景填写install-multiple。 content 是 String 指定OBS桶中的apk文件（需要提前上传到指定桶中）。 只支持大小写字母、数字、下划线（_）、点（.）、斜线（/）、冒号（:）、中划线（-）。推送的文件只支持apk文件类型。 单apk场景，只能传一个apk，最大长度为1024字节；多apk场景，最多传50个apk，中间用空格分开，最大长度8100字节。 phone_ids 否 Array of strings 云手机ID列表。 server_ids参数不存在时必选，同时存在只处理phone_ids。 server_ids 否 Array of strings 云手机服务器ID列表。 phone_ids参数不存在时必选，同时存在只处理phone_ids。

功能介绍 在云手机中安装apk。系统会将指定的apk文件下载后直接安装到云手机中。 支持安装单apk应用和多apk应用。可使用install命令安装单apk应用，一次只支持安装一个apk，如果一次传多个apk只有第一个安装成功；可使用install-multiple命令安装多apk应用（多apk应用为单个应用拆分成多个apk），一次只支持同一个应用的多个apk。该接口为异步接口。接口调用前请先确保已完成CPH服务操作OBS桶的委托授权。委托CPH操作OBS桶请参见委托CPH操作OBS桶。 管理面性能有限，对相同服务器批量执行的ADB命令，将会阻塞云手机其他任务执行。 允许安装的apk大小限制为2G（即不可将obs桶内大于2G的apk安装到手机中），超过限制将返回错误。