Creates subscription simple application servers.
Operation description
- Before you call this operation, we recommend that you understand the billing of Simple Application Server. For more information, see Billable items.
- A maximum of 20 simple application servers can be maintained in an Alibaba Cloud account.
- When you call this operation to create simple application servers, make sure that the balance in your account is sufficient to pay for the servers. If the balance in your account is insufficient, the servers cannot be created.
QPS limit
You can call this API operation up to 10 times per minute per account. Requests that exceed this limit are dropped and you may experience service interruptions. We recommend that you take note of this limit when you call this operation. For more information, see QPS limits.
Debugging
Authorization information
Request parameters
| Parameter | Type | Required | Description | Example |
|---|---|---|---|---|
| RegionId | string | Yes | The region ID of the simple application servers. You can call the ListRegions operation to query the most recent region list. | cn-hangzhou |
| ImageId | string | Yes | The image ID. You can call the ListImages operation to query the available images in the specified region. | e2c9c365024a44369c9b955a998a**** |
| PlanId | string | Yes | The plan ID. You can call the ListPlans operation to query all plans provided by Simple Application Server in the specified region. | swas.s1.c1m1s40b3t05 |
| Period | integer | Yes | The subscription period of the servers. Unit: months. Valid values: 1, 3, 6, 12, 24, and 36. | 1 |
| AutoRenew | boolean | No | Specifies whether to enable auto-renewal. Valid values:
Default value: false. | false |
| AutoRenewPeriod | integer | No | The auto-renewal period. This parameter is required only when you set | 1 |
| DataDiskSize | long | No | The size of the data disk that is attached to the server. Unit: GB. Valid values: 0 to 16380. The value must be an integral multiple of 20.
Default value: 0. | 20 |
| Amount | integer | No | The number of simple application servers that you want to create. Valid values: 1 to 20. Default value: 1. | 1 |
| ChargeType | string | No | The billing method of the simple application servers. Set the value to PrePaid, which indicates the subscription billing method. Default value: PrePaid. | PrePaid |
| 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 you must make sure that the token is unique among different requests. The value of 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 |
Response parameters
Examples
Sample success responses
JSONformat
{
"RequestId": "30637AD6-D977-4833-A54C-CC89483E1FEE",
"InstanceIds": [
"3a658ca270df4df39f22e289b338****"
]
}Error codes
| HTTP status code | Error code | Error message |
|---|---|---|
| 400 | ExceedAccountQuota | The accumulated instance amounts including this order have exceeded the quota of the account. |
| 400 | NotEnoughStock | The stock is insufficient. |
| 400 | PlatformNotMatch | The platform of specified ImageId and PlanId does not match. |
| 400 | InvalidPeriod.ValueNotSupported | The specified parameter Period is invalid. |
| 400 | InvalidDataDiskSize.ValueNotSupported | The specified parameter DataDiskSize is invalid. |
| 400 | InvalidAmount.ValueNotSupported | The specified parameter Amount is invalid. |
| 400 | InvalidChargeType.ValueNotSupported | The specified parameter ChargeType is invalid. |
| 400 | InvalidAutoRenewPeriod.ValueNotSupported | The specified parameter AutoRenewPeriod is invalid. |
| 400 | InvalidPlanIdSize.ValueNotSupported | The system disk size in the specified planId does not support the image. |
| 400 | InvalidPlanMemorySize.ValueNotSupported | The memory size in the specified planId does not support the image. |
| 403 | PaymentFailed | Payment failed. Please check your account balance. |
| 403 | InvalidInstance.UnPaidOrder | The specified Instance has an unpaid order. |
| 403 | InvalidParam | The specified parameter value is invalid. |
| 404 | InvalidImageId.NotFound | The specified ImageId does not exist. |
| 404 | InvalidPlanId.NotFound | The specified PlanId does not exist. |
| 500 | InternalError | An error occurred while processing your request. |
| 500 | NotEnoughUpgradeStock | The upgrade stock is insufficient. |
For a list of error codes, visit the Service error codes.
Change history
| Change time | Summary of changes | Operation | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 2023-09-18 | API Description Update. The Error code has changed | see changesets | ||||||||||||
| ||||||||||||||
| 2021-08-13 | The Error code has changed | see changesets | ||||||||||||
|