华为云用户手册

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。 通过调用 IAM 服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 表3 请求Body参数 参数 是否必选 参数类型 描述 phones 是 Array of PhoneDataVolumeSize objects 云手机列表。 表4 PhoneDataVolumeSize 参数 是否必选 参数类型 描述 phone_id 是 String 云手机id new_size 是 Integer 扩容后的手机数据盘大小，单位为GiB。扩容的大小必须大于等于原有容量且小于最大容量。 最大容量：32768GiB

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

响应参数 状态码：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 错误说明。

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

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

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

响应参数 状态码：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个字节。 is_support_encrypt Boolean 当前镜像是否支持文件级加密

响应参数 状态码：200 表4 响应Body参数 参数 参数类型 描述 request_id String 请求的唯一标识ID。 count Integer 实例总数。 servers Array of Server objects 云手机服务器信息。 表5 Server 参数 参数类型 描述 server_name String 云手机服务器名称，不超过65字符，只支持英文字母、数字、汉字、下划线和中划线。 availability_zone String 云手机服务器所在的可用区。如上海一可用区1为cn-east-3a。 server_id String 云手机服务器的唯一标识，不超过32个字节。 server_model_name String 云手机服务器规格名称，不超过64个字节。 phone_model_name String 云手机规格名称，不超过64个字节。 keypair_name String 连接云手机所使用的密钥对的名称，不超过64个字节。 status Integer 服务器状态。 0、1、3、4：创建中 2：异常 5：正常 8：冻结 10：关机 11：关机中 12：关机失败 13：开机中 vpc_id String 云手机服务器所属虚拟私有云（简称VPC）的ID。 网络版本network_version取值为“v1”时，表示云手机服务器所属资源租户的VPC ID；取值为“v2”时，表示租户创建服务器时指定VPC的 VPC ID。 cidr String 云手机服务器所属虚拟私有云（简称VPC）的网段。网络版本 network_version 取值为“v1”时，表示云手机服务器所属资源租户的VPC CIDR；取值为“v2”时，表示租户创建服务器时指定 VPC 的 VPC CIDR。 vpc_cidr String 云手机服务器所属虚拟私有云（简称VPC 网络版本 network_version 取值为“v1”时，表示云手机服务器所属资源租户的VPC CIDR；取值为“v2”时，表示租户创建服务器时指定 VPC 的 VPC CIDR subnet_id String 云手机服务器所属子网的ID。仅在网络版本 network_version 取值为“v2”时，该取值表示租户创建服务器时指定子网的 ID，网络版本取值为“v1”时，该字段表示云手机服务器所属资源租户的子网ID。 subnet_cidr String 云手机服务器所属子网网段。网络版本 network_version 取值为“v2”时，表示租户创建服务器时指定子网的 CIDR; 取值为“v1”时，表示云手机服务器所属资源租户的子网CIDR。 addresses Array of Address objects 云手机服务器的IP相关信息。 resource_project_id String 云手机服务器的项目ID。用于对使用系统定义网络的服务器创建对等连接，并非租户的项目ID。 metadata metadata object 订单以及产品相关信息。 network_version String 是否为自定义网络的云手机服务器标识。"v1"，非自定义网络的云手机服务器。 "v2"，自定义网络的云手机服务器。支持按照网络版本字段进行筛选。 enterprise_project_id String 云手机服务器所属企业项目ID。 create_time String 创建时间， 时间格式为UTC，YYYY-MM-DDTHH:MM:SSZ。 update_time String 更新时间， 时间格式为UTC，YYYY-MM-DDTHH:MM:SSZ。 表6 Address 参数 参数类型 描述 intranet_ip String 云手机服务器的内网IP，过期字段。 access_ip String 云手机服务器的公网IP，过期字段。 server_ip String 云手机服务器的内网IP，新增字段。 public_ip String 云手机服务器的公网IP，新增字段。 表7 metadata 参数 参数类型 描述 product_id String 订单ID，不超过64个字节。 order_id String 产品ID，不超过64个字节。 charging_mode Integer 计费类型。 0：包周期

