AllocateEipSegmentAddress - Elastic IP Address

連續 EIP 是一組按序排列的彈性公網 IP 地址，您可以在進行網路設計時，為需要連續公網 IP 地址的雲端資源批次申請和使用這些 IP 地址。您可以透過呼叫 AllocateEipSegmentAddress 介面申請連續 EIP。

說明

目前該API介面已標記為棄用。

介面說明

AllocateEipSegmentAddress 介面屬於非同步介面，即系統會先返回一個連續 EIP 群組的執行個體 ID，但該連續 EIP 群組並未建立完成，系統後台的建立任務仍在進行。您可以呼叫 DescribeEipSegment 查詢連續 EIP 群組的狀態。

當連續 EIP 群組處於 Allocating 狀態時，表示連續 EIP 群組分配中，在該狀態下，您只能執行查詢操作，不能執行其他操作。
當連續 EIP 群組處於 Allocated 狀態時，表示連續 EIP 群組已分配完成。

調試

您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。

調試

授權資訊

下表是API對應的授權資訊，可以在RAM權限原則語句的Action元素中使用，用來給RAM使用者或RAM角色授予調用此API的許可權。具體說明如下：

操作：是指具體的許可權點。
存取層級：是指每個操作的存取層級，取值為寫入（Write）、讀取（Read）或列出（List）。
資源類型：是指操作中支援授權的資源類型。具體說明如下：
- 對於必選的資源類型，用前面加 * 表示。
- 對於不支援資源級授權的操作，用全部資源表示。
條件關鍵字：是指雲產品自身定義的條件關鍵字。
關聯操作：是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權，操作才能成功。

操作

存取層級

資源類型

條件關鍵字

關聯操作

vpc:AllocateEipSegmentAddress

create

*SegmentAddress

acs:vpc:{#regionId}:{#accountId}:eip/*

無

請求參數

名稱	類型	必填	描述	樣本值
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	QuotaExceeded.Eip	Elastic IP address quota exceeded
400	InsufficientBalance	Your account does not have enough balance.
400	InvalidParameter	Specified value of "InternetChargeType" is not valid
400	ReserveIpFail	Reserve eip failed.
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	QuotaExceeded.LargeSpecEip	Elastic IP address with large spec quota exceeded.
400	InvalidResourceGroupId	The specified ResourceGroupId does not exist.	資源群組 ID 不存在。
400	OperationFailed.InsufficientEIP	Eip resource is not enough.
400	FrequentPurchase.EIP	eip frequent purchase
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	Forbidden	User not authorized to operate on the specified resource.
400	UnsupportedFeature.AllocateEipAddressWithZone	The feature of AllocateEipAddressWithZone is not supported.	目前地域不支援在指定可用區建立執行個體。
400	IllegalParam.Zone	The specified zone is invalid.	參數 Zone 非法。
400	Forbidden.AllocateEipSegmentAddress	Authentication is failed for allocating eip segment address.	申請連續 EIP 失敗，該服務已下線，請使用 IP 地址池服務。

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

變更歷史

更多資訊，參考變更詳情。