检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
Windows裸金属服务器获取密码 功能介绍 获取Windows裸金属服务器初始安装时系统生成的管理员账户（Administrator账户或Cloudbase-init设置的账户）随机密码。 如果裸金属服务器是通过私有镜像创建的，请确保已安装Cloudbase-init。公共镜像默认已安装该软件
Windows裸金属服务器清除密码 功能介绍 清除Windows裸金属服务器初始安装时系统生成的密码记录。清除密码后，不影响裸金属服务器密码登录功能，但不能再使用获取密码功能来查询该裸金属服务器密码。 如果裸金属服务器是通过私有镜像创建的，请确保已安装Cloudbase-init。
查询裸金属服务器挂载的云硬盘信息 功能介绍 查询裸金属服务器挂载的云硬盘信息。 调试 您可以在API Explorer中调试该接口。 URI GET /v1/{project_id}/baremetalservers/{server_id}/os-volume_attachments
附录 获取项目ID 获取账号ID
使用前必读 欢迎使用裸金属服务器（Bare Metal Server，BMS）。裸金属服务器为您和您的企业提供专属的云上物理服务器，为核心数据库、关键应用系统、高性能计算、大数据等业务提供卓越的计算性能以及数据安全，结合云中资源的弹性优势，租户可灵活申请，按需使用。 您可以使用本文档提供的
获取裸金属服务器远程登录地址 功能介绍 获取裸金属服务器远程登录地址。 约束 Windows系统的裸金属服务器不支持远程登录。 调试 您可以在API Explorer中调试该接口。 URI POST /v1/{project_id}/baremetalservers/{server_id
裸金属服务器绑定弹性网卡 功能介绍 为裸金属服务器绑定一张或多张弹性网卡。 调试 您可以在API Explorer中调试该接口。 URI POST /v1/{project_id}/baremetalservers/{server_id}/nics 参数说明请参见表1 参数说明。
重装裸金属服务器操作系统 功能介绍 重装裸金属服务器的操作系统。快速发放裸金属服务器支持裸金属服务器数据盘不变的情况下，使用原镜像重装系统盘。重装操作系统支持密码或者密钥注入。 确定裸金属服务器是否为快速发放，请参考查询规格详情和规格扩展信息列表API。 重装操作系统属于异步API
裸金属服务器挂载云硬盘 功能介绍 裸金属服务器创建成功后，如果发现磁盘不够用或者当前磁盘不满足要求，可以将已有云硬盘挂载给裸金属服务器，作为数据盘使用。 约束 不支持批量挂载。 单个裸金属服务器最多挂载60块云硬盘。 不支持挂载bootable的卷。 裸金属服务器状态（OS-EXT-STS
裸金属服务器卸载云硬盘 功能介绍 将挂载至裸金属服务器中的磁盘卸载。 对于挂载在系统盘盘位（也就是“/dev/sda”挂载点）上的磁盘，仅支持离线卸载。 对于挂载在数据盘盘位（非“/dev/sda”挂载点）上的磁盘，支持离线卸载和在线卸载磁盘。 离线和在线表示裸金属服务器处于“关机
查询裸金属服务器详情 功能介绍 获取裸金属服务器的详细信息。 该接口支持查询裸金属服务器的计费方式，以及是否被冻结。 调试 您可以在API Explorer中调试该接口。 URI GET /v1/{project_id}/baremetalservers/{server_id} 参数说明请参见表
查询SSH密钥列表（OpenStack原生） 功能介绍 查询SSH密钥信息列表。 约束 不支持分页查询。 URI GET /v2.1/{project_id}/os-keypairs 参数说明请参见表1。 表1 参数说明 参数 是否必选 描述 project_id 是 项目ID。
应用示例 示例1：创建裸金属服务器 示例2：查询裸金属服务器 示例3：裸金属服务器挂载磁盘
公共参数 状态码 错误码 提交任务类响应
更新裸金属服务器元数据 功能介绍 更新裸金属服务器元数据。 如果元数据中没有待更新字段，则自动添加该字段。 如果元数据中已存在待更新字段，则直接更新字段值。 如果元数据中的字段不再请求参数中，则保持不变。 约束 裸金属服务器状态（裸金属服务器的OS-EXT-STS:vm_state
删除SSH密钥（OpenStack原生） 功能介绍 根据SSH密钥的名称，删除指定SSH密钥。 URI DELETE /v2.1/{project_id}/os-keypairs/{keypair_name} 参数说明请参见表1。 表1 参数说明 参数 是否必选 描述 project_id
查询SSH密钥详情（OpenStack原生） 功能介绍 根据SSH密钥名称查询指定SSH密钥。 URI GET /v2.1/{project_id}/os-keypairs/{keypair_name} 参数说明请参见表1。 表1 参数说明 参数 是否必选 描述 project_id
修订记录 版本日期 变更说明 2024-10-22 第十九次正式发布。 下线“API（OpenStack Nova v2.1 原生）”章节，废弃接口移至历史API。 2023-11-23 第十八次正式发布。 新增切换裸金属服务器操作系统。 2023-09-14 第十七次正式发布。
错误码 背景信息 接口返回的错误码与Error Message不具有一一对应关系，表中只是列出比较常见的一种Error Message。 本服务接口以异步接口居多，有的错误码是在查询任务的返回体中体现的，HTTP状态码有可能不是很准确。 本服务对网络、存储等服务具有强依赖性，Error
创建和导入SSH密钥（OpenStack原生） 功能介绍 创建SSH密钥，或把公钥导入系统，生成密钥对。 创建SSH密钥成功后，请把响应数据中的私钥内容保存到本地文件，用户使用该私钥登录裸金属服务器。为保证裸金属服务器安全，私钥数据只能读取一次，请妥善保管。 URI POST /v2.1
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
