检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
API 接口使用说明 查询API版本信息 裸金属服务器生命周期管理 裸金属服务器状态管理 裸金属服务器规格管理 裸金属服务器网卡管理 裸金属服务器云硬盘管理 裸金属服务器元数据管理 裸金属服务器租户配额管理 裸金属服务器密码管理 Job管理 裸金属服务器的标签管理 裸金属服务器SSH密钥管理（OpenStack原生）
API概览 接口介绍 裸金属服务器所提供的接口分为BMS接口与OpenStack原生接口。推荐您使用BMS接口。 表1 接口说明 类型 子类型 说明 BMS接口 查询API版本信息 查询裸金属服务器服务当前所用的API版本。 生命周期管理 可以实现包周期裸金属服务器的创建、裸金属服务器详情查询等操作。
历史API 接口使用说明（OpenStack Nova API） 查询API版本信息（OpenStack Nova API） 裸金属服务器生命周期管理（OpenStack Nova API） 裸金属服务器状态管理（OpenStack Nova API） 裸金属服务器元数据管理（OpenStack
是否支持API方式访问裸金属服务器？ 支持。 BMS服务提供了丰富的API供您使用，包括BMS接口和OpenStack开源原生接口。如果您熟悉网络服务协议和一种以上编程语言，推荐您使用BMS API管理您的云上资源。 详情请参阅《裸金属服务器API参考》。 父主题： 通用类
查询API版本信息（OpenStack Nova API） 查询API版本信息列表 查询指定API版本信息 父主题： 历史API
如何调用API 构造请求 认证鉴权 返回结果
查询API版本信息 查询API版本信息列表 查询指定API版本信息 父主题： API
查询指定API版本信息 功能介绍 查询裸金属服务器指定API版本的信息。 调试 您可以在API Explorer中调试该接口。 URI GET /{api_version} 参数说明请参见表1。 表1 参数说明 参数 是否必选 描述 api_version 是 API版本号。例如：v1
查询指定API版本信息 功能介绍 返回指定API版本的信息。 URI GET /{api_version} 参数说明请参见表1。 表1 参数说明 参数 是否必选 描述 api_version 是 API版本号。例如：v2 请求参数 无 请求示例 查询v2版本的API版本信息。 1
已配置安全组入方向的访问规则，配置方式请参见添加安全组规则。 使用的登录工具（如PuTTY）与待登录的裸金属服务器之间网络连通。例如，默认的22端口没有被防火墙屏蔽。 密钥登录方式创建的Linux裸金属服务器，如需使用用户名和密码方式登录，请先使用远程登录方式登录裸金属服务器，开启SSH密码登录权限，具体操作请参见如何设置SSH服务配置项。
接口使用说明（OpenStack Nova API） 网络相关服务API，请参考《虚拟私有云API参考》。 专属分布式存储相关API，请参考《专属分布式存储API参考》。 使用OpenStack原生接口时，您需要使用ECS服务的终端节点（Endpoint），获取方式请参见地区和终端节点。
版本ID（版本号），如v1。 links Array of objects API的URL地址。 href String 当前API版本的引用地址。 rel String 当前API版本和被引用地址的关系。 version String 若该版本API支持微版本，则为支持的最大微版本号；如果不支持微版本，则为空。
查询API版本信息列表 功能介绍 查询裸金属服务器当前所有可用的API版本。 调试 您可以在API Explorer中调试该接口。 URI GET / 请求参数 无 请求示例 查询当前所有可用的API版本。 1 GET https://{BMS Endpoint}/ 响应参数 参数
远程桌面连接（MSTSC方式） 操作场景 本节为您介绍如何在本机使用远程登录工具MSTSC登录Windows裸金属服务器。 前提条件 裸金属服务器状态必须为“运行中”。 如果Windows裸金属服务器采用密钥方式鉴权，需要先获取裸金属服务器的密码，获取方式请参见获取Windows裸金属服务器的密码。
创建方式导航 本文介绍创建裸金属服务器的几种方式。 按照向导指引创建裸金属服务器是常见的方式，您可以灵活选择配置项，确保满足业务的需求。详细操作请参见创建裸金属服务器。 如果您想快速获取一台裸金属服务器，可以创建快速发放型裸金属服务器。详细操作请参见创建快速发放型裸金属服务器。
您在创建裸金属服务器时，已经设置了登录密码。如果未设置或者忘记了密码，您可以一键式重置密码。 您在创建裸金属服务器时，如果选择密钥对（KeyPair）登录方式，需要先使用SSH密钥方式登录裸金属服务器设置密码才可以进行远程登录。具体操作如下： 使用密钥登录裸金属服务器后切换到root用户，执行passwd命令即可设置密码。
SSH密钥方式登录 操作场景 本节操作介绍在Windows和Linux环境中使用SSH密钥对方式登录Linux裸金属服务器的操作步骤。 前提条件 裸金属服务器状态必须为“运行中”。 已获取创建该裸金属服务器时使用的密钥对私钥文件。 裸金属服务器已绑定弹性公网IP，绑定方式请参见绑定弹性公网IP至服务器。
裸金属服务器在创建时选择密钥鉴权方式，想使用密码方式登录，怎么办？ Windows操作系统的裸金属服务器在创建时只能选择密钥鉴权方式，想使用密码方式登录，可以参考以下方法获取密码： 将密钥文件解析为密码，参考链接：获取Windows裸金属服务器的密码 通过控制台的重置密码功能设置密码。参考链接：重置裸金属服务器密码
接口使用说明 网络相关服务API，请参考《虚拟私有云API参考》。 包周期裸金属服务器的创建和退订流程中涉及和运营类接口交互，详细信息请参见运营能力简介。 专属分布式存储相关API，请参考《专属分布式存储API参考》。 使用BMS提供的接口时，您需要使用BMS服务自身的终端节点（
查询裸金属服务器元数据（废弃） 功能介绍 裸金属服务器元数据包含了裸金属服务器在云平台的基本信息，例如服务器ID、主机名、网络信息等。通过该接口，您可以查询裸金属服务器的元数据。 当前API已废弃，请使用“查询裸金属服务器详情”。 约束 不支持分页查询。 URI GET /v2.
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
