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

AssociateHaVip 操作を呼び出して、仮想非公開クラウド (VPC) 内の ECS インスタンスまたはネットワークインターフェイスコントローラー (NIC) に HaVip をアタッチします。

操作説明

この操作を呼び出して HaVip を関連付ける際は、以下の項目に注意してください:

HaVip はアタッチ後すぐに効果を発揮し、ECS インスタンスを再起動する必要はありません。ただし、ECS インスタンスの Elastic ネットワークインターフェイス (ENI) で HaVip を設定する必要があります。
HaVip と関連付ける ECS インスタンスは、同じ vSwitch に属している必要があります。
HaVip は、最大 10 個の ECS インスタンスまたは最大 10 個のネットワークインターフェイスコントローラー (NIC) に同時にアタッチできます。ただし、HaVip を ECS インスタンスとネットワークインターフェイスコントローラー (NIC) に同時に関連付けることはできません。
関連付ける ECS インスタンスは、Running または Stopped 状態である必要があります。
HaVip インスタンスは、Available または InUse 状態である必要があります。
AssociateHaVip 操作は非同期です。リクエストを送信すると、システムはリクエスト ID を返しますが、HaVip の関連付けはまだ完了していません。関連付けタスクはバックグラウンドで実行中です。 DescribeHaVips を呼び出して、HaVip の関連付けステータスをクエリできます:
- HaVip が Associating 状態の場合、HaVip は関連付け中です。
- HaVip が InUse 状態の場合、HaVip は関連付け済みです。
AssociateHaVip 操作は、同じ HaVip の同時関連付けをサポートしていません。

今すぐお試しください

この 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:AssociateHaVip

create

*Instance

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

*HaVip

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

なし

リクエストパラメーター

パラメーター	型	必須 / 任意	説明	例
ClientToken	string	任意	リクエストのべき等性を確保するために使用されるクライアントトークン。クライアントを使用してトークンを生成できますが、異なるリクエスト間でトークンが一意であることを確認する必要があります。ClientToken の値には ASCII 文字のみを含めることができます。説明このパラメーターを指定しない場合、システムは API リクエストの RequestId を ClientToken として自動的に使用します。各 API リクエストの RequestId は異なる場合があります。	0c593ea1-3bea-11e9-b96b-88e9fe63****
RegionId	string	必須	HaVip のリージョン ID。 DescribeRegions 操作を呼び出して、最新のリージョンリストをクエリできます。	cn-shanghai
HaVipId	string	必須	関連付ける HaVip の ID。	havip-2zeo05qre24nhrqpy****
InstanceId	string	必須	HaVip にアタッチする ECS インスタンスのインスタンス ID。	i-faf344422ffsfad****
InstanceType	string	任意	HaVip にアタッチするインスタンスのタイプ。有効な値: EcsInstance: ECS インスタンス。 NetworkInterface: ネットワークインターフェイスコントローラー (NIC) インスタンス。HaVip にアタッチするインスタンスがネットワークインターフェイスコントローラー (NIC) の場合、このパラメーターは必須です。	EcsInstance

レスポンスフィールド

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

例

成功レスポンス

JSONJSON

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

エラーコード

HTTP ステータスコード	エラーコード	エラーメッセージ
400	OperationUnsupported.BindOnFreeNetworkInterface	The network interface must be attached to an ECS instance.
400	OperationUnsupported.BindMultipleType	You cannot bind HaVip to multiple instance types.
400	OperationUnsupported.BindOnMultipleVswitch	The bound instance and HaVip must be on the same vSwitch.
400	InvalidVip.Status	vip invalid status
400	IncorrectHaVipStatus	HaVip can be operated by this action only when it's status is Available or InUse.
400	IncorrectInstanceStatus	ECS instance can be operated by this action only when it?s status is Running or Stopped.
400	CountLimitExceed.HaVipOnInstance	The amount of HaVip associated with the specified Instance reach its limits.
400	CountLimitExceeded.HaVipOnECSInstance	The amount of Instance associated with the specified HaVip reach its limits.
400	OperationFailed.DistibuteLock	Distibute lock fail.
400	InvalidNetworkInterfaceId.NotFound	The network interface is not found.
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	OperationUnsupported.BindOnSameEcs	You cannot bind two network interfaces on the same ECS instance.
400	OperationUnsupported.HavipBindType	You cannot bind HAVIP to network interface in the specified region.
400	InvalidInstance.NotExist	InvalidInstance.NotExist : The specified Instance does not exist in the specified region. i-bp136w25mhx503ptilrh\r\nRequestId : A961CC27-D797-4E16-B1B3-19B9ECBA1495
400	OperationDenied.BindOnSameEcs	The operation is not allowed because networkinterface bind on same instance.
400	Forbidden.HaVip	No permissions to perform operations on HAVIPs. Please apply for privilege--vpc_privilege_allow_buy_havip_instance.
400	InvalidInstanceId.NotFound	The specified Instance does not exist in the specified region.
400	ResourceNotFound.EcsInstance	The specified resource of ECS instance is not found.
400	InvalidStatus.NotAllow	Bind instance status invalid
400	InvalidHaVip.Exist	haVip already bind exist.
400	InvalidRegionId.NotFound	The RegionId provided does not exist in our records.
400	QuotaExceeded.HaVipBindInstance	The amount of instance associated with the specified haVip reach its limits.
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.

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

変更履歴

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