CreateInstance

Last Updated: May 22, 2018

Description

Creates an instance. You must maintain sufficient balance to your linked credit card or PayPal account to complete the payment or preauthorization. For more information, see Subscription and Pay-As-You-Go. When you call this interface, consider the following:

Instance types

You must specify an instance type for a new ECS instance. For more information, see Instance generations and type families.

  • When you create an instance, you can choose an I/O optimized instance.

  • Once an instance is created with ephemeral SSDs, the instance type cannot be changed after the instance is created.

Images

An image is a running environment template for ECS instances. It generally includes an operating system and preconfigured application software.

  • When you create an ECS instance, you must select an image for the system disk configuration. After an instance is created, the instance system disk becomes a clone of that image.

  • If the instance memory is 512 MB, Windows OS is not supported.

  • If the instance memory is 4 GB or larger, a 32-bit OS is not supported.

Network

When you create an ECS instance in the Virtual Private Cloud (VPC) network, consider the following:

  • To create an instance for a VPC network, you must specify the VPC network and a VSwitch when creating the instance. One instance can only belong to one VSwitch.

  • If a VSwitchId is specified for creating an instance, SecurityGroupId and VSwitchId must belong to one VPC.

  • PrivateIpAddress depends on VSwitchId and cannot be specified separately. PrivateIpAddress must be within the CidrBlock of the VSwitch.

For more information, see VPC document What is VPC.

Security groups

When you create an ECS instance, you must specify the security group of the instance, and consider the following:

  • The security group must be created in advance by using the CreateSecurityGroup interface.

  • You can specify the security group when creating the instance and change the instance security group by using the ModifyInstanceAttribute interface.

  • Mutual access is allowed between instances in the same security group in the intranet. By default, firewalls are deployed between security groups, and mutual access between security groups is disabled. However, security group firewall permissions can be set through security group authorization (by using the interface for granting security group permissions).

  • The maximum number of instances in one security group is 1,000. If the security group exceeds this limit, an error message is displayed.

Storage

You must specify at least one system disk for a new instance, when you specify parameters about disks, consider the following:

  • ECS allocates a system disk of an appropriate size for the instance based on the specified ImageId.

  • The available disk categories for system disk are basic cloud disk (cloud), ultra cloud disk (cloud_efficiency), SSD cloud disk (cloud_ssd), and ephemeral SSD disk (ephemeral_ssd).

    Note:
    You must be authorized to create ephemeral SSD disk (ephemeral_ssd). By default, new users are not authorized.

  • When an I/O optimized instance is selected, the system disk can choose only ultra cloud disk (cloud_efficiency) or SSD cloud disk (cloud_ssd).

  • ECS does not allow users to separately create or add an ephemeral SSD. Therefore, the ephemeral SSD must be specified during instance creation. For disk category and size restrictions for different instance type, see Instance generations and type families.

  • The maximum capacity of cloud disks varies according to disk categories:

    • A single basic cloud disk (cloud) cannot exceed 2,000 GB.
    • A single ultra cloud disk (cloud_efficiency) cannot exceed 32 TB (32,768 GB).
    • A single SSD cloud disk (cloud_ssd) cannot exceed 32 TB (32,768 GB).
    • A single ephemeral SSD (ephemeral_ssd) cannot exceed 800 GB.
  • For a system disk created with an instance, the Portable attribute is false, the DeleteWithInstance attribute of the system disk is True. It cannot be attached or detached, and the system disk is released along with the release of an instance.

  • By default, the data disk created with an instance can be a basic cloud disk (cloud), an ultra cloud disk (cloud_efficiency), or an SSD cloud disk (cloud_ssd). The Portable attribute is true, meaning that it cannot be attached or detached. If the data disk is released with the release of the instance, the default value of the DeleteWithInstance attribute is True. Otherwise, the default value of the DeleteWithInstance attribute is False.

  • The Portable attribute of an ephemeral SSD (ephemeral_ssd) that is created with an instance is false, which means the disk cannot be attached or detached. The ephemeral SSD is released with release of the instance. Therefore, the DeleteWithInstance attribute is True.

  • A maximum of 16 data disks can be added to one instance. By default, device names of data disks are allocated in order, starting from /dev/xvdb to /dev/xvdz. The total ephemeral SSD capacity of an instance (excluding the system disk) cannot exceed 1 TB (1,024 GB).

  • If the system disk is a basic cloud disk (cloud), an ultra cloud disk (cloud_efficiency), or an SSD cloud disk (cloud_ssd), the data disk cannot be an ephemeral SSD (ephemeral_ssd).

