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

EIP を同じリージョンのクラウドリソースインスタンスに関連付けます。

操作説明

EIP は、同じリージョン内の VPC タイプの ECS インスタンス、VPC タイプの CLB インスタンス、セカンダリネットワークインターフェース (ENI)、インターネット NAT ゲートウェイ、または高可用性仮想 IP アドレス (HAVIP) に関連付けることができます。
AssociateEipAddress 操作は非同期です。リクエストを送信すると、システムはリクエスト ID を返しますが、EIP とクラウドリソースインスタンスの関連付けはまだ完了していません。関連付けタスクはバックグラウンドで引き続き実行されます。 DescribeEipAddresses を呼び出して EIP のステータスをクエリできます。
- EIP が Associating 状態の場合、EIP は関連付け中です。この状態では、クエリ操作のみを実行できます。
- EIP が InUse 状態の場合、EIP は関連付けられています。
AssociateEipAddress 操作は、同じ 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:AssociateEipAddress

update

*Address

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

NatGateway

acs:vpc:{#regionId}:{#accountId}:natgateway/{#NatGatewayId}

Instance

acs:vpc:{#regionId}:{#accountId}:instance/{#InstanceId}

Association

acs:vpc:{#regionId}:{#accountId}:havip/{#HaVipId}

なし

リクエストパラメーター

パラメーター	型	必須 / 任意	説明	例
RegionId	string	任意	クラウドリソースインスタンスに関連付ける EIP のリージョン ID。 DescribeRegions 操作を呼び出してリージョン ID をクエリできます。	cn-hangzhou
AllocationId	string	必須	クラウドリソースインスタンスに関連付ける EIP の ID。	eip-2zeerraiwb7ujsxdc****
InstanceId	string	必須	EIP に関連付けるインスタンスの ID。インターネット NAT ゲートウェイ、Classic Load Balancer (CLB) インスタンス、ECS インスタンス、セカンダリネットワークインターフェース (ENI)、高可用性仮想 IP アドレス (HAVIP)、または IP アドレスの ID を入力できます。	i-2zebb08phyczzawe****
InstanceType	string	任意	EIP に関連付けるサービスのタイプ。有効な値: Nat: インターネット NAT ゲートウェイ。 SlbInstance: Classic Load Balancer (CLB)。 EcsInstance (デフォルト): Elastic Compute Service (ECS)。 NetworkInterface: セカンダリネットワークインターフェース (ENI)。 HaVip: 高可用性仮想 IP アドレス。 IpAddress: IP アドレス。説明デフォルトのインスタンスタイプは EcsInstance です。インスタンスタイプが EcsInstance でない場合、このパラメーターは必須です。	EcsInstance
InstanceRegionId	string	任意	EIP に関連付けるインスタンスのリージョン ID。説明このパラメーターは、EIP が共有帯域幅の Alibaba Cloud Global Accelerator (GA) インスタンスに追加された後にのみ必須となります。	cn-hangzhou
PrivateIpAddress	string	任意	vSwitch CIDR ブロック内の IP アドレス。このパラメーターを指定しない場合、システムは VPC ID と vSwitch ID に基づいて非公開 IP アドレスを自動的に割り当てます。説明 InstanceType が NetworkInterface にセットされている場合、このパラメーターは必須です。関連付ける非公開 IP アドレスを入力してください。	192.168.XX.XX
Mode	string	任意	関連付けモード。有効な値: NAT (デフォルト): 一般モード (標準モード)。 MULTI_BINDED: マルチ EIP から ENI へのモード。 BINDED: EIP から ENI へのモード。説明このパラメーターは、InstanceType が NetworkInterface にセットされている場合にのみ必須です。	NAT
VpcId	string	任意	IPv4 ゲートウェイ特徴が有効になっており、EIP と同じリージョンにある VPC の ID。 EIP が IP アドレスに関連付けられている場合、システムはこの VPC のルーティング構成を使用して、関連付けられた IP アドレスのパブリックネットワークアクセスを有効にします。説明このパラメーターは、InstanceType が IpAddress にセットされている場合に必須です。	vpc-257gqcdfvx6n****
ClientToken	string	任意	リクエストのべき等性を確保するために使用されるクライアントトークン。クライアントを使用してトークンを生成できますが、異なるリクエスト間でトークンが一意であることを確認する必要があります。トークンには ASCII 文字のみを含めることができます。説明このパラメーターを指定しない場合、システムは API リクエストの RequestId を ClientToken として自動的に使用します。RequestId は API リクエストごとに異なる場合があります。	0c593ea1-3bea-11e9-b96b-88e9fe63****

レスポンスフィールド

フィールド	型	説明	例
	object	レスポンスパラメーター。
RequestId	string	リクエスト ID。	0ED8D006-F706-4D23-88ED-E11ED28DCAC0

例

成功レスポンス

JSONJSON

{
  "RequestId": "0ED8D006-F706-4D23-88ED-E11ED28DCAC0"
}

エラーコード

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	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	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	Eni.HasSubIp	Eni has sub ip can not bind direct eip.
400	Invalid.DirectEip.BindType	The direct eip can be only associated with eni.
400	InvalidStatus.EcsStatusNotSupport	The special instance status is not support operate
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	InvalidNexthop.DirectEni	The direct Eni cannot be nexthop.	パススルー ENI をネクストホップとして使用することはできません。
400	Mode.Conflict	The eni can bind only one mode of eip.
400	Mode.NotSupport	The user cannot use multi direct eip.
400	QuotaExceed.MultiBindedEip	The number of multi binded eip is over limit.	マルチ EIP から ENI モードで関連付け可能な EIP の数が制限を超えています。
400	InvalidEIPStatus.BizDisabled	The EIP has been locked.	EIP インスタンスがロック済みです。
400	OperationFailed.EniSubIp	Eni has sub ip can not bind direct eip.
400	InvalidEip.EipQuotaExceeded	The specified eni assigned eip is more than privateIp.
400	OperationUnsupported.MultiIp	Multi ip function is not support.
400	InvalidNicOrVm.NotFound	Bind nic or vm not exist.	関連付けるために指定された ENI または VM が存在しません。
400	OperationUnsupported.EipBindModel	The instance type of ecs does not support MULTI_BINDED model Eip.
400	IncorrectStatus.NatGateway	%s
400	EipBindRemote.BackendRegionMustBeSingle	eip bind remote instance, backend region must be single
400	InvalidParameter.BindingInstanceRegion	The specified BindingInstanceRegion is not supported.
400	OperationFailed.HavipBoundPortmap	%s
400	IllegalParam.Mode	%s
400	InvalidStatus.NotAllow	Bind instance status invalid	アタッチされたインスタンスのインスタンスステータスが無効です。
400	InvalidInstance.NotExist	Bind instance data not exist
400	InvalidBandwidthPackageId.NotFound	The specified BandwidthPackageId not exist.
400	InvalidStatus.InstanceHasBandWidth	The specified instance bandwidth invalid.
400	OperationDenied.CloudBoxResourceExist	The operation is not allowed because there are resources related to the cloud box in VPC.	VPC に CloudBox 関連のリソースが含まれているため、操作は禁止されています。
400	OperationDenied.CloudBoxVSwitchExist	The operation is not allowed because a cloud box type vSwitch exists in VPC.	VPC に CloudBox タイプの vSwitch が含まれているため、操作は禁止されています。
400	OperationDenied.NoAvailablePrivateIp	The operation is failed because of vSwitch has not availalbe private ip	現在の vSwitch に利用可能な非公開 IP アドレスが不足しています。
400	ResourceAlreadyAssociated.IpAddress	%s
400	OperationFailed.Ipv4GatewayNotOpenedInVpc	The operation is failed because Ipv4Gateway is not opened in Vpc.	この VPC で IPv4 ゲートウェイが有効になっていないため、EIP を IP アドレスに関連付けられませんでした。
400	OperationFailed.Ipv4GatewayNotActivatedInVpc	The operation is failed because Ipv4Gateway is not activated in Vpc.
400	OperationDenied.L2EipBindIpAddress	%s
400	Forbidden	The eip instance owner error	EIP が現在の呼び出し元に属していません。この EIP を使用する権限があるかどうかを確認してください。
400	Forbidden.FinancialLocked	The ip business status is invalid.	ルーターインターフェイスに支払い遅延がある場合、この操作は実行できません。
400	UnsupportedFeature.EipBindIpAddress	The feature of EipBindIpAddress is not supported.	EIP を IP アドレスにバインドすることはサポートされていません。
400	OperationFailed.InstanceNotExist	The ECS instance does not exist, or is not a VPC VM.	ECS インスタンスが存在しないか、VPC インスタンスではないため、EIP を ECS インスタンスに関連付けられませんでした。
400	OperationDenied.Ipv4GatewayExist	The operation is not allowed because of Ipv4GatewayExist.
400	OperationFailed.EipBindModeConflict	Eips can not bind Eni with NAT mode and MULTI_BINDED mode at the same time.
400	OperationFailed.EcsMigrating	The operation is failed because of ECS is migrating.
400	OperationFailed.IpPrefixConflict	The operation failed due to the IP prefix of the ENI.	現在の操作がネットワークインターフェースの IP プレフィックスと競合しています。
400	UnsupportedFeature.EipBindPrefixIp	The feature of EipBindPrefixIp is not supported.	現在のリージョンでは、EIP を PrefixIp にバインドすることはサポートされていません。
400	OperationDenied.UnsupportedEipBindMode	The operation is not supported for the NAT gateway due to its EIP binding mode.	この NAT ゲートウェイの EIP バインドタイプはこの操作をサポートしていません。
400	OperationDenied.Unauthorized	The operation is not allowed because the user is not in the whitelist.	ユーザーがホワイトリストに登録されていないため、操作は許可されていません。
400	OperationFailed.SystemBusy	Operation failed because system is busy.	システムがビジーです。後でもう一度お試しください。
400	OperationFailed.PrivateIpAddressNotExist	The operation failed because the PrivateIpAddress is not found.	指定された非公開 IP アドレスが存在しません。
400	IllegalParamFormat.%s	The param format of %s is illegal.	パラメーターモードが無効です。
400	MissingParam.InstanceId	The param of InstanceId can't be null or empty.	InstanceId パラメーターは空にできません。
400	InvalidEniType.SlaveEni	The eni type cannot be slave eni.	ネットワークインターフェイスタイプをセカンダリ ENI にすることはできません。
400	IllegalParam.PrivateIpAddress	The specified PrivateIpAddress is illegal.	指定された PrivateIpAddress が無効です。パラメーターの制約を確認し、修正後に再試行してください。
400	OperationFailed.Ipv4GatewayNotAssociatedWithGatewayRouteTable	The operation failed because the specified IPv4 gateway of the VPC is not associated with any gateway route table.	EIP に関連付けられた IP アドレスに対応する VPC IPv4 ゲートウェイが、ゲートウェイルートテーブルに関連付けられていません。
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 ゲートウェイがすでに有効になっているため、操作は許可されていません。

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

変更履歴

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