All Products
Search
Document Center

ENS:CreateEipInstance

Last Updated:Mar 12, 2024

Applies for an elastic IP address (EIP).

Operation description

  • You can call this operation up to 5,000 times per second per account.
  • You can call this operation up to 50 times per second per user.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer.

Authorization information

There is currently no authorization information disclosed in the API.

Request parameters

ParameterTypeRequiredDescriptionExample
EnsRegionIdstringYes

The ID of the Edge Node Service (ENS) node.

cn-suzhou-telecom
BandwidthlongNo

The peak bandwidth of the EIP. Default value: 5. Valid values: 5 to 10000. Unit: Mbit/s.

5
InstanceChargeTypestringYes

The billing method of the EIP. Set the value to PostPaid.

PostPaid
InternetChargeTypestringYes

The metering method of the EIP. Set the value to 95BandwidthByMonth.

95BandwidthByMonth
NamestringNo

The name of the EIP.

EIP1
IspstringNo

The Internet service provider. Valid values:

  • cmcc: China Mobile
  • unicom: China Unicom
  • telecom: China Telecom
cmcc
DescriptionstringNo

The description of the EIP.

yourDescription

Response parameters

ParameterTypeDescriptionExample
object

Schema of Response

RequestIdstring

The ID of the request.

9DB6123F-470D-510A-A9EB-EBA799340452
AllocationIdstring

The ID of the EIP.

eip-25877c70gddh****

Examples

Sample success responses

JSONformat

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

Error codes

HTTP status codeError codeError message
400NoPermissionPermission denied.
400InvalidParameter.%sThe specified field %s invalid. Please check it again.

For a list of error codes, visit the Service error codes.

Change history

Change timeSummary of changesOperation
2023-11-14The request parameters of the API has changedsee changesets
Change itemChange content
Input ParametersThe request parameters of the API has changed.
    Added Input Parameters: Description