User-defined data

User-defined data is a function to customize the startup behaviors of an ECS instance and to pass data into an ECS instance. When you specify parameter UserData, considering the following:

  • An ECS instance must meet all the requirements to be able to input UserData. UserData is encoded in Base64 format.

  • UserData transmission is not encrypted, we recommend that you do not input confidential information, such as passwords or private keys, in plaintext.

  • To enter confidential information, you must encrypt and encode it in Base64 format before input. When user data is transferred to the instance, the information is decrypted in the same way.

For more information, see User-defined data.

Others

When you call API in the Alibaba Cloud CLI and SDK, remove the period (.) from the request parameters that contain periods (.), such as SystemDisk.Category, SystemDisk.Size, SystemDisk.Description, DataDisk.n.Size, DataDisk.n.Category, DataDisk.n.SnapshotId, DataDisk.n.DiskName, DataDisk.n.Description, and DataDisk.n.DeleteWithInstance.
For example, use SystemDiskCategory instead of SystemDisk.Category.

Request parameters

Name Type Required Description
Action String Yes The name of this interface. Value: CreateInstance.
RegionId String Yes Region ID of an instance. For more information, see Regions and zones, or query the latest region ID list by calling DescribeRegions.
ImageId String Yes ID of an image file. An image is a running environment template for ECS instances.
InstanceType String Yes Instance type. For more information about available value, see Instance generations and type families, or query the latest instance type list by calling DescribeInstanceTypes.
SecurityGroupId String Yes ID of the security group to which an ECS instance belongs. A security group is a logical group that groups instances in the same region with the same security requirements and mutual trust.
ZoneId String No ID of a zone to which an instance belongs. If it is null, a zone is selected by the system. Default value: null.
InstanceName String No Name of an ECS instance.
  • It can contain [2, 128] characters in length.
  • Must begin with an English or Chinese character
  • Can contain digits, periods (.), colons(:), underscores (_), and hyphens (-).
  • The instance name is displayed in the ECS console.
  • Cannot begin with http:// or https://.
If this parameter is not specified, the default value is the InstanceId of the instance.
Description String No Description of an ECS instance.
  • It can contain [2, 256] characters in length.
  • Cannot begin with http:// or https://.
  • The description is displayed in the ECS console.
Default value: null.
InternetChargeType String No Internet billing method. Optional value:
  • PayByTraffic
InternetMaxBandwidthIn String No Maximum inbound bandwidth from the Internet, its unit of measurement is Mbit/s. Value range: [1, 200].
Default value: 200.
InternetMaxBandwidthOut String No Maximum outbound bandwidth to the Internet, its unit of measurement is Mbit/s. Value range: [0, 100].
If this parameter is not specified, an error is returned. If necessary, you can open a ticket to request to change the bandwidth range to [1, 200] Mbit/s.
HostName String No Host name of the ECS instance. It cannot start or end with a period (.) or a hyphen (-) and it cannot have two or more consecutive periods (.) or hyphens (-).
On Windows, the host name:
  • Can contain [2, 15] characters in length.
  • Can contain uppercase or lowercase letters.
  • Can contain digits, periods (.), and hyphens (-).
  • Cannot be only digits.
On other OSs, such as Linux, the host name:
  • Can contain [2, 128] characters in length.
  • Can be segments separated by periods (.).
  • Can contain uppercase or lowercase letters, digits, and hyphens (-).