响应示例 状态码：200 OK { "servers" : [ { "server_name" : "cph-edgr-1", "server_id" : "4aff349ab539452a85ac5d7442b39377", "server_model_name" : "physical.rx1.xlarge", "phone_model_name" : "rx1.cp.c105.d6.e5v5", "keypair_name" : "keypair01", "status" : 2, "vpc_id" : "9a11e291-967f-4dd6-99bd-9be54f10583c", "cidr" : "192.168.0.0/16", "vpc_cidr" : "192.168.0.0/16", "subnet_id" : "c7f9983d-03ca-4a2e-a0e1-d6bd97174669", "subnet_cidr" : "192.168.0.0/24", "addresses" : [ { "intranet_ip" : "192.168.0.62", "server_ip" : "192.168.0.62", "access_ip" : "10.246.175.190", "public_ip" : "10.246.175.190" }, { "intranet_ip" : "192.168.0.169", "server_ip" : "192.168.0.169", "access_ip" : "10.246.171.245", "public_ip" : "10.246.171.245" } ], "resource_project_id" : "06a5b529fa80d28b2f53c014024bed44", "metadata" : { "product_id" : "00301-221014-0--0", "order_id" : " CS 21111116336E8RX", "charging_mode" : 0 }, "availability_zone" : "xxxxxx", "network_version" : "v2", "create_time" : "2021-11-11T08:33:40Z", "update_time" : "2021-11-11T09:28:30Z" }, { "server_name" : "cph-igfp-2", "server_id" : "6d74b672216d40f39377a99e7f95aa95", "server_model_name" : "physical.kg1m.4xlarge.cg", "phone_model_name" : "kg1m.cg.c60.d20SSD.e1v1", "keypair_name" : "KeyPair-2", "status" : 2, "vpc_id" : "12021c68-730f-41fa-9884-11c616f4c9ad", "cidr" : "172.31.0.0/16", "vpc_cidr" : "172.31.0.0/16", "subnet_id" : "92cf2447-163c-4fe8-897b-fd262ab6b134", "subnet_cidr" : "172.31.0.0/16", "addresses" : [ { "intranet_ip" : "172.31.185.82", "access_ip" : "88.88.48.151", "server_ip" : "172.31.185.82", "public_ip" : "88.88.48.151" } ], "resource_project_id" : "06a5b529fa80d28b2f53c014024bed44", "metadata" : { "product_id" : "OFFI635412973496623104", "order_id" : "CS21083015171L1CA", "charging_mode" : 0 }, "availability_zone" : "xxxxxx", "network_version" : "v1", "create_time" : "2021-08-30T07:17:40Z", "update_time" : "2021-11-05T09:07:57Z" } ], "request_id" : "4336f6c61d2048c6b58b4368d9d95ecd", "count" : 2 }

URI GET /v1/{project_id}/cloud-phone/servers 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目id。 表2 Query参数 参数 是否必选 参数类型 描述 offset 否 Integer 偏移量为一个大于等于0整数，表示查询该偏移量后面的所有的资源数，默认值为0。 limit 否 Integer 每页返回的资源个数。取值范围：1~100（默认值为100），一般设置为10、20、50。 server_name 否 String 云手机服务器名称，支持模糊查询。 server_id 否 String 云手机服务器的唯一标识。 network_version 否 String 云手机服务器是否为自定义网络标识。 v1：系统定义网络的云手机服务器 v2：自定义网络的云手机服务器 phone_model_name 否 String 手机规格名称。 create_since 否 Long 查询的起始时间戳。 create_until 否 Long 查询的结束时间戳。 status 否 Integer 服务器状态。 0、1、3、4：创建中 2：异常 5：正常 8：冻结 10：关机 11：关机中 12：关机失败 13：开机中

