Applies for contiguous elastic IP addresses (EIPs).
Operation Description
AllocateEipSegmentAddress is an asynchronous operation. After a request is sent, the system returns the ID of a contiguous EIP group and runs the task in the background. You can call the DescribeEipSegment operation to query the status of the task.
- If the contiguous EIP group is in the Allocating state, the EIPs are being allocated. In this case, you can only perform the query operation and cannot perform other operations.
- If the contiguous EIP group is in the Allocated state, the EIPs are allocated.
debugging
Authorization information
Request parameters
Parameter | Type | Required | Description | Example |
---|---|---|---|---|
ClientToken | string | No | The client token that is used to ensure the idempotence of the request. You can use the client to generate a token, but you must make sure that the token is unique among different requests. ClientToken can contain only ASCII characters. Note
If you do not specify this parameter, the system automatically uses the request ID as the client token. The request ID may be different for each request.
| 02fb3da4-130e-11e9-8e44-001**** |
Bandwidth | string | No | The maximum bandwidth of the contiguous EIP group. Unit: Mbit/s.
Default value: 5. Unit: Mbit/s. | 5 |
RegionId | string | Yes | The ID of the region in which the contiguous EIP group resides. You can call the DescribeRegions operation to query the region ID. | cn-hangzhou |
EipMask | string | Yes | The subnet mask of the contiguous EIP group. Valid values:
Note
Some IP address are reserved for specific purposes. Therefore, the actual number of the contiguous EIPs may be one, three, or four less than the expected number.
| 28 |
Netmode | string | No | The network type. Set the value to public, which specifies the public network type. | public |
InternetChargeType | string | No | The metering method of the contiguous EIP group. Valid values:
| PayByBandwidth |
ResourceGroupId | string | No | The resource group ID. | rg-bp67acfmxazb4ph**** |
Isp | string | No | The line type. Valid values:
For more information about the BGP (Multi-ISP) line and BGP (Multi-ISP) Pro line, see EIP line types. If you are allowed to use single-ISP bandwidth, you can also use one of the following values:
If your services are deployed in China East 1 Finance, this parameter is required and you must set the parameter to BGP_FinanceCloud. | BGP |
Zone | string | No | The zone of the contiguous EIP group. | cn-hangzhou-a |
Response parameters
Examples
Sample success responses
JSON
format
{
"RequestId": "F7A6301A-64BA-41EC-8284-8F4838C15D1F\t",
"EipSegmentInstanceId": "eipsg-2zett8ba055tbsxme****"
}
Error codes
HTTP status code | Error code | Error message | Description |
---|---|---|---|
400 | COMMODITY_NO_EXIST | commodity is not exist | - |
400 | QuotaExceeded.Eip | Elastic IP address quota exceeded | - |
400 | InvalidParameter | Specified value of "InternetChargeType" is not valid | - |
400 | InvalidParameter | Specified value of "Bandwidth" is not valid. | The specified bandwidth value is invalid. |
400 | InsufficientBalance | Your account does not have enough balance. | Your account balance is insufficient. Top up your account and try again. |
400 | QuotaExceeded.Eip | Elastic IP address quota exceeded. | The number of EIPs exceeds the upper limit. We recommend that you use NAT gateways. |
400 | ReserveIpFail | Reserve eip failed. | The system failed to reserve the specified EIP. |
400 | InvalidRegion.NotSupport | The specified region does not support. | The specified region does not support. |
400 | InvalidBandwidth.Malformed | The specified Bandwidth is invalid. | - |
400 | INSTANCE_TYPE_NOT_SUPPORT | The instance type is invalid. | - |
400 | QueryParameter.Illegal | query parameter illegal | - |
400 | TokenVerfiy.Failed | token verify failed. | - |
400 | OrderFailed | The Account failed to create order. | - |
400 | QuotaExceeded.LargeSpecEip | Elastic IP address with large spec quota exceeded. | - |
400 | InvalidResourceGroupId | The specified ResourceGroupId does not exist. | The specified resource group ID does not exist. |
400 | PAYFOR.CREDIT_PAY_INSUFFICIENT_BALANCE | Your account does not have enough balance. | - |
400 | SYSTEM.SALE_VALIDATE_UNEXPECTED_ERROR | You have arrears and do not meet the purchase conditions. | - |
400 | Trade_Sync_Create_Sub_ERROR | SyncOrderToSub error. | - |
400 | InvalidComponent.EipBandwidthMax | The eip_bandwidth_max component is invalid. | - |
400 | OperationFailed.RiskControl | Risk control check failed. | The error message returned because your payment method has security risks. Click the link for verification in your email or console message and submit your order after verification. |
400 | OperationFailed.SaleValidate | Validate sale condition with subArticle failed. | Failed to validate the sales condition with a subproject. |
400 | IllegalParam.OrderParamComponent | Product order param has invalid component. | - |
400 | OperationFailed.SaleExpression | Get the sales expression exception attached to the item. | - |
400 | OperationFailed.CompleteUserInfo | Complete user info failed. | - |
400 | OperationFailed.QueryPrice | Query price failed when create order. | Failed to query the price when creating the order. |
400 | OperationFailed.InsufficientEIP | Eip resource is not enough. | - |
400 | OperationFailed.InvokeInnerApi | Failed to invoke inner api. | - |
400 | OperationFailed.AccountMoneyInvalid | Account money is invalid. | - |
400 | OperationFailed.QueryCredtiInfo | Failed to query credit info. | - |
400 | FrequentPurchase.EIP | eip frequent purchase | - |
400 | OperationFailed.QueryUserLabel | Failed to query user label info. | - |
400 | PAY.INSUFFICIENT_BALANCE | Your account does not have enough balance. | - |
400 | ORDER.QUANTITY_INVALID | User quota has exceeded the limit. | The maximum number of EIPs you maintain is exceeded. You can go to quota management to increase the upper limit of EIPs. |
400 | PAY.MAYI_WITHHOLDING_AGREEMENT_ILLEGAL | User withhoding argeement is illegal. | - |
400 | OperationFailed.ChargeTypeInvalid | Operation failed because hybrid netmode do not support PayByTraffic. | - |
400 | IllegalParam.EipMask | EipMask is illegal. | - |
400 | IllegalParam.Name | Name is illegal. | - |
400 | IllegalParam.Description | Description is illegal. | - |
400 | InstanceExist.EipSegment | The eipSegment instance already exists. | - |
400 | OperationFailed.QuotaExceed | Operation failed because over threshold bandwidth quota exceed. | - |
400 | OperationFailed.FrequentPurchase | Operation failed because eip frequent purchase. | - |
400 | OperationFailed.AllocateEipSegment | Operation failed because eip segment is out of stock. | - |
400 | OperationFailed.CreateOrderFailed | Operation failed because create order failed. | - |
400 | MissingParam.Bandwidth | The parameter Bandwidth is mandatory when allocate hybrid EipSegment. | - |
400 | OperationFailed.EipQuotaExceed | Operation failed because eip quota exceed. | - |
400 | OrderError.EIP | The Account failed to create order. | Failed to place the order. |
400 | OperationConflict | Request was denied due to conflict with a previous request. | The request conflicts with another one. Try again later. |
400 | Forbidden | User not authorized to operate on the specified resource. | You do not have the permissions to manage the specified resource. Apply for the permissions and try again. |
400 | UnsupportedFeature.AllocateEipAddressWithZone | The feature of AllocateEipAddressWithZone is not supported. | You are not allowed to create an instance in a specified zone in the region. |
400 | IllegalParam.Zone | The specified zone is invalid. | Zone is set to an invalid value. |
404 | InvalidRegionId.NotFound | Specified value of "RegionId" is not supported. | RegionId is set to an invalid value. Check whether the service is available in the specified region and try again. |
404 | InvalidRegionId.NotFound | The RegionId provided does not exist in our records. | The RegionId parameter is set to an invalid value. Specify a valid value and try again. |
404 | FUWU_BIZ_COMMODITY_VERIFY_FAIL | ????????, ????????PD. | - |
500 | InternalError | The request processing has failed due to some unknown error, exception or failure. | An internal error occurred. |
For a list of error codes, visit the Service error codes.
Change history
Change time | Summary of changes | Operation | ||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
2023-08-29 | The error codes of the API operation change. | see changesets | ||||||||||||
| ||||||||||||||
2023-07-26 | API Description Update,The error codes of the API operation change. | see changesets | ||||||||||||
| ||||||||||||||
2023-05-22 | The error codes of the API operation change.,The input parameters of the API operation change. | see changesets | ||||||||||||
| ||||||||||||||
2023-03-17 | The error codes of the API operation change.,The response structure of the API operation changes. | see changesets | ||||||||||||
|