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

EIP をクラウドリソースから関連付け解除します。

操作説明

UnassociateEipAddress 操作は非同期です。この操作を呼び出すと、システムはリクエスト ID を返しますが、EIP はすぐには関連付け解除されません。関連付け解除タスクはバックグラウンドで実行されます。 DescribeEipAddresses を呼び出して EIP のステータスを照会できます。
- EIP が Unassociating 状態の場合、EIP は関連付け解除中です。この状態では、クエリ操作のみを実行できます。
- EIP が Available 状態の場合、EIP は関連付け解除されています。
UnassociateEipAddress 操作では、同じ 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:UnassociateEipAddress

delete

Instance

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

*Address

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

HaVip

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

なし

リクエストパラメーター

パラメーター	型	必須 / 任意	説明	例
Force	boolean	任意	EIP が DNAT エントリまたは SNAT エントリが設定された NAT Gateway に関連付けられている場合に、EIP を強制的に関連付け解除するかどうかを指定します。有効な値: false (デフォルト): EIP を強制的に関連付け解除しません。 true: EIP を強制的に関連付け解除します。	false
RegionId	string	任意	関連付け解除する EIP のリージョン ID。 DescribeRegions を呼び出してリージョン ID をクエリできます。	cn-hangzhou
AllocationId	string	必須	関連付け解除する EIP の ID。	eip-2zeerraiwb7uj6i0d****
InstanceId	string	任意	EIP の関連付けを解除するクラウドリソースインスタンスの ID。 NAT Gateway、Classic Load Balancer (CLB) インスタンス、ECS インスタンス、セカンダリネットワークインターフェースコントローラー (NIC) インスタンス、高可用性仮想 IP アドレスインスタンス、または IP アドレスのインスタンス ID を入力できます。	i-hp3akk9irtd69jad****
InstanceType	string	任意	EIP の関連付けを解除するクラウドリソースのタイプ。有効な値: EcsInstance (デフォルト): 非公開仮想クラウド (VPC) 内の ECS インスタンス。 SlbInstance: 非公開仮想クラウド (VPC) 内の SLB インスタンス。 NetworkInterface: 非公開仮想クラウド (VPC) 内のセカンダリネットワークインターフェースコントローラー (NIC)。 Nat: NAT Gateway。 HaVip: 高可用性仮想 IP アドレス。 IpAddress: IP アドレス。	EcsInstance
PrivateIpAddress	string	任意	EIP の関連付けを解除する ECS インスタンスまたはセカンダリネットワークインターフェースコントローラー (NIC) インスタンスの非公開 IP アドレス。	192.XX.XX.2
ClientToken	string	任意	リクエストのべき等性を確保するために使用されるクライアントトークン。クライアントを使用してトークンを生成できますが、異なるリクエスト間でトークンが一意であることを確認する必要があります。トークンには ASCII 文字のみを含めることができます。説明このパラメーターを指定しない場合、システムは自動的に RequestId を ClientToken として使用します。RequestId は API 呼び出しごとに異なる場合があります。	02fb3da4-130e-11****

レスポンスフィールド

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

例

成功レスポンス

JSONJSON

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

エラーコード

HTTP ステータスコード	エラーコード	エラーメッセージ	説明
400	IncorrectEipStatus	Current elastic IP status does not support this operation.
400	InvalidInstanceId.NotFound	Specified instance does not exist.
400	IncorrectInstanceStatus	The current status of instance does not support this operation.
400	InvalidInstanceType.ValueNotSupported	The specified value of InstanceType is not supported.
400	IncorrectHaVipStatus	This operation is denied because satus of the specified HaVip is neither Available nor InUse.	この操作は、HaVip インスタンスが Available または InUse 状態の場合にのみ許可されます。
400	OperationDenied	Eip of default vpc not allow this operation
400	InvalidParameter	The specified parameter is not valid.
400	TaskConflict	The eip operate too frequent, TaskConflict.	操作が頻繁すぎます。しばらく待ってからもう一度お試しください。
400	InvalidBindingStatus	The eip binding status invalid.
400	Forbidden.FinancialLocked	The ip business status is invalid.	ルーターインターフェイスに支払い遅延がある場合、この操作は実行できません。
400	InvalidIpStatus.HasBeenUsedBySnatTable	The removed ip address has been used by snat table.
400	InvalidIpStatus.HasBeenUsedByForwardEntry	The specified address has been used by forwardTable.
400	Eni.Attached	The eni should be detached from ecs when associating with direct eip.	ENI がカットスルーモードで EIP に関連付けられている場合、ENI を ECS インスタンスから関連付け解除する必要があります。
400	InvalidEIPStatus.BizDisabled	The EIP has been locked.	EIP インスタンスがロック済みです。
400	InvalidStatus.EcsStatusNotSupport	The special instance status Pending is not support operate	インスタンスが Suspended 状態のため、この操作はサポートされていません。
400	InvalidStatus.EniStatusNotSupport	%s
400	InvalidStatus.SnatOrDnat	Operation failed because snat or dnat in unstable status.	SNAT または DNAT エントリの状態が不安定なため、EIP の関連付けを解除できませんでした。
400	DependencyViolation.SnatEntry	The specified eip is in ip pool.
400	%s	%s
400	InvalidStatus.NotAllow	Bind instance status invalid	アタッチされたインスタンスのインスタンスステータスが無効です。
400	Forbidden	The eip instance owener error	EIP が現在の呼び出し元に属していません。この EIP を使用する権限があるかどうかを確認してください。
400	InvalidLoadBalancerId.NotFound	LoadBalancerId does not exist.	指定されたロード ID が存在しません。
400	OperationFailed.SystemBusy	Operation failed because system is busy.	システムがビジーです。後でもう一度お試しください。
404	InvalidAllocationId.NotFound	Specified allocation ID is not found	指定されたパブリック IP アドレスが存在しません。指定されたパラメーターが正しいかどうかを確認してください。
404	InvalidBindInstance.NotFound	The specified bind instance does not exist.

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

変更履歴

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