OpenAPI オペレーションを呼び出して NLB インスタンスのプライベート IP アドレスを指定する - Server Load Balancer

Network Load Balancer (NLB) インスタンスを作成する際には、OpenAPI Explorer を通じて CreateLoadBalancer API を呼び出し、各ゾーンマッピングで PrivateIPv4Address を指定することで、各 vSwitch の CIDR ブロックから割り当てられるプライベート IP アドレスを制御できます。

制限事項

IPv4 およびデュアルスタックの NLB インスタンスに対しては、プライベート IPv4 アドレスの指定が可能です。デュアルスタックインスタンスに対するプライベート IPv6 アドレスの指定はサポートされていません。
NLB インスタンスを作成する前に、各 vSwitch に最低 5 つの利用可能な IP アドレス（ヘルスチェック用が 4 つ、仮想 IP アドレスが 1 つ）が必要です。利用可能なアドレス数が 5 未満の場合、作成リクエストは失敗します。

重要

今後のスケーリングに対応できるよう、各 vSwitch には最低 8 つの IP アドレスを確保してください。

開始前に利用可能な IP アドレス数を確認するには：

DescribeZones を呼び出して、サポートされているゾーンを取得します。
DescribeVSwitches を呼び出して、vSwitch の ID および CIDR ブロックを取得します。

前提条件

開始する前に、以下の条件を満たしていることを確認してください。

異なるゾーンに少なくとも 2 つの vSwitch を含む VPC。各 vSwitch には、最低 5 つの利用可能な IP アドレスがあること
NLB インスタンスを展開するゾーンの VPC ID および vSwitch ID

プライベート IP アドレスの指定

OpenAPI Explorer — CreateLoadBalancer に移動します。

CreateLoadBalancer ページで、以下のパラメーターを設定します。この例では 中国 (杭州) リージョンを使用します。下記の表には、本タスクに関連するパラメーターのみを記載しています。その他のパラメーターについては、CreateLoadBalancer をご参照ください。

この例では、2 つのゾーンを構成します。

ゾーン J (ZoneMappings.1):

ZoneMappings.1.ZoneId: cn-hangzhou-j
ZoneMappings.1.VSwitchId: vsw-bp1gw3z8urk2a7n8j****
ZoneMappings.1.PrivateIPv4Address: 10.0.3.243

ゾーン K (ZoneMappings.0):

ZoneMappings.0.ZoneId: cn-hangzhou-k
ZoneMappings.0.VSwitchId: vsw-bp1af7hb3d7j6lv5f****
ZoneMappings.0.PrivateIPv4Address: 10.0.2.25

パラメーター	説明	例
`LoadBalancerType`	ロードバランサーのタイプ。NLB インスタンスを作成する場合は、`network` を指定します。	`network`
`LoadBalancerName`	NLB インスタンスの名前。	`NLB-test01`
`AddressType`	NLB インスタンスのアドレスタイプ。`Internet`: NLB インスタンスがパブリック IP アドレスを使用し、インターネット経由でアクセス可能。`Intranet`: NLB インスタンスがプライベート IP アドレスを使用し、VPC 内でのみアクセス可能。	`Intranet`
`AddressIpVersion`	IP バージョン。有効な値: `ipv4`（デフォルト）、`DualStack`。両方ともプライベート IPv4 アドレスの割り当てがサポートされます。	`ipv4`
`VpcId`	NLB インスタンスを展開する VPC の ID。VPC ID を取得するには、VPC コンソールVPC コンソールにログインし、中国 (杭州) リージョンを選択した後、VPCs ページで ID を確認します。	`vpc-bp18jb3fqfklxde2z****`
`ZoneMappings`	ゾーンと vSwitch のマッピング。最低 2 つのゾーンを指定する必要があります。以下のサブパラメーターをご参照ください。	—

ZoneMappings のサブパラメーター:

サブパラメーター	必須	説明	例
`ZoneId`	はい	ゾーン ID。DescribeZones を呼び出して有効なゾーン ID を取得します。	`cn-hangzhou-j`
`VSwitchId`	はい	VPC コンソールVPC コンソール該当ゾーン内の vSwitch ID。vSwitch ID を取得するには、VPC コンソールで VPC を開き、Resources タブをクリックします。	`vsw-bp1gw3z8urk2a7n8j****`
`PrivateIPv4Address`	いいえ	割り当てるプライベート IPv4 アドレス。vSwitch の CIDR ブロックに属し、かつ既に利用中でない必要があります。	`10.0.3.243`
`AllocationId`	いいえ	[インターネット向けインスタンスのみ] インスタンスに関連付ける弾力的 IP アドレス (EIP) の ID。	—

Initiate Call をクリックします。正常なリクエストでは、HTTP ステータスコード 200 が返され、以下のような応答が得られます。
```
{
  "RequestId": "22260859-BB7C-5102-8046-87953CAF920C",
  "HttpStatusCode": 200,
  "LoadbalancerId": "nlb-f1j2qxsnip8wzo****",
  "OrderId": 22208577321****,
  "Success": true
}
```
異なる HTTP ステータスコードが返された場合は、エラーメッセージを確認するか、HTTP 5xx エラーのトラブルシューティングをご参照ください。インスタンスが作成された後は、GetLoadBalancerAttribute を呼び出して、インスタンスのパラメーターを確認してください。

プライベート IP アドレスの確認

作成後に、NLB インスタンスが指定したアドレスを使用していることを確認します。

NLB コンソールにログインします。
上部のナビゲーションバーで、中国 (杭州) リージョンを選択します。
Instances ページで、対象のインスタンスを見つけ、その ID をクリックします。
Instance Details タブで、プライベート IP アドレスが 10.0.3.243 および 10.0.2.25 であることを確認します。

以下の図は、指定したプライベート IP アドレスを持つ NLB インスタンスを示しています。

NLB instance with specified private IP addresses

次のステップ

NLB コンソールを使用して NLB インスタンスを作成する: NLB インスタンスの作成と管理
Application Load Balancer (ALB) インスタンスにプライベート IP アドレスを指定する: OpenAPI Explorer を使用して ALB インスタンスを作成し、プライベート IP アドレスを割り当てる
クラシックロードバランサー (CLB) インスタンスのプライベート IP アドレスを指定する: OpenAPI Explorer を使用して VPC 内の CLB インスタンスを作成する際にプライベート IP アドレスを指定する

参考

OpenAPI を使用して ALB インスタンスを作成する際にプライベート IP アドレスを指定する