UnassociateHaVip - Virtual Private Cloud - Alibaba Cloud ドキュメントセンター

高可用性仮想 IP アドレス (HaVip) を、Virtual Private Cloud (VPC) 内の Elastic Compute Service (ECS) インスタンスまたは Elastic Network Interface (ENI) から関連付け解除します。

操作説明

本 API を呼び出して HaVip を VPC 内の ECS インスタンスまたは ENI から関連付け解除する際は、以下の点にご注意ください。

関連付けを解除する ECS インスタンスのステータスは、実行中または停止済みである必要があります。
関連付けを解除する HaVip のステータスは、Available または InUse である必要があります。
UnassociateHaVip API は非同期インターフェイスです。つまり、システムはリクエスト ID を返しますが、その時点では HaVip の関連付けはまだ解除されておらず、バックグラウンドで関連付け解除処理が継続中です。DescribeHaVips を呼び出して HaVip の関連付け解除ステータスを確認できます。
- HaVip のステータスが Unassociating の場合、HaVip が関連付け解除中の状態です。
- HaVip のステータスが InUse または Available の場合、HaVip の関連付けが正常に解除されたことを示します。
UnassociateHaVip API は、同一の HaVip に対して並列で関連付け解除操作を実行することをサポートしていません。

今すぐお試しください

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

テスト

RAM 認証

この操作の認証情報はありません。問題が発生した場合は、アカウントマネージャーにご連絡ください。

リクエストパラメーター

パラメーター	型	必須 / 任意	説明	例
ClientToken	string	任意	リクエストのべき等性を保証するために使用されるクライアントトークンです。クライアント側でトークンを生成できますが、異なるリクエスト間で一意となるようにしてください。`token` には ASCII 文字のみを使用でき、長さは 64 文字以内である必要があります。	0c593ea1-3bea-11e9-b96b-88e9fe63****
RegionId	string	必須	HaVip のリージョン ID です。最新のリージョンリストは、DescribeRegions 操作を呼び出して確認できます。	cn-shanghai
HaVipId	string	必須	関連付けを解除する HaVip の ID です。	havip-2zeo05qre24nhrqpy****
InstanceId	string	必須	HaVip の関連付けを解除する対象となる ECS インスタンスまたは ENI の ID です。	i-faf344422ffsfad****
Force	string	任意	ECS インスタンスまたは ENI から HaVip を強制的に関連付け解除するかどうかを指定します。有効値： True False (デフォルト) 説明 False を指定した場合、プライマリインスタンスから HaVip を関連付け解除することはできません。	True
InstanceType	string	任意	HaVip の関連付けを解除する対象のインスタンスタイプです。有効値： EcsInstance: ECS インスタンス NetworkInterface: ENI 説明 ENI から HaVip を関連付け解除する場合は、このパラメーターが必須です。	EcsInstance

レスポンスフィールド

フィールド	型	説明	例
	object
RequestId	string	リクエスト ID です。	C44F62BE-9CE7-4277-B117-69243F3988BF

例

成功レスポンス

JSONJSON

{
  "RequestId": "C44F62BE-9CE7-4277-B117-69243F3988BF"
}

エラーコード

HTTP ステータスコード	エラーコード	エラーメッセージ
400	IncorrectHaVipStatus	HaVip can be operated by this action only when it's status is InUse.
400	IncorrectInstanceStatus	ECS instance can be operated by this action only when it's status is Running or Stopped.
400	ResourceNotAssociated	The HaVip and ECS instance are not associated.
400	Forbidden.UnassociateMaster	Unassociating a master instance is not allowed unless the parameter Force is True.
400	HA.VIP.NOT.ASSOCIATED.WITH.INSTANCE	ha vip not associated with instance.
400	OperationFailed.DistibuteLock	Distibute lock fail.
400	OperationFailed.QueryNetworkInterfaceInfo	Failed to query network interface information.
400	IllegalParam.InstanceType	The specified instance type is invalid. Only ECS instances and network interface are allowed.
400	InvalidNetworkInterfaceId.NotFound	The network interface is not found.
400	ResourceNotFound.Instance	The specified binding resource is not found.
400	Forbidden.HaVip	No permissions to perform operations on HAVIPs. Please apply for privilege--vpc_privilege_allow_buy_havip_instance.
400	InvalidRegionId.NotFound	The RegionId provided does not exist in our records.
500	InternalError	The request processing has failed due to some unknown error.
404	InvalidHaVipId.NotFound	The specified HaVip does not exist in the specified region.
404	InvalidInstanceId.NotFound	The specified Instance does not exist in the specified region.

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

変更履歴

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