All Products
Search

This Product

    Elastic Compute Service:CreateInstance

    Document Center

    Elastic Compute Service:CreateInstance

    Last Updated:Jun 29, 2026

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

    Operation description

    Note

    This operation is no longer maintained. Use RunInstances instead.

    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 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 billable methods of Elastic Computing Service (ECS). For more information, see 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, see Quota Center.

    • Before creating a VPC-connected instance, create a VPC in the corresponding region. For more information, see Create a VPC.

    Before you begin

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

    • If the billable methods of the instance is subscription (PrePaid), active coupon in your account 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, invoke AllocatePublicIpAddress to assign a public IP address. If the public bandwidth is 0, invoke ModifyInstanceNetworkSpec to adjust the bandwidth and then invoke AllocatePublicIpAddress to assign a public IP 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, see Public bandwidth limits.

    Recommendations

    • Instance type selection: See Instance family or invoke DescribeInstanceTypes to query the performance data of the target instance type. You can also see Settings 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 use Base64 encoding before passing it in. Then perform decryption 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. If you do not use ImageFamily to select the latest available image from an image family, this parameter is required.

    ubuntu_18_04_64_20G_alibase_20190624.vhd
    ImageFamily

    string

    No

    The name of the image family. 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 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, in Mbit/s. Valid values:

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

    • If 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, in Mbit/s. Valid values: 0 to 100.

    Default value: 0.

    5
    HostName

    string

    No

    The hostname of the 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 (-).

    • Other instances (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 purposes, 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. When you use this parameter, the Password parameter must be empty. 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 group number of the instance in the deployment set. This parameter takes effect only 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, 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 cluster ID of 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, 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 disk, in 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 the u1, universal instance family (ecs.u1) or the e, economy instance family (ecs.e). Settings of this parameter determine the computing power and optimization level of the system disk.

    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 (PL) of the enterprise SSD used as the system disk. Settings of this parameter apply only when the disk category is not standard SSD. 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, see 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 vSwitch ID. This parameter is required when you create a VPC-connected instance. You can call DescribeVSwitches to query available vSwitches.

    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: not I/O optimized.

    • optimized: 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 duration of the instance. 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 value of this parameter cannot exceed the subscription duration of the dedicated host. Valid values:

    If 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 duration. Valid values:

    Month.

    Default value: Month.

    Month
    UserData

    string

    No

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

    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 key pair.

    Note

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

    KeyPairTestName
    SpotPriceLimit

    number

    No

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

    0.98
    SpotDuration

    integer

    No

    The protection period of the spot instance, in 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 supports only the value 0 or 1.

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

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

    1
    SpotInterruptionBehavior

    string

    No

    The break mode 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 service limits are met, and whether the specified 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. It can only prevent manual release, not system-initiated release.

    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 is associated with a dedicated host. Valid values:

    • default: The instance is not associated with a dedicated host. When an instance that has economical mode enabled is restarted after it is stopped, the instance is deployed to 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 a 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: enabled.

    • disabled: disabled.

    Default value: enabled.

    Note

    For more information about instance metadata, see 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 more information about the modes for accessing instance metadata, see 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 when 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 using public pool resources. You do not need to set PrivatePoolOptions.Id.

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

    • None: does not use a private pool. The instance is launched without using any private pool.

    Default value: None.

    In any of 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 private pool ID, which is the ID of the elasticity assurance or capacity reservation.

    eap-bp67acfmxazb4****
    DataDisk

    array<object>

    No

    The list of data disks.

    object

    No

    PerformanceLevel

    string

    No

    The performance level (PL) of the enterprise SSD used as a data disk. Settings of this parameter apply only when the disk category is not standard SSD. 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, see ESSDs.

    PL2
    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
    SnapshotId

    string

    No

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

    • If 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 with such snapshots are rejected.

    s-bp17441ohwka0yuh****
    Size

    integer

    No

    The size of data disk N, in GiB. Valid values of N: 1 to 16. 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 SnapshotId.

    2000
    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 the data disk in the full image and modify the corresponding DataDisk.N.Size and DataDisk.N.Category parameters to change the disk 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
    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 the ecs.u1 or ecs.e instance family. Settings of this parameter determine the optimization level of the data disk.

    • elastic_ephemeral_disk_standard: elastic ephemeral disk - standard.

    • elastic_ephemeral_disk_premium: elastic ephemeral disk - Premium Edition.

    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
    KMSKeyId

    string

    No

    The KMS key ID used by the disk.

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

    string

    No

    Note

    This parameter is not publicly available.

    null
    Encrypted

    boolean

    No

    Specifies whether data disk N is encrypted.

    • true: encrypted.

    • false: not encrypted.

    Default value: false.

    false
    StorageClusterId

    string

    No

    The ID of the dedicated block storage cluster. To use a disk in a dedicated block storage cluster as a data disk 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

    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
    AssumeRoleFor

    integer

    No

    Note

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

    1234567890
    Tag

    array<object>

    No

    The list of tags.

    object

    No

    The list of tags.

    key

    string

    No

    The tag key.

    Note

    To improve compatibility, use Tag.N.Key instead.

    Test
    Key

    string

    No

    The tag key for 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 for 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
    value

    string

    No

    The tag value.

    Note

    To improve compatibility, use Tag.N.Value instead.

    Test
    SystemDisk

    object

    No

    The system disk parameters. The dedicated block storage cluster ID (StorageClusterId) must be set through this parameter.

    StorageClusterId

    string

    No

    The ID of the dedicated block storage cluster. To use a disk in a dedicated block storage cluster as the system disk when you create an ECS instance, set this parameter.

    dbsc-j5e1sf2vaf5he8m2****

    Response elements

    Element

    Type

    Description

    Example

    object

    RequestId

    string

    The request ID.

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

    string

    The instance ID.

    i-bp67acfmxazb4p****
    OrderId

    string

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

    1234567890
    TradePrice

    number

    The transaction price of the order.

    0.165

    Examples

    Success response

    JSON format

    {
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****",
  "InstanceId": "i-bp67acfmxazb4p****",
  "OrderId": "1234567890",
  "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.
    400 InvalidPassword.Malformed The specified parameter "Password" is not valid.
    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.
    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.
    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
    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.
    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
    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.
    400 InvalidDedicatedHostId.NotFound The specified DedicatedHostId does not exist.
    400 InvalidDedicatedHostStatus.NotSupport Operation denied due to dedicated host status.
    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.
    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.
    400 NoAvaliableDedicatedHost There's no enough resource on the specified dedicated host.
    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 must be IoOptimized instance when kmsKeyId is not empty. The specified instance must be an I/O optimized one when the KMSKeyId parameter is specified.
    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.
    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.
    400 AccountForbidden.ProductCreationLimited The commodity must be officially operated by Aliyun and in pay-as-you-go billing method.
    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 specified parameter Encrypted must be true when EncryptAlgorithm is not empty.
    400 InvalidEncrypted.NotMatchKmsKeyId The specified parameter Encrypted must be true when KmsKeyId is not empty.
    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 parameter EncryptAlgorithm is not valid.
    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 parameter KmsKeyId must be symmetric. The KMSKey used for encryption must be a symmetric encryption 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 Create kms data encrypted key fail. If you need further assistance, you can contact the KMS Technical Support.
    400 InvalidDiskCategory.NotSupported The specified disk category is not supported.
    400 InvalidDestinationZone.DeploymentSetMismatch Error happened, %s.
    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 Failed to perform this operation because KMS is not activated. You need to activate KMS key management service.
    400 InvalidParameter.Encrypted.KmsNotEnable Failed to perform this operation because KMS is not activated. You need to activate KMS key escrow service.
    400 InvalidParam.EncryptedMismatch Creating encrypted disks with shared encrypted image requires replacing encryption keys. You must change the encryption key to create a cloud disk after sharing an encrypted image.
    400 InvalidParameter.Encrypted Creating non-encrypted disks with encrypted snapshots is not supported. Creating a non-encrypted disk with an encrypted snapshot is not supported.
    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)
    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 some unknown error.
    500 InvalidImage.OSType The image OSType does not support this 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.
    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.
    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.
    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.
    403 InvalidSpotInterruptionBehavior.LocalDiskNotSupport The specified SpotInterruptionBehavior does not support local disk instance.
    403 QuotaExceed.PostPaidDisk Living postPaid disks quota exceeded.
    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.
    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.
    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 ECS service have no right to access your KMS. ECS is not authorized to access your KMS resources.
    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.
    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 some unknown error.
    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.
    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.
    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 creating encrypted system disks or creating encrypted data disks from snapshots. Check the DiskCategory or Encrypted parameter, or check your account for default encryption settings. This disk type does not support creating encrypted system disks or creating encrypted data disks in snapshot mode. Please check the disk type and encryption parameters you entered, or check whether you have configured the default encryption configuration for account cloud disks.
    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 CMK (Customer Master Key) must be in an active state. The CMK (Customer Master Key) must be in an active state.
    403 InvalidParameter.KMSKeyId.CMKUnauthorized The CMK(Customer Master Key) lacks authorization to add tags to the ECS service. The CMK(Customer Master Key) lacks authorization to add tags to the ECS service.
    403 InvalidEncrypted.NotMatchDiskDefaultEncryption Enabling disk default encryption prevents the creation of non-encrypted disks. After the default encryption of the cloud disk account is enabled, an unencrypted disk cannot be created.
    403 InvalidEncrypted.NotMatchSnapshot The specified parameter Encrypted must be set to true when creating disks with encrypted snapshots. When you create a disk using an encrypted snapshot, the specified parameter Encrypted must be set to true.
    404 InvalidStorageClusterId.NotExist The specified StorageClusterId does not exist in 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. The specified KMSKeyId parameter does not exist.
    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.

    See Error Codes for a complete list.

    Release notes

    See Release Notes for a complete list.