检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
使用前必读 欢迎使用裸金属服务器（Bare Metal Server，BMS）。裸金属服务器为您和您的企业提供专属的云上物理服务器，为核心数据库、关键应用系统、高性能计算、大数据等业务提供卓越的计算性能以及数据安全，结合云中资源的弹性优势，租户可灵活申请，按需使用。 您可以使用本文档提供的
创建和导入SSH密钥（OpenStack原生） 功能介绍 创建SSH密钥，或把公钥导入系统，生成密钥对。 创建SSH密钥成功后，请把响应数据中的私钥内容保存到本地文件，用户使用该私钥登录裸金属服务器。为保证裸金属服务器安全，私钥数据只能读取一次，请妥善保管。 URI POST /v2.1
修订记录 版本日期 变更说明 2024-10-22 第十九次正式发布。 下线“API（OpenStack Nova v2.1 原生）”章节，废弃接口移至历史API。 2023-11-23 第十八次正式发布。 新增切换裸金属服务器操作系统。 2023-09-14 第十七次正式发布。
查询裸金属服务器详情列表 功能介绍 用户根据设置的请求条件筛选裸金属服务器，并获取裸金属服务器的详细信息。 该接口支持查询裸金属服务器计费方式，以及是否被冻结。 调试 您可以在API Explorer中调试该接口。 URI GET /v1/{project_id}/baremetalservers
查询SSH密钥列表（OpenStack原生） 功能介绍 查询SSH密钥信息列表。 约束 不支持分页查询。 URI GET /v2.1/{project_id}/os-keypairs 参数说明请参见表1。 表1 参数说明 参数 是否必选 描述 project_id 是 项目ID。
高速网络栈 概述 高速网络栈基于高性能网络协议，通过AI参数面网络实现裸金属服务器内NPU卡的互通互联，可提供大规模集群网络拓扑管理和智能调度能力，同时，结合网络大脑的故障快速感知恢复能力，可为AI训练和推理场景提供大规模高性能高可靠的网络通信。 目前高速网络栈能力为受限功能，如需使用请提交工单或联系华为工程师评估后处理
状态码 正常 返回值 说明 200 OK 服务器已成功处理了请求。 201 Created 请求成功并且服务器创建了新的资源。 202 Accepted 服务器已接受请求，延迟处理。 204 No Content 服务器成功处理了请求，但没有返回任何内容。 异常 返回值 说明 400
权限和授权项 权限及授权项说明 生命周期管理 状态管理 规格查询 网卡管理 磁盘管理 元数据管理 租户配额管理 密码管理
获取项目ID 操作场景 在调用接口的时候，部分URL中需要填入项目ID，所以需要获取到项目ID。有如下两种获取方式： 调用API获取项目ID 从控制台获取项目ID 调用API获取项目ID 项目ID可以通过调用查询指定条件下的项目列表API获取。 获取项目ID的接口为“GET https
弹性公网IP概述 弹性公网IP 弹性公网IP（Elastic IP，EIP）提供独立的公网IP资源，包括公网IP地址与公网出口带宽服务。与传统静态IP地址不同，弹性公网IP支持与裸金属服务器、云服务器、NAT网关等资源动态绑定和解绑，可以实现绑定资源的灵活切换。当绑定的服务器出现故障时
主机名自动更新问题设置（可选） 问题现象：重启后主机名发生变化，恢复为console名称或曾用名。/etc/hosts 中localhost恢复为console名称或曾用名。建议：为保证不再意外出现这个问题，建议修改console名称与hostname一致。 检查方法： 检查/etc
提交任务类响应 任务ID的响应 订单ID的响应 父主题： 公共参数
状态管理 权限 对应API接口 授权项（Action） IAM项目（Project） 企业项目（Enterprise Project） 修改裸金属服务器名称 PUT /v1/{project_id}/baremetalservers/{server_id} bms:servers:
规格查询 权限 对应API接口 授权项（Action） IAM项目（Project） 企业项目（Enterprise Project） 查询规格详情和规格扩展信息列表 GET /v1/{project_id}/baremetalservers/flavors bms:serverFlavors
密码管理 权限 对应API接口 授权项（Action） IAM项目（Project） 企业项目（Enterprise Project） 查询裸金属服务器是否支持重置密码 GET /v1/{project_id}/baremetalservers/{server_id}/os-resetpwd-flag
租户配额管理 权限 对应API接口 授权项（Action） IAM项目（Project） 企业项目（Enterprise Project） 查询租户配额 GET /v1/{project_id}/baremetalservers/limits bms:serverQuotas:get
磁盘管理 权限 对应API接口 授权项（Action） 依赖的授权项（Action） IAM项目（Project） 企业项目（Enterprise Project） 卸载指定裸金属服务器的磁盘 DELETE /v1/{project_id}/baremetalservers/{server_id
生命周期管理 权限 对应API接口 授权项（Action） IAM项目（Project） 企业项目（Enterprise Project） 创建裸金属服务器 POST /v1/project_id}/baremetalservers bms:servers:create √ √ 查询裸金属服务器详情列表
订单ID的响应 正常响应要素 表1 正常响应要素说明 名称 参数类型 说明 order_id String 提交订单成功后返回的订单ID，用户可以使用该ID对订单的处理情况进行查询（在管理控制台的“费用中心 > 我的订单”页面查询）。 job_id String 提交任务成功后返回的任务
元数据管理 权限 对应API接口 授权项（Action） IAM项目（Project） 企业项目（Enterprise Project） 更新裸金属服务器元数据 POST /v1/{project_id}/baremetalservers/{server_id}/metadata
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
