All Products
Search

This Product

    ENS:CreateARMServerInstances

    Document Center

    ENS:CreateARMServerInstances

    Last Updated:Mar 27, 2026

    Creates ARM server instances.

    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

    ens:CreateARMServerInstances

    create

    *All Resource

    *

    		 None None

    Request parameters

    Parameter

    Type

    Required

    Description

    Example
    PayType

    string

    Yes

    The payment type. The only valid value is PrePaid.

    Note

    This service supports only the subscription (pre-paid) payment type.

    PrePaid
    EnsRegionId

    string

    Yes

    The ID of the edge node.

    cn-guiyang-12
    ServerType

    string

    Yes

    The server type. Valid values:

    • cas.cf53r

    • cas.cf52r

    • cas.cf52m1r

    • cas.tg52g2

    • ens.afq-c2m3i.medium

    cas.cf53r
    InstanceType

    string

    Yes

    The instance type for the AIC. Valid values:

    • aic.cf52r.c1.np

    • aic.cf52r.c2.np

    • aic.cf53r.c2.np

    • aic.cf52r.c4.np

    • aic.cf53r.c3.np

    • aic.cf52r.c3.np

    • aic.cf53r.c1.np

    • aic.cf53r.c5.np

    • aic.cf53r.c6

    • aic.cf53r.c4.np

    • aic.cf53r.c6.np

    • aic.cf53r.c7.np

    • aic.cf52m1r.c5.np

    • aic.cf53r.c8.np

    • aic.cf53r.c7

    • aic.cf52m1r.c2.np

    • aic.cf52m1r.c1.np

    • aic.cf52m1r.c3.np

    • aic.cf52m1r.c4.np

    • aic.cf52m1r.c6

    • ens.a6c2

    aic.cf53r.c6.np
    ImageId

    string

    Yes

    The ID of the image.

    yourImage ID
    Resolution

    string

    Yes

    The resolution. Valid values:

    • 1920*864

    • 1080*1920

    • 1920*1080

    • 720*1280

    • 2400*1080

    • 1080*2400

    • 1280*720

    • 864*1920

    720*1280
    Frequency

    integer

    No

    The refresh rate in hertz (Hz). Valid values: 30 and 60.

    30
    KeyPairName

    string

    No

    The name of the key pair.

    TestKeyPairName
    Amount

    integer

    Yes

    The number of instances to create. Valid range: 1 to 100.

    1
    Period

    integer

    No

    The subscription duration. The valid values for this parameter depend on the PeriodUnit parameter.

    • If PeriodUnit is Month, valid values are 1–9 and 12.

    • If PeriodUnit is Day, the value must be 3.

    • If PeriodUnit is Month, Period can be a value from 1 to 9, or 12.

    1
    PeriodUnit

    string

    No

    The time unit for the subscription duration. Valid values:

    • Month (default)

    • Day

    • If PeriodUnit is Monthc, Period can be an integer from 1 to 9, or 12.

    Month
    AutoRenew

    boolean

    No

    Specifies whether to automatically renew the subscription when it expires. Valid values:

    • true

    • false (Default)

    false
    NameSpace

    string

    No

    The namespace of the instance.

    pre
    ServerName

    string

    No

    The server name.

    AIC-Server
    AutoUseCoupon

    boolean

    No

    Specifies whether to automatically apply a coupon to the purchase. Valid values:

    • true: A coupon is automatically applied.

    • false (Default): A coupon is not applied.

    true
    EnvironmentVar

    string

    No

    The environment variables for the instance, specified in JSON format.

    [object Object]
    Cidr

    string

    No

    Tag

    array<object>

    No

    The tags to add to the instance. Each tag is a key-value pair.

    object

    No

    Key

    string

    No

    The tag key.

    Value

    string

    No

    The tag value.

    InstanceBillingCycle

    string

    No

    Response elements

    Element

    Type

    Description

    Example

    object

    The response object.

    RequestId

    string

    The request ID.

    CEF72CEB-54B6-4AE8-B225-F876FF7BA984
    OrderId

    string

    The order ID.

    212630314490***
    InstanceIds

    array

    The IDs of the ARM server instances that are created.

    string

    The ID of an ARM server instance.

    cas-instance****

    Examples

    Success response

    JSON format

    {
  "RequestId": "CEF72CEB-54B6-4AE8-B225-F876FF7BA984",
  "OrderId": "212630314490***",
  "InstanceIds": [
    "cas-instance****"
  ]
}

    Error codes

    HTTP status code

    Error code

    Error message

    Description
    400 CallInterface Call Interface Happen Error. An error occurred when you call the operation.
    400 ens.interface.error Failed to call API.
    400 EnsNodeStockIsNotEnough Insufficient inventory of purchased resources. Insufficient inventory of purchased resources
    400 InvalidParameterEnsRegionId The entered node information is invalid. Please enter the correct node information. The entered node information is invalid. Please enter the correct node information.
    400 InvalidImageIdNotFound The image information entered is invalid. Please re-enter valid image information. The image information entered is invalid. Please re-enter valid image information.
    400 OrderFailed Order failed, please try again. Order failed, please try again
    400 SystemUseCouponFailed Failed to use coupon. Failed to use coupon
    400 SystemUseStoredCardFailed Failed to use stored value card. Failed to use stored value card
    400 System.SystemError system error. system error.
    400 SystemCanRefundCheckFailed The business rule check of the cloud product fails, and this order cannot be refunded. The business rule check of the cloud product fails, and this order cannot be refunded.
    400 SystemOtsSystem ots storage error. ots storage error.
    400 SystemQueryImmortalError Failed to call Juxiange. Failed to call Juxiange.
    400 SystemQueryInstanceInfoFailed Failed to find instance information. Failed to find instance information
    400 SystemResellerPayCalRefundUnitError Ecological payment channel calculation unsubscribe information error. Ecological payment channel calculation unsubscribe information error.
    400 SystemSaleValidateFailed Sales Expression Validation System Error. Sales Expression Validation System Error
    400 SystemTransferDeleteOldResourceFailed Failed to delete the transferred instance in the transfer order. Failed to delete the transferred instance in the transfer order.
    400 SystemUnSupportOperationType Unsupported operation type. Unsupported operation type.
    400 RiskRiskControlRejection Risk Control Rejection. Risk Control Rejection.
    400 AuthRamAuthFailed ram sub-account authentication failed.
    400 CommodityInvalidComponent The module you purchased is illegal, please re-select. The module you purchased is illegal, please re-select.
    400 CommodityInvalidItemCode Specification code illegal. Specification code illegal.
    400 PriceHsfTimeoutError Time out when calling the request for quotation interface. Time out when calling the request for quotation interface.
    400 PricePatingConfigError Inquiry related goods configuration error. Inquiry related goods configuration error.
    400 PricePricingPlanResultNotFound Pricing plan price result not found. Pricing plan price result not found.
    400 PriceRatingGetRatingpricingPlan Obtain a valid pricing plan exception. Obtain a valid pricing plan exception.
    400 OrderAbnormalResourceStatusForRenew Invalid resource status for renewal. Invalid resource status for renewal.
    400 OrderAccountStatusIllegal Illegal account status. Illegal account status.
    400 OrderArrearage User Arrears. User Arrears.
    400 OrderBidUserOrderForbidden Bid users cannot buy on the official website. Bid users cannot buy on the official website.
    400 OrderCaptureFailed The paid order of the instance has not been deducted successfully. The paid order of the instance has not been deducted successfully.
    400 OrderExistsReleasedInstances There are already released instances. There are already released instances.
    400 OrderGroupOrderSizeOverflow The quantity of bound combined payment order exceeds the limit. The quantity of bound combined payment order exceeds the limit.
    400 OrderHomeCurrencyCanNotDowngrade Users in current currency cannot downgrade. Users in current currency cannot downgrade.
    400 OrderHomeCurrencyCanNotUpgradeByValueTransfer Users of current currency cannot upgrade through residual value transfer. Users of current currency cannot upgrade through residual value transfer.
    400 OrderInstanceHasInactiveChange Instances exist temporary upgrade. Instances exist temporary upgrade.
    400 OrderInstHasUnpaidOrder The instance has an unpaid order. The instance has an unpaid order.
    400 OrderInstHasUnsettledBills The instance has an unsettled bill. The instance has an unsettled bill.
    400 OrderLatestOrderIsHandling Recent order is being processed, please try again later. Recent order is being processed, please try again later.
    400 OrderMainOrderSizeOverflow The quantity of the main order exceeds the limit. The quantity of the main order exceeds the limit.
    400 OrderMissingModuleInfoError Module parameter not specified. Module parameter not specified.
    400 OrderNoRealNameAuthentication No real-name authentication. No real-name authentication.
    400 OrderNotFound The specified order information is not found. The specified order information is not found.
    400 OrderOpend You have activated this product. You have activated this product.
    400 OrderPeriodInvalid Illegal order cycle. Illegal order cycle.
    400 OrderQuantityInvalid Illegal quantity ordered. Illegal quantity ordered.
    400 OrderQueryInstanceError Query instance error. Query instance error.
    400 OrderQueryInstanceNotExists Instance data does not exist. Instance data does not exist.
    400 OrderQueryOrderExchangeRateFail Failed to query order exchange rate information. Failed to query order exchange rate information.
    400 OrderQueryUserSettleInfoFail Failed to query user settlement information. Failed to query user settlement information.
    400 OrderQuotaExceeded Quantity exceeds limit. Quantity exceeds limit.
    400 OrderSysConstraintInvalid System constraint check failed. System constraint check failed.
    400 OrderTradeCompleteSettleInfoFail Failed to complete the order settlement currency amount information. Failed to complete the order settlement currency amount information.
    400 TradeTradeOrderAfterPayCheckError You have already paid for the subsequent orders of this instance. The current order has been automatically voided and you cannot pay any more. You have already paid for the subsequent orders of this instance. The current order has been automatically voided and you cannot pay any more.
    400 PurchaseExistRenewchangeProd There is a renewal change subscription that has not yet taken effect. There is a renewal change subscription that has not yet taken effect.
    400 PurchaseExistToBeValidProdRuleError Currently, there are temporary orders that are not in effect, and the upgrade operation cannot be performed. Currently, there are temporary orders that are not in effect, and the upgrade operation cannot be performed.
    400 PurchaseExistToBeValidRenewChangeProdRuleError Currently, there is an uneffective renewal change subscription, and temporary upgrade operation cannot be performed. Currently, there is an uneffective renewal change subscription, and temporary upgrade operation cannot be performed.
    400 PurchaseExistValidProdRuleError Currently, there is a temporary order in effect, and operations such as upgrade/downgrade/expansion/pre-transfer cannot be performed. Currently, there is a temporary order in effect, and operations such as upgrade/downgrade/expansion/pre-transfer cannot be performed.
    400 ProductInstanceReleased Instance released. Instance released.
    400 ProductInstanceTypeNotSupported The instance type is not supported. The instance type is not supported.
    400 PatRiskRejectForTradeData Payment order problem leads to risk control rejection. Payment order problem leads to risk control rejection.
    400 PayAccountBookNotExist There is no insufficient account balance in the account book, please retry after recharging. There is no insufficient account balance in the account book, please retry after recharging.
    400 PayAmountLimitExceeded Payment limit exceeded, please resubmit. Payment limit exceeded, please resubmit.
    400 PayBeforePayRiskRuleValidateFailed The payment was blocked by risk control, and the payment failed. The payment was blocked by risk control, and the payment failed.
    400 PayCounponNotExist Counpon does not exist. Counpon does not exist.
    400 PayCouponAmountNotEnough Insufficient voucher balance or expired. Insufficient voucher balance or expired.
    400 PayCouponNotMeetConsumptionRule The coupon does not meet the conditions for use. The coupon does not meet the conditions for use.
    400 PayCurrencyInconsistency Currency mismatch. Currency mismatch.
    400 PayCurrencyNotSupported Currency not supported. Currency not supported.
    400 PayForbiddenNoReasonFefund Banned five days no reason refund. Banned five days no reason refund.
    400 PayHsfTimeoutError Call payment system timeout. Call payment system timeout.
    400 PayInsufficientBalance Account balance is insufficient, please recharge and try again. Account balance is insufficient, please recharge and try again.
    400 PayInvalidCreditCard Invalid credit card. Invalid credit card.
    400 PayInvalidPayMethod Illegal payment method. Illegal payment method.
    400 PayMegrePayOrderHasThanOneChagreChannel Payment failed, please retry or submit work order feedback. Payment failed, please retry or submit work order feedback.
    400 PayNoCreditCard No valid payment method, please check the payment method and try again. No valid payment method, please check the payment method and try again.
    400 PayOrderPayTimeInvalid Order effective time is invalid. Order effective time is invalid.
    400 PayPartRefundNotSupport Not Capture, no partial refund. Not Capture, no partial refund.
    400 PayPayChannelPayOrderInvalidStatus Illegal status of payment order in payment channel. Illegal status of payment order in payment channel.
    400 PayPayChannelPayOrderNotExist Payment channel payment order does not exist. Payment channel payment order does not exist.
    400 PayPayerAccountIllegal Illegal payment account. Illegal payment account.
    400 PayPayFailedParentRelationchanged If the financial custody relationship changes, please void the order and place a new order for payment. If the financial custody relationship changes, please void the order and place a new order for payment.
    400 PayPayForbidUserCoupon Coupon prohibited for orders. Coupon prohibited for orders.
    400 PayQueryAvailableAmountFailed Failed to query user availability, please try again later. Failed to query user availability, please try again later.
    400 PayQueryAvailableEnduserAmountFailed Failed to query the availability of quota direct customer main user, please try again later. Failed to query the availability of quota direct customer main user, please try again later.
    400 PayQueryParentRelationshipFailed Failed to query current user hosting relationship, please try again later. Failed to query current user hosting relationship, please try again later.
    400 PayQueryPayChangeChannelNotEqual Multi-order payment channels are inconsistent, please check whether the original order data payment channel is correct. Multi-order payment channels are inconsistent, please check whether the original order data payment channel is correct.
    400 PayRefundFailed Accumulated refund amount exceeds payment order amount. Accumulated refund amount exceeds payment order amount.
    400 PayResellerPayGetUrlError Order payment failed, please try again later. Order payment failed, please try again later.
    400 PayRiskRejectForPayerAccount Payment account problem leads to risk control rejection. Payment account problem leads to risk control rejection.
    400 PayStoredCardNotExist Stored value card does not exist. Stored value card does not exist.
    400 PaySystemError Error calling payment system. Error calling payment system
    400 PayTaxCalcFailed Failed to get user tax address. Failed to get user tax address.
    400 PayWithholdingAgreementIllegal Withholding Agreement Status Illegal. Withholding Agreement Status Illegal.
    400 AccountAliyunAccountFrozen Alibaba Cloud account is frozen. Alibaba Cloud account is frozen.
    400 AccountAliyunAccountNotExist Alibaba Cloud account does not exist. Alibaba Cloud account does not exist.
    400 RefundRefundInstanceNotFound Unable to find instance information. Unable to find instance information.
    400 RefundRefundNoValidProd Refund is not available to unsubscribe. Refund is not available to unsubscribe.
    400 RefundRefundParamInvalid Abnormal refund parameter. Abnormal refund parameter.
    400 RefundRefundQueryOrderFail Failed to query order for refund field. Failed to query order for refund field.
    400 SystemConcurrentOperate Concurrent operation causes failure. Concurrent operation causes failure.
    400 PricePricingPlanNotFound Pricing plan tree not found. Pricing plan tree not found.
    400 OrderInstanceHasTempUpgrade Instances exist temporary upgrade. Instances exist temporary upgrade.
    400 PayQueryParentRelationchangedFailed The financial custody relationship may change, please refresh and pay again. The financial custody relationship may change, please refresh and pay again.
    400 PayforCreditPayInsufficientBalance Insufficient quota, please contact your channel partner to increase the quota. Insufficient quota, please contact your channel partner to increase the quota.
    400 PayforAccountMoneyValidateError The available amount of your channel partner's account is insufficient, please contact your channel partner to recharge in time. The available amount of your channel partner's account is insufficient, please contact your channel partner to recharge in time.
    400 BasicInfoUncompleted You have not completed your basic personal information. Please complete the information and re-operate it. You have not completed your basic personal information. Please complete the information and re-operate it.
    400 NoPermission Permission denied.
    400 InvalidParameter.%s The specified field %s invalid. Please check it again.
    400 InvalidCidr the cidr information filled in is illegal, please re-match. the cidr information filled in is illegal, please re-match

    See Error Codes for a complete list.

    Release notes

    See Release Notes for a complete list.