华为云用户手册

URI POST /v1/{project_id}/{resource_type}/{resource_id}/tags/action 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目id。 resource_type 是 String 资源类型。 cph-server，云手机服务器 枚举值： cph-server resource_id 是 String 资源ID。

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

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

响应参数 状态码： 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 Integer 云手机实例的访问端口 session_id String 本次接入的会话ID timestamp String 时间戳 ticket String 签名令牌 表7 ConnectErrorInfo 参数 参数类型 描述 phone_id String 云手机的唯一标识ID。 error_code String 错误码。 error_msg String 错误说明。

请求参数 表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

响应示例 状态码： 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。

响应参数 状态码： 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 系统存储大小，单位：GB。 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：独立

响应参数 状态码： 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个字节。

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

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：普通云手机

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 request_id String 请求的唯一标识ID。 band_widths Array of Bandwidth objects 带宽信息。 表5 Bandwidth 参数 参数类型 描述 band_width_name String 云手机服务器的带宽名称。 band_width_id String 云手机服务器的带宽唯一标识。 band_width_size Integer 云手机服务器的带宽大小。 band_width_charge_mode Integer 云手机服务器带宽的计费方式。 0：bandwidth, 按带宽计费 1：traffic, 按流量计费 band_width_share_type Integer 云手机服务器的带宽类型。 0：per，独享带宽 1：whole，共享带宽 create_time String 带宽创建时间， 时间格式为UTC，YYYY-MM-DDTHH:MM:SSZ。 update_time String 带宽更新时间， 时间格式为UTC，YYYY-MM-DDTHH:MM:SSZ。

响应示例 状态码： 200 OK { "request_id" : "70bb40bef50e4a14b116a5a527fd7432", "band_widths" : [ { "band_width_id" : "70bb40-bef5-0e4a-14b116-a5a527fd7432", "band_width_name" : "BANDWIDTH_70bb40bef50e4a14b116a5a527fd7432", "band_width_size" : 300, "band_width_share_type" : 1, "create_time" : "2017-10-10T00:00:00Z", "update_time" : "2018-11-12T00:00:00Z" } ] }

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

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。 通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 表3 请求Body参数 参数 是否必选 参数类型 描述 action 是 String 操作标识。 create：创建 tags 是 Array of Tag objects 标签列表。 表4 Tag 参数 是否必选 参数类型 描述 key 是 String 键。 最大长度127个unicode字符。 不能为空，可以包含任意语种字母、数字、空格和_.：=+-@，但首尾不能含有空所有服务均可在标签输入框下拉选择同一标格，不能以_sys_开头。 value 是 String 值列表。 每个值最大长度255个unicode字符。 不能为空，可以包含任意语种字母、、数字、空格和_.：=+-@，但首尾不能含有空格。

请求示例 批量添加标签 Post https://{CPH Endpoint}/v1/{project_id}/{resource_type}/{resource_id}/tags/action { "action" : "create", "tags" : [ { "key" : "key1", "value" : "value1" }, { "key" : "key2", "value" : "value2" } ] }

URI POST /v1/{project_id}/{resource_type}/{resource_id}/tags/action 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目id。 resource_type 是 String 资源类型。 cph-server，云手机服务器 枚举值： cph-server resource_id 是 String 资源ID。

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 tags Array of Tag objects 资源标签列表。 表4 Tag 参数 参数类型 描述 key String 键。 最大长度127个unicode字符。 不能为空，可以包含任意语种字母、数字、空格和_.：=+-@，但首尾不能含有空所有服务均可在标签输入框下拉选择同一标格，不能以_sys_开头。 value String 值列表。 每个值最大长度255个unicode字符。 不能为空，可以包含任意语种字母、、数字、空格和_.：=+-@，但首尾不能含有空格。

响应示例 状态码： 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。 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 云手机服务器的唯一标识。

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

请求示例 查询资源实例数量 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" } ] }

响应参数 状态码： 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字符。 不能为空，可以包含任意语种字母、、数字、空格和_.：=+-@，但首尾不能含有空格。

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。 通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 表3 请求Body参数 参数 是否必选 参数类型 描述 action 是 String 操作标识（仅限于filter，count）：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的参数值为资源名称。 枚举值： resource_name value 是 String 值。 当前key的参数值只能取“resource_name”，此时value的参数值为资源名称。