Password String No Password of the ECS instance. It can be 8 to 30 characters in length and can contain the following types of characters:
  • Uppercase and lowercase letters
  • Digits
  • Special characters, such as ( ) ' ~ ! @ # $ % ^ & * − + = | { } [ ] : ; ‘ < > , . ? /
If you specify a value for parameter Password, use HTTPS to call the API to avoid data breach.
PasswordInherit Boolean No Whether or not to use the password pre-configured in the image you select. When PasswordInherit is specified, the Password must be null. For a secured access, make sure that the selected image has password configured.
IoOptimized String No Whether an ECS instance is I/O optimized or not. Optional values:
  • none: Not I/O Optimized
  • optimized: I/O Optimized
For Generation I instances, the default value is none.
For other instances, the default value is optimized.
SystemDisk.Category String No Optional values:
  • cloud: Basic cloud disk
  • cloud_efficiency: Ultra cloud disk
  • cloud_ssd: Cloud SSD
  • ephemeral_ssd: Ephemeral SSD
For Generation I and non I/O Optimized instances, the default value is cloud.
For other instances, the default value is cloud_efficiency.
Note: For I/O optimized instances, cloud_ssd and cloud__efficiency disks are supported. For non I/O Optimized instances, ephemeral_ssd and cloud disks are supported.
SystemDisk.Size integer No Size of the system disk, measured in GB.
Value range: [20, 500].
The specified value must be equal to or greater than max{20, ImageSize}.
Default value: max{40, ImageSize}.
SystemDisk.DiskName String No Name of the system disk.
  • It can be [2, 128] characters in length.
  • Must begin with an English letter or Chinese character
  • Can contain digits, colons(:), underscores (_), or hyphens (-)
  • The name is displayed in the ECS console.
  • Cannot begin with http:// or https://
Default value: null.
SystemDisk.Description String No Description of a system disk.
  • It can be [2, 256] characters in length.
  • The description is displayed in the ECS console.
  • Cannot begin with http:// or https://
Default value: null.
DataDisk.n.Size Integer No Size of the n data disk in GBs, n starts from 1. Optional values:
  • Cloud: [5, 2000]
  • cloud_efficiency: [20, 32768]
  • cloud_ssd: [20, 32768]
  • ephemeral_ssd: [5, 800]
The value must be equal to or greater than the specific snapshot.
DataDisk.n.Category String No Category of the data disk n, the valid range of n is [1, 16]. Optional values:
  • cloud: Basic cloud disk
  • cloud_efficiency: Ultra cloud disk
  • cloud_ssd: Cloud SSD
  • ephemeral_ssd: Ephemeral SSD
Default value: cloud.
DataDisk.n.Encrypted Boolean No Whether the data disk n is encrypted or not. Optional values:
  • true: Encrypted
  • false: Not encrypted
Default value: false.
DataDisk.n.SnapshotId String No Snapshot is used to create the data disk. After this parameter is specified, parameter DataDisk.n.Size is ignored, and the size of a new disk is the size of the specified snapshot.
If the specified snapshot was created on or before July 15, 2013, this invocation is denied, and an error InvalidSnapshot.TooOld is returned.
DataDisk.n.DiskName String No Name of a data disk. It can be 2 to 128 characters in length and:
  • It can be [2, 128] characters in length.
  • Must begin with an English letter or Chinese character
  • Can contain digits, colons(:), underscores (_), or hyphens (-)
  • Cannot begin with http:// or https://
  • The data disk name is displayed in the ECS console.
Default value: null.
DataDisk.n.Description String No Description of a data disk.
  • It can be [2, 256] characters in length.
  • Cannot begin with http:// or https://
  • The data disk name is displayed in the ECS console.
Default value: null.
DataDisk.n.DeleteWithInstance Boolean No Whether a data disk is released along with the instance or not. Optional values:
  • true: Indicates the disk is released with the instance.
  • false: Indicates the disk is not released with the instance.
