检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
切换裸金属服务器操作系统 功能介绍 切换裸金属服务器的操作系统。切换操作系统支持密码或者密钥注入。 切换操作系统属于异步API，接口调用成功只表示请求下发成功，任务执行结果请通过查询Job状态API获取。 约束 关机状态或者切换操作系统失败的裸金属服务器，才能执行切换操作。 使用私有镜像创建的裸金属
对于Windows裸金属服务器，在线卸载磁盘，请确保没有程序正在对该磁盘进行读写操作。否则，将造成数据丢失。 调试 您可以在API Explorer中调试该接口。 URI DELETE /v1/{project_id}/baremetalservers/{server_id}/de
D状态下不支持挂卷。 要挂载的卷必须是available状态的卷或者共享卷。 仅支持挂载SCSI类型的卷。 调试 您可以在API Explorer中调试该接口。 URI POST /v1/{project_id}/baremetalservers/{server_id}/attachvolume
功能介绍 解绑裸金属服务器中的一张或多张弹性网卡。 主网卡是裸金属服务器上配置了路由规则的网卡，不可解绑。 调试 您可以在API Explorer中调试该接口。 URI POST /v1/{project_id}/baremetalservers/{server_id}/nics/delete
指南》的“安装一键式重置密码插件”章节。 裸金属服务器的密码重置失败后，该API不会报错。 裸金属服务器开机或重启后，新密码生效。 调试 您可以在API Explorer中调试该接口。 URI PUT /v1/{project_id}/baremetalservers/{serv
公共参数 状态码 错误码 提交任务类响应
获取裸金属服务器远程登录地址 功能介绍 获取裸金属服务器远程登录地址。 约束 Windows系统的裸金属服务器不支持远程登录。 调试 您可以在API Explorer中调试该接口。 URI POST /v1/{project_id}/baremetalservers/{server_id}/remote_console
裸金属服务器绑定弹性网卡 功能介绍 为裸金属服务器绑定一张或多张弹性网卡。 调试 您可以在API Explorer中调试该接口。 URI POST /v1/{project_id}/baremetalservers/{server_id}/nics 参数说明请参见表1 参数说明。
应用示例 示例1：创建裸金属服务器 示例2：查询裸金属服务器 示例3：裸金属服务器挂载磁盘
项目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}/os-interface/{port_id}
修订记录 版本日期 变更说明 2024-10-22 第十九次正式发布。 下线“API（OpenStack Nova v2.1 原生）”章节，废弃接口移至历史API。 2023-11-23 第十八次正式发布。 新增切换裸金属服务器操作系统。 2023-09-14 第十七次正式发布。
裸金属服务器状态（裸金属服务器的OS-EXT-STS:vm_state属性）必须是active、stopped、paused。 调试 您可以在API Explorer中调试该接口。 URI POST /v1/{project_id}/baremetalservers/{server_id}/metadata
查询裸金属服务器详情列表 功能介绍 用户根据设置的请求条件筛选裸金属服务器，并获取裸金属服务器的详细信息。 该接口支持查询裸金属服务器计费方式，以及是否被冻结。 调试 您可以在API Explorer中调试该接口。 URI GET /v1/{project_id}/baremetalservers/detail
项目ID。 获取方式请参见获取项目ID。 keypair_name 是 密钥名称信息。 可以通过查询SSH密钥列表（OpenStack原生）API获取。 请求参数 无 请求示例 查询密钥名称为keypair-test的密钥详情信息。 1 GET https://{ECS Endpoint}/v2
权限和授权项 权限及授权项说明 生命周期管理 状态管理 规格查询 网卡管理 磁盘管理 元数据管理 租户配额管理 密码管理
错误码 背景信息 接口返回的错误码与Error Message不具有一一对应关系，表中只是列出比较常见的一种Error Message。 本服务接口以异步接口居多，有的错误码是在查询任务的返回体中体现的，HTTP状态码有可能不是很准确。 本服务对网络、存储等服务具有强依赖性，Error
创建和导入SSH密钥（OpenStack原生） 功能介绍 创建SSH密钥，或把公钥导入系统，生成密钥对。 创建SSH密钥成功后，请把响应数据中的私钥内容保存到本地文件，用户使用该私钥登录裸金属服务器。为保证裸金属服务器安全，私钥数据只能读取一次，请妥善保管。 URI POST /v2
查询SSH密钥列表（OpenStack原生） 功能介绍 查询SSH密钥信息列表。 约束 不支持分页查询。 URI GET /v2.1/{project_id}/os-keypairs 参数说明请参见表1。 表1 参数说明 参数 是否必选 描述 project_id 是 项目ID。
C和子网，以实现网络资源的共享和统一管理，提升资源管控效率、降低运维成本。 例如，为了规范管理网络资源，某企业使用账号A作为IT管理账号，用于管理基础公共资源，包括VPC、子网等。同时，账号A将多个子网共享给其他账号共同使用。 账号A：IT管理账号，作为资源所有者，创建VPC及子
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
