检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
附录 获取项目ID 获取账号ID
获取远程登录地址（废弃） 功能介绍 获取裸金属服务器远程登录地址。 当前API已废弃，请使用“获取裸金属服务器远程登录地址”。 URL POST /v2.1/{project_id}/servers/{server_id}/action 参数说明请参见表1。 表1 参数说明 参数
修订记录 版本日期 变更说明 2024-10-22 第十九次正式发布。 下线“API（OpenStack Nova v2.1 原生）”章节，废弃接口移至历史API。 2023-11-23 第十八次正式发布。 新增切换裸金属服务器操作系统。 2023-09-14 第十七次正式发布。
公共参数 状态码 错误码 提交任务类响应
关闭裸金属服务器（废弃） 功能介绍 关闭单台裸金属服务器。如需操作多台裸金属服务器，可以使用关闭裸金属服务器API。 当前API已废弃，请使用“关闭裸金属服务器”。 约束 裸金属服务器状态（OS-EXT-STS:vm_state属性）必须是active或error。 当前仅支持强制关闭。
重启裸金属服务器（废弃） 功能介绍 重启单台裸金属服务器。 当前API已废弃，请使用“重启裸金属服务器”。 约束 当前仅支持强制重启。 URI POST /v2.1/{project_id}/servers/{server_id}/action 参数说明请参见表1。 表1 参数说明
查询裸金属服务器规格信息列表（废弃） 功能介绍 查询裸金属服务器规格信息列表。 当前API已废弃，请使用“查询规格详情和规格扩展信息列表”。 约束 本接口查询出来的规格为系统中所有的规格，其中规格的名称以“physical”开头的为裸金属服务器的规格，可用于申请裸金属服务器。 URI
删除裸金属服务器的所有标签。 需在客户端通过以下HTTP header指定微版本号：X-OpenStack-Nova-API-Version: 2.26。 当前API已废弃，请使用“批量删除裸金属服务器标签”。 约束 “__type_baremetal”标识是一台裸金属服务器，建议
应用示例 示例1：创建裸金属服务器 示例2：查询裸金属服务器 示例3：裸金属服务器挂载磁盘
权限和授权项 权限及授权项说明 生命周期管理 状态管理 规格查询 网卡管理 磁盘管理 元数据管理 租户配额管理 密码管理
查询裸金属服务器网卡信息（废弃） 功能介绍 查询裸金属服务器的网卡信息，比如网卡的MAC地址、私网IP信息。 当前API已废弃，请使用“查询裸金属服务器网卡信息”。 URI GET /v2.1/{project_id}/servers/{server_id}/os-interface
查看裸金属服务器是否存在指定标签。 需在客户端通过以下HTTP header指定微版本号：X-OpenStack-Nova-API-Version: 2.26。 当前API已废弃，请使用“查询裸金属服务器标签”。 URI GET /v2.1/{project_id}/servers/{s
裸金属服务器卸载云硬盘（废弃） 功能介绍 卸载裸金属服务器的云硬盘。 当前API已废弃，请使用“裸金属服务器卸载云硬盘”。 约束 裸金属服务器状态为“关机”时支持用户盘的卸载且没有操作系统的限制。当裸金属服务器状态为“运行中”时卸载磁盘有如下约束： 对于Linux裸金属服务器，由
功能介绍 为裸金属服务器添加标签。 需在客户端通过以下HTTP header指定微版本号：X-OpenStack-Nova-API-Version: 2.26。 当前API已废弃，请使用“批量添加裸金属服务器标签”。 约束 标签个数不超过50个。 建议为裸金属服务器添加“__type_b
查询指定裸金属服务器网卡信息（废弃） 功能介绍 根据网卡ID，查询裸金属服务器网卡信息。 当前API已废弃，请使用“查询裸金属服务器网卡信息”。 URI GET /v2.1/{project_id}/servers/{server_id}/os-interface/{id} 参数说明请参见表1。
查询裸金属服务器IP地址（废弃） 功能介绍 查询裸金属服务器私有IP地址信息。 当前API已废弃，请使用“查询裸金属服务器详情”。 约束 不支持分页查询。 URI GET /v2.1/{project_id}/servers/{server_id}/ips 参数说明请参见表1。 表1
裸金属服务器挂载云硬盘（废弃） 功能介绍 为裸金属服务器挂载云硬盘。 当前API已废弃，请使用“裸金属服务器挂载云硬盘”。 约束 不支持挂载bootable的卷。 裸金属服务器状态（OS-EXT-STS:vm_state属性）处于PAUSED状态下不支持挂卷。 要挂载的卷必须是available状态的卷或者共享卷。
查询裸金属服务器列表（废弃） 功能介绍 查询裸金属服务器信息列表。 当前API已废弃，请使用“查询裸金属服务器详情列表”。 约束 该接口查询到的列表包括ECS和BMS全量列表，需要用户根据flavor或者创建时添加的tag信息进行进一步过滤。 在使用image作为条件过滤时，不能
查询租户配额 功能介绍 查询该租户下，所有资源的配额信息，包括已使用配额。 调试 您可以在API Explorer中调试该接口。 URI GET /v1/{project_id}/baremetalservers/limits 参数说明请参见表1。 表1 参数说明 参数 是否必选
扩展属性，磁盘配置方式，取值为以下两种： MANUAL：API使用镜像中的分区方案和文件系统创建裸金属服务器。如果目标flavor磁盘较大，则API不会对剩余磁盘空间进行分区。 AUTO：API使用与目标flavor磁盘大小相同的单个分区创建裸金属服务器，API会自动调整文件系统以适应整个分区。 O
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
