创建DevServer
功能介绍
创建DevServer。
接口约束
暂无约束
调试
您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。
URI
POST /v1/{project_id}/dev-servers
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
project_id |
是 |
String |
用户项目ID,获取方法请参见获取项目ID和名称。 |
请求参数
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
admin_pass |
否 |
String |
用于登录服务器密码。注意admin_pass和key_pair_name必须二选一。密码规则:
|
arch |
否 |
String |
服务器规格架构类型。
|
availability_zone |
否 |
String |
可用区。 |
charging_info |
否 |
ChargingInfo object |
服务器计费模式信息。 |
count |
否 |
Integer |
单次购买的服务器数量。 |
enterprise_project_id |
否 |
String |
企业ID。 |
flavor |
是 |
String |
服务器规格名称。 |
image_id |
是 |
String |
服务器镜像ID。 |
key_pair_name |
否 |
String |
服务器登录密钥对名称,admin_pass和key_pair_name必须二选一。注意超节点仅支持key_pair_name创建。 |
name |
是 |
String |
服务器名称。 |
network |
是 |
ServerNetwork object |
服务器网络信息。 |
root_volume |
否 |
EvsVolume object |
服务器系统盘信息。 |
data_volume |
否 |
ServerDataVolume object |
服务器数据盘信息。 |
server_type |
否 |
String |
服务器类型。枚举值如下:
|
userdata |
否 |
String |
创建服务器时,用户自己定义数据。 |
hps_cluster_id |
否 |
String |
超节点集群网络信息,仅创建超节点需要该参数。 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
charging_mode |
是 |
String |
付费类型。枚举值如下:
|
is_auto_pay |
否 |
Boolean |
is auto pay |
is_auto_renew |
否 |
Boolean |
is auto renew |
period_num |
是 |
Integer |
period num |
period_type |
是 |
String |
period type
|
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
ipv6_enable |
否 |
Boolean |
创建服务器是否启用IPV6。 |
roce_id |
否 |
String |
服务器RoCE网络ID。 |
security_group_id |
是 |
String |
服务器所在的安全组ID。 |
subnet_id |
是 |
String |
服务器所在子网ID。 |
vpc_id |
是 |
String |
服务器所在虚拟私有云ID。 |
响应参数
状态码:200
参数 |
参数类型 |
描述 |
---|---|---|
create_at |
Long |
创建时间。 |
update_at |
Long |
更新时间。 |
charging_mode |
String |
计费模式。
|
cloud_server |
CloudServer object |
云服务信息。 |
endpoints_response |
Array of Endpoints objects |
实例私有IP信息。 |
flavor |
String |
实例规格名称。 |
id |
String |
实例ID。 |
key_pair_name |
String |
密钥对名称。 |
name |
String |
实例名称。 |
order_id |
String |
订单ID。 |
server_image_response |
ServerImageResponse object |
实例镜像信息。 |
status |
String |
实例状态。
|
vpc_id |
String |
实例所在虚拟私有云ID。 |
endpoints |
Array of EndpointsRes objects |
服务器的私有IP信息。 |
image |
ServerImageResponse object |
服务器镜像信息。 |
category |
String |
服务器归属类型。
|
server_hps |
ServerHpsInfo object |
服务器归属超节点信息。 |
subnet_id |
String |
实例所在子网的ID。 |
参数 |
参数类型 |
描述 |
---|---|---|
id |
String |
服务器资源id。 |
type |
String |
DevServer服务器类型。枚举值如下:
|
hps_id |
String |
服务器所属的超节点资源id。 |
参数 |
参数类型 |
描述 |
---|---|---|
allowed_access_ips |
Array of strings |
允许通过SSH协议访问Notebook的公网IP地址白名单列表,默认都可以访问。当配置指定IP后,则仅允许IP所在的客户端实现对Notebook的访问。 |
dev_service |
String |
支持的服务,枚举值如下:
|
extensions |
Map<String,String> |
通过应用专属URL直接打开应用进入远程开发模式。 |
ssh_keys |
Array of strings |
SSH密钥对名称列表,允许设置多个密钥对实现同时对SSH实例的访问。 |
参数 |
参数类型 |
描述 |
---|---|---|
allowed_access_ips |
Array of strings |
允许通过SSH协议访问Notebook的公网IP地址白名单列表,默认都可以访问。当配置指定IP后,则仅允许IP所在的客户端实现对Notebook的访问。 |
dev_service |
String |
访问Notebook的途径,枚举值如下:
|
ssh_keys |
Array of strings |
SSH密钥对名称列表,允许设置多个密钥对实现同时对SSH实例的访问。 |
service |
String |
访问Notebook的途径,枚举值如下:
|
uri |
String |
实例私有IP地址。 |
请求示例
POST https://{endpoint}/v1/{project_id}/dev-servers
{
"name" : "EI-evs-1107",
"flavor" : "Si2.large.4",
"image_id" : "c90fb553-2cdb-4b81-b56a-ef68812c6cf7",
"network" : {
"security_group_id" : "150a2c76-1334-45f6-b28f-419f9b1d1742",
"subnet_id" : "38cf274a-98f9-4f6f-b622-5ed0e4a3db54",
"vpc_id" : "05982b48-a70f-43a1-a2b0-1fe36a236172"
},
"admin_pass" : "@DevServer"
}
响应示例
状态码:200
OK
{
"charging_mode" : "PRE_PAID",
"cloud_server" : {
"type" : "ECS"
},
"create_at" : 1699348284990,
"flavor" : "Si2.large.4",
"id" : "62383738-e52a-450a-9f84-f9e705402be8",
"image" : {
"arch" : "X86",
"image_id" : "c90fb553-2cdb-4b81-b56a-ef68812c6cf7",
"name" : "Ubuntu18.04_x86_64_CPU",
"server_type" : "ECS"
},
"name" : "EI-evs-1107",
"status" : "CREATING",
"update_at" : 1699348285077
}
状态码
状态码 |
描述 |
---|---|
200 |
OK |
错误码
请参见错误码。