购买系统定义网络云手机服务器

功能介绍

● 接口名称

CreateCloudPhoneServer

● 功能描述

购买系统定义网络的云手机服务器。

说明

云手机网络配置分为两种模式：

● 自定义网络：自定义网络是云手机全新一代网络配置管理模式，支持您复用已有的VPC 网络管理云手机服务器，支持云手机服务器复用您已购买的共享带宽等资源，自定义网 络当前仅支持“西南-贵阳一”区域。

● 系统定义网络：系统定义网络是云手机第一代网络模式，由系统为您的云手机服务器自 动创建VPC网络及带宽，不支持复用您已有的VPC网络及带宽资源。

URI

POST /v1/{project_id}/cloud-phone/phones 参数说明请参见表5-12。

表5-12 参数说明

参数 是否必选 参数类型 描述

project_id 是 String 项目ID

获取方式请参见获取项目ID。

请求消息

● 请求参数

参数 是否必选 参数类型 描述

server_name 是 String 云手机服务器名称

不超过60个字符，只支持英文

name 是 String 云手机服务器规格，不超过64

个字节。

_name 是 String 云手机规格，不超过64个字

节。

可通过查询云手机规格列表查 询支持的云手机规格。

image_id 是 String 云手机镜像ID，不超过32个字 节。

可通过查询手机镜像查询云手 机规格对应的镜像ID。

count 是 Integer 购买的云手机服务器个数，最

多可购买10台。

band_width 是 band_width

结构体 云手机使用的带宽信息。独占

带宽按流量计费，共享带宽可 选择带宽大小。

extend_param 是 extend_para

m结构体 计费模式参数。

keypair_name 否 String 密钥对名称，不超过64个字 节，用于云手机ADB登录。

参数 是否必选 参数类型 描述

vnc_enable 否 String 是否开启VNC方式登录云手 机。

● 为"true"时开启（忽略大小 写）。

● 为其他，则不开启。

ports 否 port结构体数

组

云手机启用的应用端口，云手 机服务会做端口转发。

subnet_cidr 否 String 服务器的子网信息，第一次购 买系统会自动创建

表5-13 band_width 数据结构说明

参数 是否必选 参数类型 描述

band_width_id 否 String 共享带宽ID，优先用该参数 为云手机绑定带宽。

表5-14 extend_param 数据结构说明

参数 是否必选 参数类型 描述

charging_mod

e 是 Integer 计费类型

0 表示包周期

参数 是否必选 参数类型 描述

period_type 是 Integer 订购周期类型

● 2 表示月

● 3 表示年 period_num 是 Integer 订购周期数

当订购周期为月时，取值范围 [1, 9]。

当订购周期为年时，取值范围 [1,10]。

is_auto_pay 否 Integer 是否自动付款。默认不自动付 款。

● 1 表示自动付款

● 0 表示不自动付款

表5-15 port 结构体数组

参数 是否必选 参数类型 描述

name 是 String 应用端口名称，不超过16个

字节，系统关键服务名称不 能使用"adb"和"vnc"。

listen_port 是 Integer 端口号，大于等于10000，小 于等于50000

internet_acces

sible 是 String ● 为"true"则映射出公网访 问（忽略大小写）。

● 为其他则不映射。

● 请求样例

POST https://{CPH Endpoint}/v1/{project_id}/cloud-phone/phones { "server_name": "myPhoneServer",

"server_model_name": "physical.rx1.xlarge", "phone_model_name": "aphs1.medium.4.aosp", "image_id": "88b8449b896f3a4f0ad57222dd919899", "count": 3,

"keypair_name": "mykeypair", "vnc_enable": "true", "ports": [

"band_width_share_type": 0 },

"extend_param": { "charging_mode": 0, "period_type": 2, "period_num": 1, "is_auto_pay": 1 }

}

响应消息

● 响应参数

参数 参数类型 描述

request_id String 请求的唯一标识ID。不超过32个字节。

order_id String 订单ID，不超过64个字节。

product_id String 产品ID，不超过64个字节。

● 响应样例

{ "request_id": "1564567b8bab40f34711234cb80d8574", "order_id": "CS1710111105S8IPB",

"product_id": "00301-25217-0--0"

}

返回值

请参考返回值。

错误码

请参考错误码。