支持的授权项 策略包含系统策略和自定义策略，如果系统策略不满足授权要求，管理员可以创建自定义策略，并通过给用户组授予自定义策略来进行精细的访问控制。策略支持的操作与API相对应，授权项列表说明如下： 权限：允许或拒绝某项操作。 对应API接口：自定义策略实际调用的API接口。 授权项：自定义策略中支持的Action，在自定义策略中的Action中写入授权项，可以实现授权项对应的权限功能。 依赖的授权项：部分Action存在对其他Action的依赖，需要将依赖的Action同时写入授权项，才能实现对应的权限功能。 IAM项目(Project)/企业项目(Enterprise Project)：自定义策略的授权范围，包括IAM项目与企业项目。授权范围如果同时支持IAM项目和企业项目，表示此授权项对应的自定义策略，可以在IAM和企业管理两个服务中给用户组授权并生效，目前CPH暂不支持企业项目授权。关于IAM项目与企业项目的区别，详情请参见：IAM与企业管理的区别。 “√”表示支持，“×”表示暂不支持。 CPH的支持自定义策略授权项如表1所示。 表1 CPH自定义策略授权项 权限 对应API接口 授权项（Action） IAM项目 (Project) 企业项目 (Enterprise Project) 创建云手机服务器 POST /v2/{project_id}/cloud-phone/servers cph:servers:create √ √ 删除云手机服务器 DELETE /v2/{project_id}/cloud-phone/servers cph:servers:delete √ √ 切换云手机服务器 POST /v2/{project_id}/cloud-phone/servers/{server_id}/change cph:servers:change √ √ 查询云手机服务器列表 GET /v1/{project_id}/cloud-phone/servers cph:servers:list √ √ 查询云手机服务器详情 GET /v1/{project_id}/cloud-phone/servers/{server_id} cph:servers:get √ √ 查询云手机服务器规格列表 GET /v1/{project_id}/cloud-phone/server-models cph:system:listServerTypes √ × 修改云手机服务器名称 PUT /v1/{project_id}/cloud-phone/servers/{server_id} cph:servers:updateName √ √ 变更云手机服务器规格 POST /v1/{project_id}/cloud-phone/servers/change-server-model cph:servers:changeType √ √ 重启云手机服务器 POST /v1/{project_id}/cloud-phone/servers/batch-restart cph:servers:restart √ √ 推送共享存储文件 POST /v1/{project_id}/cloud-phone/phones/share-files cph:servers:pushShareFiles √ √ 查询共享存储文件 GET /v1/{project_id}/cloud-phone/servers/share-files cph:servers:getShareFiles √ √ 删除共享存储文件 POST /v1/{project_id}/cloud-phone/phones/share-files cph:servers:deleteShareFiles √ √ 推送共享应用 POST /v1/{project_id}/cloud-phone/phones/share-apps cph:servers:pushShareApps √ √ 删除共享应用 DELETE /v1/{project_id}/cloud-phone/phones/share-apps cph:servers:deleteShareApps √ √ 更改密钥对 PUT /v1/{project_id}/cloud-phone/servers/open-access cph:servers:updateKeypair √ √ 查询编码服务 GET /v1/{project_id}/cloud-phone/encode-servers cph:servers:listEncodeServers √ √ 重启编码服务 POST /v1/{project_id}/cloud-phone/encode-servers/batch-restart cph:servers:restartEncodeServers √ √ 查询带宽信息 GET /v1/{project_id}/cloud-phone/bandwidths cph:bandwidths:list √ × 修改共享带宽 PUT /v1/{project_id}/cloud-phone/bandwidths/{band_width_id} cph:bandwidths:put √ × 查询云手机列表 GET /v1/{project_id}/cloud-phone/phones cph:phones:list √ √ 查询云手机详情 GET /v1/{project_id}/cloud-phone/phones/{phone_id} cph:phones:get √ √ 查询云手机规格列表 GET /v1/{project_id}/cloud-phone/phone-models cph:system:listPhoneSpecifications √ × 重置云手机实例 POST /v1/{project_id}/cloud-phone/phones/batch-reset cph:phones:reset √ √ 重启云手机实例 POST /v1/{project_id}/cloud-phone/phones/batch-restart cph:phones:restart √ √ 关闭云手机实例 POST /v1/{project_id}/cloud-phone/phones/batch-stop cph:phones:stop √ √ 修改云手机名称 PUT /v1/{project_id}/cloud-phone/phones/{phone_id} cph:phones:updateName √ √ 更新云手机属性 POST /v1/{project_id}/cloud-phone/phones/batch-update-property cph:phones:updateProperty √ √ 导出云手机数据 POST /v1/{project_id}/cloud-phone/phones/batch-storage cph:phones:storage √ √ 恢复云手机数据 POST /v1/{project_id}/cloud-phone/phones/batch-restore cph:phones:restore √ √ 云手机流量导流 POST /v1/{project_id}/cloud-phone/phones-traffic cph:phones:createTrafficRoute √ √ 云手机磁盘扩容 POST /v1/{project_id}/cloud-phone/phones/expand-volume cph:phones:expandVolume √ √ 获取云手机连接信息 POST /v1/{project_id}/cloud-phone/phones/batch-connection cph:phones:getConnections √ √ 执行异步adb shell命令 POST /v1/{project_id}/cloud-phone/phones/commands cph:phones:execCommands √ √ 执行同步adb shell命令 POST /v1/{project_id}/cloud-phone/phones/sync-commands cph:phones:execSyncCommands √ √ 查询任务执行状态 GET /v1/{project_id}/cloud-phone/jobs/{job_id} cph:jobs:get √ × 查询任务执行状态列表 GET /v1/{project_id}/cloud-phone/jobs cph:jobs:list √ × 批量添加标签 POST /v1/{project_id}/{resource_type}/{resource_id}/tags/action cph:resource:tagResource √ √ 批量删除标签 POST /v1/{project_id}/{resource_type}/{resource_id}/tags/action cph:resource:unTagResource √ √ 查询资源实例 POST /v1/{project_id}/{resource_type}/resource_instances/action cph:resource:listResourcesByTag √ √ 查询资源标签 GET /v1/{project_id}/{resource_type}/{resource_id}/tags cph:resource:listTagsForResource √ √ 查询项目标签 GET /v1/{project_id}/{resource_type}/tags cph:resource:listTags √ √ 获取手机镜像列表 GET /v1/{project_id}/cloud-phone/images cph:images:list √ × 删除手机镜像 DELETE /v1/{project_id}/cloud-phone/images/{image_id} cph:images:delete √ × 手机镜像共享 POST /v1/{project_id}/cloud-phone/images/{image_id}/members cph:images:addMembers √ × 获取手机镜像共享用户列表 GET /v1/{project_id}/cloud-phone/images/{image_id}/members cph:images:listMembers √ × 手机镜像取消共享 DELETE /v1/{project_id}/cloud-phone/images/{image_id}/members/{member_id} cph:images:deleteMembers √ × 获取可用区列表 GET /v1/{project_id}/cloud-phone/availability-zones cph:system:listServerTypesSoldOutStatus √ × 获取子网列表 GET /v1/{project_id}/cloud-phone/subnets cph:system:listSubnets √ × 查询对等连接配置 GET /v1/{project_id}/cloud-phone/peering-routes cph:system:listPeerings √ × 删除对等连接配置 DELETE /v1/{project_id}/cloud-phone/peering-routes cph:system:deletePeerings √ × 添加对等连接配置 POST /v1/{project_id}/cloud-phone/peering-routes cph:system:createPeerings √ × 导出云手机详情 GET /v1/{project_id}/cloud-phone/phones/phone-export cph:phones:exportDetails √ √ 创建委托 POST /v1/{project_id}/agencies cph:system:createAgencies √ × 检查委托 GET /v1/{project_id}/agencies cph:system:checkAgencies √ ×

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。 通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 表3 请求Body参数 参数 是否必选 参数类型 描述 band_width_size 是 Integer 小于等于300Mbit/s：默认最小增长步长为1Mbit/s。 300Mbit/s~1000Mbit/s：默认最小增长步长为50Mbit/s。 大于1000Mbit/s：默认最小增长步长为500Mbit/s。

功能介绍 推送文件到云手机文件系统中。系统会将所指定的文件下载解压后，将解压后的内容全部推送到云手机的根目录下。只支持指定tar格式的文件进行推送，您需要将tar文件提前上传至您的OBS桶中。该接口为异步接口。接口调用前请先确保已完成CPH服务操作OBS桶的委托授权。委托CPH操作OBS桶请参见委托CPH操作OBS桶。 管理面性能有限，对相同服务器批量执行的ADB命令，将会阻塞云手机其他任务执行。 允许推送的文件大小限制为6G（即不可将obs桶内大于6G的文件推送到手机中），超过限制将返回错误。 手机的系统有限制，推送到系统盘不保证推送成功，推荐把文件推送到手机的数据盘。所以在构建"tar"文件时，应将待推送的文件放到本地创建的data目录后将其打包（如tar -cvf data.tar data ），以确保把文件推送到手机的数据盘下。

响应参数 状态码： 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" } ] }