Default value: true.
This parameter is only valid for an independent cloud disk, whose value of parameter DataDisk.n.Category is cloud, cloud_efficiency, or cloud_ssd.
If you specify a value to DataDisk.n.DeleteWithInstance for ephemeral_ssd, an error is returned.
HpcClusterId String No The HPC cluster ID to which the instance belongs.
VSwitchId String No The virtual switch (VSwitch) ID must be specified when you create a VPC-connected instance.
PrivateIpAddress String No Private IP address of an ECS instance. PrivateIpAddress depends on VSwitchId and cannot be specified separately.
InstanceChargeType String No Billing methods. Optional values:
  • PrePaid: Weekly, monthly, or annual subscription
  • PostPaid: Pay-As-You-Go
Default value: PostPaid
SpotStrategy String No The spot strategy of a Pay-As-You-Go instance, and it takes effect only when parameter InstanceChargeType is PostPaid. Optional values:
  • NoSpot: A regular Pay-As-You-Go instance
  • SpotWithPriceLimit: A price threshold for a spot instance
  • SpotAsPriceGo: A price that is based on the highest Pay-As-You-Go instance
Default value: NoSpot
SpotPriceLimit Float No The hourly price threshold for an instance, and it takes effect only when parameter InstanceChargeType is PostPaid. Three decimals is allowed at most.
UserData String No The user-defined data for an instance must be encoded in Base64 format. The maximum size of the user-defined data is 16 KB.
ClientToken String No To guarantee the idempotence of the request. The value is generated by a client. It must be unique among all requests and can contain a maximum of 64 ASCII characters. For more information, see How to ensure idempotence.
KeyPairName String No Key pair name. This parameter is valid only for a Linux instance. The user name and password authentication method is disabled if a value is set for parameter KeyPairName for a Linux instance.
For a Windows ECS instance, if a value is set for parameter KeyPairName, the password still takes effect.
RamRoleName String No Instance RAM role name. The name is provided and maintained by Resource Access Management (RAM) and can be queried using ListRoles. For more information, see RAM API CreateRole and ListRoles.
Tag.n.Key String No The key of a tag, of which n is from 1 to 5. It can be up to 64 characters in length and:
  • Cannot begin with aliyun.
  • Cannot begin with http:// or https://.
  • Cannot be an empty string.
Tag.n.Value String No The value of a tag, of which n is from 1 to 5. It can be up to 128 characters in length and:
  • Cannot begin with aliyun.
  • Cannot begin with http:// or https://.
  • Can be an empty string.

Response parameters

Name Type Description
InstanceId String ID of the ECS instance. It is a unique identifier of the ECS instance.

Examples

Request example

  1. https://ecs.aliyuncs.com/?Action=CreateInstance
  2. &RegionId=cn-hangzhou
  3. &ImageId=_32_23c472_20120822172155_aliguest.vhd
  4. &SecurityGroupId=sg-c0003e8b9
  5. &HostName=Bctest01
  6. &InstanceType=ecs.t1.small
  7. &<Common Request Parameters>

Response example

XML format

  1. <CreateInstanceResponse>
  2. <RequestId>04F0F334-1335-436C-A1D7-6C044FE73368</RequestId>
  3. <InstanceId>i-instance1</InstanceId>
  4. </CreateInstanceResponse>

JSON format

  1. {
  2. "RequestId": "04F0F334-1335-436C-A1D7-6C044FE73368",
  3. "InstanceId": "i-instance1"
  4. }

Error codes

