云服务器内容精选

  • 响应示例 状态码: 200 OK { "server_name" : "cph-418540-1620-40-old-1", "availability_zone" : "br-iaas-odin1a", "addresses" : [ { "public_ip" : "10.246.xxx.xxx", "server_ip" : "172.31.22.245", "intranet_ip" : "172.31.22.245", "access_ip" : "10.246.xxx.xxx" } ], "metadata" : { "product_id" : "OFFI451249149551403012", "order_id" : " CS 2007271727F9XJE" }, "create_time" : "2020-01-01T00:00:00Z", "vpc_id" : "12021c68-730f-41fa-9884-11c616f4c9ad", "phone_model_name" : "kg1.cg.c40.d30SSD.e1v1.old", "subnet_cidr" : "172.31.0.0/16", "keypair_name" : "KeyPair-1230", "resource_project_id" : "06a5b529fa80d28b2f53c014024bed44", "server_id" : "6edb89150bc742aa81fc8ac4ff047297", "server_model_name" : "physical.kg1.4xlarge.cg", "update_time" : "2020-01-01T00:00:00Z", "cidr" : "172.31.0.0/16", "vpc_cidr" : "172.31.0.0/16", "subnet_id" : "5784d2fe-fefd-42f0-a7f1-e88454d8bc0f", "request_id" : "91d5bf46a817466daa25fc5824ab9717", "status" : 5, "network_version" : "v1", "security_groups" : [ ] }
  • 响应参数 状态码: 200 表3 响应Body参数 参数 参数类型 描述 request_id String 请求的唯一标识ID。 server_name String 云手机服务器名称, 不超过65字符,只支持英文字母、数字、汉字、下划线和中划线。 availability_zone String 云手机服务器所在的可用区。 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。 resource_project_id String 云手机服务器的项目ID。用于对使用系统定义网络的服务器创建对等连接,并非租户的项目ID。 metadata metadata object 订单以及产品相关信息。 addresses Array of Address objects 云手机服务器的IP相关信息。 band_widths Array of Bandwidth objects 云手机服务器带宽信息的结构体数组。 volumes Array of Volume objects 云手机服务器卷信息的结构体数组。 share_volume_info share_volume_info object 云手机服务器的共享存储相关信息。 network_version String 是否为自定义网络的云手机服务器标识。"v1",非自定义网络的云手机服务器。"v2",自定义网络的云手机服务器。支持按照网络版本字段进行筛选。 enterprise_project_id String 云手机服务器所属企业项目ID。 security_groups Array of strings 服务器扩展网卡绑定的安全组信息。 系统定义网络的服务器,该字段返回为空列表。 create_time String 创建时间, 时间格式为UTC,YYYY-MM-DDTHH:MM:SSZ。 update_time String 更新时间, 时间格式为UTC,YYYY-MM-DDTHH:MM:SSZ。 表4 metadata 参数 参数类型 描述 charging_mode Integer 计费类型。 0:包周期 product_id String 产品ID,不超过64个字节。 order_id String 订单ID,不超过64个字节。 表5 Address 参数 参数类型 描述 intranet_ip String 云手机服务器的内网IP,过期字段。 access_ip String 云手机服务器的公网IP,过期字段。 server_ip String 云手机服务器的内网IP,新增字段。 public_ip String 云手机服务器的公网IP,新增字段。 表6 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。 表7 Volume 参数 参数类型 描述 volume_name String 云手机服务器的硬盘名称。 volume_id String 云手机服务器的硬盘唯一标识。 volume_size Integer 云手机服务器的硬盘大小,单位G。 volume_type String 云手机服务器的硬盘类型。 create_time String 硬盘创建时间, 时间格式为UTC,YYYY-MM-DDTHH:MM:SSZ。 update_time String 硬盘更新时间, 时间格式为UTC,YYYY-MM-DDTHH:MM:SSZ。 表8 share_volume_info 参数 参数类型 描述 volume_type String 共享存储磁盘类型。 size Integer 共享存储大小,单位G。 version Integer 共享存储版本: 0:共享存储1.0 1:共享存储2.0
  • API概览 通过调用云手机服务器服务提供的接口,您可以完整地使用云手机的所有功能。例如查询云手机列表、重启云手机、为云手机推送文件。 表1 云手机服务器接口说明 类型 子类型 说明 云手机服务器 云手机服务器管理 包括查询云手机服务器列表、查询云手机服务器规格列表、购买云手机服务器等接口。 带宽管理 包括查询带宽信息、修改共享带宽接口。 手机实例管理 包括查询云手机列表、查询云手机镜像、重置云手机、重启云手机等接口。 任务管理 包括查询任务执行状态、查询任务执行状态列表接口。 密钥管理 您可通过该接口修改连接云手机的密钥对。 编码服务管理 您可通过该接口查询和重启编码服务。 ADB命令 包含推送文件、安装apk、卸载apk等接口。 标签管理 包括查询项目标签、查询资源标签、查询资源实例等接口。
  • 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参数 参数 参数类型 描述 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 云手机状态。 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 订单以及产品相关信息。 has_encrypt Boolean 当前手机是否开启文件级加密 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" } ] }
  • 响应示例 状态码: 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" : "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" }
  • 响应参数 状态码: 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 云手机服务器所在的可用区。 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 云手机数据盘大小。
  • 响应参数 状态码: 200 表4 响应Body参数 参数 参数类型 描述 request_id String 请求的唯一标识ID。 count Integer 实例总数。 servers Array of Server objects 云手机服务器信息。 表5 Server 参数 参数类型 描述 server_name String 云手机服务器名称,不超过65字符,只支持英文字母、数字、汉字、下划线和中划线。 availability_zone String 云手机服务器所在的可用区。 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" : "CS21111116336E8RX", "charging_mode" : 0 }, "availability_zone" : "br-iaas-odin1a", "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" : "br-iaas-odin1a", "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:开机中
  • 配置云手机服务器国内流量分流(可选) 参考以上“操作步骤”第6步,在国内云手机所在Region,购买EIP、公网NAT网关,并配置好SNAT规则。此处有一个差异,不需要配置路由表目的地址0.0.0.0/0到NAT网关。 参考以上“操作步骤”第2、3步,进入云手机服务器详情页面,找到“路由表”。 单击路由表名称,进入路由表页面,单击“添加路由”。 在弹出的对话框中,目的地址输入需要分流到国内的IP地址或网段,下一跳类型选择“NAT网关”,下一跳选择第1步购买的公网NAT网关,然后确定。 如果有其它IP地址或网段需要分流,重复第4步添加。
  • 操作步骤 参考推送应用tar包至服务器共享空间,推送需要预装的应用tar包到服务器共享空间,将pre_install_app设置为1。 重置云手机,所有预装应用会自动安装。 预装应用的安装过程会占用一定的手机重置时间。 若云手机正在使用中,无法重置进行重置,也可使用appctrl install命令直接安装应用。 取消应用的预装,参考推送应用tar包至服务器共享空间,再次推送该应用的tar包并将pre_install_app参数设置为0;再次重置云手机时,该应用不会自动安装到云手机中。
  • 发布时间:2022-06-20 镜像ID 新增特性 BUG修复 physical.rx1.xlarge规格的镜像ID: 22050020220530e101210a300000012f physical.kg1.4xlarge.cp规格的镜像ID: 22050020220530e201220a2000000104 集成音视频3.0 sdk 支持命令行动态修改系统语言 兼容性提升 修复部分场景花屏问题 修复系统盘磁盘空间满的问题 修复部分场景摄像头崩溃问题
  • 发布时间:2022-01-10 镜像ID 新增特性 BUG修复 physical.rx1.xlarge规格的镜像ID: 21120220220105e101110a3000000d6b physical.kg1.4xlarge.cp规格的镜像ID: 21120220220105e201120a2000000ed2 图形处理优化 Logcat日志持久化 修复am restart功能异常 修复dumpsys display功能异常