Documentación de Oracle Cloud Infrastructure

Asignación de direcciones IPv4 públicas reservadas a gateways de API

Descubra cómo asignar direcciones IPv4 públicas reservadas a gateways de API con el servicio API Gateway.

Al crear un gateway de API de pila única IPv4 público o un gateway de API de pila doble IPv4/IPv6 público, puede especificar que al gateway de API se le asigne una dirección IPv4 pública reservada. Una dirección IPv4 pública reservada es un recurso de OCI independiente con su propio OCID. Una vez asignada una dirección IPv4 pública reservada a un gateway de API, si posteriormente suprime el gateway de API y lo sustituye por un nuevo gateway de API, puede volver a utilizar la misma dirección IPv4 pública reservada y asignarla al nuevo gateway de API. Como resultado, no tiene que reescribir ninguna configuración de red existente, ya que la dirección IP del gateway de API no ha cambiado.

Para poder crear un nuevo gateway de API y asignarle una dirección IPv4 pública reservada, ya debe existir una dirección IPv4 pública reservada adecuada. Para obtener más información sobre las direcciones IPv4 públicas reservadas y cómo crearlas, consulte Direcciones IPv4 reservadas.

Al crear un nuevo gateway de API, utilice atributos del recurso de gateway de API para especificar que el gateway de API debe utilizar una dirección IPv4 pública reservada:

  • ipMode Defina este atributo en IPV4 o DUAL_STACK.
  • ipv4AddressConfiguration Utilice este atributo para especificar la dirección IPv4 pública reservada para el nuevo gateway de API, mediante el siguiente campo:
    • reservedIpIds: especifique el OCID de un recurso de dirección IPv4 público reservado que se utilizará para el gateway de API.

Tenga en cuenta que:

  • Solo están soportadas las direcciones IPv4 públicas reservadas. Solo puede asignar direcciones IPv4 públicas reservadas a gateways de API activados para IPv4 públicos. No puede asignar direcciones IPv4 públicas reservadas a gateways de API privados.
  • Una vez creado un gateway de API sin una dirección IPv4 pública reservada, no puede asignar posteriormente al gateway de API una dirección IPv4 pública reservada. Solo puede especificar una dirección IPv4 pública reservada al crear un gateway de API.

Requisitos para asignar direcciones IPv4 públicas reservadas a gateways de API

Si ya tiene los permisos de IAM necesarios para crear gateways de API (incluido el permiso manage virtual-network-family), no se necesitan permisos adicionales para asignar una dirección IPv4 pública reservada a un gateway de API.

Creación de gateways de API de pila única IPv4 con direcciones IPv4 públicas reservadas

Puede crear gateways de API de pila única IPv4 con direcciones IPv4 públicas reservadas mediante la CLI o la API (no puede utilizar la consola).

Al utilizar la CLI, la sintaxis del comando es la siguiente:

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>"]}'

Por ejemplo, para crear un gateway de API de pila única IPv4 público con una dirección IPv4 pública reservada:

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"]}'

Creación de gateways de API de doble pila IPv4/IPv6 con direcciones IPv4 públicas reservadas

Puede crear gateways de API de doble pila IPv4/IPv6 con direcciones IPv4 públicas reservadas mediante la CLI o la API (no puede utilizar la consola).

Al utilizar la CLI, la sintaxis del comando es la siguiente:

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]

Por ejemplo:

  • Para crear un gateway de API de doble pila pública IPv4/IPv6 con una dirección IPv4 pública reservada y una dirección IPv6 efímera:

    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"]}'

  • Para crear un gateway de API de pila doble IPv4/IPv6 público con una dirección IPv4 pública reservada y una dirección IPv6 especificada manualmente:

    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"]}'