調用AssociateEipAddressBatch接口批量將彈性公網IP（Elastic IP Address，簡稱EIP）綁定到同地域的云產品實例上。
接口說明
- AssociateEipAddressBatch 用于批量綁定 EIP 到云產品實例，僅支持批量綁定 EIP 到同地域的 NAT 網關實例或輔助彈性網卡實例。EIP 綁定其他云產品實例，請參見 AssociateEipAddress 。
- AssociateEipAddressBatch 接口屬于異步接口，即系統會先返回一個請求 ID，但 EIP 實例與云產品實例并未批量綁定完成，系統后臺的綁定任務仍在進行。您可以調用 DescribeEipAddresses 查詢 EIP 實例的狀態：
- 當 EIP 實例處于 Associating 狀態時，表示 EIP 實例正在綁定中，在該狀態下，您只能執行查詢操作，不能執行其他操作。
- 當 EIP 實例處于 InUse 狀態時，表示 EIP 實例綁定完成。
- AssociateEipAddressBatch 接口不支持同一個 EIP 實例并發綁定云產品實例。
調試
您可以在OpenAPI Explorer中直接運行該接口，免去您計算簽名的困擾。運行成功后，OpenAPI Explorer可以自動生成SDK代碼示例。
授權信息
下表是API對應的授權信息，可以在RAM權限策略語句的Action元素中使用，用來給RAM用戶或RAM角色授予調用此API的權限。具體說明如下：
- 操作：是指具體的權限點。
- 訪問級別：是指每個操作的訪問級別，取值為寫入（Write）、讀取（Read）或列出（List）。
- 資源類型：是指操作中支持授權的資源類型。具體說明如下：
- 對于必選的資源類型，用背景高亮的方式表示。
- 對于不支持資源級授權的操作，用
全部資源表示。
- 條件關鍵字：是指云產品自身定義的條件關鍵字。
- 關聯操作：是指成功執行操作所需要的其他權限。操作者必須同時具備關聯操作的權限，操作才能成功。
| 操作 | 訪問級別 | 資源類型 | 條件關鍵字 | 關聯操作 |
|---|---|---|---|---|
| vpc:AssociateEipAddressBatch | update | *Address acs:vpc:{#regionId}:{#accountId}:eip/{#AllocationId}*Instance acs:vpc:{#regionId}:{#accountId}:instance/{#InstanceId}*NatGateway acs:vpc:{#regionId}:{#accountId}:natgateway/{#NatGatewayId} |
| 無 |
請求參數
| 名稱 | 類型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| RegionId | string | 是 | 要綁定云產品實例的 EIP 所在的地域 ID。 您可以通過調用 DescribeRegions 接口獲取地域 ID。 | cn-hangzhou |
| BindedInstanceId | string | 是 | 要綁定 EIP 的云產品實例 ID。 支持輸入 NAT 網關實例 ID、輔助彈性網卡實例 ID。 | ngw-hp3akk9irtd69jad**** |
| BindedInstanceType | string | 是 | 要綁定 EIP 的實例的類型，取值：
| Nat |
| Mode | string | 否 | 綁定模式，僅取值為MULTI_BINDED，表示多 EIP 網卡可見模式。 僅 InstanceType 配置為 NetworkInterface 時，才需要配置該參數。 | MULTI_BINDED |
| InstanceIds | array | 是 | 需要與云產品實例綁定的 EIP 列表。 需至少輸入 1 個 EIP，最多支持輸入 50 個 EIP。 | |
| string | 是 | 需要與云產品實例綁定的 EIP 實例 ID。 需至少輸入 1 個 EIP 實例的 ID，最多支持輸入 50 個 EIP 實例的 ID。 | eip-2zeerraiwb7ujsxdc**** | |
| ClientToken | string | 否 | 客戶端 Token，用于保證請求的冪等性。 從您的客戶端生成一個參數值，確保不同請求間該參數值唯一。ClientToken 只支持 ASCII 字符。 說明
若您未指定，則系統自動使用 API 請求的 RequestId 作為 ClientToken 標識。每次 API 請求的 RequestId 不一樣。
| 02fb3da4-130e-11e9-8e44-0016e04115b |
返回參數
示例
正常返回示例
JSON格式
{
"RequestId": "54B48E3D-DF70-471B-AA93-08E683A1B45"
}錯誤碼
| HTTP status code | 錯誤碼 | 錯誤信息 | 描述 |
|---|---|---|---|
| 400 | InvalidAssociation.Duplicated | Specified instance already is associated. | 該實例已綁定EIP或全球加速實例，不能再綁定，如需更換實例綁定的EIP或全球加速實例，請先解綁。 |
| 400 | OperationDenied | Specified instance is not in VPC. | 該實例在VPC中不存在。 |
| 400 | InvalidParameter.Mismatch | Specified elastic IP address and ECS instance are not in the same region. | 該EIP和ECS實例不在同一個地域內。 |
| 400 | IncorrectEipStatus | Current elastic IP status does not support this operation | 當前EIP的狀態不支持該操作。 |
| 400 | IncorrectInstanceStatus | Current instance status does not support this operation. | 當前實例的狀態不支持該操作。 |
| 400 | InvalidInstanceType.ValueNotSupported | The specified value of InstanceType is not supported. | 參數InstanceType的值不合法。 |
| 400 | IncorrectHaVipStatus | HaVip can be operated by this action only when it's status is Available or InUse. | Havip實例為Available或InUse才允許操作 |
| 400 | InvalidParameter | The specified parameter is not valid. | 該參數值不合法。 |
| 400 | OperationDenied | Eip of default vpc not allow this operation | 默認專有網絡的EIP不支持該操作。 |
| 400 | Forbidden | The eip instance owener error | EIP 不屬于當前調用者，請您檢查該 EIP 是否可被您調用。 |
| 400 | TaskConflict | The eip operate too frequent, TaskConflict. | 操作過于頻繁，任務沖突。 |
| 400 | InvalidBindingStatus | The eip binding status invalid. | EIP綁定狀態不正確。 |
| 400 | BIND_INSTANCE_HAVE_PORTMAP_OR_BIND_EIP | The instance may have portMap or already bind eip. | ECS 實例已經存在端口轉發規則，請刪除相應的端口轉發規則再進行操作。 |
| 400 | EIP_CAN_NOT_ASSOCIATE_WITH_PUBLIC_IP | instance already bind natpublicip,cannot bind eip. | - |
| 400 | BIND_INSTANCE_OWENER_ERROR | Cannot operate the eip. | 不能操作這個EIP。 |
| 400 | NATGATEWAY_FINANCIALLOCKED | The NatGateway has expire, cannot do bind operation. | - |
| 400 | InvalidParameter.InstanceTypeNotSupport | The specified instance type is not support. | - |
| 400 | QuotaExceeded.NumberOfTrafficEip | The number of traffic eip on natgw exceed limitation. | - |
| 400 | QuotaExceeded.NumberOfEip | Binded eip Quota exceed on this NatGw. | 此NAT網關上，綁定的EIP數量已經超出配額限制 |
| 400 | InvalidEipBandwidth.OutOfMaxValue | The Eip Bandwidth is invalid. | - |
| 400 | Forbidden.EipCanNotBindGatgw | Eip can not bind on natgw. | - |
| 400 | InvalidAction.Denied | Action is denied due to unfinished Eip configuration modification. | 由于未完成Eip配置修改，操作被拒絕。 |
| 400 | InstanceType.NotSupport | The instance type is invalid. | - |
| 400 | InvalidParams.NotFound | instance not found | 實例不存在。 |
| 400 | BindInstance.NotSupported | bind instance type %s is not supported. | - |
| 400 | Forbidden.InstanceBandwidthNotZero | Eip can not bind with instance when it's bandwidth is not zero. | - |
| 400 | INSTANCE_TYPE_NOT_SUPPORT | The instance type is invalid. | - |
| 400 | ServerRegion.Invalid | Eip bind remote server region invalid. | - |
| 400 | Eni.Attached | The eni should be detached from ecs when associating with direct eip. | 當ENI綁定直通EIP時，需要ENI與ECS解綁 |
| 400 | Invalid.DirectEip.BindType | The direct eip can be only associated with eni. | - |
| 400 | Invalid.Function.NotSupported | Multi-IP function is under test, the region or uid is not supported. | - |
| 400 | InvalidStatus.EniStatusNotSupport | %s | - |
| 400 | InvalidParameter.EniInstanceId | %s | - |
| 400 | %s | %s | - |
| 400 | EipBatchBind.TypeNotSupport | eip batch bind type not support | - |
| 400 | OperationFailed.RegionNotMatch | The specified eip is not in this region | - |
| 400 | InvalidEIPStatus.BizDisabled | The EIP has been locked. | EIP實例被鎖定 |
| 400 | Forbidden.FinancialLocked | The ip business status is invalid. | 該實例已欠費鎖定，無法操作 |
| 400 | OperationDenied.Unauthorized | The operation is not allowed because the user is not in the whitelist. | 此操作不被允許，用戶不在白名單。 |
| 400 | OperationDenied.UnsupportedEipBindMode | The operation is not supported for the NAT gateway due to its EIP binding mode. | 此NAT網關的EIP綁定類型不支持此操作。 |
| 400 | OperationDenied.Ipv4GatewayExist | The operation is not allowed because of Ipv4GatewayExist. | EIP綁定操作失敗，因為此VPC下存在Ipv4網關 |
| 404 | InvalidAllocationId.NotFound | Specified allocation ID is not found. | 指定的公網 IP 不存在，請您檢查填寫的公網 IP 是否正確。 |
| 404 | InvalidInstanId.NotFound | Specified instance does not exist. | 指定的實例不存在，請您檢查該實例是否正確。 |
| 404 | InvalidRegionId.NotFound | Specified value of InstanceRegionId is not supported. | - |
| 404 | InvalidAllocationId.NotFound | Specified allocation ID is not found | 指定的公網IP不存在，請您檢查您填寫的參數是否正確。 |
| 404 | Forbidden.RegionNotFound | Specified instance is not found during access authentication. | 當前Region不支持 |
| 404 | OperationDenied.VpcIpv4GatewayEnabled | The operation is not allowed because of the VPC of the NAT gateway has opened IPv4 Gateway. | 不允許操作，因為NAT網關的VPC已經開啟IPv4網關 |
訪問錯誤中心查看更多錯誤碼。
變更歷史
| 變更時間 | 變更內容概要 | 操作 |
|---|---|---|
| 2023-09-21 | OpenAPI 描述信息更新、OpenAPI 去除了 deprecated 標記、OpenAPI 錯誤碼發生變更 | 查看變更詳情 |
| 2023-06-26 | OpenAPI 錯誤碼發生變更 | 查看變更詳情 |
| 2023-05-15 | OpenAPI 錯誤碼發生變更 | 查看變更詳情 |
| 2023-03-23 | OpenAPI 錯誤碼發生變更 | 查看變更詳情 |