响应示例 状态码：200 OK { "request_id" : "4d4aefaa7b1d4a2bb5637e9d5631342f", "server_models" : [ { "server_model_name" : "physical.rx1.xlarge", "server_type" : "Hi1616", "cpu" : 64, "memory" : 256, "extend_spec" : { "cpu" : "Hi1616(2*32Core*2.4GHz)", "memory" : "DDR4 RAM ", "disk" : "2*1.2T SAS + 800G SSD", "network_interface" : "2 x 2*10GE", "gpu" : "3*WX5100", "bms_flavor" : "physical.rg1.xlarge.cph.ondemand", "gpu_count" : 3, "numa_count" : 4 }, "product_type" : 0, "free_size" : 0 } ] }

响应参数 状态码：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个字节。 disk_max_num Integer 云手机服务器最大挂载磁盘数量。值为0时表示该机型磁盘为本地盘。 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 操作系统盘类型

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

请求示例 批量重启encode_server_ids列表中的服务器上的编码容器 POST https://{CPH Endpoint}/v1/{project_id}/cloud-phone/encode-servers/batch-restart { "encode_server_ids" : [ "d5cfa92995da40168c39b38d2aa478b3", "00b00d1b35094f13b360cdfe15a9bfee" ] }

响应示例 状态码：200 OK { "jobs" : [ { "job_id" : "e9d7b1a2572c4f2c9bf056a3d1b35e39", "encode_server_id" : "d5cfa92995da40168c39b38d2aa478b3" }, { "job_id" : "4d0a42447cac4c9697b97f07934b74bd", "encode_server_id" : "00b00d1b35094f13b360cdfe15a9bfee" } ], "request_id" : "c775bdf09bc0400a9138199b346cab62" }

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

响应参数 状态码：200 表3 响应Body参数 参数 参数类型 描述 tags Array of Tags objects 资源标签列表。 表4 Tags 参数 参数类型 描述 key String 键。 最大长度127个unicode字符。 key不能为空。 values Array of strings 值列表。 最多10个value。 value不允许重复。 每个值最大长度255个unicode字符。 如果values为空则表示any_value。 value之间为或的关系。

响应示例 状态码：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, "type" : 0, "availability_zone" : "xxxxxx", "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" }

响应参数 状态码：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码。 type Integer 云手机类型。 0：普通云手机 traffic_type String 手机路由类型。 direct：默认路由 routing：路由到编码容器 volume_mode Integer 手机物理磁盘是否独立。 0：不独立 1：独立 availability_zone String 云手机服务器所在的可用区。如上海一可用区1为cn-east-3a。 has_encrypt Boolean 当前手机是否开启文件级加密。 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 云手机数据盘大小。

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。 通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 表3 请求Body参数 参数 是否必选 参数类型 描述 traffic_type 是 String 手机路由类型。 direct：默认路由 routing：路由到编码容器 phone_ids 是 Array of strings 手机id列表，一次调用最多支持100个。

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

请求示例 在共享存储目录中删除共享存储文件，该功能仅在支持共享存储的云手机规格上可实现 POST https://{CPH Endpoint}/v1/{project_id}/cloud-phone/phones/share-files { "file_paths" : [ "/data/app", "/data/data/test.apk" ], "server_ids" : [ "1234567b8bab40ffb711234cb80d0234", "1678567b8bab40f93711234cb80d0764" ] }

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。 通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 表3 请求Body参数 参数 是否必选 参数类型 描述 server_ids 是 Array of strings 云手机服务器ID列表。 file_paths 是 Array of strings 所需删除的共享存储文件绝对路径。以/开头，最大长度4096字节，目前只支持大小写字母、数字、点（.）、斜线（/）、中划线（-）、空格、下划线（_）、等号（=），不支持中文。路径中不能包含.. 上层目录路径，防止跨目录攻击。

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

请求示例 将共享存储文件推送到服务器列表中的服务器上，文件来自于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" ] }