[](BCC/API Reference/Appendix.md#StorageType)Precondition

Creating an instance requires the real name authentication. Anyone who does not pass the real name authentication can go to the [Personal Authentication](#UserGuide/Identity Verification/Individual Identity Verification.md) or [Enterprise Authentication](#UserGuide/Identity Verification/Enterprise Identity Verification.md) under the security authentication in the Baidu AI Cloud official website console for the authentication.

BCC instance

• Considerations for billing:

  • To create a postpaid instance, the account cash balance and the general voucher must be greater than 100 CNY. To create a prepaid instance, the account cash balance must be greater than or equal to the instance cost.
  • When you create the public IP with specified bandwidth, the billing mode is bill-by-bandwidth.

• Considerations for instance:

  • By spec field, you can specify a vm type to be created. By a specification list API for an instance package, you can view an available instance package and its prices.
  • You can not purchase both GPU card and FPGA card for the same instance. When you purchase an instance with GPU card or FPGA card, you must specify the number of GPU cards or FPGA cards for the virtual machine to purchase through cardCount.

• Considerations for storage:

  • When creating instances, you can specify a system disk size, of [40, 500]Gb in range. You can also specify disk type. For details, see [StorageType](#BCC/API Reference/Appendix.md#StorageType).
  • The system disk added during the creation of instance can not be changed after the creation, and it does not support to create or add the system disk separately.
  • The system disk does not support the mount, uninstall or delete.
  • When you create the CDS system disk and data disk, it supports to select the disk size at the step width 1 GB.
  • An instance can mount up to 5 CDS disks by default.
  • The system disk size of BCC instance can not exceed up to 500 GB.
  • You can purchase one temporary data disk for each instance at most. Only the hp1 type of temporary data disk exists by default.
  • To create a memory optimized instance, you must purchase the temporary data disk, and specify the storage capacity of the temporary data disk through ephemeralDisks. The temporary data disk is of nvme type by default, which does not need to specify.

• Considerations for network:

  • BCC instances support user-defined security groups and subnets, both of which need to be specified under the same VPC If you do not specify a security group and subnet, you will automatically enter the system's default security group and subnet when you create a dedicated instance.

• Other Precautions

  • Batch creation is supported, and if one instance fails to be created in the creation, all instances are rolled back and all creations fail. If a CDS is included when it is created, the CDS will also be rolled back.
  • If the interface is asynchronously created, the instance status can be queried via the [Designated Instance Details Interface](#BCC/API Reference/Instance Related Interface/Query the details of Designated Instances.md).

Request

Request Structure

POST /v{version}/instanceBySpec?clientToken={clientToken} HTTP/1.1
Host: bcc.bj.baidubce.com
Authorization: authorization string

{
    "spec": spec,
    “rootDiskSizeInGb":rootDiskSizeInGb,
    "rootDiskStorageType":"rootDiskStorageType",
    "ephemeralDisks": [
        {
            "storageType": storageType,
            "sizeInGB": size
        },
        {
            "storageType": storageType,
            "sizeInGB": size
        }
    ],
    "createCdsList": [
        {
            "storageType": storageType,
            "cdsSizeInGB": cdsSizeInGB,
            "snapshotId": snapshotId
        }
    ],
    "name": "name",
    "hostname": "hostname",
    "autoSeqSuffix": autoSeqSuffix,
    "isOpenHostnameDomain": isOpenHostnameDomain,
    "imageId": "imageId",
    "networkCapacityInMbps": networkCapacityInMbps,
    "autoRenewTimeUnit": "autoRenewTimeUnit",
    "autoRenewTime": autoRenewTime,
    "cdsAutoRenew": cdsAutoRenew,
    "internetChargeType": internetChargeType,
    "dedicatedHostId": dedicatedHostId,
    "purchaseCount": purchaseCount,
    "billing":{
        "paymentTiming": paymentTiming,
        "reservation": {
            "reservationLength": reservationLength
        }
    },
    "zoneName": zoneName,
    "subnetId": subnetId,
    "securityGroupId": securityGroupId,
    "relationTag": relationTag,
    "isOpenIpv6": isOpenIpv6,
    "tags": [
       {
          "tagKey": tagKey,
          "tagValue": tagValue
       } 
    ],
    "keypairId": keypairId
}

Request header field

No other special header fields are available, except for common header fields.

Request Parameter

Return

Return a header field

There are no other special header fields except the common header field.

Return Parameter

Error Code

Example

Request instance ( create Instance by the specified instance package spec).

POST /v2/instanceBySpec?clientToken=be31b98c-5e41-4838-9830-9be700de5a20 HTTP/1.1
Host: bcc.bj.baidubce.com
ContentType: application/json    
Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2015-08-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de

{
    "spec": "bcc.g3.c4m12",
    "createCdsList": [
        {
            "storageType": "std1",
            "cdsSizeInGB": 5
        }
    ],
    "name": "example",
    "imageId": "m-mRjO3cjs",
    "networkCapacityInMbps": 0,
    "purchaseCount": 1,
    "billing":{
        "paymentTiming":"Prepaid",
        "reservation": {
            "reservationLength": 1
        }
    }
}

Return Example

HTTP/1.1 200 OK
x-bce-request-id: 1214cca7-4ad5-451d-9215-71cb844c0a50
Date: Wed, 03 Dec 2014 06:42:19 GMT
Content-Type: application/json;charset=UTF-8
Server: BWS

{
    "instanceIds": [
        "i-T1I3OtUO"
    ]
}