AllocateEipSegmentAddress - 申請連續EIP

更新時間:
Copy as MD

連續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程式碼範例。

調試

授權資訊

當前API暫無授權資訊透出。

請求參數

名稱

類型

必填

描述

樣本值

ClientToken

string

用戶端 Token,用於保證請求的等冪性。

從您的用戶端產生一個參數值,確保不同請求間該參數值唯一。ClientToken 只支援 ASCII 字元。

說明

若您未指定,則系統自動使用 API 請求的 RequestId 作為 ClientToken 標識。每次 API 請求的 RequestId 不一樣。

02fb3da4-130e-11e9-8e44-001****

Bandwidth

string

EIP 的頻寬峰值。單位:Mbps。

  • InternetChargeType 取值為 PayByBandwidth 時,Bandwidth 取值範圍為 1~500

  • InternetChargeType 取值為 PayByTraffic 時,Bandwidth 取值範圍為 1~200

預設值為 5 Mbps。

5

RegionId

string

連續 EIP 所在的地區 ID。

您可以通過調用 DescribeRegions 介面擷取地區 ID。

cn-hangzhou

EipMask

string

連續 EIP 的掩碼,取值:

  • 28:單次調用,系統將分配 16 個連續 EIP。

  • 27:單次調用,系統將分配 32 個連續 EIP。

  • 26:單次調用,系統將分配 64 個連續 EIP。

  • 25:單次調用,系統將分配 128 個連續 EIP。

  • 24:單次調用,系統將分配 256 個連續 EIP。

說明

由於 IP 位址保留,實際申請到的連續 EIP 可能缺少 1、3 或者 4 個 EIP。

28

Netmode

string

網路類型,僅取值:public,表示公網。

public

InternetChargeType

string

連續 EIP 的計費方式,取值:

  • PayByBandwidth(預設值):按固定頻寬計費。

  • PayByTraffic:按使用流量計費。

PayByBandwidth

ResourceGroupId

string

資源群組 ID。

rg-bp67acfmxazb4ph****

Isp

string

線路類型。取值:

  • BGP(預設值):BGP(多線)線路。目前全部地區都支援 BGP(多線)線路 EIP。

  • BGP_PRO:BGP(多線)_精品線路。目前僅中國香港、新加坡、日本(東京)、馬來西亞(吉隆坡)、菲律賓(馬尼拉)、印尼(雅加達)和泰國(曼穀)地區支援 BGP(多線)_精品線路 EIP。

關於 BGP(多線)線路和 BGP(多線)_精品線路的更多資訊,請參見 EIP 線路類型

如果您是單線頻寬的白名單使用者,您還可以選擇以下類型:

  • ChinaTelecom:中國電信

  • ChinaUnicom:中國聯通

  • ChinaMobile:中國移動

  • ChinaTelecom_L2:中國電信 L2

  • ChinaUnicom_L2:中國聯通 L2

  • ChinaMobile_L2:中國移動 L2

如果您是杭州金融雲使用者,該欄位必填,取值: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.

訪問錯誤中心查看更多錯誤碼。

變更歷史

更多資訊,參考變更詳情