All Products
Search

This Product

    Elastic Compute Service:CreateInstance

    Document Center

    Elastic Compute Service:CreateInstance

    Last Updated:Sep 15, 2026

    Creates a subscription or pay-as-you-go ECS instance. You can use this operation to configure various parameters based on your requirements to create a customized instance.

    Operation description

    Note

    This operation is no longer being updated. We recommend that you use RunInstances.

    Before you call this operation, make sure that you fully understand the billing methods and pricing of ECS.

    This is an asynchronous operation. After a request to create an instance is sent, the instance ID is returned. The instance is not immediately created. Call DescribeInstanceStatus to query the instance status. When the returned status is Stopped, the instance is created. Then, you can call StartInstance to start the instance.

    Before you begin

    • Creating an instance incurs charges. Make sure that you understand the billing methods of Elastic Compute Service. For more information, refer to Billing overview.

    • Make sure that the total number of instances or the total number of vCPUs across all instance types does not exceed the quota. For more information, refer to Quota Center.

    • Before creating a VPC-connected instance, create a VPC in the corresponding Alibaba Cloud region.

    Precautions

    • When you invoke this operation, the system does not send notifications (including text messages, emails, and internal messages) about instance creation.

    • If the billing method of the instance is subscription (PrePaid), active coupon are used by default during payment.

    • If the instance memory is 512 MiB, you cannot use Windows Server images except through the half-year channel. If the instance memory is 4 GiB or more, you cannot use 32-bit operating system images.

    • Instances created by invoking this operation are not assigned Internet IP addresses. If the public bandwidth is greater than 0, you can invoke AllocatePublicIpAddress to assign an address. If the public bandwidth is 0, invoke ModifyInstanceNetworkSpec to adjust the bandwidth and then invoke AllocatePublicIpAddress to assign an address.

    Note

    In a single region, the total peak pay-by-bandwidth Internet bandwidth for a single Alibaba Cloud account is limited. For more information, refer to Public bandwidth limits.

    Suggestions

    • Instance type selection: Refer to Instance family or invoke DescribeInstanceTypes to query the performance data of the target instance type. You can also refer to Best practices for instance type selection to learn how to select an instance type.

    • Check active resources: Invoke DescribeAvailableResource to query active resources in a specific region or zone.

    • User data: If the instance meets the requirements for instance user data, you can pass in UserData. The UserData data is not encrypted when the API request is sent. Do not send confidential information such as passwords or private keys in plaintext. If you must pass in such information, encrypt it and encode it in Base64 before passing it in. Then, decrypt it inside the instance.

    Try it now

    Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

    Test

    RAM authorization

    The table below describes the authorization required to call this API. You can define it in a Resource Access Management (RAM) policy. The table's columns are detailed below:

    • Action: The actions can be used in the Action element of RAM permission policy statements to grant permissions to perform the operation.

    • API: The API that you can call to perform the action.

    • Access level: The predefined level of access granted for each API. Valid values: create, list, get, update, and delete.

    • Resource type: The type of the resource that supports authorization to perform the action. It indicates if the action supports resource-level permission. The specified resource must be compatible with the action. Otherwise, the policy will be ineffective.

      • For APIs with resource-level permissions, required resource types are marked with an asterisk (*). Specify the corresponding Alibaba Cloud Resource Name (ARN) in the Resource element of the policy.

      • For APIs without resource-level permissions, it is shown as All Resources. Use an asterisk (*) in the Resource element of the policy.

    • Condition key: The condition keys defined by the service. The key allows for granular control, applying to either actions alone or actions associated with specific resources. In addition to service-specific condition keys, Alibaba Cloud provides a set of common condition keys applicable across all RAM-supported services.

    • Dependent action: The dependent actions required to run the action. To complete the action, the RAM user or the RAM role must have the permissions to perform all dependent actions.

    Action

    Access level

    Resource type

    Condition key

    Dependent action

    ecs:CreateInstance

    create

    *All Resource

    *
    • vpc:VPC
    • vpc:IsDefaultVSwitch
    • vpc:IsDefaultVpc
    • ecs:IsDiskEncrypted
    • ecs:InstanceType
    • ecs:InstanceTypeFamily
    • ecs:ImageOwnerId
    • ecs:ImageSource
    • ecs:NotSpecifySecurityGroupId
    • ecs:LoginAsNonRoot
    • ecs:IsSystemDiskByokEncrypted
    • ecs:IsDiskByokEncrypted
    • ecs:PasswordInherit
    • ecs:PasswordCustomized
    • ecs:IsSystemDiskEncrypted
    • ecs:ImagePlatform
    • ecs:LoginAsNonRoot
    • ecs:IsSystemDiskByokEncrypted
    • ecs:IsDiskByokEncrypted
    • ecs:PasswordInherit
    • ecs:PasswordCustomized
    • ecs:IsSystemDiskEncrypted
    • ecs:ImagePlatform
    • ecs:SecurityHardeningMode
    • vpc:CreateDefaultVpc
    • ecs:SecurityEnhancementStrategy
    • ecs:AssociatePublicIpAddress
    • ecs:InstanceChargeType
    		 None

    Request parameters

    Parameter

    Type

    Required

    Description

    Example
    RegionId

    string

    Yes

    The region ID of the instance. You can call DescribeRegions to query the most recent region list.

    cn-hangzhou
    ImageId

    string

    No

    The ID of the image used to start the instance. To use an Alibaba Cloud Marketplace image, you can view the ImageId on the image product page. This parameter is required if you do not specify ImageFamily to use the latest available image from an image family.

    ubuntu_18_04_64_20G_alibase_20190624.vhd
    ImageFamily

    string

    No

    The name of the image family. You can set this parameter to obtain the latest available image from the specified image family to create the instance.

    • If ImageId is specified, you cannot set this parameter.

    • If ImageId is not specified, you can set this parameter.

    hangzhou-daily-update
    InstanceType

    string

    Yes

    The instance type.

    ecs.g6.large
    SecurityGroupId

    string

    No

    The ID of the security group to which the new instance belongs.

    sg-bp15ed6xe1yxeycg****
    InstanceName

    string

    No

    The name of the instance. The name must be 2 to 128 characters in length and can contain letters in the Unicode letter category (including English and Chinese characters) and digits. The name can contain colons (:), underscores (_), periods (.), or hyphens (-). If this parameter is not specified, the default value is the instance ID.

    k8s-node-[1,4]-alibabacloud
    InternetChargeType

    string

    No

    The billing method for network usage. Valid values:

    • PayByBandwidth: pay-by-bandwidth.

    • PayByTraffic (default): pay-by-traffic.

    Note

    In pay-by-traffic mode, the peak inbound and outbound bandwidths are both upper limits and are not guaranteed. When resource contention occurs, the peak bandwidth may be throttled. If your workloads require guaranteed bandwidth, use pay-by-bandwidth mode.

    PayByTraffic
    AutoRenew

    boolean

    No

    Specifies whether to enable auto-renewal. This parameter takes effect only when InstanceChargeType is set to PrePaid. Valid values:

    • true: enables auto-renewal.

    • false (default): disables auto-renewal.

    true
    AutoRenewPeriod

    integer

    No

    The auto-renewal period. This parameter is required when AutoRenew is set to True.

    If PeriodUnit is set to Month, valid values of AutoRenewPeriod are 1, 2, 3, 6, and 12.

    2
    InternetMaxBandwidthIn

    integer

    No

    The maximum inbound public bandwidth. Unit: Mbit/s. Valid values:

    • If the purchased outbound public bandwidth is less than or equal to 10 Mbit/s: 1 to 10. Default value: 10.

    • If the purchased outbound public bandwidth is greater than 10 Mbit/s: 1 to the value of InternetMaxBandwidthOut. Default value: the value of InternetMaxBandwidthOut.

    50
    InternetMaxBandwidthOut

    integer

    No

    The maximum outbound public bandwidth. Unit: Mbit/s. Valid values: 0 to 100.

    Default value: 0.

    5
    HostName

    string

    No

    The hostname of the Elastic Compute Service server.

    • The hostname cannot start or end with a period (.) or hyphen (-), and cannot contain consecutive periods or hyphens.

    • Windows instances: The hostname must be 2 to 15 characters in length and cannot contain periods (.) or consist entirely of digits. It can contain uppercase and lowercase letters, digits, and hyphens (-).

    • Instances of other types (such as Linux): The hostname must be 2 to 64 characters in length and can contain multiple periods (.). Each segment separated by a period can contain uppercase and lowercase letters, digits, and hyphens (-).

    LocalHostName
    Password

    string

    No

    The password of the instance. The password must be 8 to 30 characters in length and must contain at least three of the following character types: uppercase letters, lowercase letters, digits, and special characters. The following special characters are supported:

    ()`~!@#$%^&*-_+=|{}[]:;'<>,.?/

    Note the following items:

    • For security reasons, we recommend that you use HTTPS to send requests if the Password parameter is specified.

    • For Windows instances, the password cannot start with a forward slash (/).

    • For instances that run certain operating systems, passwords are not supported. Only key pairs are supported. Examples: Others Linux and Fedora CoreOS.

    TestEcs123!
    PasswordInherit

    boolean

    No

    Specifies whether to use the password preset in the image. If you use this parameter, leave Password empty and make sure that the image has a password configured.

    false
    DeploymentSetId

    string

    No

    The ID of the deployment set.

    ds-bp1brhwhoqinyjd6****
    DeploymentSetGroupNo

    integer

    No

    The number of the deployment set group in which to deploy the instance. This parameter is valid when the deployment set strategy is set to high availability group (AvailabilityGroup). Valid values: 1 to 7.

    1
    ZoneId

    string

    No

    The ID of the zone in which to create the instance. For more information, call DescribeZones to query the zone list.

    Note

    If you specify VSwitchId, the specified ZoneId must be in the same zone as the vSwitch. You can also leave ZoneId empty, and the system automatically selects the zone of the specified vSwitch.

    Default value: empty. The system automatically selects a zone.

    cn-hangzhou-g
    ClusterId

    string

    No

    The ID of the cluster in which to create the instance.

    Note

    This parameter will be deprecated. To improve compatibility, use other parameters instead.

    c-bp67acfmxazb4p****
    ClientToken

    string

    No

    The client token that is used to ensure the idempotence of the request. You can use the client to generate the token, but make sure that the token is unique among different requests. The ClientToken value can contain only ASCII characters and cannot exceed 64 characters in length. For more information, refer to How to ensure idempotence.

    123e4567-e89b-12d3-a456-426655440000
    VlanId

    string

    No

    The virtual local area network ID.

    10
    InnerIpAddress

    string

    No

    The internal IP address of the instance.

    192.168.**.**
    SystemDisk.Size

    integer

    No

    The size of the system disk. Unit: GiB. Valid values:

    • Basic disk: 20 to 500.

    • Other disk types: 20 to 2048.

    The value of this parameter must be greater than or equal to max{20, ImageSize}.

    Default value: max{40, ImageSize}.

    40
    SystemDisk.Category

    string

    No

    The category of the system disk. Valid values:

    • cloud_efficiency: ultra disk.

    • cloud_ssd: standard SSD.

    • cloud_essd: enterprise SSD (ESSD).

    • cloud: basic disk.

    • cloud_auto: ESSD AutoPL disk.

    • cloud_essd_entry: ESSD Entry disk.

    Note

    The cloud_essd_entry value is supported only when InstanceType is set to a universal instance family u1 (ecs.u1) or e, economy instance family (ecs.e) instance type. This parameter supports the cloud_essd_entry value only when the computing power meets the requirements of these instance families.

    For retired instance types that are not I/O optimized instances, the default value is cloud. For other instance types, the default value is cloud_efficiency.

    cloud_ssd
    SystemDisk.DiskName

    string

    No

    The name of the system disk. The name must be 2 to 128 characters in length and can contain letters in the Unicode letter category (including English and Chinese characters and digits). The name can contain colons (:), underscores (_), periods (.), or hyphens (-).

    Default value: empty.

    SystemDiskName
    SystemDisk.Description

    string

    No

    The description of the system disk. The description must be 2 to 256 characters in length and cannot start with http:// or https://.

    Default value: empty.

    TestDescription
    SystemDisk.PerformanceLevel

    string

    No

    The performance level of the enterprise SSD used as the system disk. Set this parameter when you create an ESSD as the system disk. Valid values:

    • PL0: a single disk can deliver up to 10,000 random read/write IOPS.

    • PL1 (default): a single disk can deliver up to 50,000 random read/write IOPS.

    • PL2: a single disk can deliver up to 100,000 random read/write IOPS.

    • PL3: a single disk can deliver up to 1,000,000 random read/write IOPS.

    For information about how to select an ESSD performance level, refer to ESSDs.

    PL1
    NodeControllerId

    string

    No

    Note

    This parameter is in invitational preview and is not publicly available.

    null
    Description

    string

    No

    The description of the instance. The description must be 2 to 256 characters in length and cannot start with http:// or https://.

    Default value: empty.

    InstanceTest
    VSwitchId

    string

    No

    The ID of the vSwitch. This parameter is required if you are creating a VPC-connected instance. You can invoke DescribeVSwitches to query available vSwitches. Before creating a VPC-connected instance, create a VPC in the corresponding region.

    Note

    If you specify VSwitchId, the specified ZoneId must be in the same zone as the vSwitch. You can also leave ZoneId empty, and the system automatically selects the zone of the specified vSwitch.

    vsw-bp1s5fnvk4gn2tws0****
    PrivateIpAddress

    string

    No

    The private IP address of the instance. The IP address must be an available address within the CIDR block of the specified vSwitch (VSwitchId).

    172.16.236.*
    IoOptimized

    string

    No

    Specifies whether the instance is I/O optimized. Valid values:

    • none: The instance is not I/O optimized.

    • optimized: The instance is I/O optimized.

    The default value for retired instance types is none.

    The default value for other instance types is optimized.

    optimized
    UseAdditionalService

    boolean

    No

    Specifies whether to use the virtual machine system configuration provided by Alibaba Cloud (Windows: NTP and KMS. Linux: NTP and YUM).

    true
    InstanceChargeType

    string

    No

    The billing method of the instance. Valid values:

    • PrePaid: subscription. If you set this parameter to PrePaid, make sure that your account supports credit payment or balance payment. Otherwise, an InvalidPayMethod error is returned.

    • PostPaid (default): pay-as-you-go.

    PrePaid
    Period

    integer

    No

    The subscription period of the resource. Unit: specified by PeriodUnit. This parameter is required and takes effect only when InstanceChargeType is set to PrePaid. If DedicatedHostId is specified, the value of this parameter cannot exceed the subscription period of the dedicated host. Valid values:

    If PeriodUnit is set to Month: 1, 2, 3, 6, and 12.

    1
    PeriodUnit

    string

    No

    The unit of the subscription period. Valid values:

    Month.

    Default value: Month.

    Month
    UserData

    string

    No

    The instance user data. The data must be encoded in Base64. The raw data can be up to 32 KB in size.

    ZWNobyBoZWxsbyBlY3Mh
    SpotStrategy

    string

    No

    The bidding policy for the instance. This parameter takes effect only when InstanceChargeType is set to PostPaid. Valid values:

    • NoSpot (default): The instance is a regular pay-as-you-go instance.

    • SpotWithPriceLimit: The instance is a spot instance with a user-defined maximum hourly price.

    • SpotAsPriceGo: The instance is a spot instance for which the market price at the time of purchase is automatically used as the bid price.

    NoSpot
    KeyPairName

    string

    No

    The name of the SSH key pair.

    Note

    For Windows instances, this parameter is ignored. The default value is empty. Even if you specify this parameter, only the Password content is used.

    KeyPairTestName
    SpotPriceLimit

    number

    No

    The maximum hourly price of the instance. This parameter supports up to three decimal places and takes effect only when SpotStrategy is set to SpotWithPriceLimit.

    0.98
    SpotDuration

    integer

    No

    The protection period of the spot instance. Unit: hours. Default value: 1. Valid values:

    • 1: After the instance is created, Alibaba Cloud ensures that the instance is not automatically released for 1 hour. After 1 hour, the system automatically compares the bid price with the market price and checks resource availability to determine whether to retain automatic release the instance.

    • 0: After the instance is created, Alibaba Cloud does not ensure that the instance runs for 1 hour. The system automatically compares the bid price with the market price and checks resource availability to determine whether to retain automatic release the instance.

    Note

    • This parameter currently supports only the values 0 and 1.

    • Spot instances are billed by second. Select an appropriate protection period based on the expected task execution duration.

    • Alibaba Cloud sends a notification through an ECS system event 5 minutes before the instance is released.

    1
    SpotInterruptionBehavior

    string

    No

    The interruption pattern of the spot instance. Valid values:

    Default value: Terminate.

    Terminate
    RamRoleName

    string

    No

    The name of the instance RAM role. You can call the RAM API ListRoles to query the instance RAM roles that you have created.

    RAMTestName
    SecurityEnhancementStrategy

    string

    No

    Specifies whether to enable security hardening. Valid values:

    • Active: enables security hardening. This value is applicable only to public images.

    • Deactive: disables security hardening. This value is applicable to all image types.

    Active
    ResourceGroupId

    string

    No

    The ID of the enterprise resource group to which the instance belongs.

    rg-bp67acfmxazb4p****
    HpcClusterId

    string

    No

    The ID of the HPC cluster to which the instance belongs.

    hpc-bp67acfmxazb4p****
    DryRun

    boolean

    No

    Specifies whether to perform only a dry run. Valid values:

    • true: performs only a dry run. The system checks whether the required parameters are specified, whether the request format is valid, whether the business restrictions are met, and whether the ECS resources are available. If the check fails, the corresponding error is returned. If the check succeeds, the DryRunOperation error code is returned.

    • false (default): performs a dry run and sends the request. If the check succeeds, the instance is created.

    false
    DedicatedHostId

    string

    No

    The ID of the dedicated host.

    You can call DescribeDedicatedHosts to query the list of dedicated host IDs.

    Important Spot instances cannot be created on dedicated hosts. If you specify DedicatedHostId, the SpotStrategy and SpotPriceLimit settings in the request are automatically ignored.

    dh-bp67acfmxazb4p****
    CreditSpecification

    string

    No

    The performance mode of the burstable instance. Valid values:

    Standard
    DeletionProtection

    boolean

    No

    The release protection attribute of the instance. Specifies whether the instance can be released from the ECS console or by calling DeleteInstance.

    • true: enables release protection.

    • false (default): disables release protection.

    Note

    This attribute is applicable only to pay-as-you-go instances and can only restrict manual release operations. It does not take effect on system-initiated release operations.

    false
    HibernationOptions.Configured

    boolean

    No

    Note

    This parameter is in invitational preview and is not publicly available.

    false
    Affinity

    string

    No

    Specifies whether the instance on a dedicated host is associated with the dedicated host. Valid values:

    • default: The instance is not associated with the dedicated host. When an instance that has economical mode enabled is restarted after it is stopped, the instance is deployed on another dedicated host in the automatic deployment resource pool if the resources of the original dedicated host are insufficient.

    • host: The instance is associated with the dedicated host. When an instance that has economical mode enabled is restarted after it is stopped, the instance remains on the original dedicated host. If the resources of the original dedicated host are insufficient, the instance fails to restart.

    Default value: default.

    default
    Tenancy

    string

    No

    Specifies whether to create the instance on a dedicated host. Valid values:

    • default: creates the instance on a non-dedicated host.

    • host: creates the instance on a dedicated host. If you do not specify DedicatedHostId, Alibaba Cloud automatically selects a dedicated host for the instance.

    Default value: default.

    default
    StorageSetId

    string

    No

    The ID of the storage set.

    ss-bp1j4i2jdf3owlhe****
    StorageSetPartitionNumber

    integer

    No

    The maximum number of partitions in the storage set. Valid values: greater than or equal to 2.

    2
    HttpEndpoint

    string

    No

    Specifies whether to enable the access channel for instance metadata. Valid values:

    • enabled: enables the access channel.

    • disabled: disables the access channel.

    Default value: enabled.

    Note

    For information about instance metadata, refer to Overview of instance metadata.

    enabled
    HttpTokens

    string

    No

    Specifies whether to forcefully use the security-hardened mode (IMDSv2) to access instance metadata. Valid values:

    • optional: does not forcefully use the security-hardened mode.

    • required: forcefully uses the security-hardened mode. After this value is set, instance metadata cannot be accessed in normal mode.

    Default value: optional.

    Note

    For information about the modes for accessing instance metadata, refer to Instance metadata access modes.

    optional
    HttpPutResponseHopLimit

    integer

    No

    Note

    This parameter is not publicly available.

    0
    PrivatePoolOptions.MatchCriteria

    string

    No

    The private pool option for launching the instance. A private pool is generated after an elasticity assurance or capacity reservation takes effect. You can select a private pool when you start an instance. Valid values:

    • Open: open mode. The system automatically matches an open private pool. If no matching private pool is available, the instance is launched by using public pool resources. You do not need to set PrivatePoolOptions.Id.

    • Target: specified mode. The instance is launched by using the capacity of the specified private pool. If the specified private pool is unavailable, the instance fails to be launched. In this mode, you must specify the private pool ID. Set PrivatePoolOptions.Id to the ID of the private pool.

    • None: none mode. No private pool is used to launch the instance.

    Default value: None.

    In the following scenarios, the private pool option can only be set to None or left empty:

    • Creating a spot instance.

    • Creating an ECS instance on a dedicated host.

    Open
    PrivatePoolOptions.Id

    string

    No

    The ID of the private pool. The ID of an elasticity assurance or capacity reservation.

    eap-bp67acfmxazb4****
    DataDisk

    array<object>

    No

    The list of data disks.

    object

    No

    Category

    string

    No

    The category of data disk N. Valid values:

    • cloud_efficiency: ultra disk.

    • cloud_ssd: standard SSD.

    • cloud_essd: enterprise SSD (ESSD).

    • cloud: basic disk.

    • cloud_auto: ESSD AutoPL disk.

    • cloud_essd_entry: ESSD Entry disk.
      Note

      The cloud_essd_entry value is supported only when InstanceType is set to an ecs.u1 or ecs.e instance type.

    • elastic_ephemeral_disk_standard: elastic ephemeral disk - Standard.

    • elastic_ephemeral_disk_premium: elastic ephemeral disk - Premium.

    The default value is cloud_efficiency for I/O optimized instances and cloud for non-I/O optimized instances.

    cloud_ssd
    DeleteWithInstance

    boolean

    No

    Specifies whether the data disk is released when the instance is released.

    • true: The data disk is released when the instance is released.

    • false: The data disk is not released when the instance is released.

    Default value: true.

    true
    Description

    string

    No

    The description of the data disk. The description must be 2 to 256 characters in length and cannot start with http:// or https://.

    TestDescription
    Device

    string

    No

    The mount point of the data disk.

    Note

    This parameter is applicable only to full image (system image) scenarios. You can set this parameter to the mount point of a data disk in the full image and modify the corresponding DataDisk.N.Size and DataDisk.N.Category parameters to change the category and size of the data disk in the full image.

    /dev/xvdb
    DiskName

    string

    No

    The name of the data disk. The name must be 2 to 128 characters in length and can contain letters in the Unicode letter category (including English and Chinese characters and digits). The name can contain colons (:), underscores (_), periods (.), or hyphens (-).

    DataDiskName
    EncryptAlgorithm

    string

    No

    Note

    This parameter is not publicly available.

    null
    Encrypted

    boolean

    No

    Specifies whether data disk N is encrypted.

    • true: The data disk is encrypted.

    • false: The data disk is not encrypted.

    Default value: false.

    false
    KMSKeyId

    string

    No

    The ID of the Key Management Service (KMS) key used by the disk.

    0e478b7a-4262-4802-b8cb-00d****
    PerformanceLevel

    string

    No

    The performance level of the enterprise SSD used as a data disk. Set this parameter when you create an ESSD as a data disk. The value of N must be the same as that in DataDisk.N.Category=cloud_essd. Valid values:

    • PL0: a single disk can deliver up to 10,000 random read/write IOPS.

    • PL1 (default): a single disk can deliver up to 50,000 random read/write IOPS.

    • PL2: a single disk can deliver up to 100,000 random read/write IOPS.

    • PL3: a single disk can deliver up to 1,000,000 random read/write IOPS.

    For information about how to select an ESSD performance level, refer to ESSDs.

    PL2
    Size

    integer

    No

    The size of data disk N. Valid values of N: 1 to 16. Unit: GiB. Valid values:

    • cloud_efficiency: 20 to 32768.

    • cloud_ssd: 20 to 32768.

    • cloud_essd: The valid value range depends on the value of DataDisk.N.PerformanceLevel.

      • PL0: 1 to 65536.

      • PL1: 20 to 65536.

      • PL2: 461 to 65536.

      • PL3: 1261 to 65536.

    • cloud: 5 to 2000.

    Note

    The value of this parameter must be greater than or equal to the size of the snapshot specified by SnapshotId.

    2000
    SnapshotId

    string

    No

    The ID of the snapshot used to create data disk N. Valid values of N: 1 to 16.

    • After DataDisk.N.SnapshotId is specified, DataDisk.N.Size is ignored. The actual size of the created disk is the size of the specified snapshot.

    • Snapshots created on or before July 15, 2013 cannot be used. Requests that use such snapshots are rejected.

    s-bp17441ohwka0yuh****
    StorageClusterId

    string

    No

    The ID of the dedicated block storage cluster. If you want to use disks in a dedicated block storage cluster as data disks when you create an ECS instance, set this parameter.

    dbsc-j5e1sf2vaf5he8m2****
    Arn

    array<object>

    No

    Note

    This parameter is in invitational preview and is not publicly available.

    object

    No

    AssumeRoleFor

    integer

    No

    Note

    This parameter is in invitational preview and is not publicly available.

    1234567890
    RoleType

    string

    No

    Note

    This parameter is in invitational preview and is not publicly available.

    Primary
    Rolearn

    string

    No

    Note

    This parameter is in invitational preview and is not publicly available.

    acs:ram::123456789012****:role/adminrole
    Tag

    array<object>

    No

    The tags.

    object

    No

    The tags.

    Key

    string

    No

    The tag key of the instance, disk, and primary ENI. Valid values of N: 1 to 20. The tag key cannot be an empty string. The tag key can be up to 128 characters in length and cannot start with aliyun or acs:. The tag key cannot contain http:// or https://.

    TestKey
    Value

    string

    No

    The tag value of the instance, disk, and primary ENI. Valid values of N: 1 to 20. The tag value can be an empty string. The tag value can be up to 128 characters in length and cannot contain http:// or https://.

    TestValue
    key

    string

    No

    The tag key.

    Note

    For better compatibility, use Tag.N.Key.

    Test
    value

    string

    No

    The tag value.

    Note

    For better compatibility, use Tag.N.Value.

    Test
    SystemDisk

    object

    No

    The system disk parameters. The dedicated block storage cluster ID (StorageClusterId) must be specified by using this parameter.

    StorageClusterId

    string

    No

    The ID of the dedicated block storage cluster. If you want to use disks in a dedicated block storage cluster as the system disk when you create an ECS instance, specify this parameter.

    dbsc-j5e1sf2vaf5he8m2****
    ManagedHostId

    string

    No

    The unique ID of the platform-managed host, such as mh-f2d3647ca21****.

    mh-f2d3647ca21****

    Response elements

    Element

    Type

    Description

    Example

    object

    InstanceId

    string

    The instance ID.

    i-bp67acfmxazb4p****
    OrderId

    string

    The order ID. This parameter is returned only when you create a subscription ECS instance (the request parameter InstanceChargeType=PrePaid).

    1234567890
    RequestId

    string

    The request ID.

    473469C7-AA6F-4DC5-B3DB-A3DC0DE3****
    TradePrice

    number

    The transaction price of the order.

    0.165

    Examples

    Success response

    JSON format

    {
  "InstanceId": "i-bp67acfmxazb4p****",
  "OrderId": "1234567890",
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****",
  "TradePrice": 0.165
}

    Error codes

    HTTP status code

    Error code

    Error message

    Description
    400 InvalidStorageClusterId.CapacityNotEnough The remaining capacity of the current dedicated storage cluster is less than the size of disk. The remaining capacity of the dedicated block storage cluster to which the disk belongs is insufficient.
    400 InvalidStorageClusterId.StatusNotSupport The current status of the dedicated storage cluster cannot create a cloud disk yet.
    400 InvalidStorageClusterId.ZoneIdEmpty The specified param ZoneId cannot be empty when StorageClusterId given.
    400 InvalidStorageClusterId.PerformanceLevelNotMatch The current dedicated storage cluster cannot create this performance level of disk.
    400 InvalidStorageClusterId.CategoryNotMatch The current dedicated storage cluster cannot create this category of disk.
    400 InvalidStorageClusterId.DiskSizeEmpty The specified param DiskSize cannot be empty when StorageClusterId given.
    400 InvalidInstanceType.ValueUnauthorized The specified InstanceType is not authorized.
    400 InvalidInternetChargeType.ValueNotSupported The specified InternetChargeType is not valid. The specified InternetChargeType parameter is invalid.
    400 InvalidParameter The specified parameter "InternetMaxBandwidthOut" is not valid.
    400 InvalidSystemDiskCategory.ValueNotSupported The specified parameter " SystemDisk.Category " is not valid.
    400 InvalidDataDiskSize.ValueNotSupported The specified DataDisk.n.Size beyond the permitted range, or the capacity of snapshot exceeds the size limit of the specified disk category. The specified DataDisk.N.Size parameter is invalid or the snapshot size exceeds the maximum capacity allowed for the specified disk category.
    400 InvalidInstanceType.ValueNotSupported The specified InstanceType does not exist or beyond the permitted range. The specified instance type does not exist or you are not authorized to manage instances of this instance type.
    400 InvalidDescription.Malformed The specified parameter "Description" is not valid. The source description can be 2 to 256 characters in length. It cannot start with http:// and https://.
    400 InvalidHostName.Malformed The specified parameter "HostName" is not valid. The specified HostName parameter is invalid.
    400 InvalidPassword.Malformed The specified parameter "Password" is not valid. The specified Password parameter is invalid.
    400 InvalidPasswordParam.Mismatch The input password should be null when passwdInherit is true. The Password parameter must be left empty when the PasswdInherit parameter is used.
    400 InvalidDiskName.Malformed The specified parameter "SystemDisk.DiskName or DataDisk.n.DiskName" is not valid.
    400 InvalidDiskDescription.Malformed The specified parameter "SystemDisk.DiskDescription" or "DataDisk.n.Description" is not valid. The specified SyatemDisk.DiskDescription or DataDisk.n.Description is invalid.
    400 InvalidDataDiskCategory.ValueNotSupported The specified parameter "DataDisk.n.Category" is not valid.
    400 InvalidDataDevice.Malformed The specified parameter "DataDisk.n.Device" is not valid.
    400 InvalidNodeControllerId.Malformed The specified parameter "NodeControllerId" is not valid.
    400 InvalidInnerIpAddress.Malformed The specified parameter "InnerIpAddress" is not valid.
    400 InvalidInnerIpAddress.Unusable The specified InnerIpAddress is already used or not found in usable ip range. The specified internal IP address is unavailable.
    400 OperationDenied The specified parameter "VlanId" is not valid or vlan has not enough IP address.
    400 InvalidParameter.Conflict The specified image does not support the specified instance type. The specified image cannot be used for instances of the specified instance type.
    400 ImageNotSupportCloudInit The specified image does not support cloud-init. The specified image does not support CloudInit.
    400 InvalidSnapshotId.BasedSnapshotTooOld The specified snapshot is created before 2013-07-15. The specified snapshot was created before July 15, 2013.
    400 QuotaExceed.AfterpayInstance The maximum number of Pay-As-You-Go instances is exceeded: %s.
    400 InvalidMarketImageChargeType.NotSupport The specified chargeType of marketImage is unsupported. The billing method of the Alibaba Cloud Marketplace image is not supported.
    400 InvalidInstanceName.Malformed The specified parameter "InstanceName" is not valid. The specified InstanceName parameter is invalid.
    400 InvalidParameter.Mismatch Specified security group and virtual switch are not in the same VPC. The specified security group and vSwitch do not belong to the same VPC.
    400 InvalidNetworkType.Mismatch Specified parameter InternetMaxBandwidthIn or InternetMaxBandwidthOut conflict with instance network type. The specified InternetMaxBandwidthIn or InternetMaxBandwidthOut parameter conflicts with the instance network type.
    400 InvalidPrivateIpAddress Specified private IP address is not in the CIDR block of virtual switch. The specified private IP address does not fall within the CIDR block of the specified vSwitch.
    400 InvalidPrivateIpAddress.Malformed Specified private IP address is invalid.
    400 InvalidPrivateIpAddress.Duplicated Specified private IP address is duplicated.
    400 QuotaExceeded.PrivateIpAddress Don't have enough private IPs in this switch.
    400 QuotaExceeded Living instances quota exceeded in this VPC.
    400 IncorrectVSwitchStatus The current status of virtual switch does not support this operation. The specified vSwitch is in the Pending state and cannot be deleted.
    400 ResourceNotAvailable Resource you requested is not available in this region or zone.
    400 MissingParameter The input parameter "VSwitchId" that is mandatory for processing this request is not supplied.
    400 InvalidDiskCategory.Mismatch The specified disk categories' combination is not supported.
    400 InvalidIoOptimizedValue.ValueNotSupported IoOptimized value not supported. The specified IoOptimized value is not supported.
    400 MissingParamter The specified parameter "Period" is not null. The Period parameter cannot be empty.
    400 InvalidPeriod The specified period is not valid. The specified period is invalid.
    400 InstanceDiskCategoryLimitExceed The specified DataDisk.n.Size beyond the permitted range, or the capacity of snapshot exceeds the size limit of the specified disk category. The specified DataDisk.N.Size parameter is invalid or the snapshot size exceeds the maximum capacity allowed for the specified disk category.
    400 InvalidParameter.Bandwidth The specified parameter Bandwidth is not valid. The specified bandwidth value is invalid.
    400 InvalidIPAddress.AlreadyUsed The specified IPAddress is already used by other resource. The specified IP address is being used by another resource.
    400 InvalidUserData.SizeExceeded The specified parameter "UserData" exceeds the size.
    400 InvalidUserData.NotSupported The specified parameter "UserData" only support the vpc and IoOptimized Instance.
    400 InstanceDiskNumber.LimitExceed The total number of specified disk in an instance exceeds. The number of disks on an instance exceeds the upper limit.
    400 Account.Arrearage Your account has an outstanding payment. Your account has overdue payments.
    400 InvalidDiskCategory.ValueNotSupported The specified parameter "DiskCategory" is not valid. The specified cloud disk type DiskCategory is invalid.
    400 InvalidAutoRenewPeriod.ValueNotSupported The specified autoRenewPeriod is not valid. The specified AutoRenewPeriod parameter is invalid.
    400 InvalidSpotStrategy The specified SpotStrategy is not valid. The specified SpotStrategy parameter is invalid.
    400 InvalidSpotParam.EmptyZoneID The specified ZoneId is empty when SpotStrategy is set. The ZoneId parameter is not specified while the SpotStrategy parameter is specified.
    400 InvalidSpotPriceLimit The specified SpotPriceLimitis not valid. The specified SpotPriceLimit parameter is invalid.
    400 InvalidSpotDuration The specified SpotDuration is not valid. The specified SpotDuration parameter is invalid.
    400 InvalidSpotAuthorized The specified Spot param is unauthorized. You are not authorized to set the SpotDuration parameter.
    400 InvalidSpotPrepaid The specified Spot type is not support PrePay Instance. Spot instances do not support the subscription billing method.
    400 InvalidSpotAliUid The specified UID is not authorized to use SPOT instance. You are not authorized to create spot instances.
    400 InvalidTagKey.Malformed The specified Tag.n.Key is not valid. The specified Tag.N.Key parameter is invalid.
    400 RegionUnauthorized %s The user is not authorized to create instances in the specified region.
    400 Zone.NotOnSale %s The requested resources are unavailable in the specified zone. %s is a variable. An error message is dynamically returned based on call conditions.
    400 InvalidSystemDiskSize.ValueNotSupported %s The specified system disk size is invalid.
    400 InvalidParameter.EncryptedIllegal %s The specified parameter is invalid. Check whether your encryption operation is supported. %s is a variable. An error message is dynamically returned based on call conditions.
    400 InvalidParameter.EncryptedNotSupported %s The specified parameter is invalid and your encryption operation is not supported. %s is a variable. An error message is dynamically returned based on call conditions.
    400 EncryptedOption.Conflict %s The specified parameter is invalid and your encryption operation is not supported. %s is a variable. An error message is dynamically returned based on call conditions.
    400 InvalidSpotPriceLimit.LowerThanPublicPrice The specified parameter "soptPriceLimit" can't be lower than current public price. The specified SpotPriceLimit parameter cannot be lower than the current public price.
    400 InvalidHpcClusterId.Unnecessary The specified HpcClusterId is unnecessary. The HpcClusterId parameter is specified.
    400 InvalidVSwitchId.Necessary The VSwitchId is necessary. The VSwitchId parameter is required.
    400 InvalidHpcClusterId.Necessary The HpcClusterId is necessary. The HpcClusterId parameter is required.
    400 InvalidHpcClusterId.NotFound The specified HpcClusterId is not found. The specified HpcClusterId parameter does not exist.
    400 InvalidHpcClusterId.Creating The specified HpcClusterId is creating. The specified HPC cluster is being created.
    400 InvalidPeriodUnit.ValueNotSupported The specified parameter PeriodUnit is not valid. The specified PeriodUnit parameter is invalid.
    400 IncorrectImageStatus Encrypted snapshots do not support this operation. Encrypted snapshots do not support the operation.
    400 InvalidTagValue.Malformed The specified Tag.n.Value is not valid. The specified tag value is invalid.
    400 InvalidSecurityGroup.NotInDefaultVpc %s The security group is not in the default VPC. Check whether the specified SecurityGroupId parameter is correct.
    400 VpcNotFound Vpc is not found according to the specified VSwitch or the vpc does not belong to you. No VPC is found based on the specified vSwitch or the corresponding VPC does not belong to you.
    400 InvalidSpotInterruptionBehavior %s The specified SpotInterruptionBehavior parameter is not supported.
    400 OperationDenied.IllegalPaymentPolicy The current payment policy is illegal, please connect your service provider to authenticate relative agreement. The current payment policy is invalid. Contact your service provider to validate agreements relevant to the payment policy.
    400 InvalidDeploymentOnHost %s The instance cannot be deployed in the specified deployment set.
    400 InvalidInstanceChargeType.NotSupport The Dedicated host not support the specified Instance charge type. This dedicated host does not support instances that use the specified billing method.
    400 InvalidNetworkType.NotSupported The classic networkType not support create ECS on dedicatedHost. Dedicated hosts do not support instances in the classic network type.
    400 InvalidDedicatedHostId.NotFound The specified DedicatedHostId does not exist. The specified dedicated host does not exist.
    400 InvalidDedicatedHostStatus.NotSupport Operation denied due to dedicated host status. The current status of the dedicated host does not support this operation.
    400 IncorrectDedicatedHostStatus The current status of the resource does not support this operation. The resource is in a state that does not support the current operation.
    400 ChargeTypeViolation.PostPaidDedicatedHost Prepaid instance onto postpaid dedicated host is not allowed. A subscription instance cannot be added to a pay-as-you-go dedicated host.
    400 InvalidPeriod.ExceededDedicatedHost Instance expired date can't exceed dedicated host expired date.
    400 DedicatedHostType.Unmatched The specified DedicatedHostType doesn?t match the instance type. The specified dedicated host type does not match the instance type.
    400 NoAvaliableDedicatedHost There's no enough resource on the specified dedicated host. No available dedicated host was found.
    400 InvalidParameter.Affinity The specified Affinity is invalid.
    400 InvalidParameter.Tenancy The specified Tenancy is invalid.
    400 InvalidParam.Tenancy The specified Tenancy is invalid. The specified Tenancy parameter is invalid.
    400 InvalidParameter.CreditSpecification The specified CreditSpecification is not supported in this region. The running mode of the specified burst performance instance is not supported in this zone.
    400 InvalidInstanceType.NotSupported The specified instanceType is not supported by the deployment set. The current deployment set does not support the specified instance type. Try another instance type.
    400 InvalidVpcZone.NotSupported Zone of the specified VSwitch is not available for creating, please try in other zones. The default vSwitch cannot be created in the specified zone. Try another zone.
    400 IncorrectDefaultVpcStatus The status of the default VPC is invalid. The state of the default VPC is invalid.
    400 IoOptimized.NotSupported The specified instance type must be an I/O optimized instance when the KMSKeyId parameter is specified. Please select an I/O optimized instance type and try again.
    400 InvalidClientToken.ValueNotSupported The ClientToken provided is invalid. The specified ClientToken parameter is invalid.
    400 InvalidCapacityReservationId.NotFound The specified CapacityReservationId does not exist.
    400 LackResource There's no enough resource on the specified capacity reservation.
    400 Duplicate.TagKey The Tag.N.Key contain duplicate key. The specified tag key already exists. Tag keys must be unique.
    400 InvalidParameter.Arns The specified Arns is not valid. The Arns parameter is invalid. Please check and pass it again.
    400 InvalidOperation.NotSupportEnterpriseGroup The specified instance type doesn't support enterprise level security group.
    400 InvalidOperation.MultiGroupType The specified instance can't join different types of security group.
    400 InvalidAccountStatus.PayAmountLimitExceeded Your account is being restricted, because you have no default payment method or you are not authorized.
    400 InvalidPerformanceLevel.Malformed The specified parameter DataDisk.n.PerformanceLevel is not valid. The specified PerformanceLevel parameter is invalid.
    400 InvalidSecurityGroup.NetworkType %s
    400 QuotaExceeded.PrepayDataDiskCapacity The quota of prepay data disk capacity exceeds.
    400 InvalidCustomInstanceType.NotSupported The specified custom instance type is invalid.
    400 InvalidOperation.EniCountExceeded The maximum number of eni in a enterprise security group is exceeded. The number of ENIs in the advanced security group has reached the upper limit.
    400 AccountForbidden.ProductCreationLimited The commodity must be officially operated by Aliyun and in pay-as-you-go billing method. Enterprise cloud migration customers can purchase only pay-as-you-go ECS instances and cannot purchase third-party products such as images provided by Alibaba Cloud Marketplace. Check the parameters and retry with valid parameters.
    400 UnexpectedImageFamily.ImageIdSupplied The input parameter ImageFamily must be null when image id is set. The ImageFamily parameter must be left empty if an image ID is specified.
    400 InvalidEncrypted.NotMatchEncryptAlgorithm The Encrypted parameter must be set to true when EncryptAlgorithm is specified. Please adjust the parameters and try again.
    400 InvalidEncrypted.NotMatchKmsKeyId The Encrypted parameter must be set to true when KMSKeyId is specified. Please adjust the parameters and try again.
    400 InvalidEncryptAlgorithm.NotMatchSnapshot The specified parameter EncryptAlgorithm is different from the encrypt algorithm of the snapshot.
    400 InvalidKmsKeyId.NotMatchSnapshot The specified parameter KmsKeyId is different from the KmsKeyId of the snapshot.
    400 InvalidEncryptAlgorithm The specified EncryptAlgorithm is not valid. Ensure the value is a supported encryption algorithm such as AES-256.
    400 InvalidHttpEndpoint.NotSupported The specified HttpEndpoint not supported, you can use enabled(default) or disabled. The specified HttpEndpoint parameter is invalid. The valid values of this parameter are enabled and disabled. The default value is enabled.
    400 InvalidHttpTokens.NotSupported The specified HttpTokens not supported, you can use optional(default) or required. The specified HttpTokens parameter is invalid. The valid values of this parameter are optional and required. The default value is optional.
    400 InvalidHttpPutResponseHopLimit.NotSupported The specified HttpPutResponseHopLimit not supported, more than 1 and less than 64 is reasonable. The specified HttpPutResponseHopLimit parameter is invalid. The valid values of this parameter are 1 to 64.
    400 InvalidOperation.VpcHasEnabledAdvancedNetworkFeature The specified vpc has enabled advanced network feature. Advanced features are enabled for the specified VPC. You cannot create low-specification instances in the VPC.
    400 InvalidChargeType.CapacityReservationNotSupported %s
    400 InvalidPerformanceLevel.ValueNotSupported The current ZoneId or InstanceType does not support PL0 of cloud_essd.
    400 InvalidKMSKeyId.NotSymmetric The specified KMSKeyId must be a symmetric key. Please use a symmetric KMS key such as an AES-256 key.
    400 InvalidDedicatedHostClusterId.NotFound The specified DedicatedHostClusterId does not exist.
    400 InvalidDedicatedHostClusterId.InValid The specified Dedicated Host Cluster is invalid.
    400 InvalidOperation.UserNotSupported Reseller user do not support purchase at the moment.
    400 InvalidDeploymentSetId.NotFound The parameter DeploymentSetId is invalid.
    400 MissingParameter.PrivatePoolOptionsId The specified PrivatePoolOptions.Id should not be null. The PrivatePoolOptions.Id parameter is required.
    400 Invalid.PrivatePoolOptionsId The specified PrivatePoolOptions.Id is invalid. The specified PrivatePoolOptions.Id parameter is invalid.
    400 DedicatedHostNotSupported DedicatedHost is not supported for PrivatePool. The private pool does not support dedicated hosts.
    400 SpotNotSupported Spot is not supported for PrivatePool. The private pool does not support spot instances.
    400 ClassicNetworkNotSupported Classic network is not supported for PrivatePool. The private pool does not support instances in the classic network.
    400 Invalid.InstanceId Instance does not exist. The specified instance does not exist.
    400 Invalid.PrivatePoolOptions.MatchCriteria Target mode does not support this operation. The operation is not supported while the PrivatePoolOptions.MatchCriteria parameter is set to Target.
    400 MissingParameter.PrivatePoolOptions.Id The specified PrivatePoolOptions.Id should not be null. The PrivatePoolOptions.Id parameter is required.
    400 Invalid.PrivatePoolOptions.Id The PrivatePool does not exist. The private pool does not exist.
    400 Invalid.InstanceType The InstanceType does not match the PrivatePool. The instance type and the private pool do not match.
    400 Invalid.InstanceChargeType The InstanceChargeType does not match the PrivatePool. The instance billing method and the private pool do not match.
    400 Invalid.ZoneId The ZoneId does not match the PrivatePool. The zone and the private pool do not match.
    400 Invalid.PrivatePoolOptions.NoStock The PrivatePool has been used up. The capacity of the specified private pool (elastic assurance, capacity reservation) has been used up.
    400 InvalidPlatform.ValueNotSupported The Platform does not match the PrivatePool. The specified Platform parameter does not match the private pool.
    400 Invalid.PrivatePoolOptions.status The PrivatePool is expired or inactive. The private pool has expired or is not activated.
    400 InvalidAliUid The PrivatePool does not belong to the user of the Instance. The specified private pool does not belong to the user who attempted to create the instance.
    400 HibernationConfigured.InstanceTypeNotSupport The specified instance type is not support.
    400 HibernationConfigured.ImageNotEncrypted The hibernation configured instance only support encrypted image.
    400 HibernationConfigured.MemorySizeTooBig The hibernation configured instance memory size is too big.
    400 InvalidSystemDiskSize.LessThanMemSize The specified parameter SystemDisk.Size is less than the memory size.
    400 InvalidCloudBoxZone.OperationNotSupported The cloud box zone does not support creating prepaid or encrypted resources.
    400 InvalidInternetMaxBandwidthOut.Malformed The specified parameter InternetMaxBandwidthOut is not valid.
    400 InvalidInternetMaxBandwidthIn.Malformed The specified parameter InternetMaxBandwidthIn is not valid.
    400 InvalidParameter.CloudboxNotSupported %s
    400 NotSupportSnapshotEncrypted.ShareImage Shared snapshot creating encrypted disks with native snapshot encrypt is not supported.
    400 QuotaExceed.DiskCapacity The used capacity of disk type has exceeded the quota in the zone, %s. The capacity of disks that belong to the specified disk category exceeds the quota limit for the zone.
    400 InvalidParameter.DataEncryptedKeyCreateFailed The ECS service is not authorized to access your KMS key. Please grant the ECS service permission to use the key and try again.
    400 InvalidDiskCategory.NotSupported The specified disk category is not supported.
    400 InvalidDestinationZone.DeploymentSetMismatch Error happened, %s. If the instance joins a deployment set with the LowLatency strategy and the deployment set already contains instances, the instance must be in the same zone as the existing instances.
    400 NoPermission.Price The operation requires price permission. Please either apply for permission from your main account, or set the parameter AutoPay as true. This operation requires price permission. Please apply for permission to your master account, or set the parameter AutoPay to true for automatic payment.
    400 InvalidParameter.DedicatedRegionNotSupported The specified action is rejected because the specified ECS instance in the dedicated region does not support public IP. Parameter error codes not supported in the dedicated region
    400 InvalidParameter.KmsNotEnabled The operation failed because KMS is not activated. Please activate KMS in the KMS console and try again.
    400 InvalidParameter.Encrypted.KmsNotEnable The operation failed because KMS is not activated. Please activate KMS in the KMS console and try again.
    400 InvalidParam.EncryptedMismatch Creating a disk from a shared encrypted image requires encryption with your own KMS key. Please set the Encrypted parameter to true.
    400 InvalidParameter.Encrypted Creating non-encrypted disks from encrypted snapshots is not allowed. Please set Encrypted to true or use an unencrypted snapshot.
    400 QuotaExceeded.InternetBandwidth %s. Under your current account, the public network bandwidth of the Pay-As-You-Go ECS instance charged by fixed bandwidth exceeds the total bandwidth quota limit.
    400 InvalidVSwitchId.NotFound The specified VSwitch does not exist in the specified region. The specified vSwitch does not exist in the specified region.
    400 OperationDenied.TestAccountRetricted Test-account for testing has been prohibited from creating instance in this region. Please contact 400181. Test accounts are not allowed to create instances in the local region. Please contact Cost and Resource Center @ Gao Chong (400181)
    400 InvalidVSwitch.Ipv4NotEnabled The specify VSwitch of ECS does not support IPv4.
    400 InvalidManagedHostId.DedicatedHostIdConflict The parameters 'ManagedHostId' and 'DedicatedHostId' cannot be specified at the same time. Cannot specify ManagedHostId and DedicatedHostId at the same time
    400 InvalidManagedHostId.ManagedPrivateSpaceIdConflict The parameters 'ManagedHostId' and 'ManagedPrivateSpaceId' cannot be specified at the same time. Cannot specify ManagedHostId and ManagedPrivateSpaceId at the same time
    400 InvalidManagedHostId.TenancyConflict The specified parameter 'ManagedHostId' requires 'Tenancy' to be 'managedHost'. Specified ManagedHostId Only Tenancy can be specified as managedHost or no Tenancy can be specified
    401 InvalidRamRole.NotEcsRole The specified ram role is not authorized for ecs, please check your role policy. The specified RAM role is not authorized to use ECS. Check your role policies.
    500 InternalError The request processing has failed due to an internal error and you may retry later or contact support with the request ID.
    500 InvalidImage.OSType The image OSType does not support this instance type. The operating system of this image does not support the selected instance type.
    403 InvalidDiskCategory.NotSupported The specified disk category is not support the specified instance type.
    403 ImageNotSubscribed The specified image has not be subscribed.
    403 OperationDenied The specified Image is disabled or is deleted. The specified image is disabled or deleted.
    403 InvalidSystemDiskCategory.ValueUnauthorized The disk category is not authorized. You are not authorized to use the specified disk category.
    403 InvalidSnapshotId.NotReady The specified snapshot has not completed yet.
    403 InstanceDiskCategoryLimitExceed The total size of specified disk category in an instance exceeds. The total size of disks of the specified category exceeds the maximum capacity allowed for an instance.
    403 InvalidDevice.InUse The specified device has been occupied.
    403 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 includeing exact the same product code has been removed. The specified Alibaba Cloud Marketplace image is unavailable, or the specified custom image contains the product code of the Alibaba Cloud Marketplace image from which the custom image is derived and the Alibaba Cloud Marketplace image was removed from Alibaba Cloud Marketplace.
    403 CategoryNotSupported The specified zone does not offer the specified disk category.
    403 OperationDenied.NoStock The requested resource is sold out in the specified zone; try other types of resources or other regions and zones. The requested resources are insufficient.
    403 QuotaExceed.PortableCloudDisk The quota of portable cloud disk exceeds.
    403 SecurityGroupInstanceLimitExceed The maximum number of instances in a security group is exceeded. The maximum number of instances in the security group has been reached.
    403 NodeControllerUnavailable The Node Controller is temporarily unavailable.
    403 RegionUnauthorized There is no authority to create instance in the specified region. You are not authorized to create instances in the specified region.
    403 InvalidSnapshotId.NotDataDiskSnapshot The specified snapshot is system disk snapshot.
    403 DeleteWithInstance.Conflict The specified disk is not a portable disk and cannot be set to DeleteWithInstance attribute.
    403 InstanceDiskNumLimitExceed The number of specified disk in an instance exceeds. The number of specified disks exceeds the upper limit for an instance.
    403 IoOptimized.NotSupported The specified image is not support IoOptimized Instance.
    403 ImageNotSupportInstanceType The specified image don't support the InstanceType instance. The specified image does not support the selected instance type.
    403 InvalidDiskSize.TooSmall Specified disk size is less than the size of snapshot.
    403 InvalidDiskCategory.Mismatch The specified disk categories combination is not supported.
    403 QuotaExceed.BuyImage The specified image is from the image market, You have not bought it or your quota has been exceeded. The specified image is from Alibaba Cloud Marketplace.
    403 InvalidVSwitchId.NotFound The VSwitchId provided does not exist in our records. The specified vSwitch ID does not exist.
    403 InvalidParameter.ResourceOwnerAccount ResourceOwnerAccount is Invalid. The specified ResourceOwnerAccount parameter is invalid.
    403 InvalidUserData.Forbidden User not authorized to input the parameter "UserData", please apply for permission "UserData".
    403 Zone.NotOpen The specified zone is not granted to you to buy resources yet.
    403 Zone.NotOnSale The specified zone is not available for purchase. The requested resources are unavailable in the specified zone. Try a different instance type or select a different region or zone.
    403 InvalidClusterId.NotFound The specified clusterId does not exist. The specified ClusterId parameter does not exist.
    403 InvalidResourceType.NotSupported %s The specified resource combination does not exist. Change to another zone or specification.
    403 InvalidInstanceType.ValueNotSupported The specified InstanceType does not exist or beyond the permitted range.
    403 InvalidInstanceType.ZoneNotSupported The specified zone does not support this instancetype. The specified instance type is not supported in the specified zone.
    403 InvalidPayMethod The specified pay method is not valid.
    403 OperationDenied.ImageNotValid The specified Image is disabled or is deleted.
    403 InvalidUserData.Base64FormatInvalid The specified UserData is not valid.
    403 InstanceType.Offline %s The operation is not supported while the instance type is retired or while resources of the instance type are insufficient.
    403 DependencyViolation.WindowsInstance The instance creating is window, cannot use ssh key pair to login. The specified instance is a Windows instance and does not support logons using SSH key pairs.
    403 RealNameAuthenticationError Your account has not passed the real-name authentication yet. You have not completed real-name verification. Complete real-name verification and try again.
    403 InvalidNetworkType.MismatchRamRole Ram role cannot be applied to instances of Classic network type. Instance RAM roles can be used only for instances of the VPC type, not for instances of the classic network type.
    403 InvalidUser.PassRoleForbidden The RAM user does not have the privilege to pass a RAM role. The RAM user is not authorized to pass a RAM role.
    403 InvalidImage.NotSupported The specified image does not support vSGX instance. The specified virtual TPM instance requires a UEFI image.
    403 InvalidAccountStatus.NotEnoughBalance Your account does not have enough balance.
    403 IncorrectVpcStatus Current VPC status does not support this operation.
    403 InvalidParameter.NotMatch %s A specified parameter is invalid. Check whether parameter conflicts exist.
    403 OperationDenied.InvalidNetworkType %s The network type does not support this operation.
    403 InvalidSpotInterruptionBehavior.ClassicNetworkNotSupport The specified SpotInterruptionBehavior does not support Classic network Instance. This operation does not support instances of the classic network type.
    403 InvalidSpotInterruptionBehavior.LocalDiskNotSupport The specified SpotInterruptionBehavior does not support local disk instance. This operation does not support instances with local disks.
    403 QuotaExceed.PostPaidDisk Living postPaid disks quota exceeded. The number of pay-as-you-go disks has exceeded the allowed quota.
    403 QuotaExceed.DeploymentSetInstanceQuotaFull Instance quota in one deployment set exceeded.
    403 InvalidVSwitch.DefaultVSwitchNotSupport The specified zone in vpc can't support create default vSwitch.
    403 OperationDenied.LocalDiskUnsupported The configuration change is not allowed when the specified instance has local disks mounted. Instance types cannot be changed for instances that have local disks attached.
    403 OperationDenied.InconsistentNetwork The specified security group and vswitch are not in the same vpc. The specified security group and vSwitch do not belong to the same VPC.
    403 DefaultVswitch.Existed The default vswitch for VPC already exists. A default vSwitch already exists in the current VPC.
    403 InvalidChargeType.ValueNotSupported Deletion protection is only valid for postPaid instance, not for prePaid or spot instance. Release protection can be enabled only for pay-as-you-go instances.
    403 IncorrectInstanceStatus The current status of the resource does not support this operation.
    403 CategoryViolation The specified instance does not support this operation because of its disk category.
    403 ResourcesNotInSameZone The specified instance and dedicated host are not in the same zone. The specified disk and instance are not in the same zone.
    403 InvalidRegion.NotSupport The specified region does not support byok. The bring your own key (BYOK) feature is not supported in the region.
    403 UserNotInTheWhiteList The user is not in byok white list. You are not authorized to use the bring your own key (BYOK) feature. Try again when you are authorized.
    403 InvalidParameter.KMSKeyId.KMSUnauthorized The ECS service is not authorized to access your KMS key. Please grant the ECS service permission to use the key and try again.
    403 SecurityRisk.3DVerification We have detected a security risk with your default credit or debit card. Please proceed with verification via the link in your email. A security risk has been detected on your default credit or debit card. Verify your identity by using the link in the email.
    403 InvalidDisk.SystemDiskSize The specified SystemDiskSize beyond the permitted range. The specified system disk size exceeds the maximum allowed value.
    403 InsufficientBalance Your account does not have enough balance.
    403 Mayi.InternalError The request processing has failed due to an internal error and you may retry later or contact support with the request ID.
    403 InvalidNetworkType The network type is not support in this region. The network type NetworkType entered is no longer supported.
    403 InvalidAccountStatus Your account status is invalid, please contact customer service.
    403 QuotaExceeded.PrivateIpAddress %s The internal IP address of the specified switch VSwitch is insufficient.
    403 InvalidVSwitchId.IpInvalid %s The specified private IP address is invalid.
    403 OperationDenied.PerformanceLevelNotMatch The specified DataDisk.n.PerformanceLevel and DataDisk.n.Size do not match.
    403 InvalidStorageSetName.Malformed Specified parameter StorageSetName is not valid.
    403 InvalidDescription.Malformed Specified parameter Description is not valid.
    403 InvalidMaxPartitionNumber.Malformed Specified parameter MaxPartitionNumber is not valid.
    403 InvalidParameter.StorageSetPartitionNumber Specified parameter StorageSetPartitionNumber is not valid.
    403 InvalidParameter.StorageSetId Specified parameter StorageSetId is not valid.
    403 InvalidParameter.StorageSetZoneId Specified parameter StorageSetZoneId is not valid.
    403 QuotaExceed.Tags %s The number of specified tags exceeds the upper limit. %s is a variable. An error message is dynamically returned based on call conditions.
    403 OperationDenied.RegionIdNotSupported Region not support spot duration instance.
    403 OperationDenied.FlavorNotSupported Flavor not support spot duration instance.
    403 OperationDenied.TimestampNotSupported Timestamp not support spot duration instance.
    403 OperationDenied.PrepayNotAvailable Prepay instance is not available now.
    403 OperationDenied.PaygNotAvailable Pay-as-you-go instance is not available now.
    403 EnterpriseGroupLimited.MutliGroupType The specified instance can not join multi SecurityGroup types. The specified instance cannot belong to both a basic and an advanced security group. You can call the DescribeSecurityGroups operation to query the type of security groups.
    403 EnterpriseGroupLimited.InstanceType The specified instance type does not support Enterprise SecurityGroup.
    403 InternalError.AllocateUnderlayIp Allocate underlay ip for the instance error. Failed to assign the Underlay IP address to the instance.
    403 OperationDenied.BidOwnResource Bid user can not own resource.
    403 OperationDenied.CloudSSDNotSupported The specified available zone does not offer the cloud_ssd disk, use cloud_essd instead. The specified zone does not support cloud_ssd disks. Use cloud_essd disks and try again.
    403 InvalidVPCStatus.NotWorking The specified VPC subnet status is not working.
    403 QuotaExceed.ElasticQuota No additional quota is available for the specified ECS instance type. The maximum number of instances of the specified instance type in the region has been reached. Reduce the quantity of instances that you want to purchase or try another region or instance type. Alternatively, you can go to the ECS console or Quota Center to request a quota increase.
    403 QuotaExceeded.PostpaidDataDiskCapacity The quota of postpaid data disk capacity exceeds. The used capacity of the pay-as-you-go disk reaches the quota limit.
    403 InvalidImageFamily.MissingAvailableImage There is no available image related to the specified image family.
    403 InvalidRegionId.NotSupportEncryptAlgorithm The current region does not support creating encrypted disks with EncryptAlgorithm.
    403 InvalidOperation.ResourceManagedByCloudProduct %s You cannot modify security groups managed by cloud services.
    403 Forbidden.OnlySupportEnterpriseGroup %s
    403 HibernationConfigured.InstanceOperationForbidden The operation is not permitted due to limit of the hibernation configured instance. The operation cannot be performed due to the limitations of instances for which the instance hibernation feature is enabled.
    403 InstanceDiskLimitExceeded The amount of the disk on instance reach its limits. The specified instance has reached the maximum number of disks that can be attached.
    403 InvalidInstanceType.NotSupportDiskCategory The instanceType of the specified instance does not support this disk category. The instance type does not support the current disk category. Try another instance type. For information about the disk categories supported by instance types, see the instance family documentation.
    403 NotSupportSnapshotEncrypted.DiskCategory The specified disk category does not support re-encrypting a disk with a new KMSKeyId from a snapshot. Please use a disk category that supports encryption such as cloud_essd.
    403 InvalidOperation.PublicIpAddressNoStock The public IP address for the specified Region or ChargeType of the instance is out of stock. Please try another Region or ChargeType. Under the conditions of the specified region or payment type, the public IP address inventory of the instance is insufficient. Please try another region or payment type.
    403 InvalidParameter.KMSKeyId.CMKNotEnabled The specified KMS key must be in an enabled state. Please enable the key in the KMS console and try again.
    403 InvalidParameter.KMSKeyId.CMKUnauthorized The specified KMS key is not authorized for the ECS service. Please grant the ECS service permission to use the key in the KMS console and try again.
    403 InvalidEncrypted.NotMatchDiskDefaultEncryption The operation failed because default disk encryption is enforced on your account. Please set the Encrypted parameter to true.
    403 InvalidEncrypted.NotMatchSnapshot The Encrypted parameter must be set to true when creating disks from encrypted snapshots. Please set Encrypted to true or use an unencrypted snapshot.
    403 OperationDenied.KMSKeyUnauthorized The operation is denied due to missing KMS key authorization. Please check the KMS key permissions and ensure the key is properly authorized for this operation.
    404 InvalidStorageClusterId.NotExist The specified StorageClusterId does not exist in current region. The specified storage cluster ID does not exist in the current region.
    404 InvalidRegionId.NotFound The RegionId provided does not exist in our records. Region information error
    404 IoOptimized.NotSupported The specified instancetype is not support IoOptimized instance.
    404 InvalidZoneId.NotFound The ZoneId provided does not exist in our records.
    404 InvalidSecurityGroupId.NotFound The specified SecurityGroupId does not exist. The specified security group does not exist in this account. Check whether the security group ID is correct.
    404 InvalidDataDiskSnapshotId.NotFound The specified parameter "DataDisk.n.SnapshotId" is not valid.
    404 InvalidClusterId.NotFound The ClusterId provided does not exist in our records.
    404 OperationDenied The specified Image is disabled or is deleted.
    404 InvalidVSwitchId.NotFound Specified virtual switch does not exist. The specified vSwitch ID does not exist.
    404 InvalidImageId.NotFound The specified ImageId does not exist. The specified image does not exist in this account. Check whether the image ID is correct.
    404 InvalidInstanceChargeType.NotFound The InstanceChargeType does not exist in our records.
    404 DependencyViolation.IoOptimized The specified instancetype must be IoOptimized instance.
    404 PaymentMethodNotFound No payment method has been registered on the account.
    404 HOSTNAME_ILLEGAL The specified parameter Hostname is not valid.
    404 InvalidSystemDiskSize.LessThanImageSize The specified parameter SystemDisk.Size is less than the image size.
    404 InvalidSystemDiskSize.LessThanMinSize The specified parameter SystemDisk.Size is less than the min size.
    404 InvalidSystemDiskSize.MoreThanMaxSize The specified SystemDisk.Size parameter exceeds the maximum size.
    404 InvalidParameter The specified vm bandwidth is not valid.
    404 InvalidSystemDiskSize The specified parameter SystemDisk.Size is invalid. The specified SystemDisk.Size parameter is invalid.
    404 InvalidKeyPairName.NotFound The specified parameter KeyPairName does not exist in our records.
    404 InvalidRamRole.NotFound The specified RAMRoleName does not exist. The specified RamRoleName parameter does not exist.
    404 InvalidResourceGroup.NotFound The ResourceGroup provided does not exist in our records. The specified resource group does not exist.
    404 InvalidMarketImage.NotFound The specified marketplace image does not exist, please change the imageId and try again. The specified Alibaba Cloud Marketplace image does not exist. Modify the ImageId parameter and try again.
    404 DeploymentSet.NotFound The specified deployment set does not exist. The specified deployment set does not exist.
    404 InvalidInstanceType.ValueNotSupported The specified InstanceType does not exist or beyond the permitted range.
    404 InvalidParameter.KMSKeyId.NotFound The specified KMSKeyId does not exist. Please verify that the key ID is correct and that the key resides in the current region.
    404 InvalidDiskIds.NotPortable The specified DiskId is not portable.
    429 Throttling.Resource The request throttle by resource operation. Request is controlled by resource operation.
    409 OperationConflict Request was denied due to conflict with a previous request,please try again later. A request conflict occurred. Wait a moment and try again, or submit a ticket.

    See Error Codes for a complete list.

    Release notes

    See Release Notes for a complete list.