检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
API概览 弹性云服务器所提供的接口分为ECS接口与OpenStack原生接口。推荐您使用ECS接口。 调试 您可以在API Explorer中调试接口。 ECS接口说明 表1 ECS接口说明 类型 说明 生命周期管理 包括弹性云服务器的创建、删除、查询等接口。 状态管理 包括弹
计费说明 计费项 ECS根据您选择ECS实例规格和使用时长计费。 表1 计费项信息 计费项 计费说明 ECS实例 实例类型及规格（vCPU，内存），购买时长以及所购买的实例数量。 具体请参考弹性云服务器产品价格详情。 镜像 银河麒麟(KylinOS)、统信（UnionTechOS
API版本选择建议 API风格说明 当前ECS服务对外开放两类风格的API： ECS服务自定义规范的API（以下简称ECS API） 顺从OpenStack社区标准原生规范的API 两种风格不同，功能相近。OpenStack风格API主要用于满足您在开源生态工具方面的对接需求，在某些功能上ECS
mpute 2.27。 调试 您可以在API Explorer中调试该接口。 URI GET /{api_version} 参数说明请参见表1。 表1 参数说明 参数 是否必选 描述 api_version 是 API版本号。例如: v2 请求消息 无 响应消息 响应参数如表2所示。
查询API版本信息（OpenStack Nova API） 查询API版本信息列表（废弃） 查询指定API版本信息（废弃） 父主题： 历史API
API 生命周期管理 状态管理 批量操作 规格管理 网卡管理 磁盘管理 元数据管理 租户配额管理 查询Job状态 标签管理 密码管理 云服务器组管理 智能购买组管理 规格推荐管理 可用区管理 历史版本
status string API版本的状态。 CURRENT，这是使用的API的首选版本 SUPPORTED，这是一个较老的，但仍然支持的API版本。 DEPRECATED，一个被废弃的API版本，该版本将被删除。 version string 如果API的这个版本支持微版本，则支持最大的微版本。
收费标准类 包年/包月和按需计费模式有什么区别？ 弹性云服务器关机后还会计费吗？ “故障”状态的弹性云服务器还会计费吗？ 包年/包月和按需计费模式是否支持互相切换？ 云服务器资源冻结/释放/删除/退订常见问题 弹性云服务器怎样停止计费？ 竞价计费型实例常见计费问题 父主题： 计费FAQ
规格管理（OpenStack Nova API） 查询云服务器规格列表（废弃） 查询云服务器规格详情列表（废弃） 查询云服务器规格详情（废弃） 查询云服务器规格extra_specs的详情（废弃） 父主题： 历史API
Nova API） 镜像管理（OpenStack Nova API） 安全组管理（OpenStack Nova API） 规格管理（OpenStack Nova API） 网卡管理（OpenStack Nova API） 磁盘管理（OpenStack Nova API） 元数据管理（OpenStack
用户必须具备调用该接口所需的权限，否则，API请求将调用失败。每个接口所需要的权限，与各个接口所对应的授权项相对应，只有发起请求的用户被授予授权项所对应的策略，该用户才能成功调用该接口。例如，用户要调用接口来查询云服务器列表，那么这个IAM用户被授予的策略中必须包含允许“ecs:
请求幂等性说明 当您调用ECS API操作资源时，操作可能在完成之前超时或遇到其他服务器问题，客户端可能会尝试重试请求。如果原始请求和后续重试请求都成功执行，则操作将多次完成。这意味着您可能会创建比预期更多的资源。 为了解决这种问题，引入了请求幂等标识，通过针对幂等请求标识的一系
支持。 在管理控制台进行操作时，如果显示错误码，错误码说明请参见《弹性云服务器用户指南》的常见问题“针对管理控制台的异常提示信息，应该如何处理”。 错误码说明 当您调用API时，如果遇到“APIGW”开头的错误码，请参见API网关错误码进行处理。 状态码 错误码 错误信息 描述 处理措施
如何调用API 构造请求 认证鉴权 返回结果
密钥、密码管理（OpenStack Nova API） 查询SSH密钥列表（废弃） 查询SSH密钥详情（废弃） 创建和导入SSH密钥（废弃） 删除SSH密钥（废弃） 获取云服务器密码（废弃） 清除云服务器密码（废弃） 父主题： 历史API
敏感数据，比如限制访问范围、加密等。 接口约束 云服务器状态（云服务器的OS-EXT-STS:vm_state属性）必须是active，stopped，paused或者suspended。 调试 您可以在API Explorer中调试该接口。 URI POST /v1/{proj
欠费说明 用户在使用弹性云服务器时，账户的可用额度小于待结算的账单，即被判定为账户欠费。欠费后，可能会影响弹性云服务器资源的正常运行，请及时充值。 欠费原因 已购买按需计费或竞价计费的弹性云服务器，因持续性周期扣款而导致账户的余额不足。 删除按需计费或竞价计费的弹性云服务器后，因
根据云服务器ID，查询云服务器的详细信息。 当前API已废弃，请使用查询云服务器详情。 调试 您可以在API Explorer中调试该接口。 URI GET /v2.1/{project_id}/servers/{server_id} 参数说明请参见表1。 表1 参数说明 参数 是否必选 描述 project_id
从您申请到竞价计费型实例开始，到该竞价计费型实例被释放的时刻结束（手动或系统中断），精度精确到秒。 竞价计费型实例关机后会继续收费吗？ 详细说明请参考表1。 表1 竞价计费型实例关机后计费说明 竞价计费型实例 竞价模式 不含本地盘和FPGA卡的实例、非裸金属实例 与同等规格按需计费一致，关机后，基础资源（
r_id}/action）”两个接口一起使用。 当前API已废弃，请使用变更云服务器规格（按需）。 URI POST /v2.1/{project_id}/servers/{server_id}/action 参数说明请参见表1。 表1 参数说明 参数 是否必选 描述 project_id
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
