检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
项目ID。 获取方式请参见获取项目ID。 keypair_name 是 密钥名称信息。 可以通过查询SSH密钥列表（OpenStack原生）API获取。 请求参数 无 请求示例 查询密钥名称为keypair-test的密钥详情信息。 1 GET https://{ECS Endpoint}/v2
错误码 背景信息 接口返回的错误码与Error Message不具有一一对应关系，表中只是列出比较常见的一种Error Message。 本服务接口以异步接口居多，有的错误码是在查询任务的返回体中体现的，HTTP状态码有可能不是很准确。 本服务对网络、存储等服务具有强依赖性，Error
获取账号ID 在调用接口的时候，部分URL中需要填入账号ID（domain_id），所以需要先在管理控制台上获取到账号ID。账号ID获取步骤如下： 登录管理控制台。 鼠标悬停在右上角的用户名，选择下拉列表中的“我的凭证”。 在“API凭证”页面查看账号ID。 图1 获取账号ID 父主题：
安全，结合云中资源的弹性优势，租户可灵活申请，按需使用。 您可以使用本文档提供的API对裸金属服务器进行相关操作，如创建、挂载磁盘、开关机等。支持的全部操作请参见API概览。 在调用裸金属服务器API之前，请确保已经充分了解裸金属服务器相关概念，详细信息请参见产品介绍。 裸金属服
创建和导入SSH密钥（OpenStack原生） 功能介绍 创建SSH密钥，或把公钥导入系统，生成密钥对。 创建SSH密钥成功后，请把响应数据中的私钥内容保存到本地文件，用户使用该私钥登录裸金属服务器。为保证裸金属服务器安全，私钥数据只能读取一次，请妥善保管。 URI POST /v2
权限和授权项 权限及授权项说明 生命周期管理 状态管理 规格查询 网卡管理 磁盘管理 元数据管理 租户配额管理 密码管理
查询SSH密钥列表（OpenStack原生） 功能介绍 查询SSH密钥信息列表。 约束 不支持分页查询。 URI GET /v2.1/{project_id}/os-keypairs 参数说明请参见表1。 表1 参数说明 参数 是否必选 描述 project_id 是 项目ID。
规格查询 权限 对应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） 修改裸金属服务器名称 PUT /v1/{project_id}/baremetalservers/{server_id} bms:servers:put
密码管理 权限 对应API接口 授权项（Action） IAM项目（Project） 企业项目（Enterprise Project） 查询裸金属服务器是否支持重置密码 GET /v1/{project_id}/baremetalservers/{server_id}/os-resetpwd-flag
磁盘管理 权限 对应API接口 授权项（Action） 依赖的授权项（Action） IAM项目（Project） 企业项目（Enterprise Project） 卸载指定裸金属服务器的磁盘 DELETE /v1/{project_id}/baremetalservers/{s
租户配额管理 权限 对应API接口 授权项（Action） IAM项目（Project） 企业项目（Enterprise Project） 查询租户配额 GET /v1/{project_id}/baremetalservers/limits bms:serverQuotas:get
状态码 正常 返回值 说明 200 OK 服务器已成功处理了请求。 201 Created 请求成功并且服务器创建了新的资源。 202 Accepted 服务器已接受请求，延迟处理。 204 No Content 服务器成功处理了请求，但没有返回任何内容。 异常 返回值 说明 400
提交任务类响应 任务ID的响应 订单ID的响应 父主题： 公共参数
生命周期管理 权限 对应API接口 授权项（Action） IAM项目（Project） 企业项目（Enterprise Project） 创建裸金属服务器 POST /v1/project_id}/baremetalservers bms:servers:create √ √ 查询裸金属服务器详情列表
元数据管理 权限 对应API接口 授权项（Action） IAM项目（Project） 企业项目（Enterprise Project） 更新裸金属服务器元数据 POST /v1/{project_id}/baremetalservers/{server_id}/metadata
须具备调用该接口所需的权限，否则，API请求将调用失败。每个接口所需要的权限，与各个接口所对应的授权项相对应，只有发起请求的用户被授予授权项所对应的策略，该用户才能成功调用该接口。例如，用户要调用接口来查询裸金属服务器列表，那么这个IAM用户被授予的策略中必须包含允许“bms:s
调用查询规格详情和规格扩展信息列表API，确定响应参数中某个规格对应的“baremetal:__support_evs”的取值，如果为“true”表示支持挂载云硬盘，为“false”表示不支持。有些裸金属服务器规格中无此参数，也表示不支持云硬盘。 涉及接口 挂载磁盘涉及的接口如下： 创建云硬盘 裸金属服务器挂载云硬盘
示例2：查询裸金属服务器 操作场景 当您名下有多台裸金属服务器时，可以指定查询条件获取需要的裸金属服务器。 涉及接口 涉及的接口如下： 查询裸金属服务器详情列表 指定flavor查询裸金属服务器详情列表 接口相关信息 URI格式：GET /v1/{project_id}/baremetalservers/detail
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
