检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
切换裸金属服务器操作系统 功能介绍 切换裸金属服务器的操作系统。切换操作系统支持密码或者密钥注入。 切换操作系统属于异步API，接口调用成功只表示请求下发成功，任务执行结果请通过查询Job状态API获取。 约束 关机状态或者切换操作系统失败的裸金属服务器，才能执行切换操作。 使用私有镜像创建的裸金属
须具备调用该接口所需的权限，否则，API请求将调用失败。每个接口所需要的权限，与各个接口所对应的授权项相对应，只有发起请求的用户被授予授权项所对应的策略，该用户才能成功调用该接口。例如，用户要调用接口来查询裸金属服务器列表，那么这个IAM用户被授予的策略中必须包含允许“bms:s
对于Windows裸金属服务器，在线卸载磁盘，请确保没有程序正在对该磁盘进行读写操作。否则，将造成数据丢失。 调试 您可以在API Explorer中调试该接口。 URI DELETE /v1/{project_id}/baremetalservers/{server_id}/de
D状态下不支持挂卷。 要挂载的卷必须是available状态的卷或者共享卷。 仅支持挂载SCSI类型的卷。 调试 您可以在API Explorer中调试该接口。 URI POST /v1/{project_id}/baremetalservers/{server_id}/attachvolume
为指定裸金属服务器批量删除标签。 TMS使用该接口批量管理裸金属服务器的标签。 此接口为幂等接口，删除时，如果删除的标签不存在，默认处理成功。 约束与限制 每个裸金属服务器最多20个标签。 调试 您可以在API Explorer中调试该接口。 URI POST /v1/{projec
指南》的“安装一键式重置密码插件”章节。 裸金属服务器的密码重置失败后，该API不会报错。 裸金属服务器开机或重启后，新密码生效。 调试 您可以在API Explorer中调试该接口。 URI PUT /v1/{project_id}/baremetalservers/{serv
扩展属性，磁盘配置，取值为以下两种： MANUAL：API使用镜像中的分区方案和文件系统创建裸金属服务器。如果目标flavor磁盘较大，则API不会对剩余磁盘空间进行分区。 AUTO：API使用与目标flavor磁盘大小相同的单个分区创建裸金属服务器，API会自动调整文件系统以适应整个分区。 fault
裸金属服务器状态（裸金属服务器的OS-EXT-STS:vm_state属性）必须是active、stopped、paused。 调试 您可以在API Explorer中调试该接口。 URI POST /v1/{project_id}/baremetalservers/{server_id}/metadata
功能介绍 解绑裸金属服务器中的一张或多张弹性网卡。 主网卡是裸金属服务器上配置了路由规则的网卡，不可解绑。 调试 您可以在API Explorer中调试该接口。 URI POST /v1/{project_id}/baremetalservers/{server_id}/nics/delete
创建和导入SSH密钥（OpenStack原生） 功能介绍 创建SSH密钥，或把公钥导入系统，生成密钥对。 创建SSH密钥成功后，请把响应数据中的私钥内容保存到本地文件，用户使用该私钥登录裸金属服务器。为保证裸金属服务器安全，私钥数据只能读取一次，请妥善保管。 URI POST /v2
功能介绍 修改裸金属服务器所绑定的弹性网卡属性：终止时删除，即删除裸金属服务器，或者解绑网卡时是否删除该网卡。 调试 您可以在API Explorer中调试该接口。 URI PUT /v1/{project_id}/baremetalservers/{server_id}/os-interface/{port_id}
查询裸金属服务器挂载的云硬盘信息 功能介绍 查询裸金属服务器挂载的云硬盘信息。 调试 您可以在API Explorer中调试该接口。 URI GET /v1/{project_id}/baremetalservers/{server_id}/os-volume_attachments
查询裸金属服务器详情列表 功能介绍 用户根据设置的请求条件筛选裸金属服务器，并获取裸金属服务器的详细信息。 该接口支持查询裸金属服务器计费方式，以及是否被冻结。 调试 您可以在API Explorer中调试该接口。 URI GET /v1/{project_id}/baremetalservers/detail
获取账号ID 在调用接口的时候，部分URL中需要填入账号ID（domain_id），所以需要先在管理控制台上获取到账号ID。账号ID获取步骤如下： 登录管理控制台。 鼠标悬停在右上角的用户名，选择下拉列表中的“我的凭证”。 在“API凭证”页面查看账号ID。 图1 获取账号ID 父主题：
获取项目ID 操作场景 在调用接口的时候，部分URL中需要填入项目ID，所以需要获取到项目ID。有如下两种获取方式： 调用API获取项目ID 从控制台获取项目ID 调用API获取项目ID 项目ID可以通过调用查询指定条件下的项目列表API获取。 获取项目ID的接口为“GET https:
查询SSH密钥列表（OpenStack原生） 功能介绍 查询SSH密钥信息列表。 约束 不支持分页查询。 URI GET /v2.1/{project_id}/os-keypairs 参数说明请参见表1。 表1 参数说明 参数 是否必选 描述 project_id 是 项目ID。
初始化Linux数据盘 初始化Windows数据盘 05 API 通过BMS开放的丰富API和调用示例，您可以使用并管理实例、规格、云硬盘、网卡、安全组等。 API文档 API 概览 API 调用示例 BMS API OpenStack Nova API 02 入门 以部署一台Web应用服务器为例，帮助您快速上手裸金属服务器。
状态码 正常 返回值 说明 200 OK 服务器已成功处理了请求。 201 Created 请求成功并且服务器创建了新的资源。 202 Accepted 服务器已接受请求，延迟处理。 204 No Content 服务器成功处理了请求，但没有返回任何内容。 异常 返回值 说明 400
错误码 背景信息 接口返回的错误码与Error Message不具有一一对应关系，表中只是列出比较常见的一种Error Message。 本服务接口以异步接口居多，有的错误码是在查询任务的返回体中体现的，HTTP状态码有可能不是很准确。 本服务对网络、存储等服务具有强依赖性，Error
BMS服务提供了丰富的API供您使用，包括BMS接口和OpenStack开源原生接口。如果您熟悉网络服务协议和一种以上编程语言，推荐您使用BMS API管理您的云上资源。 读者对象：裸金属服务器专家、企业管理/开发人员、个人开发者 API参考 2018年3月 序号 功能名称 功能描述
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
