APIゲートウェイへの予約済パブリックIPv4アドレスの割当て
APIゲートウェイ・サービスを使用して、予約済パブリックIPv4アドレスをAPIゲートウェイに割り当てる方法を確認します。
パブリックIPv4単一スタックAPIゲートウェイまたはパブリックIPv4/IPv6デュアル・スタックAPIゲートウェイを作成する場合、APIゲートウェイに予約済パブリックIPv4アドレスを割り当てるように指定できます。予約済パブリックIPv4アドレスは、独自のOCIDを持つ個別のOCIリソースです。予約済パブリックIPv4アドレスをAPIゲートウェイに割り当てた後、APIゲートウェイを削除して新しいAPIゲートウェイに置き換えると、同じ予約済パブリックIPv4アドレスを再利用して新しいAPIゲートウェイに割り当てることができます。そのため、APIゲートウェイのIPアドレスが変更されていないため、既存のネットワーク構成をリライトする必要はありません。
新しいAPIゲートウェイを作成して予約済パブリックIPv4アドレスを割り当てる前に、適切な予約済パブリックIPv4アドレスがすでに存在している必要があります。予約済パブリックIPv4アドレスおよびその作成方法の詳細は、予約済IPv4アドレスを参照してください。
新しいAPIゲートウェイを作成する場合、APIゲートウェイ・リソースの属性を使用して、APIゲートウェイで予約済パブリックIPv4アドレスを使用することを指定します:
ipModeこの属性をIPV4またはDUAL_STACKに設定します。ipv4AddressConfiguration次のフィールドを使用して、この属性を使用して、新しいAPIゲートウェイの予約済パブリックIPv4アドレスを指定します。reservedIpIds: APIゲートウェイに使用する予約済パブリックIPv4アドレス・リソースのOCIDを指定します。
次に注意してください:
- 予約済パブリックIPv4アドレスのみがサポートされています。予約済パブリックIPv4アドレスは、パブリックIPv4対応APIゲートウェイにのみ割り当てることができます。予約済パブリックIPv4アドレスをプライベートAPIゲートウェイに割り当てることはできません。
- 予約済パブリックIPv4アドレスのないAPIゲートウェイを作成した後で、APIゲートウェイに予約済パブリックIPv4アドレスを割り当てることはできません。予約済パブリックIPv4アドレスは、APIゲートウェイの作成時にのみ指定できます。
予約済パブリックIPv4アドレスをAPIゲートウェイに割り当てるための前提条件
APIゲートウェイの作成に必要なIAM権限(manage virtual-network-family権限を含む)がすでにある場合、予約済パブリックIPv4アドレスをAPIゲートウェイに割り当てるための追加の権限は必要ありません。
予約済パブリックIPv4アドレスを使用したIPv4単一スタックAPIゲートウェイの作成
CLIまたはAPIを使用して、予約済パブリックIPv4アドレスを持つIPv4単一スタックAPIゲートウェイを作成できます(コンソールは使用できません)。
CLIを使用する場合、コマンド構文は次のとおりです。
oci api-gateway gateway create --display-name "<gateway-name>" --compartment-id "<compartment-ocid>" --endpoint-type "PUBLIC" --subnet-id "<subnet-ocid>" --ip-mode "IPV4" \
--ipv4-address-configuration '{"reservedIpIds":["<reserved-ip-ocid>"]}'たとえば、予約済パブリックIPv4アドレスを持つパブリックIPv4単一スタックAPIゲートウェイを作成するには:
oci api-gateway gateway create --display-name "my-ipv4-ss-apigw" --compartment-id "ocid1.compartment.oc1..aaaaaaaa7______ysq" --endpoint-type "PUBLIC" --subnet-id "ocid1.subnet.oc1.iad.aaaaaaaaz______rca" --ip-mode "IPV4" \
--ipv4-address-configuration '{"reservedIpIds":["ocid1.publicip.oc1.iad.aaaa______rb3a"]}'予約済パブリックIPv4アドレスを使用したIPv4/IPv6デュアル・スタックAPIゲートウェイの作成
CLIまたはAPIを使用して、予約済パブリックIPv4アドレスを持つIPv4/IPv6デュアル・スタックAPIゲートウェイを作成できます(コンソールは使用できません)。
CLIを使用する場合、コマンド構文は次のとおりです。
oci api-gateway gateway create --display-name "<gateway-name>" --compartment-id "<compartment-ocid>" --endpoint-type "PUBLIC" --subnet-id "<subnet-ocid>" --ip-mode "DUAL_STACK" \
--ipv4-address-configuration '{"reservedIpIds":["<reserved-ip-ocid>"]}' [OPTIONS]例:
-
予約済パブリックIPv4アドレスおよびエフェメラルIPv6アドレスを使用してパブリックIPv4/IPv6デュアル・スタックAPIゲートウェイを作成するには:
oci api-gateway gateway create --display-name "my-ds-apigw" --compartment-id "ocid1.compartment.oc1..aaaaaaaa7______ysq" --endpoint-type "PUBLIC" --subnet-id "ocid1.subnet.oc1.iad.aaaaaaaaz______rca" --ip-mode "DUAL_STACK" \ --ipv4-address-configuration '{"reservedIpIds":["ocid1.publicip.oc1.iad.aaaa______rb3a"]}' -
予約済パブリックIPv4アドレスおよび手動で指定されたIPv6アドレスを使用して、パブリックIPv4/IPv6デュアル・スタックAPIゲートウェイを作成するには:
oci api-gateway gateway create --display-name "my-ds-apigw" --compartment-id "ocid1.compartment.oc1..aaaaaaaa7______ysq" --endpoint-type "PUBLIC" --subnet-id "ocid1.subnet.oc1.iad.aaaaaaaaz______rca" --ip-mode "DUAL_STACK" \ --ipv4-address-configuration '{"reservedIpIds": ["ocid1.publicip.oc1.iad.aaaa______rb3a"]}' --ipv6-address-configuration '{"addresses":["2001:db8:abcd:1234::1"]}'