创建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：弹性云服务器