裸金属服务器状态管理-华为云

裸金属服务器 BMS-获取远程登录地址（废弃）:请求消息

请求消息请求参数参数是否必选参数类型描述 os-getSerialConsole 是 Object 获取裸金属服务器远程登录地址。详情请参见表2。表2 os-getSerialConsole字段数据结构说明参数是否必选参数类型描述 type 是 String 获取对象，请将type配置为“serial”。请求示例获取ID为47e9be4e-a7b9-471f-92d9-ffc83814e07a的裸金属服务器的远程登录地址。 1 POST https://{E CS Endpoint}/v2/9c53a566cb3443ab910cf0daebca90c4/servers/47e9be4e-a7b9-471f-92d9-ffc83814e07a/action 12345 { "os-getSerialConsole": { "type": "serial" }}

裸金属服务器 BMS 裸金属服务器状态管理（OpenStack Nova API）

裸金属服务器 BMS-切换裸金属服务器操作系统:请求示例

请求示例 1 POST https://{BMS Endpoint}/v1/bbf1946d374b44a0a2a95533562ba954/baremetalservers/cf2a8b97-b5c6-47ef-9714-eb27adf26e5b/changeos 1 2 3 4 5 6 7 8 910 { "os-change": { "keyname": "$key_name", "imageid": "04dc740a-5820-4ab6-9d01-8cd3a6577296", "userid": "7e25b1da389f4697a79df3a0e5bd494e", "metadata": { "user_data": "$USER_DATA" } }}

裸金属服务器 BMS 裸金属服务器状态管理

裸金属服务器 BMS-切换裸金属服务器操作系统:响应参数

响应参数正常响应要素表4 正常响应要素说明名称参数类型说明 jobId String 提交任务成功后返回的任务ID，用户可以使用该ID对任务执行情况进行查询。如何根据job_id来查询Job的执行状态，请参考查询Job状态。异常响应要素表5 异常响应要素说明名称参数类型说明 error 字典数据结构提交任务异常时返回的异常信息，详情请参见表6。表6 error数据结构名称参数类型说明 message String 任务异常错误信息描述。 code String 任务异常错误信息编码。

裸金属服务器 BMS 裸金属服务器状态管理

裸金属服务器 BMS-切换裸金属服务器操作系统:请求参数

请求参数参数是否必选参数类型描述 os-change 是 Object 标记为切换裸金属服务器OS操作。详情请参见表2。表2 os-change字段数据结构说明参数是否必选参数类型描述 adminpass 否 String 裸金属服务器管理员账号的初始登录密码。其中，Linux管理员账户为root，Windows管理员账户为Administrator。建议密码复杂度如下：长度为8-26位。密码至少必须包含大写字母、小写字母、数字和特殊字符（!@$%^-_=+[{}]:,./?）中的三种。密码不能包含用户名或用户名的逆序。说明：对于Windows裸金属服务器，不能包含用户名中超过两个连续字符的部分。对于Linux裸金属服务器也可使用user_data字段实现密码注入，此时adminpass字段无效。 adminpass和keyname不能同时有值。 adminpass和keyname如果同时为空，此时，metadata中的user_data属性必须有值。 keyname 否 String 密钥名称。密钥可以通过创建和导入SSH密钥（OpenStack原生）API创建，或者使用查询SSH密钥列表（OpenStack原生）API查询已有的密钥。 userid 否 String 用户ID（登录管理控制台，进入我的凭证，即可看到“用户ID”）。 imageid 是 String 镜像ID。镜像ID可以从镜像服务控制台获取，或者参考《镜像服务API参考》的“查询镜像列表”章节查询。在使用“查询镜像列表”API查询时，可以添加过滤字段“?virtual_env_type=Ironic”来筛选裸金属服务器镜像。 metadata 否 Object 切换裸金属服务器的元数据。详情请参见表3。表3 metadata字段数据结构说明参数是否必选参数类型描述 user_data 否 String 切换裸金属服务器过程中待注入的Linux镜像root密码，用户自定义初始化密码。注：修改密码脚本需经base64编码。建议密码复杂度如下：长度为8-26位。密码至少必须包含大写字母（A-Z）、小写字母（a-z）、数字（0-9）和特殊字符（!@$%^-_=+[{}]:,./?）中的三种。示例：使用明文密码（存在安全风险），以密码cloud.1234为例： 12 #!/bin/bash echo 'root:Cloud.1234' | chpasswd ; 使用密码： 12 #!/bin/bash echo 'root:$6$V6azyeLwcD3CHlpY$BN3VVq18fmCkj66B4zdHLWevqcxlig/GpOkLcOhab9smJoLKYm/Tf9Hcwa6DpiPDhdHfGEAPajFmLZa0YDd910' | chpasswd -e 此脚本需经base64编码方式编码。其中，$6$V6azyeLwcD3CHlpY$BN3VVq18fmCkj66B4zdHLWevqcxlig为密文密码，生成方法如下：生成加密盐值 12 [root@test linux]# python -c "import crypt, getpass, pwd;print crypt.mksalt()" $6$V6azyeLwcD3CHlpY 根据盐值生成密文密码 12 [root@test linux]# python -c "import crypt, getpass, pwd;print crypt.crypt('Cloud.1234','\$6\$V6azyeLwcD3CHlpY')" $6$V6azyeLwcD3CHlpY$BN3VVq18fmCkj66B4zdHLWevqcxlig/GpOkLcOhab9smJoLKYm/Tf9Hcwa6DpiPDhdHfGEAPajFmLZa0YDd910 密文生成之后，修改密码脚本需经base64编码方式编码。

裸金属服务器 BMS 裸金属服务器状态管理

裸金属服务器 BMS-切换裸金属服务器操作系统:URI

URI POST /v1/{project_id}/baremetalservers/{server_id}/changeos 参数说明请参见表1。表1 参数说明参数是否必选描述 X-Auth-Token 是用户Token。通过调用 IAM 服务获取用户Token接口获取(响应消息头中X-Subject-Token的值) project_id 是项目ID。获取方式请参见获取项目ID。 server_id 是裸金属服务器ID。可以从裸金属服务器控制台查询，或者通过调用查询裸金属服务器列表（废弃）获取。

裸金属服务器 BMS 裸金属服务器状态管理

裸金属服务器 BMS-切换裸金属服务器操作系统:约束

约束关机状态或者切换操作系统失败的裸金属服务器，才能执行切换操作。使用私有镜像创建的裸金属服务器，请确保已经安装了Cloud-init（Linux镜像）或Cloudbase-init（Windows镜像）。如使用未安装Cloud-init或Cloudbase-init的镜像，该接口不能注入密钥或密码。公共镜像默认已安装Cloud-init或Cloudbase-init。执行切换操作系统任务时，请勿并行执行其他操作，否则可能会引起切换操作系统失败。目前Windows镜像不支持注入密码，Linux镜像的user_data为加密后的密码。

裸金属服务器 BMS 裸金属服务器状态管理

云服务器内容精选

裸金属服务器状态管理

7*24

备案

专业服务

退订

建议反馈

售前咨询热线