创建实例

说明：

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

1. 接口描述

本接口 (RunInstances) 用于创建一个或多个指定配置的实例。
接口请求域名：cvm.api.qcloud.com

• 实例创建成功后将自动开机启动，实例状态变为“运行中”。
• 预付费实例的购买会预先扣除本次实例购买所需金额，按小时后付费实例购买会预先冻结本次实例购买一小时内所需金额，在调用本接口前请确保账户余额充足。
• 本接口允许购买的实例数量遵循 CVM 实例购买限制，所创建的实例和官网入口创建的实例共用配额。
• 本接口为异步接口，当创建请求下发成功后会返回一个实例ID列表，此时实例的创建并立即未完成。在此期间实例的状态将会处于“准备中”，可以通过调用 DescribeInstancesStatus 接口查询对应实例的状态，来判断生产有没有最终成功。如果实例的状态由“准备中”变为“运行中”，则为创建成功。

2. 输入参数

以下请求参数列表仅列出了接口请求参数，其它参数见 公共请求参数 页面。

3. 输出参数

接口执行正常返回参数示例

{
    "Response": {
        "InstanceIdSet": [
            "xxx1",
            "xxx2"
        ],
        "RequestId": "eac6b301-a322-493a-8e36-83b295459397"
    }
}

接口执行异常返回参数示例

{
  "Response": {
    "Error": {
      "Code": "AuthFailure",
      "Message": "qcloud was not able to validate the provided access credentials"
    },
    "RequestId": "eac6b301-a322-493a-8e36-83b295459397"
  }
}

4. 错误码

以下错误码表仅列出了该接口的业务逻辑错误码，更多错误码详见 公共错误码。

5. 示例

示例1

说明：

最简单参数的购买：
只传必传的 Zone 和镜像 ID，其他均采用系统默认值，具体配置如下：实例所在位置为广州二区，镜像 ID 为：img-pmqg1cw7。

请求参数

  https://cvm.api.qcloud.com/v2/index.php?Action=RunInstances
  &Version=2017-03-12
  &Placement.Zone=ap-guangzhou-2
  &ImageId=img-pmqg1cw7
  &<公共请求参数>

返回参数

{
    "Response": {
        "InstanceIdSet": [
            "ins-1vogaxgk"
        ],
        "RequestID": "3c140219-cfe9-470e-b241-907877d6fb03"
    }
}

示例2

说明：

包年包月实例购买：
实例所在位置为广州二区，付费模式为包年包月，购买一个月，到期自动续费，镜像 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=PREPAID
  &InstanceChargePrepaid.Period=1
  &InstanceChargePrepaid.RenewFlag=NOTIFY_AND_AUTO_RENEW
  &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
  &<公共请求参数>

返回参数

{
    "Response": {
        "InstanceIdSet": [
            "ins-bfw5zq3y"
        ],
        "RequestID": "3c140219-cfe9-470e-b241-907877d6fb03"
    }
}

示例3

说明：

按小时后付费实例购买：
实例所在位置为广州二区，付费模式为按小时后付费，镜像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
  &<公共请求参数>

返回参数

{
    "Response": {
        "InstanceIdSet": [
            "ins-32kcaqoa"
        ],
        "RequestID": "3c140219-cfe9-470e-b241-907877d6fb03"
    }
}