文档首页/魔坊（ModelArts）模型训推平台/SDK参考/Lite Server生命周期管理/创建Lite Server
更新时间：2025-12-04 GMT+08:00
查看PDF
分享

创建Lite Server

示例代码

在ModelArts Notebook平台，Session鉴权无需输入鉴权参数。其它平台的Session鉴权请参见Session鉴权。

from modelarts.server_mgmt import ServerManagement
from modelarts.session import Session
from modelarts.servers.server_def import Volume, ChargingInfo, Network, RootVolume, DataVolume, Server, Tag, ImageBody, BindIP

network = Network(
    security_group_id="150a2c76-1334-45f6-b28f-419f9b1d1742",
    subnet_id="38cf274a-98f9-4f6f-b622-5ed0e4a3db54",
    vpc_id="05982b48-a70f-43a1-a2b0-1fe36a236172")
rootvolume = RootVolume(
    root_type="SSD",
    size="200")
charginginfo = ChargingInfo(
    charging_mode="POST_PAID",
    period_num=1,
    period_type="MONTH")
server = Server(
    name="server_test",
    flavor="s7.small.1",
    image_id="e16eff65-1899-446e-baf2-0d2b6b5dd8c0",
    key_pair_name = "KeyPair-3d6a",
    network=network,
    root_volume=rootvolume,
    charging_info=charginginfo,
    arch="X86")
ServerManagement.create(session=Session(),server=server)

参数说明

表1 路径参数

参数

是否必选

参数类型

描述

session

是

Class

管理与Lite Server的交互,提供project_id

表2 请求Body参数

参数

是否必选

参数类型

描述

admin_pass

否

String

用于登录服务器密码。注意admin_pass和key_pair_name必须二选一。密码规则：

  • 长度为8至26个
  • 至少包含大写字母、小写字母、数字及特殊符号(!@%-_=+[{}]:,./?)中的3种
  • 不能与用户名或倒序的用户名相同
  • 不能包含root或administrator及其逆序

arch

否

String

服务器规格架构类型。

  • ARM
  • X86

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

服务器类型。枚举值如下：

  • BMS：裸金属服务
  • ECS：弹性云服务
  • HPS：超节点服务

userdata

否

String

创建服务器时，用户自己定义数据。

hps_cluster_id

否

String

超节点集群网络信息，仅创建超节点需要该参数。

表3 ChargingInfo

参数

是否必选

参数类型

描述

charging_mode

是

String

付费类型。枚举值如下：

  • COMMON：预付费和后付费
  • POST_PAID：后付费
  • PRE_PAID: 预付费

is_auto_pay

否

Boolean

is auto pay

is_auto_renew

否

Boolean

is auto renew

period_num

是

Integer

period num

period_type

是

String

period type

  • ABSOLUTE
  • DAY：天
  • HOUR：小时
  • MONTH：月
  • WEEK：周
  • YEAR：年
表4 ServerNetwork

参数

是否必选

参数类型

描述

ipv6_enable

否

Boolean

创建服务器是否启用IPV6。

roce_id

否

String

服务器RoCE网络ID。

security_group_id

是

String

服务器所在的安全组ID。

subnet_id

是

String

服务器所在子网ID。

vpc_id

是

String

服务器所在虚拟私有云ID。

表5 EvsVolume

参数

是否必选

参数类型

描述

size

否

Integer

系统盘大小。

type

否

String

系统盘类型。

  • ESSD；
  • GPSSD；
  • SAS；
  • SATA；
  • SSD。
表6 ServerDataVolume

参数

是否必选

参数类型

描述

size

是

Integer

数据盘大小。

type

是

String

系统盘类型。

ESSD；

GPSSD；

SAS；

SATA；

SSD。

count

是

Integer

数据盘个数,取值范围为1~8。

表7 响应Body参数

参数

参数类型

描述

create_at

Long

创建时间。

update_at

Long

更新时间。

charging_mode

String

计费模式。

  • COMMON：同时支持包周期和按需
  • POST_PAID：按需模式
  • PRE_PAID：包周期

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

实例状态。

  • CREATE_FAILED: 创建失败；
  • CREATING: 创建中；
  • DELETED: 已删除；
  • DELETE_FAILED: 删除失败；
  • DELETING: 删除中；
  • ERROR: 错误；
  • RUNNING: 运行中；
  • STARTING: 启动中；
  • START_FAILED: 启动失败；
  • STOPPED: 已停止；
  • STOPPING: 停止中；
  • STOP_FAILED: 停止失败：
  • REBOOTING: 重启中：
  • REBOOT_FAILED: 重启失败；
  • CHANGINGOS: 切换操作系统中：
  • CHANGINGOS_FAILED: 切换操作系统失败：
  • REINSTALLINGOS: 重装操作系统中：
  • REINSTALLINGOS_FAILED。重装操作系统失败。

vpc_id

String

实例所在虚拟私有云ID。

endpoints

Array of EndpointsRes objects

服务器的私有IP信息。

image

ServerImageResponse object

服务器镜像信息。

category

String

服务器归属类型。

  • HPS：超节点服务器
  • SPOD：整柜服务器
  • SERVER：单台服务器

server_hps

ServerHpsInfo object

服务器归属超节点信息。

subnet_id

String

实例所在子网的ID。

表8 CloudServer

参数

参数类型

描述

id

String

服务器资源id。

type

String

Lite Server服务器类型。枚举值如下：

  • BMS：裸金属服务器
  • ECS：弹性云服务器
  • HPS：超节点服务器

hps_id

String

服务器所属的超节点资源id。

表9 EndPoints

参数

参数类型

描述

allowed_access_ips

Array of strings

允许通过SSH协议访问Notebook的公网IP地址白名单列表，默认都可以访问。当配置指定IP后，则仅允许IP所在的客户端实现对Notebook的访问。

dev_service

String

支持的服务，枚举值如下：

  • NOTEBOOK：可以通过https协议访问Notebook
  • SSH：可以通过SSH协议远程连接Notebook
  • AI_FLOW
  • MA_STUDIO
  • TENSOR_BOARD
  • WEB_IDE

extensions

Map<String,String>

通过应用专属URL直接打开应用进入远程开发模式。

ssh_keys

Array of strings

SSH密钥对名称列表，允许设置多个密钥对实现同时对SSH实例的访问。

表10 EndpointsRes

参数

参数类型

描述

allowed_access_ips

Array of strings

允许通过SSH协议访问Notebook的公网IP地址白名单列表，默认都可以访问。当配置指定IP后，则仅允许IP所在的客户端实现对Notebook的访问。

dev_service

String

访问Notebook的途径，枚举值如下：

  • NOTEBOOK：可以通过https协议访问Notebook。
  • SSH：可以通过SSH协议远程连接Notebook。

ssh_keys

Array of strings

SSH密钥对名称列表，允许设置多个密钥对实现同时对SSH实例的访问。

service

String

访问Notebook的途径，枚举值如下：

  • NOTEBOOK：可以通过https协议访问Notebook。
  • SSH：可以通过SSH协议远程连接Notebook。

uri

String

实例私有IP地址。

表11 ServerImageResponse

参数

参数类型

描述

arch

String

服务器镜像架构类型。

  • ARM
  • X86

image_id

String

服务器镜像ID。

name

String

服务器镜像名称。

server_type

String

服务器类型。枚举值如下：

  • BMS：裸金属服务器
  • ECS：弹性云服务器
表12 ServerHpsInfo

参数

参数类型

描述

id

String

Lite Server超节点实例id。

name

String

Lite Server超节点名称。