说明:
为了帮助用户快速使用云服务器(CVM)API,这里给出一个使用示例,能够引导用户使用API服务完整的创建并销毁一个实例。
1. 创建一个新的实例
在创建实例前,我们首先需要确定其配置,因为它决定了用户所创建实例的性能。有关配置用户可以参考 实例规格。
如果我们想创建一个新的广州二区的 Windows Server 2012 R2 标准版 64位中文版的按量计费实例,并具有1核心 CPU,1GB的内存,需要的具体请求参数见下表:
综上,结合公共请求参数和接口请求参数,最终得到的请求形式如下:
https://cvm.api.qcloud.com/v2/index.php?Action=RunInstancesHour&Region=gz&Timestamp=1465750149&Nonce=46364&SecretId=************&Signature=5umi9gUWpTTyk18V2g%2FYi56hqls%3D&zoneId=100002&imageId=img-egif9bvl&cpu=1&mem=1&storageSize=0&bandwidth=1&password=@TQq191111118864+
上述请求的返回结果如下,由结果可知,新创建的实例的 ID 是 ins-a19qoqqk。这个 ID 唯一标识了这个实例。后续将实例进行退还(删除实例)或是调整配置都需要通过它来指定对象。
{"code" : 0,"message" : "ok","unInstanceIds":["ins-a19qoqqk"]}
2. 主动退还一个已存在的实例。
由于按量计费类型的实例会实时计费,不需要的时候我们要主动退还它。
具体的接口请求参数见下表:
参数名称 | 是否必选 | 类型 | 描述 |
instanceId | 是 | String |
结合公共请求参数和接口请求参数,最终得到的请求形式如下:
https://cvm.api.qcloud.com/v2/index.php?Action=ReturnInstance&Region=gz&Timestamp=1465750149&Nonce=46364&SecretId=************&Signature=5umi9gUWpTTyk18V2g%2FYi56hqls%3D&instanceId=ins-a19qoqqk
上述请求的返回结果如下,由结果可知,新创建的实例的 ID 是 ins-a19qoqqk。这个 ID 唯一标识了这个实例。后续将实例进行退还(删除实例)或是伸缩操作(调整配置)都需要通过它来指定对象。
{"code" : 0,"message" : "ok"}