检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
任务ID的响应 正常响应要素 表1 正常响应要素说明 名称 参数类型 说明 job_id String 提交任务成功后返回的任务ID，用户可以使用该ID对任务执行情况进行查询。 如何根据job_id来查询Job的执行状态，请参考查询Job状态。 异常响应要素 表2 异常响应要素说明
查询裸金属服务器详情 功能介绍 获取裸金属服务器的详细信息。 该接口支持查询裸金属服务器的计费方式，以及是否被冻结。 调试 您可以在API Explorer中调试该接口。 URI GET /v1/{project_id}/baremetalservers/{server_id} 参数说明请参见表1。
创建裸金属服务器（废弃） 功能介绍 创建一台裸金属服务器。 当前API已废弃，请使用“创建裸金属服务器”。 约束 本接口不支持批量创建裸金属服务器。 使用支持Cloud-init或Cloudbase-init功能的镜像创建裸金属服务器时，只能使用key_name参数，adminP
裸金属服务器解绑弹性网卡 功能介绍 解绑裸金属服务器中的一张或多张弹性网卡。 主网卡是裸金属服务器上配置了路由规则的网卡，不可解绑。 调试 您可以在API Explorer中调试该接口。 URI POST /v1/{project_id}/baremetalservers/{se
重启裸金属服务器 功能介绍 根据给定的裸金属服务器ID列表，批量重启裸金属服务器。一次最多可以重启1000台。 重启裸金属服务器属于异步API，接口调用成功只表示请求下发成功，任务执行结果请通过查询Job状态API获取。 调试 您可以在API Explorer中调试该接口。 URI
修改裸金属服务器名称 功能介绍 修改裸金属服务器名称。 约束 裸金属服务器名称取值范围： 只能由中文字符、英文字母（a~z，A~Z）、数字（0~9）、下划线（_）、中划线（-）、点（.）组成，且长度为[1-63]个字符。 本接口只修改裸金属服务器的实例名称，但hostname不能同步修改。重启裸金属服务器后生效。
权限和授权项 权限及授权项说明 生命周期管理 状态管理 规格查询 网卡管理 磁盘管理 元数据管理 租户配额管理 密码管理
API概览 接口介绍 裸金属服务器所提供的接口分为BMS接口与OpenStack原生接口。推荐您使用BMS接口。 表1 接口说明 类型 子类型 说明 BMS接口 查询API版本信息 查询裸金属服务器服务当前所用的API版本。 生命周期管理 可以实现包周期裸金属服务器的创建、裸金属服务器详情查询等操作。
订单ID的响应 正常响应要素 表1 正常响应要素说明 名称 参数类型 说明 order_id String 提交订单成功后返回的订单ID，用户可以使用该ID对订单的处理情况进行查询（在管理控制台的“费用中心 > 我的订单”页面查询）。 job_id String 提交任务成功后返
查询租户配额 功能介绍 查询该租户下，所有资源的配额信息，包括已使用配额。 调试 您可以在API Explorer中调试该接口。 URI GET /v1/{project_id}/baremetalservers/limits 参数说明请参见表1。 表1 参数说明 参数 是否必选
裸金属服务器绑定弹性网卡 功能介绍 为裸金属服务器绑定一张或多张弹性网卡。 调试 您可以在API Explorer中调试该接口。 URI POST /v1/{project_id}/baremetalservers/{server_id}/nics 参数说明请参见表1 参数说明。
实例家族 实例概述 实例即您创建的一台裸金属服务器。不同实例类型提供不同的计算能力、存储空间、网络性能，您可以基于业务需求选择不同类型的实例。当华为云向您交付一个实例时，您将获得这台服务器完整的控制权限，包括开机、关机、带内管理等。 实例类型 裸金属服务器按着CPU体系架构，分为
查询API版本信息列表 功能介绍 查询裸金属服务器当前所有可用的API版本。 调试 您可以在API Explorer中调试该接口。 URI GET / 请求参数 无 请求示例 查询当前所有可用的API版本。 1 GET https://{BMS Endpoint}/ 响应参数 参数
责任共担 华为云秉承“将公司对网络和业务安全性保障的责任置于公司的商业利益之上”。针对层出不穷的云安全挑战和无孔不入的云安全威胁与攻击，华为云在遵从法律法规业界标准的基础上，以安全生态圈为护城河，依托华为独有的软硬件优势，构建面向不同区域和行业的完善云服务安全保障体系。 安全性是华为云与您的共同责任，如图1所示。
批量删除裸金属服务器标签 功能介绍 为指定裸金属服务器批量删除标签。 TMS使用该接口批量管理裸金属服务器的标签。 此接口为幂等接口，删除时，如果删除的标签不存在，默认处理成功。 约束与限制 每个裸金属服务器最多20个标签。 调试 您可以在API Explorer中调试该接口。 URI
切换裸金属服务器操作系统 功能介绍 切换裸金属服务器的操作系统。切换操作系统支持密码或者密钥注入。 切换操作系统属于异步API，接口调用成功只表示请求下发成功，任务执行结果请通过查询Job状态API获取。 约束 关机状态或者切换操作系统失败的裸金属服务器，才能执行切换操作。 使用
查询裸金属服务器详情（废弃） 功能介绍 根据裸金属服务器ID，查询裸金属服务器的详细信息。 当前API已废弃，请使用“查询裸金属服务器详情”。 URI GET /v2.1/{project_id}/servers/{server_id} 参数说明请参见表1。 表1 参数说明 参数
查询SSH密钥列表（OpenStack原生） 功能介绍 查询SSH密钥信息列表。 约束 不支持分页查询。 URI GET /v2.1/{project_id}/os-keypairs 参数说明请参见表1。 表1 参数说明 参数 是否必选 描述 project_id 是 项目ID。
查询指定API版本信息 功能介绍 查询裸金属服务器指定API版本的信息。 调试 您可以在API Explorer中调试该接口。 URI GET /{api_version} 参数说明请参见表1。 表1 参数说明 参数 是否必选 描述 api_version 是 API版本号。例如：v1
批量添加裸金属服务器标签 功能介绍 为指定裸金属服务器批量添加标签。 标签管理服务（Tag Management Service，TMS）使用该接口批量管理裸金属服务器的标签。 此接口为幂等接口，创建时，如果创建的标签已经存在（key/value均相同视为重复），默认处理成功。k
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
