检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
云服务器网卡配置虚拟IP地址（废弃） 功能介绍 虚拟IP地址用于为网卡提供第二个IP地址，同时支持与多个弹性云服务器的网卡绑定，从而实现多个弹性云服务器之间的高可用性。 该接口用于给云服务器网卡配置虚拟IP地址： 当指定的IP地址是一个不存在的虚拟IP地址时，系统会创建该虚拟IP，
切换弹性云服务器操作系统（安装Cloud-init） 功能介绍 切换弹性云服务器操作系统。支持弹性云服务器数据盘不变的情况下，使用新镜像重装系统盘。 本接口为异步接口，当前切换弹性云服务器操作系统请求下发成功后会返回job_id，此时切换弹性云服务器操作系统并没有立即完成，需要通过调用查询任务的执行状态查询
查询云服务器组列表 功能介绍 查询云服务器组列表。 调试 您可以在API Explorer中调试该接口。 URI GET /v1/{project_id}/cloudservers/os-server-groups?limit={limit}&marker={marker} 参数说明请参见表
查询云服务器是否配置了自动恢复动作（废弃） 功能介绍 查询云服务器是否配置了自动恢复动作。 调试 您可以在API Explorer中调试该接口。 URI GET /v1/{project_id}/cloudservers/{server_id}/autorecovery 参数说明请参见表
查询云服务器规格变更支持列表（废弃） 功能介绍 变更规格时，部分规格的云服务器之间不能互相变更。您可以通过本接口，通过指定弹性云服务器规格，查询该规格可以变更的规格列表。 当前API已废弃，请使用查询云服务器规格变更支持列表。 URI GET /v2.1/{project_id}/
查询弹性云服务器挂载磁盘列表信息 功能介绍 查询弹性云服务器挂载的磁盘列表信息。 调试 您可以在API Explorer中调试该接口。 URI GET /v1/{project_id}/cloudservers/{server_id}/os-volume_attachments 参数说明请参见表
关联FPGA镜像与弹性云服务器镜像 功能介绍 本接口用于创建FPGA镜像与弹性云服务器镜像之间的关联映射关系。 目前仅“华北-北京一、华东-上海二、华南-广州”区域支持，其他区域暂未支持。 URI POST /v1/{project_id}/cloudservers/fpga_image
重装弹性云服务器操作系统（未安装Cloud-init） 功能介绍 重装弹性云服务器的操作系统。 本接口为异步接口，当前重装弹性云服务器操作系统请求下发成功后会返回job_id，此时重装弹性云服务器操作系统并没有立即完成，需要通过调用查询任务的执行状态查询job状态，当Job状态为
解关联FPGA镜像与弹性云服务器镜像 功能介绍 本接口用于删除FPGA镜像与弹性云服务器镜像之间的关联映射关系。 目前仅“华北-北京一、华东-上海二、华南-广州”区域支持，其他区域暂未支持。 URI DELETE /v1/{project_id}/cloudservers/fpga_image
切换弹性云服务器操作系统（未安装Cloud-init） 功能介绍 切换弹性云服务器操作系统。 本接口为异步接口，当前切换弹性云服务器操作系统请求下发成功后会返回job_id，此时切换弹性云服务器操作系统并没有立即完成，需要通过调用查询任务的执行状态查询job状态，当Job状态为 SUCCESS
附录 状态码 错误码 云服务器状态 请求幂等性说明
查询弹性云服务器挂载磁盘列表详情信息 功能介绍 查询弹性云服务器挂载的磁盘列表详情信息。 调试 您可以在API Explorer中调试该接口。 URI GET /v1/{project_id}/cloudservers/{server_id}/block_device 参数说明请参见表
公共参数 通用请求返回值 获取项目ID 提交任务类请求结果 提交批量操作请求结果
应用示例 获取Token并检验Token的有效期 创建ECS高频场景示例 创建弹性云服务器 查询弹性云服务器详情列表 弹性云服务器挂载磁盘 弹性云服务器挂载网卡 查询弹性云服务器关联的弹性公网IP
数据结构 数据结构(创建云服务器) 数据结构(查询云服务器详情) 数据结构(查询规格详情)
使用前必读 概述 欢迎使用弹性云服务器（Elastic Cloud Server ，ECS）。弹性云服务器是由CPU、内存、镜像、云硬盘组成的一种可随时获取、弹性可扩展的计算服务器，同时它结合虚拟私有云、虚拟防火墙、数据多副本保存等能力，为您打造一个高效、可靠、安全的计算环境，确保您的服务持久稳定运行
状态码 正常状态码 描述 200 OK 201 Created 202 Accepted 204 No Content 错误状态码 描述 400 Bad Request 401 Unauthorized 403 Forbidden 404 Not Found 405 Method
权限和授权项 权限及授权项说明 生命周期管理 状态管理 批量操作 网络管理 镜像管理 安全组管理 规格查询 网卡管理 磁盘管理 元数据管理 租户配额管理 SSH密钥管理 密码管理 浮动IP管理 云服务器组管理 云服务器控制台管理 可用区管理 标签管理 FPGA逻辑文件管理 资源粒度授权
请求幂等性说明 当您调用ECS API操作资源时，操作可能在完成之前超时或遇到其他服务器问题，客户端可能会尝试重试请求。如果原始请求和后续重试请求都成功执行，则操作将多次完成。这意味着您可能会创建比预期更多的资源。 为了解决这种问题，引入了请求幂等标识，通过针对幂等请求标识的一系列判断检查
状态管理 权限 对应的API接口 授权项（Action） 依赖的授权项 IAM项目 (Project) 企业项目 (Enterprise Project) 实例授权 标签授权 切换弹性云服务器操作系统 POST /v2/{project_id}/cloudservers/{server_id
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
