All Products
Search

This Product

    Elastic Compute Service:CreateInstance

    Document Center

    Elastic Compute Service:CreateInstance

    Last Updated:Apr 10, 2026

    This API creates a single Alibaba Cloud ECS instance using the subscription or pay-as-you-go billing method. You can configure various parameters to customize the instance to your requirements.

    Operation description

    Note

    This API is deprecated. We recommend that you use the RunInstances API.

    Before using this API, ensure you understand the billing methods and Pricing of ECS.

    This is an asynchronous operation. After you send a request, an instance ID is returned, but the instance is not created immediately. You can call DescribeInstanceStatus to query the instance status. When the instance status changes to Stopped, the instance is created. You can then call StartInstance to start the instance.

    Usage notes

    • Creating an instance incurs charges. Ensure you understand the billing methods of ECS. For more information, see Billing overview.

    • Ensure that your total number of instances and total number of vCPUs for all instance types do not exceed your quota. For more information, see Quota Center.

    • Before you create a VPC-type instance, you must create a VPC in the corresponding Alibaba Cloud region.

    Important

    • Calling this operation does not trigger system notifications, such as SMS messages, emails, or internal messages, upon successful instance creation.

    • If the billing method for the instance is subscription (PrePaid), the system automatically applies your available coupons during payment.

    • An instance with 512 MiB of memory cannot use Windows Server images, except for those from the semi-annual channel. An instance with 4 GiB or more of memory cannot use 32-bit operating system images.

    • This operation does not assign a public IP address to created instances. If the public bandwidth is greater than 0, you can call AllocatePublicIpAddress to assign one. If the public bandwidth is 0, you must first call ModifyInstanceNetworkSpec to adjust the bandwidth before calling AllocatePublicIpAddress.

    Note

    For a single Alibaba Cloud account, the total peak public bandwidth for all pay-by-bandwidth instances is limited on a per-region basis.

    Recommendations

    • Instance type selection: See Instance families or call DescribeInstanceTypes to view the performance data of specific instance types. For guidance on selecting an instance type, see Instance type selection.

    • Inventory check: Call DescribeAvailableResource to check resource availability in a specific region or zone.

    • User data: If an instance meets the requirements for using instance user data, you can pass in user data. When you send an API request, the UserData is not encrypted. Do not pass confidential information, such as passwords and private keys, in plaintext. If you must include such information, encrypt and then Base64-encode it. You must then decrypt the data within 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 ID of the region for the instance. You can call the DescribeRegions operation to get the latest list of regions.

    cn-hangzhou
    ImageId

    string

    No

    The ID of the image used to create the instance. To use a Marketplace image, find the ImageId on the image's details page in Alibaba Cloud Marketplace. This parameter is required if ImageFamily is not specified.

    ubuntu_18_04_64_20G_alibase_20190624.vhd
    ImageFamily

    string

    No

    The name of the image family. Use this parameter to create the instance from the latest available image in the specified family.

    • This parameter cannot be used with ImageId.

    hangzhou-daily-update
    InstanceType

    string

    Yes

    The instance type.

    ecs.g6.large
    SecurityGroupId

    string

    No

    The ID of the security group to assign to the instance.

    sg-bp15ed6xe1yxeycg****
    InstanceName

    string

    No

    The name of the instance. The name must be 2 to 128 characters long. It can contain Unicode characters in the Letter category (such as Chinese and English letters), digits, colons (:), underscores (_), periods (.), and hyphens (-). If this parameter is not specified, the instance ID is used as the name by default.

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

    string

    No

    The network billing method. Valid values:

    • PayByBandwidth: Pay-by-bandwidth.

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

    Note

    For pay-by-traffic billing, the peak bandwidth is an upper limit, not a guaranteed rate. During periods of high network contention, the actual bandwidth may be lower. If your business requires guaranteed bandwidth, use the pay-by-bandwidth billing method.

    PayByTraffic
    AutoRenew

    boolean

    No

    Specifies whether to enable auto-renewal for the instance. This parameter is valid only for subscription instances (where InstanceChargeType is PrePaid). Valid values:

    • true: Enables auto-renewal.

    • false (default): Disables auto-renewal.

    true
    AutoRenewPeriod

    integer

    No

    The auto-renewal period. This parameter is required if AutoRenew is set to true.

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

    2
    InternetMaxBandwidthIn

    integer

    No

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

    • If InternetMaxBandwidthOut is 10 Mbit/s or less, the range is 1 to 10. Default value: 10.

    • If InternetMaxBandwidthOut is greater than 10 Mbit/s, the valid range is 1 to the value of InternetMaxBandwidthOut. The default is 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 ECS instance.

    • A period (.) or a hyphen (-) cannot be used as the first or last character and cannot be used consecutively.

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

    • For other types of instances (such as Linux): The hostname must be 2 to 64 characters long. You can use periods (.) to separate the name into multiple segments. Each segment can contain letters, digits, and hyphens (-).

    LocalHostName
    Password

    string

    No

    The password of the instance. It must be 8 to 30 characters long and include characters from at least three of the following categories: uppercase letters, lowercase letters, digits, and special characters. The supported special characters are:

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

    Notes:

    • To prevent password exposure, send requests that include the Password parameter over HTTPS.

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

    • Password-based logon is not supported for some operating systems, such as Others Linux and Fedora CoreOS. For these instances, you must use a key pair.

    TestEcs123!
    PasswordInherit

    boolean

    No

    Specifies whether to use the password pre-configured in the image. If set to true, the Password parameter must be empty and the specified image must have a password configured.

    false
    DeploymentSetId

    string

    No

    The ID of the deployment set.

    ds-bp1brhwhoqinyjd6****
    DeploymentSetGroupNo

    integer

    No

    If the deployment set uses the high availability group strategy (AvailabilityGroup), you can use this parameter to specify the group number of the instance within the deployment set. Valid values: 1 to 7.

    1
    ZoneId

    string

    No

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

    Note

    If you specify the VSwitchId parameter, the specified ZoneId must be in the same zone as the VSwitch. If you do not specify the ZoneId parameter, the system automatically uses the zone of the specified VSwitch.

    If you do not specify this parameter, 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 being deprecated. For forward compatibility, we recommend using other parameters.

    c-bp67acfmxazb4p****
    ClientToken

    string

    No

    A client-generated token to ensure the idempotence of the request. The token must be unique across requests. ClientToken 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 ID of the VLAN.

    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–500

    • Other cloud disk categories: 20–2048

    The size must be at least 20 GiB and no smaller than the image size.

    Default value: The greater of 40 GiB or the image size.

    40
    SystemDisk.Category

    string

    No

    The category of the system disk. Valid values:

    • cloud_efficiency: Ultra Disk.

    • cloud_ssd: Standard SSD.

    • cloud_essd: Enhanced SSD (ESSD).

    • cloud: Basic Disk.

    • cloud_auto: ESSD AutoPL disk.

    • cloud_essd_entry: ESSD Entry disk.

    Note

    You can set this parameter to cloud_essd_entry only when InstanceType is set to an u1 (general-purpose) (ecs.u1) or e (economical) (ecs.e) instance type family.

    For retired instance types that are not I/O-optimized, 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 long. It can contain Unicode characters in the Letter category (such as Chinese and English letters), digits, colons (:), underscores (_), periods (.), and hyphens (-).

    Default value: empty.

    SystemDiskName
    SystemDisk.Description

    string

    No

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

    Default value: empty.

    TestDescription
    SystemDisk.PerformanceLevel

    string

    No

    The performance level of the ESSD when used as the system disk. Valid values:

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

    • PL1 (default): A single ESSD delivers up to 50,000 random read/write IOPS.

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

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

    For more 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 long 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 an instance in a VPC. You can call the DescribeVSwitches operation to query information about existing vSwitches.

    Note

    If you specify the VSwitchId parameter, the specified ZoneId must be in the same zone as the vSwitch. If you do not specify the ZoneId parameter, the system automatically uses 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 vSwitch specified by VSwitchId.

    172.16.236.*
    IoOptimized

    string

    No

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

    • none: non-I/O-optimized.

    • optimized: I/O-optimized.

    For retired 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 system configurations for virtual machines (VMs) that are 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. To use this billing method, your account must support payments by balance or credit. Otherwise, the system returns an InvalidPayMethod error.

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

    PrePaid
    Period

    integer

    No

    The subscription duration of the resource. The unit is specified by PeriodUnit. This parameter is required and valid only when InstanceChargeType is set to PrePaid. If you specify DedicatedHostId, the value cannot exceed the subscription duration of the dedicated host. Valid values:

    If PeriodUnit is set to Month, valid values for 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 user data for the instance, which must be Base64-encoded. The raw data before encoding can be up to 32 KB in size.

    ZWNobyBoZWxsbyBlY3Mh
    SpotStrategy

    string

    No

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

    • NoSpot (default): A regular pay-as-you-go instance.

    • SpotWithPriceLimit: A preemptible instance with a user-defined maximum price.

    • SpotAsPriceGo: The system automatically bids based on the current market price.

    NoSpot
    KeyPairName

    string

    No

    The name of the key pair.

    Note

    For Windows instances, this parameter is ignored and the password specified by Password is used instead.

    KeyPairTestName
    SpotPriceLimit

    number

    No

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

    0.98
    SpotDuration

    integer

    No

    The protection period of the preemptible instance, in hours. This period ensures that the instance is not preempted. After the period expires, the system may reclaim the instance based on the market price and resource availability. Valid values:

    • 1 (default): 1-hour protection period.

    • 0: No protection period.

    Note

    • This parameter can be set only to 0 or 1.

    • Preemptible instances are billed by the second. We recommend that you select a protection period based on the expected runtime of your task.

    • Alibaba Cloud notifies you of an impending instance release via an ECS system event 5 minutes in advance.

    1
    SpotInterruptionBehavior

    string

    No

    The action to take when the preemptible instance is interrupted. Valid values:

    • Terminate (default): Releases the instance.

    • Stop: Stops the instance, which then enters Economical Mode.

      For more information, see Economical Mode.

    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 setting applies only to system images.

    • Deactive: Disables security hardening. This setting applies to all image types.

    Active
    ResourceGroupId

    string

    No

    The ID of the 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 a dry run for this request. Valid values:

    • true: Performs a dry run to check the request without creating the instance. The system checks for required parameters, request format, business limits, and ECS inventory. If the check fails, an error is returned. If the check succeeds, the DryRunOperation error code is returned.

    • false (default): Sends a normal request and creates the instance if the check succeeds.

    false
    DedicatedHostId

    string

    No

    The ID of the dedicated host.

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

    Important You cannot create preemptible instances on dedicated hosts. If you specify the DedicatedHostId parameter, the SpotStrategy and SpotPriceLimit parameters are ignored.

    dh-bp67acfmxazb4p****
    CreditSpecification

    string

    No

    The performance mode of the burstable performance instance. Valid values:

    Standard
    DeletionProtection

    boolean

    No

    Specifies whether to enable release protection for the instance. This feature prevents the instance from being released by using the console or by calling the DeleteInstance operation.

    • true: Enables release protection for the instance.

    • false (default): Disables release protection for the instance.

    Note

    This parameter applies only to pay-as-you-go instances and prevents only manual releases. It does not prevent system-initiated releases.

    false
    HibernationOptions.Configured

    boolean

    No

    Note

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

    false
    Affinity

    string

    No

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

    • default: The instance is not associated with a dedicated host. When you restart a stopped instance that is in Economical Mode, the instance may be placed on a different dedicated host from the automatic deployment resource pool if the original dedicated host has insufficient resources.

    • host: The instance is associated with a dedicated host. When you restart a stopped instance that is in Economical Mode, the instance is still placed on its original dedicated host. If the original dedicated host has insufficient resources, 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: 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 number of partitions in the storage set. The value must be greater than or equal to 2.

    2
    HttpEndpoint

    string

    No

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

    • enabled

    • disabled

    Default value: enabled.

    Note

    For more information about instance metadata, see Overview of ECS instance metadata.

    enabled
    HttpTokens

    string

    No

    Specifies whether to enforce the security-hardened mode (IMDSv2) when instance metadata is accessed. Valid values:

    • optional: The security-hardened mode is not enforced.

    • required: The security-hardened mode is enforced. If you set this value, you cannot access instance metadata in normal mode.

    Default value: optional.

    Note

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

    optional
    HttpPutResponseHopLimit

    integer

    No

    Note

    This parameter is not publicly available.

    0
    PrivatePoolOptions.MatchCriteria

    string

    No

    The private pool option for launching the instance. An elastic assurance or a capacity reservation generates a private pool after it becomes active. You can use the capacity in the private pool to launch instances. Valid values:

    • Open: Open mode. The system automatically finds a matching open private pool to launch the instance. If no matching private pool is found, public resources are used. When you set this parameter to Open, you do not need to specify PrivatePoolOptions.Id.

    • Target: Specified mode. The instance is launched by using the capacity in a specified private pool. If the specified private pool has insufficient capacity, the instance cannot be launched. When you set this parameter to Target, you must specify PrivatePoolOptions.Id.

    • None: The instance is not launched from a private pool.

    Default value: None.

    This parameter must be set to None or left empty in the following scenarios:

    • Creating a preemptible instance

    • Creating an instance in the classic network

    • Creating an instance on a dedicated host

    Open
    PrivatePoolOptions.Id

    string

    No

    The ID of the private pool. This is the ID of an elastic assurance or a capacity reservation.

    eap-bp67acfmxazb4****
    DataDisk

    array<object>

    No

    The data disks.

    object

    No

    PerformanceLevel

    string

    No

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

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

    • PL1 (default): A single ESSD delivers up to 50,000 random read/write IOPS.

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

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

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

    PL2
    Description

    string

    No

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

    TestDescription
    SnapshotId

    string

    No

    The snapshot that is used to create data disk N. N can be an integer from 1 to 16.

    • If DataDisk.N.SnapshotId is specified, DataDisk.N.Size is ignored, and the created disk is the same size as the specified snapshot.

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

    s-bp17441ohwka0yuh****
    Size

    integer

    No

    The size of data disk N, in GiB. N can be an integer from 1 to 16. The valid range for this parameter depends on the disk category specified by DataDisk.N.Category:

    • cloud_efficiency: 20–32,768

    • cloud_ssd: 20–32,768

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

      • PL0: 1–65,536

      • PL1: 20–65,536

      • PL2: 461–65,536

      • PL3: 1,261–65,536

    • cloud: 5–2,000

    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 when you use a whole-machine image. You can set this parameter to the mount point of a data disk in the whole-machine image and then use the DataDisk.N.Size and DataDisk.N.Category parameters to change the size and category of the data disk.

    /dev/xvdb
    DiskName

    string

    No

    The name of data disk N. The name must be 2 to 128 characters long. It can contain Unicode characters in the Letter category (such as Chinese and English letters), digits, colons (:), underscores (_), periods (.), and hyphens (-).

    DataDiskName
    Category

    string

    No

    The category of data disk N. Valid values:

    • cloud_efficiency: Ultra Disk.

    • cloud_ssd: Standard SSD.

    • cloud_essd: Enhanced SSD (ESSD).

    • cloud: Basic Disk.

    • cloud_auto: ESSD AutoPL disk.

    • cloud_essd_entry: ESSD Entry disk.
      Note

      You can set this parameter to cloud_essd_entry only when InstanceType is set to an ecs.u1 or ecs.e instance type family.

    • elastic_ephemeral_disk_standard: Standard elastic ephemeral disk.

    • elastic_ephemeral_disk_premium: Premium elastic ephemeral 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 the data disk when the instance is released.

    • true

    • false

    Default value: true.

    true
    KMSKeyId

    string

    No

    The ID of the KMS key to use for the disk.

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

    string

    No

    Note

    This parameter is not publicly available.

    null
    Encrypted

    boolean

    No

    Specifies whether to encrypt data disk N.

    • true: Encrypts the disk.

    • false: Does not encrypt the disk.

    Default value: false.

    false
    StorageClusterId

    string

    No

    The ID of the dedicated block storage cluster. If you want to use a disk from a dedicated block storage cluster as a data disk when you create the instance, specify 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

    标签列表。

    object

    No

    The tags.

    key

    string

    No

    The key of tag N.

    Note

    For compatibility, we recommend that you use Tag.N.Key.

    Test
    Key

    string

    No

    The key of tag N.

    Note

    For compatibility, we recommend that you use Tag.N.Key.

    TestKey
    Value

    string

    No

    The value of tag N. The tag is applied to the instance, its disks, and its primary elastic network interface (ENI). The value can be an empty string, must be 128 characters or less in length, and cannot contain http:// or https://.

    TestValue
    value

    string

    No

    The value of tag N. The tag is applied to the instance, its disks, and its primary elastic network interface (ENI). The value can be an empty string, must be 128 characters or less in length, and cannot contain http:// or https://.

    Test
    SystemDisk

    object

    No

    系统盘相关参数，目前专属块存储集群 ID（StorageClusterId）需要通过该参数设置参数值。

    StorageClusterId

    string

    No

    专属块存储集群 ID。如果您在创建 ECS 实例时，需要使用专属块存储集群中的云盘资源作为系统盘，请设置该参数。

    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 (the InstanceChargeType parameter is set to PrePaid).

    1234567890
    TradePrice

    number

    The 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.