# 创建轻量算力节点 #### 示例代码 在ModelArts Notebook平台，Session鉴权无需输入鉴权参数。其它平台的Session鉴权请参见[Session鉴权](https://support.huaweicloud.com/sdkreference-modelarts/modelarts_04_0123.html)。 ``` 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 | 管理与轻量算力节点的交互,提供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 | 超节点集群网络信息，仅创建超节点需要该参数。 | 表3ChargingInfo | 参数 | 是否必选 | 参数类型 描述 | |:---|:---|:---| | 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：年 | 表4ServerNetwork | 参数 | 是否必选 | 参数类型 描述 | |:---|:---|:---| | ipv6_enable | 否 | Boolean 创建服务器是否启用IPV6。 | | roce_id | 否 | String 服务器RoCE网络ID。 | | security_group_id | 是 | String 服务器所在的安全组ID。 | | subnet_id | 是 | String 服务器所在子网ID。 | | vpc_id | 是 | String 服务器所在虚拟私有云ID。 | 表5EvsVolume | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | size | 否 | Integer | 系统盘大小。 | | type | 否 | String | 系统盘类型。 - ESSD； - GPSSD； - SAS； - SATA； - SSD。 | 表6ServerDataVolume | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | 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。 | 表8CloudServer | 参数 | 参数类型 | 描述 | |:---|:---|:---| | id | String | 服务器资源id。 | | type | String | 轻量算力节点服务器类型。枚举值如下： - BMS：裸金属服务器 - ECS：弹性云服务器 - HPS：超节点服务器 | | hps_id | String | 服务器所属的超节点资源id。 | 表9EndPoints | 参数 | 参数类型 | 描述 | |:---|:---|:---| | dev_service | String | 支持的服务，枚举值如下： - NOTEBOOK：可以通过https协议访问Notebook - SSH：可以通过SSH协议远程连接Notebook - AI_FLOW - MA_STUDIO - TENSOR_BOARD - WEB_IDE | | extensions | Map\ | 通过应用专属URL直接打开应用进入远程开发模式。 | | ssh_keys | Array of strings | SSH密钥对名称列表，允许设置多个密钥对实现同时对SSH实例的访问。 | 表10EndpointsRes | 参数 | 参数类型 | 描述 | |:---|:---|:---| | 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地址。 | 表11ServerImageResponse | 参数 | 参数类型 | 描述 | |:---|:---|:---| | arch | String | 服务器镜像架构类型。 - ARM - X86 | | image_id | String | 服务器镜像ID。 | | name | String | 服务器镜像名称。 | | server_type | String | 服务器类型。枚举值如下： - BMS：裸金属服务器 - ECS：弹性云服务器 | 表12ServerHpsInfo | 参数 | 参数类型 | 描述 | |:---|:---|:---| | id | String | 轻量算力节点超节点实例id。 | | name | String | 轻量算力节点超节点名称。 |