切换轻量算力节点超节点服务器操作系统镜像

示例代码

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

from modelarts.server_mgmt import ServerManagement
from modelarts.session import Session
from modelarts.servers.server_def import ImageBody

change_body = ImageBody(key_pair_name="KeyPair-3d6a",
                          image_id="e16eff65-1899-446e-baf2-0d2b6b5dd8c0")
ServerManagement.change_hps_image(session = Session(), hps_cluster_id = "hps_cluster_id",change_body = change_body)   #输入hps_cluster_id

参数说明

表1 路径参数
参数	是否必选	参数类型	描述
hps_cluster_id	是	String	HPS Cluster ID。
session	是	Class	管理与轻量算力节点的交互,提供project_id

表2 请求Body参数
参数	是否必选	参数类型	描述
admin_pass	否	String	用于登录服务器密码。注意admin_pass和key_pair_name必须二选一。密码规则：长度为8至26个至少包含大写字母、小写字母、数字及特殊符号(!@%-_=+[{}]:,./?)中的3种不能与用户名或倒序的用户名相同不能包含root或administrator及其逆序
key_pair_name	否	String	服务器登录密钥对名称，admin_pass和key_pair_name必须二选一。注意超节点仅支持key_pair_name创建。
image_id	是	String	服务器镜像ID。
user_data	否	String	创建服务器时，用户自己定义数据。

表3 响应Body参数
参数	参数类型	描述
create_at	Long	创建时间。
hps_cluster_id	String	超节点集群ID
hps_id	String	超节点实例ID
id	String	实例ID。
name	String	实例名称。
order_id	String	订单ID。
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。重装操作系统失败。
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	实例镜像信息。
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。
server_hps	ServerHpsInfo object	服务器归属超节点信息。
subnet_id	String	实例所在子网的ID。

表4 CloudServer
参数	参数类型	描述
id	String	服务器资源id。
type	String	轻量算力节点服务器类型。枚举值如下： BMS：裸金属服务器 ECS：弹性云服务器 HPS：超节点服务器
hps_id	String	服务器所属的超节点资源id。

表5 Endpoints
参数	参数类型	描述
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实例的访问。

表6 EndpointsRes
参数	参数类型	描述
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地址。

表7 ServerImageResponse
参数	参数类型	描述
arch	String	服务器镜像架构类型。 ARM X86
image_id	String	服务器镜像ID。
name	String	服务器镜像名称。
server_type	String	服务器类型。枚举值如下： BMS：裸金属服务器 ECS：弹性云服务器