检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
获取裸金属服务器远程登录地址 功能介绍 获取裸金属服务器远程登录地址。 约束 Windows系统的裸金属服务器不支持远程登录。 调试 您可以在API Explorer中调试该接口。 URI POST /v1/{project_id}/baremetalservers/{server_id
裸金属服务器绑定弹性网卡 功能介绍 为裸金属服务器绑定一张或多张弹性网卡。 调试 您可以在API Explorer中调试该接口。 URI POST /v1/{project_id}/baremetalservers/{server_id}/nics 参数说明请参见表1 参数说明。
批量添加裸金属服务器标签 功能介绍 为指定裸金属服务器批量添加标签。 标签管理服务（Tag Management Service，TMS）使用该接口批量管理裸金属服务器的标签。 此接口为幂等接口，创建时，如果创建的标签已经存在（key/value均相同视为重复），默认处理成功。key
查询SSH密钥详情（OpenStack原生） 功能介绍 根据SSH密钥名称查询指定SSH密钥。 URI GET /v2.1/{project_id}/os-keypairs/{keypair_name} 参数说明请参见表1。 表1 参数说明 参数 是否必选 描述 project_id
修改裸金属服务器弹性网卡的属性 功能介绍 修改裸金属服务器所绑定的弹性网卡属性：终止时删除，即删除裸金属服务器，或者解绑网卡时是否删除该网卡。 调试 您可以在API Explorer中调试该接口。 URI PUT /v1/{project_id}/baremetalservers/
查询SSH密钥列表（OpenStack原生） 功能介绍 查询SSH密钥信息列表。 约束 不支持分页查询。 URI GET /v2.1/{project_id}/os-keypairs 参数说明请参见表1。 表1 参数说明 参数 是否必选 描述 project_id 是 项目ID。
应用示例 示例1：创建裸金属服务器 示例2：查询裸金属服务器 示例3：裸金属服务器挂载磁盘
使用前必读 欢迎使用裸金属服务器（Bare Metal Server，BMS）。裸金属服务器为您和您的企业提供专属的云上物理服务器，为核心数据库、关键应用系统、高性能计算、大数据等业务提供卓越的计算性能以及数据安全，结合云中资源的弹性优势，租户可灵活申请，按需使用。 您可以使用本文档提供的
创建和导入SSH密钥（OpenStack原生） 功能介绍 创建SSH密钥，或把公钥导入系统，生成密钥对。 创建SSH密钥成功后，请把响应数据中的私钥内容保存到本地文件，用户使用该私钥登录裸金属服务器。为保证裸金属服务器安全，私钥数据只能读取一次，请妥善保管。 URI POST /v2.1
查询裸金属服务器挂载的云硬盘信息 功能介绍 查询裸金属服务器挂载的云硬盘信息。 调试 您可以在API Explorer中调试该接口。 URI GET /v1/{project_id}/baremetalservers/{server_id}/os-volume_attachments
修订记录 版本日期 变更说明 2024-10-22 第十九次正式发布。 下线“API（OpenStack Nova v2.1 原生）”章节，废弃接口移至历史API。 2023-11-23 第十八次正式发布。 新增切换裸金属服务器操作系统。 2023-09-14 第十七次正式发布。
更新裸金属服务器元数据 功能介绍 更新裸金属服务器元数据。 如果元数据中没有待更新字段，则自动添加该字段。 如果元数据中已存在待更新字段，则直接更新字段值。 如果元数据中的字段不再请求参数中，则保持不变。 约束 裸金属服务器状态（裸金属服务器的OS-EXT-STS:vm_state
查询裸金属服务器详情列表 功能介绍 用户根据设置的请求条件筛选裸金属服务器，并获取裸金属服务器的详细信息。 该接口支持查询裸金属服务器计费方式，以及是否被冻结。 调试 您可以在API Explorer中调试该接口。 URI GET /v1/{project_id}/baremetalservers
状态码 正常 返回值 说明 200 OK 服务器已成功处理了请求。 201 Created 请求成功并且服务器创建了新的资源。 202 Accepted 服务器已接受请求，延迟处理。 204 No Content 服务器成功处理了请求，但没有返回任何内容。 异常 返回值 说明 400
权限和授权项 权限及授权项说明 生命周期管理 状态管理 规格查询 网卡管理 磁盘管理 元数据管理 租户配额管理 密码管理
错误码 背景信息 接口返回的错误码与Error Message不具有一一对应关系，表中只是列出比较常见的一种Error Message。 本服务接口以异步接口居多，有的错误码是在查询任务的返回体中体现的，HTTP状态码有可能不是很准确。 本服务对网络、存储等服务具有强依赖性，Error
获取项目ID 操作场景 在调用接口的时候，部分URL中需要填入项目ID，所以需要获取到项目ID。有如下两种获取方式： 调用API获取项目ID 从控制台获取项目ID 调用API获取项目ID 项目ID可以通过调用查询指定条件下的项目列表API获取。 获取项目ID的接口为“GET https
获取账号ID 在调用接口的时候，部分URL中需要填入账号ID（domain_id），所以需要先在管理控制台上获取到账号ID。账号ID获取步骤如下： 登录管理控制台。 鼠标悬停在右上角的用户名，选择下拉列表中的“我的凭证”。 在“API凭证”页面查看账号ID。 图1 获取账号ID 父主题
提交任务类响应 任务ID的响应 订单ID的响应 父主题： 公共参数
磁盘管理 权限 对应API接口 授权项（Action） 依赖的授权项（Action） IAM项目（Project） 企业项目（Enterprise Project） 卸载指定裸金属服务器的磁盘 DELETE /v1/{project_id}/baremetalservers/{server_id
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
