说明：当前页面接口为旧版 API，未来可能停止维护，目前不展示在左侧导航。云服务器 API 3.0 版本接口定义更加规范，访问时延下降显著，建议使用 云服务器 API 3.0。
为了帮助用户快速使用云服务器（CVM）API，这里给出一个使用示例，能够引导用户使用API服务完整的创建并销毁一个实例。
1. 查询实例机型列表
在创建实例前，我们首先需要确定其机型，实例的 CPU 和内存大小是通过机型来决定，因此我们可以先通过调用查询实例机型列表接口来获取需要指定 CPU 个数和内存大小对应的机型参数；或者通过查看产品文档： 实例类型里面的描述来获取。本例以通过查询接口获取为例来介绍，假设我们想获取如下要求的机型：
所在地域为广州二区, CPU 个数为 2 个, 内存大小为 4GB 的二代标准型实例对应的机型参数值
综上，可通过如下请求来获取。具体每个参数详细介绍可参考查询实例机型列表接口描述。
https://cvm.api.qcloud.com/v2/index.php?Action=DescribeInstanceTypeConfigs &Version=2017-03-12 &Filters.1.Name=zone &Filters.1.Values.1=ap-guangzhou-2 &Filters.1.Name=instance-family &Filters.1.Values.1=S2 &<公共请求参数>
根据如上请求可以得到返回结果如下，找到对应 CPU 和 Memory 值里面对应的InstanceType字段对应的值就是我们要查找的机型参数，本例需求想查找的机型值为： S2.MEDIUM4 。
{
"Response": {
"InstanceTypeConfigSet": [
{
"Zone": "ap-guangzhou-2",
"InstanceFamily": "S2",
"InstanceType": "S2.MEDIUM4",
"CPU": 2,
"Memory": 4
},
......
],
"RequestId": "2f1fd71e-95ab-4f10-8adb-895e99d33ff5"
}
}
2. 创建一个新的实例
创建实例操作可以通过调用创建实例 API来实现。假设我们想创建一个如下要求的实例：
实例所在位置为广州二区，付费模式为按小时后付费，镜像ID为：img-pmqg1cw7，选择机型为：1C1G标准型(S1.SMALL1)，50G大小本地普通系统盘，带100G大小本地普通数据盘，基础网络，公网付费模式为流量按小时后付费，外网带宽上限10Mbps，分配公网 IP，实例命名为 QCLOUD-TEST，设置登录密码为
Qcloud@TestApi123++，安装 腾讯云可观测平台云安全，购买数量为 1 台。
综上，可通过如下请求来创建该实例。具体每个参数详细介绍可参考创建实例接口描述。
https://cvm.api.qcloud.com/v2/index.php?Action=RunInstances &Version=2017-03-12 &Placement.Zone=ap-guangzhou-2 &InstanceChargeType=POSTPAID_BY_HOUR &ImageId=img-pmqg1cw7 &InstanceType=S1.SMALL1 &SystemDisk.DiskType=LOCAL_BASIC &SystemDisk.DiskSize=50 &DataDisks.0.DiskType=LOCAL_BASIC &DataDisks.0.DiskSize=100 &InternetAccessible.InternetChargeType=TRAFFIC_POSTPAID_BY_HOUR &InternetAccessible.InternetMaxBandwidthOut=10 &InternetAccessible.PublicIpAssigned=TRUE &InstanceName=QCLOUD-TEST &LoginSettings.Password=Qcloud@TestApi123++ &EnhancedService.SecurityService.Enabled=TRUE &EnhancedService.MonitorService.Enabled=TRUE &InstanceCount=1 &<公共请求参数>
根据如上请求可以得到返回结果如下，返回结果中的 InstanceId 字段即为所创建实例的 ID，本例创建出来的实例ID值为： ins-32kcaqoa。
{
"Response": {
"InstanceIdSet": [
"ins-32kcaqoa"
],
"RequestID": "3c140219-cfe9-470e-b241-907877d6fb03"
}
}
就这样我们创建了一个实例。拥有了它的实例ID。用户就可以通过VNC或是远程桌面去管理它了。
3. 主动退还一个已存在的实例。
当我们不再使用一个实例时，可以通过退还实例API来退还该实例。假设我们想退还如下要求的实例：
实例ID为：ins-32kcaqoa
综上，可通过如下请求来退还该实例。具体每个参数详细介绍可参考退还实例接口描述。
https://cvm.api.qcloud.com/v2/index.php?Action=TerminateInstances &Version=2017-03-12 &InstanceIds.0=ins-32kcaqoa &<公共请求参数>
根据如上请求可以得到返回结果如下。
{
"Response": {
"RequestId": "6EF60BEC-0242-43AF-BB20-270359FB54A7"
}
}