检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
返回结果 状态码 请求发送以后，您会收到响应，其中包含状态码、响应消息头和消息体。 状态码是一组从1xx到5xx的数字代码，状态码表示了请求响应的状态，完整的状态码列表请参见状态码。 对于管理员创建IAM用户接口，如果调用后返回状态码为“201”，则表示请求成功。 响应消息头 对
查询指定API版本信息 功能介绍 查询裸金属服务器指定API版本的信息。 调试 您可以在API Explorer中调试该接口。 URI GET /{api_version} 参数说明请参见表1。 表1 参数说明 参数 是否必选 描述 api_version 是 API版本号。例如：v1
盘下发裸金属服务器。 云硬盘（EVS）：提供多种不同QoS的云硬盘类型给裸金属服务器使用，满足不同性能要求的业务场景。 专属分布式存储（DSS）：为用户提供独享的存储资源，可根据需要创建不同规格的磁盘，挂载给裸金属服务器使用。 专属企业存储（DESS）：提供专属的企业存储设备，支持企业关键业务上云。
查询API版本信息列表 功能介绍 查询裸金属服务器当前所有可用的API版本。 调试 您可以在API Explorer中调试该接口。 URI GET / 请求参数 无 请求示例 查询当前所有可用的API版本。 1 GET https://{BMS Endpoint}/ 响应参数 参数
查询裸金属服务器的指定IP地址（废弃） 功能介绍 根据网络名称查询裸金属服务器的指定IP地址。 当前API已废弃，请使用“查询裸金属服务器详情”。 URI GET /v2.1/{project_id}/servers/{server_id}/ips/{vpc_id} 参数说明请参见表1。
规格查询 权限 对应API接口 授权项（Action） IAM项目（Project） 企业项目（Enterprise Project） 查询规格详情和规格扩展信息列表 GET /v1/{project_id}/baremetalservers/flavors bms:serverFlavors:get
查询裸金属服务器规格详情（废弃） 功能介绍 根据裸金属服务器的规格ID，查询规格的详细信息，比如规格名称、CPU核数、内存大小等。 当前API已废弃，请使用“查询规格详情和规格扩展信息列表”。 URI GET /v2.1/{project_id}/flavors/{flavor_id}
查询Job状态 功能介绍 查询Job的执行状态。 对于创建裸金属服务器、挂卸卷等异步API，命令下发后，会返回“job_id”，通过“job_id”可以查询任务的执行状态。 调试 您可以在API Explorer中调试该接口。 URI GET /v1/{project_id}/jobs/{job_id}
查询指定API版本信息 功能介绍 返回指定API版本的信息。 URI GET /{api_version} 参数说明请参见表1。 表1 参数说明 参数 是否必选 描述 api_version 是 API版本号。例如：v2 请求参数 无 请求示例 查询v2版本的API版本信息。 1
查询API版本信息列表 功能介绍 返回Nova当前所有可用的版本。 URI GET / 请求参数 无 请求示例 查询当前可用版本。 1 GET https://{ECS Endpoint}/ 响应参数 参数 参数类型 描述 versions Array of objects 描述version对象的列表。
查询租户配额 功能介绍 查询该租户下，所有资源的配额信息，包括已使用配额。 调试 您可以在API Explorer中调试该接口。 URI GET /v1/{project_id}/baremetalservers/limits 参数说明请参见表1。 表1 参数说明 参数 是否必选
查询裸金属服务器规格信息列表（废弃） 功能介绍 查询裸金属服务器规格信息列表。 当前API已废弃，请使用“查询规格详情和规格扩展信息列表”。 约束 本接口查询出来的规格为系统中所有的规格，其中规格的名称以“physical”开头的为裸金属服务器的规格，可用于申请裸金属服务器。 URI
盘。重装操作系统支持密码或者密钥注入。 确定裸金属服务器是否为快速发放，请参考查询规格详情和规格扩展信息列表API。 重装操作系统属于异步API，接口调用成功只表示请求下发成功，任务执行结果请通过查询Job状态API获取。 约束 使用私有镜像创建的裸金属服务器，请确保已经安装了C
参数类型 说明 job_id String 提交任务成功后返回的任务ID，用户可以使用该ID对任务执行情况进行查询。 如何根据job_id来查询Job的执行状态，请参考查询Job状态。 异常响应要素 表5 异常响应要素说明 名称 参数类型 说明 error 字典数据结构 提交任务异常时返回的异常信息，详情请参见表6。
参数类型 说明 job_id String 提交任务成功后返回的任务ID，用户可以使用该ID对任务执行情况进行查询。 如何根据job_id来查询Job的执行状态，请参考查询Job状态。 异常响应要素 表5 异常响应要素说明 名称 参数类型 说明 error 字典数据结构 提交任务异常时返回的异常信息，详情请参见表6。
查询裸金属服务器IP地址（废弃） 功能介绍 查询裸金属服务器私有IP地址信息。 当前API已废弃，请使用“查询裸金属服务器详情”。 约束 不支持分页查询。 URI GET /v2.1/{project_id}/servers/{server_id}/ips 参数说明请参见表1。 表1
参数类型 说明 job_id String 提交任务成功后返回的任务ID，用户可以使用该ID对任务执行情况进行查询。 如何根据job_id来查询Job的执行状态，请参考查询Job状态。 异常响应要素 表5 异常响应要素说明 名称 参数类型 说明 error 字典数据结构 提交任务异常时返回的异常信息，详情请参见表6。
查询API版本信息 查询API版本信息列表 查询指定API版本信息 父主题： API
imageid 是 String 镜像ID。 镜像ID可以从镜像服务控制台获取，或者参考《镜像服务API参考》的“查询镜像列表”章节查询。 在使用“查询镜像列表”API查询时，可以添加过滤字段“?virtual_env_type=Ironic”来筛选裸金属服务器镜像。 metadata
项目ID。 获取方式请参见获取项目ID。 flavor_id 是 规格ID。 可以在裸金属服务器控制台查询，也可以通过查询裸金属服务器规格信息列表（废弃）API获取。 请求参数 无 请求示例 查询ID为physical.s2.medium的规格详情信息，包含extra_specs信息。 1
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
