AllocateEipSegmentAddress - 申請連續EIP
連續EIP是一組按序排列的Elastic IP Address地址,您可以在進行網路設計時,為需要連續公網IP地址的雲資源批量申請和使用這些IP地址。您可以通過調用AllocateEipSegmentAddress介面申請連續EIP。
目前該API介面已標記為棄用。
介面說明
AllocateEipSegmentAddress 介面屬於非同步介面,即系統會先返回一個連續 EIP 組的執行個體 ID,但該連續 EIP 組並未建立完成,系統背景建立任務仍在進行。您可以調用 DescribeEipSegment 查詢連續 EIP 組的狀態。
-
當連續 EIP 組處於 Allocating 狀態時,表示連續 EIP 組分配中,在該狀態下,您只能執行查詢操作,不能執行其他動作。
-
當連續 EIP 組處於 Allocated 狀態時,表示連續 EIP 組已指派完成。
調試
您可以在OpenAPI Explorer中直接運行該介面,免去您計算簽名的困擾。運行成功後,OpenAPI Explorer可以自動產生SDK程式碼範例。
調試
授權資訊
請求參數
|
名稱 |
類型 |
必填 |
描述 |
樣本值 |
| ClientToken |
string |
否 |
用戶端 Token,用於保證請求的等冪性。 從您的用戶端產生一個參數值,確保不同請求間該參數值唯一。ClientToken 只支援 ASCII 字元。 說明
若您未指定,則系統自動使用 API 請求的 RequestId 作為 ClientToken 標識。每次 API 請求的 RequestId 不一樣。 |
02fb3da4-130e-11e9-8e44-001**** |
| Bandwidth |
string |
否 |
EIP 的頻寬峰值。單位:Mbps。
預設值為 5 Mbps。 |
5 |
| RegionId |
string |
是 |
連續 EIP 所在的地區 ID。 您可以通過調用 DescribeRegions 介面擷取地區 ID。 |
cn-hangzhou |
| EipMask |
string |
是 |
連續 EIP 的掩碼,取值:
說明
由於 IP 位址保留,實際申請到的連續 EIP 可能缺少 1、3 或者 4 個 EIP。 |
28 |
| Netmode |
string |
否 |
網路類型,僅取值:public,表示公網。 |
public |
| InternetChargeType |
string |
否 |
連續 EIP 的計費方式,取值:
|
PayByBandwidth |
| ResourceGroupId |
string |
否 |
資源群組 ID。 |
rg-bp67acfmxazb4ph**** |
| Isp |
string |
否 |
線路類型。取值:
關於 BGP(多線)線路和 BGP(多線)_精品線路的更多資訊,請參見 EIP 線路類型。 如果您是單線頻寬的白名單使用者,您還可以選擇以下類型:
如果您是杭州金融雲使用者,該欄位必填,取值:BGP_FinanceCloud。 |
BGP |
| Zone |
string |
否 |
連續 EIP 組的可用性區域。 |
cn-hangzhou-a |
返回參數
|
名稱 |
類型 |
描述 |
樣本值 |
|
object |
返回資訊列表。 |
||
| RequestId |
string |
請求 ID。 |
F7A6301A-64BA-41EC-8284-8F4838C15D1F |
| EipSegmentInstanceId |
string |
連續 EIP 組的執行個體 ID。 |
eipsg-2zett8ba055tbsxme**** |
樣本
正常返回樣本
JSON格式
{
"RequestId": "F7A6301A-64BA-41EC-8284-8F4838C15D1F",
"EipSegmentInstanceId": "eipsg-2zett8ba055tbsxme****"
}
錯誤碼
|
HTTP status code |
錯誤碼 |
錯誤資訊 |
描述 |
|---|---|---|---|
| 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 | InsufficientBalance | Your account does not have enough balance. | |
| 400 | ReserveIpFail | Reserve eip failed. | |
| 400 | InvalidRegion.NotSupport | 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. | 資源群組ID不存在。 |
| 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. | 我們檢測到您的付款條件存在安全風險。請通過電子郵件或控制台訊息中的連結繼續驗證,並在驗證後重新提交訂單。 |
| 400 | OperationFailed.SaleValidate | Validate sale condition with subArticle failed. | 使用子專案驗證銷售條件失敗。 |
| 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. | 建立訂單時查詢價格失敗。 |
| 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. | 您當前保有的EIP數量已達上限,可前往配額管理提升EIP數量配額 |
| 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. | 連續EIP庫存不足。 |
| 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. | 下單失敗 |
| 400 | OperationConflict | Request was denied due to conflict with a previous request. | |
| 400 | Forbidden | User not authorized to operate on the specified resource. | |
| 400 | UnsupportedFeature.AllocateEipAddressWithZone | The feature of AllocateEipAddressWithZone is not supported. | 當前地區不支援指定Zone建立執行個體 |
| 400 | IllegalParam.Zone | The specified zone is invalid. | 參數Zone非法 |
| 400 | Forbidden.AllocateEipSegmentAddress | Authentication is failed for allocating eip segment address. | 申請連續EIP失敗,該服務已下線,請使用IP位址集區服務。 |
| 500 | InternalError | The request processing has failed due to some unknown error, exception or failure. | 內部錯誤 |
| 500 | OrderError.EIP | The Account failed to create order. | |
| 404 | InvalidRegionId.NotFound | Specified value of "RegionId" is not supported. | |
| 404 | FUWU_BIZ_COMMODITY_VERIFY_FAIL | ????????, ????????PD. |
訪問錯誤中心查看更多錯誤碼。
變更歷史
更多資訊,參考變更詳情。