云手机服务器 CPH-购买云手机服务器:请求参数

时间:2024-03-28 19:28:11

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

用户Token。 通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。

表3 请求Body参数

参数

是否必选

参数类型

描述

server_name

String

云手机服务器名称,不超过60个字符,只支持英文字母、数字、汉字、下划线和中划线。批量购买会在服务器名称后自动添加序号,比如设置此参数为server-1,那么创建的云手机服务器名称会自动按序增加数字后缀,比如为server-1-0001。

server_model_name

String

云手机服务器规格,不超过64个字节。

phone_model_name

String

云手机规格,不超过64个字节。

image_id

String

云手机镜像ID,不超过32个字节。

count

Integer

购买的云手机服务器个数,最多可购买10台。

keypair_name

String

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

ports

Array of Port objects

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

extend_param

extend_param object

计费模式参数。

tenant_vpc_id

String

租户自定义的VPC ID,为待创建的云服务器所属的虚拟私有云(简称VPC),需要指定已创建VPC的ID,UUID格式。

nics

Array of Nic objects

租户自定义的网卡的结构体,为待创建的云服务器的网卡信息。

public_ip

public_ip object

租户自定义的弹性公网IP结构体。

配置云服务器的弹性IP信息的方式,

自动分配,需要指定新创建弹性IP的信息; 使用已有,需要指定已经购买的EIP ID。

phone_count_per_ip

Integer

多少个手机共用一个vip。默认为手机开数,表示所有手机共享1个vip。取值范围:1到手机规格开数。

phone_data_volume

phone_data_volume object

手机磁盘结构体,2.0规格必选。

server_share_data_volume

server_share_data_volume object

共享存储磁盘结构体,2.0规格可选。

band_width

band_width object

云手机使用的带宽信息。

availability_zone

String

待创建云服务器所在的可用区,需要指定可用区(AZ)的名称。如上海一可用区1为cn-east-3a。

表4 Port

参数

是否必选

参数类型

描述

name

String

应用端口名称,不超过16个字节,系统关键服务名称不能使用"adb"和"vnc"。

listen_port

Integer

端口号,大于等于10000,小于等于50000。

internet_accessible

String

为"true"则映射出公网访问(忽略大小写)。 为其他则不映射。

表5 extend_param

参数

是否必选

参数类型

描述

charging_mode

Integer

计费类型。

  • 0:包周期

period_type

Integer

订购周期类型。

  • 2:月

  • 3:年

period_num

Integer

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

is_auto_pay

Integer

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

  • 1:自动付款

  • 0:不自动付款

is_auto_renew

Integer

是否自动续订。默认不自动续订。

  • 1:自动续订

  • 0:不自动续订

enterprise_project_id

String

企业项目ID。 该字段不传(或传为字符串“0”),则将资源绑定给默认企业项目。

表6 Nic

参数

是否必选

参数类型

描述

subnet_id

String

租户自定义的子网 ID,为待创建的云服务器所属的子网。

需要指定tenant_vpc_id对应VPC下已创建的子网(subnet)的网络ID,UUID格式。

ipv6_enable

Boolean

是否支持ipv6。

取值为true时,标识此网卡支持ipv6。

ipv6_bandwidth

ipv6_bandwidth object

绑定的共享带宽信息,详情请参见 ipv6_bandwidth数据结构说明。

表7 ipv6_bandwidth

参数

是否必选

参数类型

描述

band_width_id

String

ipv6绑定的共享带宽ID。

表8 public_ip

参数

是否必选

参数类型

描述

ids

Array of strings

指定已有的EIP进行服务器创建,当前只支持传入一个已有的EIP ID。

eip

eip object

配置服务器自动分配弹性IP时,创建弹性IP的配置参数,详情见 eip 结构体。

count

Integer

Eip数量。默认为1,不需要Eip可设置为0,取值范围为0到手机IP数。

表9 eip

参数

是否必选

参数类型

描述

type

String

弹性公网IP的类型。

  • 5_telcom:电信

  • 5_union:联通

  • 5_bgp:全动态BGP

  • 5_sbgp:静态BGP

表10 phone_data_volume

参数

是否必选

参数类型

描述

volume_type

String

磁盘类型,只支持如下类型:

  • SSD

  • GPSSD

size

Integer

磁盘大小,单位GB,取值范围[0,32768]。

表11 server_share_data_volume

参数

是否必选

参数类型

描述

volume_type

String

磁盘类型,只支持如下类型:

  • SSD

  • GPSSD

size

Integer

磁盘大小,单位GB,取值范围[0,32768]。

表12 band_width

参数

是否必选

参数类型

描述

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,共享带宽

support.huaweicloud.com/api-cph/cph_api_0550.html