检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
参数说明 参数 是否必选 描述 project_id 是 项目ID。 获取方式请参见获取项目ID。 server_id 是 裸金属服务器ID。 可以从裸金属服务器控制台查询，或者通过调用查询裸金属服务器列表（废弃）获取。 请求参数 表2 请求参数说明 参数 是否必选 参数类型 说明 metadata
Message，或者联系技术支持。 400 Common.0018 token无效，token中的tenant_id和URL中的tenant_id不一致 tenantId in token is not the same with in URL. 请检查租户的token是否正确。 400 BMS.0111 密码或密钥未指定或者重复指定。
安全，结合云中资源的弹性优势，租户可灵活申请，按需使用。 您可以使用本文档提供的API对裸金属服务器进行相关操作，如创建、挂载磁盘、开关机等。支持的全部操作请参见API概览。 在调用裸金属服务器API之前，请确保已经充分了解裸金属服务器相关概念，详细信息请参见产品介绍。 裸金属服
裸金属服务器在创建时选择密钥鉴权方式，想使用密码方式登录，怎么办？ Windows操作系统的裸金属服务器在创建时只能选择密钥鉴权方式，想使用密码方式登录，可以参考以下方法获取密码： 将密钥文件解析为密码，参考链接：获取Windows裸金属服务器的密码 通过控制台的重置密码功能设置密码。参考链接：重置裸金属服务器密码
修订记录 版本日期 变更说明 2024-10-22 第十九次正式发布。 下线“API（OpenStack Nova v2.1 原生）”章节，废弃接口移至历史API。 2023-11-23 第十八次正式发布。 新增切换裸金属服务器操作系统。 2023-09-14 第十七次正式发布。
1/{project_id}/os-keypairs 参数说明请参见表1。 表1 参数说明 参数 是否必选 描述 project_id 是 项目ID。 获取方式请参见获取项目ID。 请求参数 无 请求示例 查询项目ID为bbf1946d374b44a0a2a95533562ba954的SSH密钥列表。
密码管理 权限 对应API接口 授权项（Action） IAM项目（Project） 企业项目（Enterprise Project） 查询裸金属服务器是否支持重置密码 GET /v1/{project_id}/baremetalservers/{server_id}/os-resetpwd-flag
应用示例 示例1：创建裸金属服务器 示例2：查询裸金属服务器 示例3：裸金属服务器挂载磁盘
Service，TMS）使用该接口批量管理裸金属服务器的标签。 此接口为幂等接口，创建时，如果创建的标签已经存在（key/value均相同视为重复），默认处理成功。key相同，value不同时，会覆盖原有标签。 约束 每台裸金属服务器最多20个标签。 调试 您可以在API Explorer中调试该接口。
为指定裸金属服务器批量删除标签。 TMS使用该接口批量管理裸金属服务器的标签。 此接口为幂等接口，删除时，如果删除的标签不存在，默认处理成功。 约束与限制 每个裸金属服务器最多20个标签。 调试 您可以在API Explorer中调试该接口。 URI POST /v1/{projec
公共参数 状态码 错误码 提交任务类响应
权限和授权项 权限及授权项说明 生命周期管理 状态管理 规格查询 网卡管理 磁盘管理 元数据管理 租户配额管理 密码管理
状态管理 权限 对应API接口 授权项（Action） IAM项目（Project） 企业项目（Enterprise Project） 修改裸金属服务器名称 PUT /v1/{project_id}/baremetalservers/{server_id} bms:servers:put
规格查询 权限 对应API接口 授权项（Action） IAM项目（Project） 企业项目（Enterprise Project） 查询规格详情和规格扩展信息列表 GET /v1/{project_id}/baremetalservers/flavors bms:serverFlavors:get
网卡管理 权限 对应API接口 授权项（Action） IAM项目（Project） 企业项目（Enterprise Project） 查询裸金属服务器网卡信息 GET /v1/{project_id}/baremetalservers/{server_id}/os-interface
方式一：使用镜像服务的ISO镜像功能制作镜像 创建云服务器系统盘镜像 以zvhd2格式导出镜像至OBS桶 制作裸金属服务器镜像 父主题： 获取镜像
状态码 正常 返回值 说明 200 OK 服务器已成功处理了请求。 201 Created 请求成功并且服务器创建了新的资源。 202 Accepted 服务器已接受请求，延迟处理。 204 No Content 服务器成功处理了请求，但没有返回任何内容。 异常 返回值 说明 400
示例2：查询裸金属服务器 操作场景 当您名下有多台裸金属服务器时，可以指定查询条件获取需要的裸金属服务器。 涉及接口 涉及的接口如下： 查询裸金属服务器详情列表 指定flavor查询裸金属服务器详情列表 接口相关信息 URI格式：GET /v1/{project_id}/baremetalservers/detail
提交任务类响应 任务ID的响应 订单ID的响应 父主题： 公共参数
磁盘管理 权限 对应API接口 授权项（Action） 依赖的授权项（Action） IAM项目（Project） 企业项目（Enterprise Project） 卸载指定裸金属服务器的磁盘 DELETE /v1/{project_id}/baremetalservers/{s
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