Error code Error message HTTP status code Meaning
Account.Arrearage Your account has an outstanding payment. 400 Your account has an overdue payment.
IncorrectVSwitchStatus The current status of virtual switch does not support this operation. 400 The status of the specified VSwitch does not support the operation.
InstanceDiskCategoryLimitExceed The specified DataDisk.n.Size beyond the permitted range, or the capacity of the snapshot exceeds the size limit of the specified disk category. 400 The specified DataDisk.n.Size exceeds the maximum size of the specified disk category.
InstanceDiskNumber.LimitExceed The maximum number of specified disk in an instance exceeds. 400 The number of data disks attached to one ECS exceeds 16.
InvalidAutoRenewPeriod.ValueNotSupported The specified autoRenewPeriod is not valid. 400 The specified autoRenewPeriod is invalid.
InvalidDataDiskCategory.ValueNotSupported The specified parameter DataDisk.n.Category is not valid. 400 The specified DataDisk.n.Category is invalid.
InvalidDataDiskSize.ValueNotSupported The specified DataDisk.n.Size beyond the permitted range, or the capacity of the snapshot exceeds the size limit of the specified disk category. 400 The specified DataDisk.n.Size is invalid or exceeds the maximum size of the specified disk category.
InvalidDescription.Malformed The specified parameter Description is not valid. 400 The specified Description is invalid.
InvalidDiskCategory.Mismatch The specified disk categories combination is not supported. 400 The combination of specified disk categories is not supported.
InvalidDiskCategory.ValueNotSupported The specified parameter DiskCategory is not valid. 400 The specified DiskCategory is invalid.
InvalidDiskDescription.Malformed The specified parameter SystemDisk.DiskDescription or DataDisk.n.Description is not valid. 400 The specified SystemDisk.DiskDescription or DataDisk.n.Description is invalid.
InvalidDiskName.Malformed The specified parameter SystemDisk.DiskName or DataDisk.n.DiskName is not valid. 400 The specified SyatemDisk.DiskName or DataDisk.n.DiskName is invalid.
InvalidHostName.Malformed The specified parameter HostName is not valid. 400 The specified HostName is invalid.
InvalidInstanceName.Malformed The specified parameter InstanceName is not valid. 400 The specified InstanceName is invalid.
InvalidInstanceType.ValueNotSupported The specified InstanceType beyond the permitted range. 400 The specified InstanceType is invalid or does not exist.
InvalidInstanceType.ValueUnauthorized The specified InstanceType is not authorized. 400 The specified InstanceType is unauthorized.
InvalidInternetChargeType.ValueNotSupported The specified InternetChargeType is not valid. 400 The specified InternetChargeType does not exist.
InvalidIoOptimizedValue.ValueNotSupported IoOptimized value not supported. 400 The specified IoOptimized is invalid or does not exist.
InvalidIPAddress.AlreadyUsed The specified IPAddress is already used by other resource. 400 The specified PrivateIpAddress already exists.
InvalidNetworkType.Mismatch Specified parameter InternetMaxBandwidthIn or InternetMaxBandwidthOut conflict with instance network type. 400 The specified InternetMaxBandwidthIn or InternetMaxBandwidthOut does not match the network type of the instance.
InvalidNetworkType.Mismatch Specified parameter InternetChargeType conflict with instance network type. 400 The specified InternetChargeType is invalid for the network type of the instance.
InvalidParameter The specified instance bandwidth is not valid. 400 The specified bandwidth is invalid.
InvalidParameter The specified parameter InternetMaxBandwidthOut is not valid. 400 The specified InternetMaxBandwidthOut is invalid or exceeds the maximum rate.
InvalidParameter.Bandwidth The specified parameter Bandwidth is not valid. 400 The specified bandwidth is invalid.
InvalidParameter.Conflict The specified image does not support the specified instance type. 400 You cannot use the specified image to create an ECS instance of the specified instance type.
EncryptedOption.Conflict Encryption value of disk and snapshot conflict. 400 Both the specified data disk and the specified snapshot must be encrypted or not at the same time.
InvalidParameter.Encrypted.KmsNotEnabled The encrypted disk need enable KMS 400 You have not enabled the Key Management Service (KMS) service. For more information, see KMS document What is KMS.
InvalidParameter.EncryptedIllegal The value of parameter encrypted is illegal. 400 The specified DataDisk.n.Encrypted is invalid.
InvalidParameter.EncryptedNotSupported Encrypted disk is not support in this region. 400 You cannot encrypt the data disk in the specified RegionId.
InvalidParameter.EncryptedNotSupported Corresponding data disk category does not support encryption. 400 You cannot encrypt the data disk of the specified DataDisk.n.Category.
InvalidParameter.Mismatch Specified virtual switch is not in the specified zone. 400 The specified VSwitch is not in the specified zone.
InvalidParameter.Mismatch Specified security group and virtual switch are not in the same VPC. 400 Both the specified security group and the specified VSwitch must be in the same VPC.
InvalidPassword.Malformed The specified parameter Password is not valid. 400 The specified Password is invalid.
InvalidPasswordParam.Mismatch The input password should be null when passwdInherit is true. 400 When PasswordInherit is specified, the Password must be null.
InvalidPeriod The specified period is not valid. 400 The specified Period is invalid.
InvalidPrivateIpAddress Specified private IP address is not in the CIDR block of virtual switch. 400 You must specify the PrivateIpAddress in the form of a Classless Inter-Domain Routing (CIDR) block of the specified VSwitch.
InvalidPrivateIpAddress.Duplicated Specified private IP address is duplicated. 400 The specified PrivateIpAddress already exists.
InvalidPrivateIpAddress.Malformed Specified private IP address is malformed. 400 The specified PrivateIpAddress is invalid.
InvalidSnapshotId.BasedSnapshotTooOld The specified snapshot is created before 2013-07-15. 400 The specified DataDisk.n.SnapshotId was created before July 15, 2013.
InvalidSpotAliUid The specified UID is not authorized to use SPOT instance. 400 You are not authorized to purchase a spot instance.
InvalidSpotStrategy The specified SpotStrategy is not valid. 400 The parameter SpotStrategy is invalid.
InvalidSpotPriceLimit The specified SpotPriceLimit is not valid. 400 The parameter SpotPriceLimit is invalid.
InvalidSpotAuthorized The specified Spot param is unauthorized. 400 You cannot create a spot instance.
InvalidSpotPrepaid The specified Spot type is not support PrePay Instance. 400 Billing method Pay-As-You-Go is not applicable for the specified spot instance.
InvalidSpotPriceLimit.LowerThanPublicPrice The specified parameter SpotPriceLimit can’t be lower than current public price. 400 The specified SpotPriceLimit must be equal to or greater than the official price of the specified instance.
InvalidSystemDiskCategory.ValueNotSupported The specified parameter SystemDisk.Category is not valid. 400 The specified SystemDisk.Category is invalid.
InvalidUserData.NotSupported The specified parameter UserData only support the Vpc and IoOptimized Instance. 400 You can only specify UserData for I/O optimized VPC-connected instances.
InvalidUserData.SizeExceeded The specified parameter UserData exceeds the size. 400 The size of the UserData has exceeded 16 KB.
InvalidHpcClusterId.NotFound The specified HpcClusterId is not found. 400 The specified HpcClusterId does not exist.
InvalidHpcClusterId.Creating The specified HpcClusterId is creating. 400 The specified HpcClusterId is being created. Please try again later.
InvalidHpcClusterId.Unnecessary The specified HpcClusterId is unnecessary. 400 You can specify the HpcClusterId only for some instance types.
InvalidVSwitchId.Necessary The HpcClusterId is necessary. 400 You must specify the HpcClusterId for this instance type.
MissingParameter The input parameter VSwitchId that is mandatory for processing this request is not supplied. 400 The VSwitchId parameter is required.
QuotaExceed.AfterpayInstance The maximum number of Pay-As-You-Go instances is exceeded. 400 The maximum number of Pay-As-You-Go instances is exceeded.
QuotaExceeded Living instances quota exceeded in this VPC. 400 The number of instances in the specified VPC has reached the upper limit.
QuotaExceeded.PrivateIpAddress Do not have enough private IPs in this switch. 400 Insufficient number of PrivateIpAddress in the specified VSwitch.
ResourceNotAvailable Resource you requested is not available in this region or zone. 400 The resource you requested is unavailable in the specified RegionId or ZoneId. Please try again in another regions or zones.
CategoryNotSupported The specified zone does not offer the specified disk category. 403 You cannot create a disk of the specified disk category in the specified zone.
DeleteWithInstance.Conflict The specified disk is not a portable disk and cannot be set to DeleteWithInstance attribute. 403 You cannot specify DeleteWithInstance to true for the specified disk.
DependencyViolation.WindowsInstance The instance creating is window, cannot use ssh key pair to login. 403 Parameter KeyPairName is valid only for a Linux instance.
DeploymentSet.NoRoom There is no room for more instance creation in the specified DeploymentSet. 403 No more instances can be created in the specified DeploymentSet.
Forbbiden User not authorized to operate on the specified resource. 403 You are not allowed to operate the specified resource.
ImageNotSubscribed The specified image is not subscribed. 403 The specified image on the marketplace is not subscribed.
ImageNotSupportInstanceType The specified image do not support the InstanceType instance. 403 The specified image does not support the instance type.
ImageRemovedInMarket The specified market image is not available, Or the specified user defined image includes product code because it is based on an image subscribed from marketplace, and that image in marketplace including exact the same product code has been removed. 403 The specified image on the marketplace is unavailable, or the image on the marketplace corresponding to the product code is unavailable.
InstanceDiskCategoryLimitExceed The total size of specified disk category in an instance exceeds. 403 The specified disk category exceeds the maximum capacity of a single instance.
InstanceDiskNumLimitExceed The number of specified disk in an instance exceeds. 403 The number of data disks attached to one ECS is more than 16.
InvalidDiskCategory.Mismatch The specified disk categories combination is not supported. 403 The combination of specified disk categories is not supported.
InvalidDiskCategory.NotSupported The specified disk category is not support the specified instance type. 403 The specified disk category is not supported by the specified instance type.
InvalidDiskSize.TooSmall Specified disk size is less than the size of snapshot. 403 The capacity of the specified disk must be equal to or greater than the size of the specified snapshot.
InvalidInstanceType.ZoneNotSupported The specified zone does not support this InstanceType. 403 The specified InstanceType cannot be created in the specified zone.
InvalidNetworkType.MismatchRamRole Ram role cannot be attached to instances of Classic network type. 403 RAM roles cannot be attached to classic network instances.
InvalidParameter.ResourceOwnerAccount ResourceOwnerAccount is Invalid. 403 The specified ResourceOwnerAccount is invalid.
InvalidPayMethod The specified pay method is not valid. 403 The specified billing method does not exist.
InvalidResourceType.NotSupported This resource type is not supported; please try other resource types. 403 The specified InstanceType is unavailable. Please try other instance types.
InvalidSnapshotId.NotDataDiskSnapshot The specified snapshot is a system disk snapshot. 403 A data disk cannot be created from the system disk snapshot.
InvalidSnapshotId.NotReady The specified snapshot has not completed yet. 403 The snapshot has not been completed yet.
InvalidSystemDiskCategory.ValueUnauthorized The disk category is not authorized. 403 You are not allowed to create a disk of the specified category.
InvalidUser.PassRoleForbidden The RAM user does not have the privilege to pass a role. 403 A RAM user must be granted with a pass role permission before he or she specify RamRoleName for a new ECS instance.
InvalidVSwitchId.NotFound The VSwitchId provided does not exist. 403 The specified VSwitchId does not exist.
IoOptimized.NotSupported Vpc is not support IoOptimized instance. 403 I/O optimized instances are not supported in VPC.
IoOptimized.NotSupported The specified image does not support IoOptimized Instance. 403 The specified image does not support the I/O optimized instances.
OperationDenied The type of the disk does not support the operation. 403 The specified category does not support the operation.
OperationDenied The specified Image is disabled or is deleted. 403 The specified image is unavailable or does not exist.
OperationDenied The specified snapshot is not allowed to create a disk. 403 The snapshot of the specified disk is not allowed to create a disk, or the snapshot is not allowed to create a disk.
OperationDenied The creation of Instance to the specified Zone is not allowed. 403 An instance cannot be created for the specified zone. Or the specified ZoneId is not in the specified RegionId.
OperationDenied The specified region is in resource control, please try later. 403 Pay-As-You-Go instances are out of stock in the specified RegionId.
OperationDenied The capacity of snapshot exceeds the size limit of the specified disk category or the specified category is not authorized. 403 The specified DataDisk.n.Size is invalid. Or the maximum capacity of the specified DataDisk.n.Size is exceeded. Or you are not allowed to create a disk of the specified category.
OperationDenied The specified Image is disabled or is deleted. 403 The specified image does not exist.
OperationDenied.NoStock The requested resource is sold out in the specified zone; try other types of resources or other regions and zones. 403 The specified instance type is out of stock. Please try other instance types in the region or try other regions and zones.
QuotaExceed.BuyImage The specified image is from the image market. You have not bought it or your quota has been exceeded. 403 The specified image is from the marketplace. You must purchase it in advance or the image is out of stock in the specified region.
QuotaExceed.PortableCloudDisk The quota of portable cloud disk exceeds. 403 The number of cloud disks that can be attached to an instance has exceeded 16.
RegionUnauthorized There is no permission to create instances in the specified region. 403 You are not authorized to use the specified region.
SecurityGroupInstanceLimitExceed Exceeding the allowed number of instances in a security group. 403 The maximum number of instances in the specified security group is exceeded.
Zone.NotOnSale The specified zone is not available for purchase. 403 The specified zone is unavailable for creating instance. You can try again in other regions or zones.
Zone.NotOpen The specified zone is not granted to you to buy resources yet. 403 You are not allowed to create instances in the specified zone.
ZoneId.NotFound The specified zone does not exists. 403 The specified ZoneId does not exist.
DependencyViolation.IoOptimized The specified InstanceType must be IoOptimized instance. 404 Only I/O optimized instances are allowed for the specified instance type.
HOSTNAME_ILLEGAL hostname is not valid. 404 The specified HostName is invalid.
InvalidDataDiskSnapshotId.NotFound The specified parameter DataDisk.n.SnapshotId is not valid. 404 The specified DataDisk.n.SnapshotId does not exist.
InvalidImageId.NotFound The specified ImageId does not exist. 404 The specified ImageId does not exist.
InvalidInstanceChargeType.NotFound The InstanceChargeType does not exist. 404 The specified InstanceChargeType does not exist.
InvalidKeyPairName.NotFound The specified KeyPairName does not exist. 404 The specified KeyPairName parameter does not exist.
InvalidRamRole.NotFound The specified RamRoleName does not exist. 404 The specified RamRoleName does not exist.
InvalidRegionId.NotFound The specified RegionId does not exist. 404 The specified RegionId does not exist. For more information, see Regions and Zones.
InvalidSecurityGroupId.NotFound The specified SecurityGroupId does not exist. 404 The specified SecurityGroupId does not exist or you are not authorized to use the specified SecurityGroupId.
InvalidSystemDiskSize.LessThanImageSize The specified parameter SystemDisk.Sizeis less than the image size. 404 The value of specified SystemDisk.Size must be greater than the image size.
InvalidSystemDiskSize.LessThanMinSize The specified parameter SystemDisk.Size is less than the min size. 404 The value of specified SystemDisk.Size must be less than the minimum capacity of the system disk.
InvalidSystemDiskSize.MoreThanMaxSize The specified parameter SystemDisk.Size is more than the max size. 404 The value of specified SystemDisk.Size exceeds the maximum capacity of the system disk.
InvalidSystemDiskSize The specified parameter SystemDisk.Size is invalid. 404 The specified SystemDisk.Size is invalid.
InvalidVSwitchId.NotFound Specified virtual switch does not exist. 404 The specified VSwitch does not exist.
InvalidZoneId.NotFound The ZoneId provided does not exist. 404 The specified ZoneId does not exist.
IoOptimized.NotSupported The specified instance type does not support IoOptimized instance. 404 The instances of the specified instance type are not I/O optimized.
OperationDenied Another Instance has been creating. 404 Another Instance is being created.
PaymentMethodNotFound No payment method has been registered on the account. 404 No billing method is specified for this account.
InternalError The request processing has failed due to some unknown error,exception or failure. 500 Internal error. Please try again later.
Thank you! We've received your feedback.