# 重装轻量算力节点服务器操作系统镜像 #### 示例代码 在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 ImageBod reinstall_body = ImageBody(key_pair_name="KeyPair-3d6a", image_id="e16eff65-1899-446e-baf2-0d2b6b5dd8c0") ServerManagement.reinstall_server_image(session = Session(), server_id = "server_id", reinstall_body = reinstall_body) #输入server_id ``` #### 参数说明 表1路径参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | server_id | 是 | String | 轻量算力节点 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 | 创建时间。 | | 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。 | 表4CloudServer | 参数 | 参数类型 | 描述 | |:---|:---|:---| | id | String | 服务器资源id。 | | type | String | 轻量算力节点服务器类型。枚举值如下： - BMS：裸金属服务器 - ECS：弹性云服务器 - HPS：超节点服务器 | | hps_id | String | 服务器所属的超节点资源id。 | 表5Endpoints | 参数 | 参数类型 | 描述 | |:---|:---|:---| | 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实例的访问。 | 表6EndpointsRes | 参数 | 参数类型 | 描述 | |:---|:---|:---| | 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地址。 | 表7ServerImageResponse | 参数 | 参数类型 | 描述 | |:---|:---|:---| | arch | String | 服务器镜像架构类型。 - ARM - X86 | | image_id | String | 服务器镜像ID。 | | name | String | 服务器镜像名称。 | | server_type | String | 服务器类型。枚举值如下： - BMS：裸金属服务器 - ECS：弹性云服务器 | 表8ServerHpsInfo | 参数 | 参数类型 | 描述 | |:---|:---|:---| | id | String | 轻量算力节点超节点实例id。 | | name | String | 轻量算力节点超节点名称。 |