# 创建云手机裸服务器 - CreateCloudPhoneSingleServer #### 功能介绍 该接口创建的服务器仅包含服务器和服务器的镜像，不包含云手机实例和镜像等内容。若需创建包含云手机实例的服务器，请使用创建云手机服务器接口。 #### 调试 您可以在[API Explorer](https://console.huaweicloud.com/apiexplorer/#/openapi/CPH/doc?api=CreateCloudPhoneSingleServer)中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。 #### 授权信息 账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。 - 如果使用角色与策略授权，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-cph/cph_api_06000.html)。 - 如果使用身份策略授权，需具备如下身份策略权限。 | 授权项 | 访问级别 | 资源类型（\*为必须） | 条件键 | 别名 | 依赖的授权项 | |:---|:---|:---|:---|:---|:---| | cph:servers:create | Write | server \* | - | - | - vpc:vpcs:get - vpc:subnets:get - vpc:networks:get - eip:bandwidths:get - eip:publicIps:list - kps:SSHKeyPair:get - vpc:quotas:list - sfsturbo:shares:getShare - sfsturbo:shares:showFsDir - ims:images:list | | cph:servers:create | Write | - | g:EnterpriseProjectId | - | - vpc:vpcs:get - vpc:subnets:get - vpc:networks:get - eip:bandwidths:get - eip:publicIps:list - kps:SSHKeyPair:get - vpc:quotas:list - sfsturbo:shares:getShare - sfsturbo:shares:showFsDir - ims:images:list | #### URI POST /v2.1/{project_id}/cloud-phone/servers 表1路径参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | project_id | 是 | String | 项目id。 | #### 请求参数 表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 | 云手机裸服务器规格名称。 | | count | 是 | Integer | 购买的云手机裸服务器个数，最多可购买10台。 | | order_param | 是 | [order_param] object | 订单结构体。 | | nics | 是 | Array of [NicForSingleServer] objects | 租户自定义的网卡的结构体，为待创建的云手机裸服务器的网卡信息。 | | public_ip | 是 | [public_ip] object | 租户自定义的弹性公网IP结构体。 配置云手机裸服务器的弹性IP信息的方式， 自动分配，需要指定新创建弹性IP的信息； 使用已有，需要指定已经购买的EIP ID。 | | availability_zone | 否 | String | 待创建云手机裸服务器所在的可用区（AZ）的名称。如上海一可用区1为cn-east-3a。 | | data_volume | 否 | [data_volume] object | 数据盘结构体。 | | keypair_name | 是 | String | 指定登录云手机裸服务器已有密钥的名称。 | | enterprise_project_id | 否 | String | 企业项目ID。 该字段不传（或传为字符串"0"），则将资源绑定给默认企业项目。 | | image_id | 否 | String | 云手机裸服务器镜像ID，不超过36个字节。未指定时使用默认云手机裸服务器镜像。 | 表4order_param | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | charging_mode | 是 | Integer | 计费类型。 0：包周期 | | period_type | 是 | Integer | 订购周期类型。 2：月 3：年 | | period_num | 是 | Integer | 订购周期数。 当订购周期为月时，取值范围\[1, 9\]。 当订购周期为年时，取值范围\[1,10\]。 | | is_auto_pay | 否 | Integer | 是否自动付款。默认不自动付款。 0：不自动付款 1：自动付款 | | is_auto_renew | 否 | Integer | 是否自动续订。默认不自动续订。 0：不自动续订 1：自动续订 | 表5NicForSingleServer | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | subnet_id | 是 | String | 租户自定义的子网 ID，为待创建的云手机裸服务器所属的子网。 需要指定vpc_id对应VPC下已创建的子网（subnet）的网络ID，UUID格式 | | ipv6_enable | 否 | Boolean | 是否支持ipv6，默认不支持ipv6。 false：不支持ipv6 true：支持ipv6 | | ipv6_band_width_id | 否 | String | ipv6绑定的共享带宽ID。 | 表6public_ip | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | ids | 否 | Array of strings | 指定已有的EIP进行云手机裸服务器创建，当前只支持传入一个已有的EIP ID。指定EIP后public_ip结构体中count字段和type字段不生效。 | | type | 否 | String | 弹性公网IP的类型。 例如： 5_telcom：电信 5_union：联通 5_bgp：全动态BGP 5_sbgp：静态BGP | | count | 否 | Integer | Eip数量。默认为0。取值范围为【0,1】 | | band_width | 是 | [band_width] object | 云手机裸服务器使用的带宽信息。 | 表7band_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，共享带宽 | 表8data_volume | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | volume_type | 是 | String | 数据盘类型，只支持如下类型： SSD GPSSD | | size | 是 | Integer | 数据盘大小，单位GiB，取值范围\[1，32768\] | | count | 否 | Integer | 数据盘数量，默认值为1 | #### 响应参数 **状态码：200** 表9响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | request_id | String | 请求的唯一标识ID。 | | order_id | String | 订单ID，不超过64个字节。 | | product_id | String | 产品ID，不超过64个字节。 | | server_ids | Array of strings | 服务器ID列表。 | | error_msg | String | 任务错误码说明。 | | error_code | String | 任务错误码。 | #### 请求示例 创建云手机裸服务器请求体 ``` POST https://{CPH Endpoint}/v2.1/{project_id}/cloud-phone/servers { "server_name" : "cph-test-wy", "server_model_name" : "physical.rx2.32xlarge.4", "count" : 1, "order_param" : { "charging_mode" : 0, "period_type" : 2, "period_num" : 1, "is_auto_renew" : 0, "is_auto_pay" : 1 }, "nics" : [ { "subnet_id" : "3c5e2638-b71f-4499-8d1e-355e89f21ae0", "ipv6_enable" : true, "ipv6_band_width_id" : "fbe74c2f-e2ba-427a-b8aa-1c7c4f510ac1" } ], "public_ip" : { "type" : "5_bgp", "count" : 1, "band_width" : { "band_width_share_type" : 0, "band_width_size" : 300, "band_width_charge_mode" : 1 } }, "keypair_name" : "KeyPair-1d1d-wy", "enterprise_project_id" : "0" } ``` #### 响应示例 **状态码：200** OK ``` { "request_id" : "1564567b8bab40f34711234cb80d8574", "order_id" : "CS1710111105S8IPB", "product_id" : "00301-25217-0--0", "server_ids" : [ "1234567b8bab40ffb711234cb80d0234", "1678567b8bab40f93711234cb80d0764" ] } ``` #### 状态码 | 状态码 | 描述 | |:---|:---| | 200 | OK | #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-cph/ErrorCode.html)。