检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
Service，TMS）使用该接口批量管理裸金属服务器的标签。 此接口为幂等接口，创建时，如果创建的标签已经存在（key/value均相同视为重复），默认处理成功。key相同，value不同时，会覆盖原有标签。 约束 每台裸金属服务器最多20个标签。 调试 您可以在API Explorer中调试该接口。
修订记录 版本日期 变更说明 2024-10-22 第十九次正式发布。 下线“API（OpenStack Nova v2.1 原生）”章节，废弃接口移至历史API。 2023-11-23 第十八次正式发布。 新增切换裸金属服务器操作系统。 2023-09-14 第十七次正式发布。
裸金属服务器状态（裸金属服务器的OS-EXT-STS:vm_state属性）必须是active、stopped、paused。 调试 您可以在API Explorer中调试该接口。 URI POST /v1/{project_id}/baremetalservers/{server_id}/metadata
查询裸金属服务器详情列表 功能介绍 用户根据设置的请求条件筛选裸金属服务器，并获取裸金属服务器的详细信息。 该接口支持查询裸金属服务器计费方式，以及是否被冻结。 调试 您可以在API Explorer中调试该接口。 URI GET /v1/{project_id}/baremetalservers/detail
项目ID。 获取方式请参见获取项目ID。 keypair_name 是 密钥名称信息。 可以通过查询SSH密钥列表（OpenStack原生）API获取。 请求参数 无 请求示例 查询密钥名称为keypair-test的密钥详情信息。 1 GET https://{ECS Endpoint}/v2
租户配额管理 权限 对应API接口 授权项（Action） IAM项目（Project） 企业项目（Enterprise Project） 查询租户配额 GET /v1/{project_id}/baremetalservers/limits bms:serverQuotas:get
权限和授权项 权限及授权项说明 生命周期管理 状态管理 规格查询 网卡管理 磁盘管理 元数据管理 租户配额管理 密码管理
创建和导入SSH密钥（OpenStack原生） 功能介绍 创建SSH密钥，或把公钥导入系统，生成密钥对。 创建SSH密钥成功后，请把响应数据中的私钥内容保存到本地文件，用户使用该私钥登录裸金属服务器。为保证裸金属服务器安全，私钥数据只能读取一次，请妥善保管。 URI POST /v2
生命周期管理 权限 对应API接口 授权项（Action） IAM项目（Project） 企业项目（Enterprise Project） 创建裸金属服务器 POST /v1/project_id}/baremetalservers bms:servers:create √ √ 查询裸金属服务器详情列表
提交任务类响应 任务ID的响应 订单ID的响应 父主题： 公共参数
获取账号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:
状态码 正常 返回值 说明 200 OK 服务器已成功处理了请求。 201 Created 请求成功并且服务器创建了新的资源。 202 Accepted 服务器已接受请求，延迟处理。 204 No Content 服务器成功处理了请求，但没有返回任何内容。 异常 返回值 说明 400
状态管理 权限 对应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
密码管理 权限 对应API接口 授权项（Action） IAM项目（Project） 企业项目（Enterprise Project） 查询裸金属服务器是否支持重置密码 GET /v1/{project_id}/baremetalservers/{server_id}/os-resetpwd-flag
磁盘管理 权限 对应API接口 授权项（Action） 依赖的授权项（Action） IAM项目（Project） 企业项目（Enterprise Project） 卸载指定裸金属服务器的磁盘 DELETE /v1/{project_id}/baremetalservers/{s
元数据管理 权限 对应API接口 授权项（Action） IAM项目（Project） 企业项目（Enterprise Project） 更新裸金属服务器元数据 POST /v1/{project_id}/baremetalservers/{server_id}/metadata
属服务器进行部署。 下面介绍如何调用创建裸金属服务器API创建裸金属服务器，API的调用方法请参见如何调用API。 目前仅支持创建包年/包月裸金属服务器。 前提条件 您需要规划裸金属服务器所在的区域信息，并根据区域确定调用API的Endpoint，详细信息请参见终端节点。 裸金属
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
