AssociateEipAddressBatch - Elastic IP Address - Alibaba Cloud ドキュメントセンター

同じリージョン内の複数の EIP をクラウドサービスインスタンスにバッチで関連付けます。

操作説明

AssociateEipAddressBatch は、複数の EIP をクラウドサービスインスタンスにバッチで関連付けます。この操作は、同じリージョン内のインターネット NAT Gateway インスタンスまたはセカンダリネットワークインターフェース (NIC) インスタンスへの EIP のバッチ添付ファイルのみをサポートします。他のクラウドサービスインスタンスに EIP を関連付けるには、 AssociateEipAddress を呼び出してください。
AssociateEipAddressBatch は非同期操作です。この操作を呼び出すと、システムはリクエスト ID を返しますが、EIP インスタンスはまだクラウドサービスインスタンスにアタッチされていません。添付ファイルタスクはバックグラウンドで実行され続けます。 DescribeEipAddresses を呼び出して、EIP インスタンスのステータスをクエリできます。
- EIP インスタンスが Associating 状態の場合、EIP インスタンスはアタッチ中です。この状態では、クエリ操作のみを実行できます。
- EIP インスタンスが InUse 状態の場合、EIP インスタンスはアタッチ済みです。
AssociateEipAddressBatch は、同じ EIP インスタンスのクラウドサービスインスタンスへの同時添付ファイルをサポートしていません。

今すぐお試しください

この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

テスト

RAM 認証

下表に、この API を呼び出すために必要な認証情報を示します。認証情報は、RAM (Resource Access Management) ポリシーを使用して定義できます。以下で各列名について説明します。

アクション：特定のリソースに対して実行可能な操作。ポリシー構文ではAction要素として指定します。
API：アクションを具体的に実行するための API。
アクセスレベル：各 API に対して事前定義されているアクセスの種類。有効な値：create、list、get、update、delete。
リソースタイプ：アクションが作用するリソースの種類。リソースレベルでの権限をサポートするかどうかを示すことができます。ポリシーの有効性を確保するため、アクションの対象として適切なリソースを指定してください。
- リソースレベルの権限を持つ API の場合、必要なリソースタイプはアスタリスク (*) でマークされます。ポリシーのResource要素で対応する ARN を指定してください。
- リソースレベルの権限を持たない API の場合、「すべてのリソース」と表示され、ポリシーのResource要素でアスタリスク (*) でマークされます。
条件キー：サービスによって定義された条件のキー。このキーにより、きめ細やかなアクセス制御が可能になります。この制御は、アクション単体に適用することも、特定のリソースに対するアクションに適用することもできます。Alibaba Cloud は、サービス固有の条件キーに加えて、すべての RAM 統合サービスに適用可能な一連の共通条件キーを提供しています。
依存アクション：ある特定のアクションを実行するために、前提として実行が必要となる他のアクション。依存アクションの権限も RAM ユーザーまたは RAM ロールに付与する必要があります。

アクション

アクセスレベル

リソースタイプ

条件キー

依存アクション

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 Gateway インスタンスまたはセカンダリネットワークインターフェース (NIC) インスタンスのインスタンス ID を指定できます。	ngw-hp3akk9irtd69jad****
BindedInstanceType	string	必須	EIP をアタッチするインスタンスのタイプ。有効な値: Nat: インターネット NAT Gateway。 NetworkInterface: セカンダリネットワークインターフェース (NIC)。	Nat
Mode	string	任意	関連付けモード。値を MULTI_BINDED に設定します。これは、マルチ EIP から ENI へのモードを指定します。このパラメーターは、InstanceType が NetworkInterface に設定されている場合にのみ必須です。	MULTI_BINDED
InstanceIds	array	必須	クラウドサービスインスタンスに関連付ける EIP のリスト。少なくとも 1 つの EIP を指定する必要があり、最大 50 個の EIP を指定できます。
	string	任意	クラウドサービスインスタンスに関連付ける EIP インスタンスの ID。少なくとも 1 つの EIP インスタンス ID を指定する必要があり、最大 50 個の EIP インスタンス ID を指定できます。	eip-2zeerraiwb7ujsxdc****
RegionId	string	必須	リクエストのべき等性を確保するために使用されるクライアントトークン。クライアントを使用してトークンを生成できますが、異なるリクエスト間でトークンが一意であることを確認する必要があります。トークンには ASCII 文字のみを含めることができます。説明このパラメーターを指定しない場合、システムは API リクエストの RequestId を ClientToken として自動的に使用します。RequestId は API リクエストごとに異なる場合があります。	cn-hangzhou
ClientToken	string	任意	リクエストのべき等性を保証するために使用されるクライアントトークンです。クライアント側でトークンを生成できますが、異なるリクエスト間でトークンが一意であることを保証する必要があります。トークンには ASCII 文字のみを使用できます。説明このパラメーターを指定しない場合、システムは自動的にリクエスト ID をクライアントトークンとして使用します。リクエスト ID は各リクエストごとに異なる場合があります。	02fb3da4-130e-11e9-8e44-0016e04115b

レスポンスフィールド

フィールド	型	説明	例
	object	応答パラメーター。
RequestId	string	リクエスト ID。	54B48E3D-DF70-471B-AA93-08E683A1B45

例

成功レスポンス

JSONJSON

{
  "RequestId": "54B48E3D-DF70-471B-AA93-08E683A1B45"
}

エラーコード

HTTP ステータスコード	エラーコード	エラーメッセージ	説明
400	InvalidAssociation.Duplicated	Specified instance already is associated.
400	OperationDenied	Specified instance is not in VPC.
400	InvalidParameter.Mismatch	Specified elastic IP address and ECS instance are not in the same region.
400	IncorrectEipStatus	Current elastic IP status does not support this operation
400	IncorrectInstanceStatus	Current instance status does not support this operation.
400	InvalidInstanceType.ValueNotSupported	The specified value of InstanceType is not supported.
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	Forbidden	The eip instance owener error	EIP が現在の呼び出し元に属していません。この EIP を使用する権限があるかどうかを確認してください。
400	TaskConflict	The eip operate too frequent, TaskConflict.	操作が頻繁すぎます。しばらく待ってからもう一度お試しください。
400	InvalidBindingStatus	The eip binding status invalid.
400	BIND_INSTANCE_HAVE_PORTMAP_OR_BIND_EIP	The instance may have portMap or already bind eip.	ECS インスタンスにポートフォワーディングルール (DNAT) が既に存在します。続行する前に対応するポートフォワーディングルールを転送先から削除してください。
400	EIP_CAN_NOT_ASSOCIATE_WITH_PUBLIC_IP	instance already bind natpublicip,cannot bind eip.
400	BIND_INSTANCE_OWENER_ERROR	Cannot operate the 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.
404	InvalidAllocationId.NotFound	Specified allocation ID is not found.
404	InvalidInstanId.NotFound	Specified instance does not exist.
404	Forbidden.RegionNotFound	Specified instance is not found during access authentication.	現在のリージョンはサポートされていません。
404	OperationDenied.VpcIpv4GatewayEnabled	The operation is not allowed because of the VPC of the NAT gateway has opened IPv4 Gateway.	NAT Gateway の VPC で IPv4 ゲートウェイがすでに有効になっているため、操作は許可されていません。

完全なリストについては、「エラーコード」をご参照ください。

変更履歴

完全なリストについては、「変更履歴」をご参照ください。