CreateEipInstance - ENS - Alibaba Cloud Documentation Center

Allocates an Elastic IP Address (EIP) to your account.

Operation description

API call rate: 5,000 requests per second.
Single-user call rate: 50 requests per second.

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

create

*All Resource

*

None

Request parameters

Parameter	Type	Required	Description	Example
EnsRegionId	string	Yes	The ID of the edge node.	cn-suzhou-telecom
Bandwidth	integer	No	The peak bandwidth of the EIP. Default value: 5. Unit: Mbit/s. Valid values: 5 to 10000.	5
InstanceChargeType	string	Yes	The billing method of the EIP. The value is set to PostPaid, which is the pay-as-you-go billing method.	PostPaid
InternetChargeType	string	Yes	The metering method of the EIP. The value is set to 95BandwidthByMonth, which indicates the monthly 95th percentile bandwidth metering method.	95BandwidthByMonth
Name	string	No	The name of the EIP instance.	EIP1
Isp	string	No	The ISP. Valid values: cmcc: China Mobile unicom: China Unicom telecom: China Telecom	cmcc
Description	string	No	The description.	yourDescription
Tag	array<object>	No	The resource tags.
	object	No	The information of the tags. You can specify up to 20 tags.
Key	string	No	The key of tag N that is added to the instance. Valid values of N: 1 to 20. The tag key cannot start with `aliyun`, `acs:`, `http://`, or `https://`. The tag key can be up to 64 characters in length. The tag key cannot be an empty string.	team
Value	string	No	The tag value. The value can be up to 128 characters in length. It cannot start with `aliyun` or `acs:`. It cannot contain `http://` or `https://`.	tagValue
ClientToken	string	No	A client-generated token that ensures the idempotence of the request. This prevents duplicate operations if you retry the request. You can generate a unique, case-sensitive string that contains only ASCII characters and is no more than 64 characters in length. If you use a previously used client token with the same request parameters, the server returns the same result as the original request without changing its state. You can safely retry requests that time out or return a `PROCESSING` error code. Idempotence is guaranteed if the original request was successful (HTTP status code `200`). However, it is not guaranteed if the original request failed with an HTTP `4xx` error code other than `PROCESSING`. The token is valid for 10 minutes.	26C28756-2586-17AF-B802-0DC50D8FDEBB
IpAddress	string	No	The IP address. If you do not specify this parameter, the system automatically allocates an available IP address.
InstanceId	string	No	The ID of the EIP instance.

Response elements

Element	Type	Description	Example
	object	The response object.
RequestId	string	The request ID.	9DB6123F-470D-510A-A9EB-EBA799340452
AllocationId	string	The ID of the EIP instance.	eip-25877c70gddh****

Examples

Success response

JSON format

{
  "RequestId": "9DB6123F-470D-510A-A9EB-EBA799340452",
  "AllocationId": "eip-25877c70gddh****"
}

Error codes

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.

HTTP status code	Error code	Error message	Description
400	ens.interface.error	Failed to call API.
400	ResourceNotAvailable	Resource you requested is not available in this node.	The specified node does not support VPC.
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	Processing	Request is in progress, please try again later.	Request is in progress, please try again later.
400	SaleControlVerificationFailedBandwidthType	Bandwidth type sales constraint verification failed, please re-match, or contact the product.	Bandwidth billing method sales constraint verification failed, please re-select.
400	NoPermission	Permission denied.
400	InvalidParameter.%s	The specified field %s invalid. Please check it again.
400	InvalidParam_NotSupportInstanceIdAndIpAddress	The parameter InstanceId and IpAddress cannot be supported simultaneously.	The parameter InstanceId and IpAddress cannot be supported simultaneously.
400	InventoryExceeded	The Instance in stock are insufficient,please submit a ticket.	The specified instance resource inventory is insufficient, please re-match.
400	ResourceNotFound.Ip	The specified ip is not found.	The specified IP address does not exist.