检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
切换裸金属服务器操作系统 功能介绍 切换裸金属服务器的操作系统。切换操作系统支持密码或者密钥注入。 切换操作系统属于异步API，接口调用成功只表示请求下发成功，任务执行结果请通过查询Job状态API获取。 约束 关机状态或者切换操作系统失败的裸金属服务器，才能执行切换操作。 使用私有镜像创建的裸金属
码或者密钥注入。 确定裸金属服务器是否为快速发放，请参考查询规格详情和规格扩展信息列表API。 重装操作系统属于异步API，接口调用成功只表示请求下发成功，任务执行结果请通过查询Job状态API获取。 约束 使用私有镜像创建的裸金属服务器，请确保已经安装了Cloud-init（L
如果裸金属服务器是通过私有镜像创建的，请确保已安装Cloudbase-init。公共镜像默认已安装该软件。 调试 您可以在API Explorer中调试该接口。 URI DELETE /v1/{project_id}/baremetalservers/{server_id}/os-server-password
扩展属性，磁盘配置，取值为以下两种： MANUAL：API使用镜像中的分区方案和文件系统创建裸金属服务器。如果目标flavor磁盘较大，则API不会对剩余磁盘空间进行分区。 AUTO：API使用与目标flavor磁盘大小相同的单个分区创建裸金属服务器，API会自动调整文件系统以适应整个分区。 fault
功能介绍 解绑裸金属服务器中的一张或多张弹性网卡。 主网卡是裸金属服务器上配置了路由规则的网卡，不可解绑。 调试 您可以在API Explorer中调试该接口。 URI POST /v1/{project_id}/baremetalservers/{server_id}/nics/delete
附录 获取项目ID 获取账号ID
获取项目ID 操作场景 在调用接口的时候，部分URL中需要填入项目ID，所以需要获取到项目ID。有如下两种获取方式： 调用API获取项目ID 从控制台获取项目ID 调用API获取项目ID 项目ID可以通过调用查询指定条件下的项目列表API获取。 获取项目ID的接口为“GET https:
指南》的“安装一键式重置密码插件”章节。 裸金属服务器的密码重置失败后，该API不会报错。 裸金属服务器开机或重启后，新密码生效。 调试 您可以在API Explorer中调试该接口。 URI PUT /v1/{project_id}/baremetalservers/{serv
获取裸金属服务器远程登录地址 功能介绍 获取裸金属服务器远程登录地址。 约束 Windows系统的裸金属服务器不支持远程登录。 调试 您可以在API Explorer中调试该接口。 URI POST /v1/{project_id}/baremetalservers/{server_id}/remote_console
功能介绍 修改裸金属服务器所绑定的弹性网卡属性：终止时删除，即删除裸金属服务器，或者解绑网卡时是否删除该网卡。 调试 您可以在API Explorer中调试该接口。 URI PUT /v1/{project_id}/baremetalservers/{server_id}/os-interface/{port_id}
裸金属服务器绑定弹性网卡 功能介绍 为裸金属服务器绑定一张或多张弹性网卡。 调试 您可以在API Explorer中调试该接口。 URI POST /v1/{project_id}/baremetalservers/{server_id}/nics 参数说明请参见表1 参数说明。
对于Windows裸金属服务器，在线卸载磁盘，请确保没有程序正在对该磁盘进行读写操作。否则，将造成数据丢失。 调试 您可以在API Explorer中调试该接口。 URI DELETE /v1/{project_id}/baremetalservers/{server_id}/de
查询裸金属服务器挂载的云硬盘信息 功能介绍 查询裸金属服务器挂载的云硬盘信息。 调试 您可以在API Explorer中调试该接口。 URI GET /v1/{project_id}/baremetalservers/{server_id}/os-volume_attachments
查询裸金属服务器详情列表 功能介绍 用户根据设置的请求条件筛选裸金属服务器，并获取裸金属服务器的详细信息。 该接口支持查询裸金属服务器计费方式，以及是否被冻结。 调试 您可以在API Explorer中调试该接口。 URI GET /v1/{project_id}/baremetalservers/detail
D状态下不支持挂卷。 要挂载的卷必须是available状态的卷或者共享卷。 仅支持挂载SCSI类型的卷。 调试 您可以在API Explorer中调试该接口。 URI POST /v1/{project_id}/baremetalservers/{server_id}/attachvolume
项目ID。 获取方式请参见获取项目ID。 keypair_name 是 密钥名称。 可以通过查询SSH密钥列表（OpenStack原生）API获取。 请求参数 无 请求示例 删除名称为keypair-test的SSH密钥。 1 DELETE https://{ECS Endpoint}/v2
修订记录 版本日期 变更说明 2024-10-22 第十九次正式发布。 下线“API（OpenStack Nova v2.1 原生）”章节，废弃接口移至历史API。 2023-11-23 第十八次正式发布。 新增切换裸金属服务器操作系统。 2023-09-14 第十七次正式发布。
公共参数 状态码 错误码 提交任务类响应
裸金属服务器状态（裸金属服务器的OS-EXT-STS:vm_state属性）必须是active、stopped、paused。 调试 您可以在API Explorer中调试该接口。 URI POST /v1/{project_id}/baremetalservers/{server_id}/metadata
错误码 背景信息 接口返回的错误码与Error Message不具有一一对应关系，表中只是列出比较常见的一种Error Message。 本服务接口以异步接口居多，有的错误码是在查询任务的返回体中体现的，HTTP状态码有可能不是很准确。 本服务对网络、存储等服务具有强依赖性，Error
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
