All Products
Search

This Product

    Elastic Compute Service:CreateInstance

    Document Center

    Elastic Compute Service:CreateInstance

    Last Updated:Oct 22, 2026

    Creates a subscription or pay-as-you-go Elastic Compute Service (ECS) instance.

    Operation description

    Note

    This API operation is no longer updated. Use the RunInstances operation instead.

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

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

    Before you begin

    • Creating instances incurs fees. Make sure that you understand the billing methods of Elastic Compute Service (ECS). For more information, see Billing overview.

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

    • Before creating a VPC-type 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) upon successful instance creation.

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

    • If the instance memory is 512 MiB, you cannot use Windows Server images except for the Semi-Annual Channel images. If the instance memory is 4 GiB or larger, you cannot use 32-bit operating system images.

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

    Note

    In a single region, the sum of peak Internet bandwidths billed by fixed bandwidth for a single Alibaba Cloud account is limited. For more information, see Internet bandwidth limits.

    Usage recommendations

    • Instance type selection: See Instance families or call the DescribeInstanceTypes operation to view the performance data of the target instance type. Alternatively, see Instance type selection to learn how to select an instance type.

    • Inventory query: Call the DescribeAvailableResource operation to check the resource availability in a specified region or zone.

    • Custom data: If the instance meets the limits for using instance user data, you can pass in user data. When you send an API request, the UserData parameter is not encrypted. Do not pass in confidential information such as passwords and private keys in plaintext. If you must pass in such information, encrypt the information, encode it in Base64, and then pass it in. Decrypt the information inside the instance before use.

    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 details page in Alibaba Cloud Marketplace. This parameter is required unless you specify ImageFamily to use the latest available image in the 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 use the latest available image in the image family to create the instance.

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

    • If ImageId is not specified, you can specify 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 and digits. It can also contain colons (:), underscores (_), periods (.), and 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: pay-by-traffic. This is the default value.

    Note

    In pay-by-traffic mode, the peak inbound and outbound bandwidths are upper limits and are not guaranteed. When resource contention occurs, the peak bandwidths may be limited. If your business requires guaranteed bandwidth, use the 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: disables auto-renewal. This is the default value.

    true
    AutoRenewPeriod

    integer

    No

    The auto-renewal duration. This parameter is required when AutoRenew is set to true.

    When 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:

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

    • When the purchased outbound 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 instance.

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

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

    • For other instances such as Linux instances: The hostname must be 2 to 64 characters in length and can contain multiple periods (.). The string between two consecutive periods is a segment, which 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 contain at least three of the following character types: uppercase letters, lowercase letters, digits, and special characters. The following special characters are supported:

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

    Note:

    • If you specify the Password parameter, send requests over HTTPS to prevent password leaks.

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

    • Instances running certain operating systems do not support password configuration and only support key pair configuration, such as Others Linux and Fedora CoreOS.

    TestEcs123!
    PasswordInherit

    boolean

    No

    Specifies whether to use the preset password of the image. When you use this parameter, leave the Password parameter empty and make sure that the selected image has a preset password.

    false
    DeploymentSetId

    string

    No

    The ID of the deployment set.

    ds-bp1brhwhoqinyjd6****
    DeploymentSetGroupNo

    integer

    No

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

    1
    ZoneId

    string

    No

    The zone ID of the instance. For more information, see DescribeZones to obtain the zone list.

    Note

    If you specify the VSwitchId parameter, the ZoneId parameter must match the zone of the vSwitch. You can also leave the ZoneId parameter 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 to which the instance belongs.

    Note

    This parameter is about to 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 value, but you must make sure that the value is unique among different requests. The ClientToken value can contain only ASCII characters and cannot exceed 64 characters in length. For more information, see 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 cloud disk. Unit: GiB. Valid values:

    • Basic cloud disk: 20 to 500.

    • Other cloud 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 cloud disk. Valid values:

    • cloud_efficiency: ultra cloud disk.

    • cloud_ssd: standard SSD.

    • cloud_essd: ESSD.

    • cloud: basic cloud disk.

    • cloud_auto: ESSD AutoPL.

    • cloud_essd_entry: ESSD Entry disk.

    Note

    This parameter supports the cloud_essd_entry value only when the InstanceType Settings are general computing power instance family u1 (ecs.u1) or Economy instance family e (ecs.e).

    For phased-out 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 cloud disk. The name must be 2 to 128 characters in length and can contain letters and digits. It can also contain colons (:), underscores (_), periods (.), and hyphens (-).

    Default value: empty.

    SystemDiskName
    SystemDisk.Description

    string

    No

    The description of the system cloud 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

    Settings of the performance level of the ESSD used as the system cloud disk. Valid values:

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

    • PL1: A single ESSD can deliver up to 50,000 random read/write IOPS. This is the default value.

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

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

    For more information about how to select the performance level of an ESSD, see standard SSD.

    PL1
    NodeControllerId

    string

    No

    Note

    This parameter is in invitational preview and is not supported.

    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 when you create a VPC-type instance. You can call the DescribeVSwitches operation to query the information of created vSwitches.

    Note

    If you specify the VSwitchId parameter, the ZoneId parameter must match the zone of the vSwitch. You can also leave the ZoneId parameter 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 IP address within the CIDR block of the vSwitch specified by VSwitchId.

    172.16.236.*
    IoOptimized

    string

    No

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

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

    • optimized: The instance is I/O optimized.

    For phased-out instance types, the default value is none.

    For other instance types, the default value is optimized.

    optimized
    UseAdditionalService

    boolean

    No

    Specifies whether to use the virtual machine system configurations 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 select this billing method, make sure that your account supports balance payment or credit payment. Otherwise, an InvalidPayMethod error is returned.

    • PostPaid: pay-as-you-go. This is the default value.

    PrePaid
    Period

    integer

    No

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

    When PeriodUnit is set to Month, valid values of Period are 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

    Instance user data of the instance. Instance user data must be encoded in Base64. The maximum size of the raw data is 32 KB.

    ZWNobyBoZWxsbyBlY3Mh
    SpotStrategy

    string

    No

    The preemption policy for spot instance. This parameter takes effect when InstanceChargeType is set to PostPaid. Valid values:

    • NoSpot: Spot instance is a regular pay-as-you-go instance. This is the default value.

    • SpotWithPriceLimit: Spot instance is a preemptible instance with a maximum hourly price.

    • SpotAsPriceGo: Spot instance is a preemptible instance for which the market price is automatically used as the bid price.

    NoSpot
    KeyPairName

    string

    No

    The name of the key pair.

    Note

    For Windows instances, this parameter is ignored. Default value: empty. Even if you specify this parameter, only the Password parameter takes effect.

    KeyPairTestName
    SpotPriceLimit

    number

    No

    The maximum hourly price of the instance. The value can be accurate to three decimal places. This parameter takes effect when SpotStrategy is set to SpotWithPriceLimit.

    0.98
    SpotDuration

    integer

    No

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

    • 1: Alibaba Cloud guarantees that spot instance will not undergo automatic release within 1 hour after it is created. After 1 hour, the system automatically compares the bid price with the marketplace price and checks resource inventory to determine whether to retain or revoke spot instance.

    • 0: Alibaba Cloud does not guarantee that spot instance runs for 1 hour after it is created. The system automatically compares the bid price with the marketplace price and checks resource inventory to determine whether to retain or revoke spot instance.

    Note

    • The Settings of this parameter can only be 0 or 1.

    • Spot instances are billed by the second. Select an appropriate protection period based on the execution duration of your node.

    • Alibaba Cloud sends you a notification through ECS system events 5 minutes before spot instance is revoked.

    1
    SpotInterruptionBehavior

    string

    No

    The interruption behavior of the preemptible instance. Valid values:

    Default value: Terminate.

    Terminate
    RamRoleName

    string

    No

    The name of the instance RAM role. You can use the RAM API operation 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 on the request. Valid values:

    • true: performs a dry run and does not create the instance. The system checks whether required parameters are specified, the request format, service limits, and ECS inventory. If the check fails, the corresponding error is returned. If the check succeeds, the DryRunOperation error code is returned.

    • false: performs a dry run and creates the instance if the check succeeds. This is the default value.

    false
    DedicatedHostId

    string

    No

    The ID of the dedicated host.

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

    Important Dedicated hosts do not support spot instance. If you specify the DedicatedHostId parameter, 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. It specifies whether the instance can be released through the console or by calling the DeleteInstance operation.

    • true: enables release protection for the instance.

    • false: disables release protection for the instance. This is the default value.

    Note

    This attribute applies only to pay-as-you-go instances and restricts only manual release operations. It does not take effect on system release operations.

    false
    HibernationOptions.Configured

    boolean

    No

    Note

    This parameter is in invitational preview and is not supported.

    false
    Affinity

    string

    No

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

    • default: The instance is not associated with the dedicated host. If an instance in the economical mode is stopped and then started, and the original dedicated host has insufficient resources, the instance is deployed on another dedicated host in the automatic deployment resource pool.

    • host: The instance is associated with the dedicated host. If an instance in the economical mode is stopped and then started, it is still deployed on the original dedicated host. If the original dedicated host has insufficient resources, the instance fails to start.

    Default value: default.

    default
    Tenancy

    string

    No

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

    • default: The instance is created on a non-dedicated host.

    • host: The instance is created on a dedicated host. If you do not specify DedicatedHostId, Alibaba Cloud automatically selects a dedicated host to deploy 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 more information about instance metadata, see Overview of instance metadata.

    enabled
    HttpTokens

    string

    No

    Specifies whether to forcibly use the security hardening mode (IMDSv2) to access instance metadata. Valid values:

    • optional: does not forcibly use IMDSv2.

    • required: forcibly uses IMDSv2. After you set this value, you cannot access instance metadata in normal mode.

    Default value: optional.

    Note

    For more information about the modes for accessing instance metadata, see Access modes of instance metadata.

    optional
    HttpPutResponseHopLimit

    integer

    No

    Note

    This parameter is not available.

    0
    PrivatePoolOptions.MatchCriteria

    string

    No

    The private pool options for starting spot instance. After an elasticity assurance or a capacity reservation takes effect, a private pool is generated for you to select when you start spot instance. Valid values:

    • Open: open mode. The system automatically matches an open private pool. If no matching private pool is available, the system uses resources from the public pool to start spot instance. In this mode, you do not need to specify the PrivatePoolOptions.Id parameter.

    • Target: specified mode. The system uses the specified private pool to start spot instance. If the specified private pool is unavailable, spot instance fails to start. In this mode, you must specify the private pool ID, which means the PrivatePoolOptions.Id parameter is required.

    • None: no private pool. Spot instance is started without using private pool capacity.

    Default value: None.

    In any of the following scenarios, the private pool option for starting spot instance can only be set to None or left empty:

    • Create a preemptible instance.

    • Create an ECS instance on a dedicated host.

    Open
    PrivatePoolOptions.Id

    string

    No

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

    eap-bp67acfmxazb4****
    DataDisk

    array<object>

    No

    The data cloud disks.

    object

    No

    Category

    string

    No

    The category of data cloud disk N. Valid values:

    • cloud_efficiency: ultra cloud disk.

    • cloud_ssd: standard SSD.

    • cloud_essd: ESSD.

    • cloud: basic cloud disk.

    • cloud_auto: ESSD AutoPL.

    • cloud_essd_entry: ESSD Entry.
      Note

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

    • elastic_ephemeral_disk_standard: standard ESSD Entry disk.

    • elastic_ephemeral_disk_premium: premium ESSD Entry disk.

    For I/O optimized instances, the default value is cloud_efficiency. For non-I/O optimized instances, the default value is cloud.

    cloud_ssd
    DeleteWithInstance

    boolean

    No

    Specifies whether to release data cloud disk N when the instance is released.

    • true: releases the data cloud disk.

    • false: does not release the data cloud disk.

    Default value: true.

    true
    Description

    string

    No

    The description of data cloud disk N. 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 data cloud disk N.

    Note

    This parameter is applicable only to full images. You can set this parameter to the mount point of the data cloud disk in the full image, and modify the DataDisk.N.Size and DataDisk.N.Category parameters to change the category and size of the data cloud disk in the full image.

    /dev/xvdb
    DiskName

    string

    No

    The name of data cloud disk N. The name must be 2 to 128 characters in length and can contain letters and digits. It can also contain colons (:), underscores (_), periods (.), and hyphens (-).

    DataDiskName
    EncryptAlgorithm

    string

    No

    Note

    This parameter is not available.

    null
    Encrypted

    boolean

    No

    Specifies whether to encrypt data cloud disk N.

    • true: encrypts the data cloud disk.

    • false: does not encrypt the data cloud disk.

    Default value: false.

    false
    KMSKeyId

    string

    No

    The ID of the KMS key used by the cloud disk.

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

    string

    No

    Settings of the performance level of the ESSD used as data cloud disk N. The value of N must be the same as the value of N in DataDisk.N.Category=cloud_essd. Valid values:

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

    • PL1: A single ESSD can deliver up to 50,000 random read/write IOPS. This is the default value.

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

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

    For more information about how to select the performance level of an ESSD, see standard SSD.

    PL2
    Size

    integer

    No

    The size of data cloud 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 values depend on the value of DataDisk.N.PerformanceLevel.

      • PL0: 1 to 65,536.

      • PL1: 20 to 65,536.

      • PL2: 461 to 65,536.

      • PL3: 1261 to 65,536.

    • cloud: 5 to 2000.

    Note

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

    2000
    SnapshotId

    string

    No

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

    • If you specify the DataDisk.N.SnapshotId parameter, the DataDisk.N.Size parameter is ignored, and the actual size of the created cloud disk is the size of the specified snapshot.

    • You cannot use snapshots created on or before July 15, 2013. Otherwise, the request is rejected with an error.

    s-bp17441ohwka0yuh****
    StorageClusterId

    string

    No

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

    dbsc-j5e1sf2vaf5he8m2****
    Arn

    array<object>

    No

    Note

    This parameter is in invitational preview and is not supported.

    object

    No

    AssumeRoleFor

    integer

    No

    Note

    This parameter is in invitational preview and is not supported.

    1234567890
    RoleType

    string

    No

    Note

    This parameter is in invitational preview and is not supported.

    Primary
    Rolearn

    string

    No

    Note

    This parameter is in invitational preview and is not supported.

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

    array<object>

    No

    The list of tags.

    object

    No

    The list of tags.

    Key

    string

    No

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

    TestKey
    Value

    string

    No

    The tag value of the instance, cloud disk, and primary ENI. Valid values of N: 1 to 20. If this parameter is specified, it 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 the Tag.N.Key parameter.

    Test
    value

    string

    No

    The tag value.

    Note

    For better compatibility, use the Tag.N.Value parameter.

    Test
    SystemDisk

    object

    No

    The system cloud disk parameters. Currently, you must use this parameter to specify the dedicated block storage cluster ID (StorageClusterId).

    StorageClusterId

    string

    No

    The dedicated block storage cluster ID. If you need to use a cloud disk in a dedicated block storage cluster as the system cloud disk when creating an ECS instance, specify this parameter.

    dbsc-j5e1sf2vaf5he8m2****
    ManagedHostId

    string

    No

    The unique identifier 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 InstanceChargeType request parameter is set to 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 is beyond the permitted range or the snapshot capacity exceeds the limit of the specified disk category. Please call DescribeAvailableResource to query supported disk size ranges and try again.
    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 parameter HostName 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 image does not support cloud-init.
    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 is beyond the permitted range or the snapshot capacity exceeds the limit of the specified disk category. Please call DescribeAvailableResource to query supported disk size ranges and try again.
    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 You are 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 sotPriceLimit 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 specified dedicated host does not support the specified instance charge type.
    400 InvalidNetworkType.NotSupported The classic networkType not support create ECS on dedicatedHost. Dedicated hosts do not support instances of 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 state 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. Subscription instances cannot be added to pay-as-you-go dedicated hosts.
    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 hosts are 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 parameter Tag.N.Key contains duplicate values. Please remove the duplicate tag keys and try again.
    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. When you create encrypted disks based on a shared image, only the encryption key provided by the shared image can be used for these disks and you cannot specify encryption keys for the disks.
    400 QuotaExceed.DiskCapacity The disk capacity quota of the specified disk category has been exceeded in the current zone. Please reduce the requested disk capacity or select another zone and try again. You can also view the disk capacity quota and apply for an increase in Quota Center.
    400 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.
    400 InvalidDiskCategory.NotSupported The specified disk category is not supported. Please call DescribeAvailableResource to view supported disk categories and try again.
    400 InvalidDestinationZone.DeploymentSetMismatch Error happened, %s. If the instance is added to a LowLatency deployment set that already contains instances, the instance must reside 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 does not support the specified instance type. Please call DescribeAvailableResource to query the supported disk category and try again.
    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 creation of the specified snapshot is still in progress. Please wait for it to complete and try again.
    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 category combination is not supported. Please call DescribeAvailableResource to view supported disk categories and try again.
    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 an Alibaba Cloud Marketplace image.
    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 is not supported for instances of the classic network type.
    403 InvalidSpotInterruptionBehavior.LocalDiskNotSupport The specified SpotInterruptionBehavior does not support local disk instance. This operation is not supported for instances with local disks.
    403 QuotaExceed.PostPaidDisk The quota for pay-as-you-go data disks has been exceeded. Please reduce the number of disks or request a quota increase.
    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 customer master keys. Please choose another region or use a default KMS key and try again.
    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 is detected with your default credit or debit card. Verify it by clicking 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 zone does not offer the cloud_ssd disk category. Please use cloud_essd or another supported disk category 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 parameter EncryptAlgorithm is not supported. Please remove EncryptAlgorithm and try again.
    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 specified InstanceType does not support the specified disk category. Please call DescribeAvailableResource to query the supported disk category and try again.
    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.