说明:
欢迎使用云服务器(Cloud Virtual Machine)。
腾讯云服务器(Cloud Virtual Machine,以下简称 CVM)运行在腾讯数据中心,它提供了可以弹性伸缩的计算服务,可以根据业务需要来构建和托管软件系统。
注意:
本模块底下的云服务器接口,均为改版后的 API 接口,后续 CVM 相关的所有新增功能都会在此模块底下的接口里面增加。我们 推荐新用户使用改版后的 API 接口。
现有旧接口的功能依然保持,对于使用旧接口的用户详情可参见:云服务器 API(旧版)简介。
术语表
本文档涉及的一些常用术语如下:
术语 | 全称 | 中文 | 说明 |
Instance | Instance | 指代一台云服务器。 | |
Region | Region | 表示资源所在的地域,每个地域包含一个或多个可用区。 | |
Zone | Zone | ||
Image | Image | CVM 实例上软件环境的拷贝,一般包括操作系统和已安装的软件;我们使用镜像来创建实例。 | |
SecurityGroup | Security Group | 一种有状态的包过滤功能的虚拟防火墙,用于控制 CVM 实例的网络访问, 是一种重要的网络安全隔离手段。 | |
EIP | Elastic IP | 弹性 IP 是公网 IP 的一种。与普通公网 IP 不同的是,弹性 IP 归属于用户账户而不是实例;实例与公网IP的映射关系随时可以更改。 | |
无 | 无 | 包年包月 | |
无 | 无 | 按量计费 |
输入参数与返回参数释义
Limit 和 Offset
说明:
用来控制分页的参数;Limit 为单次返回的最多条目数量,Offset 为偏移量。当相应结果是列表形式时,如果数量超过了 Limit 所限定的值,那么只返回 Limit 个值。
举例来说,参数 Offset=0&Limit=20 返回第 0 到 20 项,Offset=20&Limit=20 返回第 20 到 40 项,Offset=40&Limit=20 返回第 40 到 60 项;以此类推。
Ids.N
说明:
同时输入多个参数的格式。当遇到形如这样的格式时,那么该输入参数可以同时传多个。例如:
Ids.0=10.12.243.21&Ids.1=10.11.243.21&Ids.2=10.12.243.21&Ids.3=10.13.243.21...
以此类推(以下标 0 开始)。
API 快速入门
这里针对几个典型的使用场景对 CVM API 的使用方式进行说明:
1. 通过使用 创建实例 API,提供可用区 ID、镜像 ID、机型参数等一些必要的信息,即可立刻创建一个按量计费的实例。
2. 如需修改配置,可以使用 调整实例配置 API 调整为更高的配置。通过调整实例的机型来实现 CPU 和内存的变更。
3. 如需关闭实例,可以使用 关闭实例 API。
4. 在不使用此实例时使用 退还实例 API 销毁它。退还实例后,将不再收费。
使用限制
CVM API 调用配额为:1000 次/分钟;且单一 API 不超过 100 次/分钟。
API 创建的机器遵循 CVM实例购买限制 文档所描述的数量限制,和官网所创建的机器共用配额。
更具体的限制请参考对应 API 接口文档或产品文档。