检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
项目ID。 获取方式请参见获取项目ID。 keypair_name 是 密钥名称。 可以通过查询SSH密钥列表（OpenStack原生）API获取。 请求参数 无 请求示例 删除名称为keypair-test的SSH密钥。 1 DELETE https://{ECS Endpoint}/v2
修改裸金属服务器弹性网卡的属性 功能介绍 修改裸金属服务器所绑定的弹性网卡属性：终止时删除，即删除裸金属服务器，或者解绑网卡时是否删除该网卡。 调试 您可以在API Explorer中调试该接口。 URI PUT /v1/{project_id}/baremetalservers/{server_id
修订记录 版本日期 变更说明 2024-10-22 第十九次正式发布。 下线“API（OpenStack Nova v2.1 原生）”章节，废弃接口移至历史API。 2023-11-23 第十八次正式发布。 新增切换裸金属服务器操作系统。 2023-09-14 第十七次正式发布。
安全，结合云中资源的弹性优势，租户可灵活申请，按需使用。 您可以使用本文档提供的API对裸金属服务器进行相关操作，如创建、挂载磁盘、开关机等。支持的全部操作请参见API概览。 在调用裸金属服务器API之前，请确保已经充分了解裸金属服务器相关概念，详细信息请参见产品介绍。 裸金属服
查询裸金属服务器挂载的云硬盘信息 功能介绍 查询裸金属服务器挂载的云硬盘信息。 调试 您可以在API Explorer中调试该接口。 URI GET /v1/{project_id}/baremetalservers/{server_id}/os-volume_attachments
项目ID。 获取方式请参见获取项目ID。 keypair_name 是 密钥名称信息。 可以通过查询SSH密钥列表（OpenStack原生）API获取。 请求参数 无 请求示例 查询密钥名称为keypair-test的密钥详情信息。 1 GET https://{ECS Endpoint}/v2
用户根据设置的请求条件筛选裸金属服务器，并获取裸金属服务器的详细信息。 该接口支持查询裸金属服务器计费方式，以及是否被冻结。 调试 您可以在API Explorer中调试该接口。 URI GET /v1/{project_id}/baremetalservers/detail 参数说明请参见表1。
22xlarge.physical的裸金属服务器，您还需要通过API为该私有镜像打上“__support_c6_22xl_physical”标签。操作方法如下： 获取Token，请参考“认证鉴权”。 参考“更新镜像信息”API，为镜像打上“__support_c6_22xl_physical”标签。
权限和授权项 权限及授权项说明 生命周期管理 状态管理 规格查询 网卡管理 磁盘管理 元数据管理 租户配额管理 密码管理
先在管理控制台上获取到账号ID。账号ID获取步骤如下： 登录管理控制台。 鼠标悬停在右上角的用户名，选择下拉列表中的“我的凭证”。 在“API凭证”页面查看账号ID。 图1 获取账号ID 父主题： 附录
创建和导入SSH密钥（OpenStack原生） 功能介绍 创建SSH密钥，或把公钥导入系统，生成密钥对。 创建SSH密钥成功后，请把响应数据中的私钥内容保存到本地文件，用户使用该私钥登录裸金属服务器。为保证裸金属服务器安全，私钥数据只能读取一次，请妥善保管。 URI POST /v2
在调用接口的时候，部分URL中需要填入项目ID，所以需要获取到项目ID。有如下两种获取方式： 调用API获取项目ID 从控制台获取项目ID 调用API获取项目ID 项目ID可以通过调用查询指定条件下的项目列表API获取。 获取项目ID的接口为“GET https://{Endpoint}/v3/
提交任务类响应 任务ID的响应 订单ID的响应 父主题： 公共参数
状态管理 权限 对应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
查询SSH密钥列表（OpenStack原生） 功能介绍 查询SSH密钥信息列表。 约束 不支持分页查询。 URI GET /v2.1/{project_id}/os-keypairs 参数说明请参见表1。 表1 参数说明 参数 是否必选 描述 project_id 是 项目ID。
公有云提供了Web化的服务管理系统（即管理控制台）和基于HTTPS请求的API（Application Programming Interface）管理方式。 API方式 如果用户需要将云平台上的裸金属服务器集成到第三方系统，用于二次开发，请使用API方式访问裸金属服务器。 管理控制台方式 其他相关操
本服务对网络、存储等服务具有强依赖性，Error Message显示依赖服务的错误消息时，处理措施需要联系技术支持。 错误码说明 当您调用API时，如果遇到“APIGW”开头的错误码，请参见API网关错误码进行处理。 HTTP状态码 返回值 说明 Error Message 处理措施 400 BMS.0001
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
