有奖捉虫:办公协同&微信生态&物联网文档专题 HOT
说明:

当前页面接口为旧版 API,未来可能停止维护,目前不展示在左侧导航。云服务器 API 3.0 版本接口定义更加规范,访问时延下降显著,建议使用 云服务器 API 3.0

为了帮助用户快速使用云服务器(CVM)API,这里给出一个使用示例,能够引导用户使用API服务完整的创建并销毁一个实例。

1. 创建一个新的实例

在创建实例前,我们首先需要确定其配置,因为它决定了用户所创建实例的性能。有关配置用户可以参考 实例规格
如果我们想创建一个新的广州二区的 Windows Server 2012 R2 标准版 64位中文版的按量计费实例,并具有1核心 CPU,1GB的内存,需要的具体请求参数见下表:

参数名称 描述 取值
zoneId 可用区 ID。 100002
imageId 镜像 ID,这里我们使用 Windows Server 2012 R2 标准版 64位中文版(具体 imageId 对应何种操作系统可见镜像列表)。 img-egif9bvl
cpu CPU 核数。 1
mem 内存(GB)。 1
storageSize 数据盘大小(GB)。 0
bandwidth 公网带宽大小(Mbps) 。 1
password 操作系统的系统管理员的密码。 @TQq191111118864+

如果对某些参数并不了解,可以详细参考 创建实例(按量计费) 页面,它详尽的解释了每个参数。

综上,结合公共请求参数和接口请求参数,最终得到的请求形式如下:

https://cvm.api.qcloud.com/v2/index.php?
Action=RunInstancesHour
&Region=gz
&Timestamp=1465750149
&Nonce=46364
&SecretId=AKIDxxxxugEY
&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"
      ]
  }

就这样我们创建了一个实例。拥有了它的实例 ID。用户就可以通过 VNC 或是 远程桌面 去管理它了。

2. 主动退还一个已存在的实例。

由于按量计费类型的实例会实时计费,不需要的时候我们要主动退还它。
具体的接口请求参数见下表:

参数名称 是否必选 类型 描述
instanceId String 待操作 CVM 的实例 ID。可通过 DescribeInstances 接口返回字段中的 unInstanceId 获取。

结合公共请求参数和接口请求参数,最终得到的请求形式如下:

https://cvm.api.qcloud.com/v2/index.php?
Action=ReturnInstance
&Region=gz
&Timestamp=1465750149
&Nonce=46364
&SecretId=AKIDxxxxugEY
&Signature=5umi9gUWpTTyk18V2g%2FYi56hqls%3D
&instanceId=ins-a19qoqqk

上述请求的返回结果如下,由结果可知,新创建的实例的 ID 是 ins-a19qoqqk。这个 ID 唯一标识了这个实例。后续将实例进行退还(删除实例)或是伸缩操作(调整配置)都需要通过它来指定对象。

  {
      "code" : 0,
      "message" : "ok"
  }