云服务器内容精选

  • 响应参数 状态码: 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" } ] }
  • 请求参数 表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 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" ] }
  • 功能介绍 在云手机中安装apk。系统会将指定的apk文件下载后直接安装到云手机中。 支持安装单apk应用和多apk应用。可使用install命令安装单apk应用,一次只支持安装一个apk,如果一次传多个apk只有第一个安装成功;可使用install-multiple命令安装多apk应用(多apk应用为单个应用拆分成多个apk),一次只支持同一个应用的多个apk。该接口为异步接口。接口调用前请先确保已完成CPH服务操作OBS桶的委托授权。委托CPH操作OBS桶请参见委托CPH操作OBS桶。 管理面性能有限,对相同服务器批量执行的ADB命令,将会阻塞云手机其他任务执行。 建议通过开发应用市场的方式安装apk。允许安装的apk大小限制为2G(即不可将obs桶内大于2G的apk安装到手机中),超过限制将返回错误。
  • 功能介绍 推送应用tar文件至共享应用存储目录中,该功能仅在支持共享应用的云手机服务器上可实现。接口调用前请先确保已完成CPH服务操作OBS桶的委托授权。委托CPH操作OBS桶请参见委托CPH操作OBS桶。 注意:不能向低版本服务器推送高版本手机导出的应用包,否则可能会造成兼容性问题。如果您使用的是physical.kg1.4xlarge.a.cp服务器规格,请确保共享应用的可用空间大于两倍的tar包
  • 响应参数 状态码: 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 错误说明。
  • 请求示例 将应用推送到服务器列表中的服务器上,应用来自于obs桶中 POST https://{CPH Endpoint}/v1/{project_id}/cloud-phone/phones/share-apps { "package_name" : "com.miniteck.miniworld", "bucket_name" : "bucket", "object_path" : "my_apps/test.tar", "server_ids" : [ "1234567b8bab40ffb711234cb80d0234", "1678567b8bab40f93711234cb80d0764" ] }
  • 响应示例 状态码: 200 OK { "request_id" : "6837531fd3f54550927b930180a706bf", "jobs" : [ { "server_id" : "1234567b8bab40ffb711234cb80d0234", "job_id" : "1564567b8bab40f34711234cb80d0123" }, { "server_id" : "1678567b8bab40f93711234cb80d0764", "job_id" : "1564567b8bab40f34711234cb80d5678" } ] }
  • 请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。 通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。 表3 请求Body参数 参数 是否必选 参数类型 描述 package_name 是 String 合法的应用包名。 pre_install_app 否 Integer 是否预装应用。 1:预装 0:不预装;默认不预装 bucket_name 是 String 合法的OBS桶名,3-63个字符,只能由小写字母、数字、中划线(-)和小数点组成 object_path 是 String 合法的OBS对象key,最大长度1024字符。仅支持大小写字母、数字、小数点(.)、斜线(/)、中划线(-)、下划线(_)、加号(+)、井号(#)、等号等这些字符。 推送的文件只支持tar文件类型。推送时,按tar文件解压后的文件目录结构推送到手机。 server_ids 是 Array of strings 云手机服务器ID列表。
  • 请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。 通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。 表3 请求Body参数 参数 是否必选 参数类型 描述 server_name 是 String 云手机服务器名称,必须为小写字母(a-z)、大写字母(A-Z)、数字(0-9)、中文字符、中划线-、下划线_,且不得超过60个字符。
  • 响应参数 状态码: 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:独立
  • 响应示例 状态码: 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 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" : [ ] }