Vinculación, desvinculación y traslado de rangos de direcciones públicas

Puede vincular, desvincular y mover rangos de direcciones públicas a una VPC en una zona de disponibilidad con la consola, CLI, API y Terraform.

Antes de empezar

Revisa los siguientes requisitos y consideraciones antes de vincular, desvincular o trasladar un rango de direcciones públicas:

  • Asegúrate de revisar las consideraciones de planificación para los rangos de megafonía.
  • La vinculación de un rango de direcciones públicas debe incluir tanto una VPC como una zona de disponibilidad.
  • Al utilizar un rango de direcciones públicas, debe configurar el enrutamiento de entrada tras vincular el rango de direcciones para dirigir el tráfico al recurso adecuado. La vinculación del rango de direcciones a una VPC no redirige automáticamente el tráfico hacia el recurso.

Vincular, desvincular y mover rangos de direcciones públicas en la consola

Puede vincular, desvincular y mover un rango de direcciones públicas a una VPC en una zona de disponibilidad en la consola.

Vinculación de un rango de direcciones públicas en la consola

Para vincular un rango de direcciones públicas en la consola IBM Cloud®, siga estos pasos:

  1. Desde la consola IBM Cloud, seleccione el ícono Menú del menú de Navegación, luego haga clic en el ícono VPC de Infraestructura > Red > Rangos de direcciones públicas. Aparece la página Rangos de direcciones públicas para VPC.
  2. Resalte la fila del intervalo de direcciones en la tabla y, a continuación, haga clic en Encuadernar en el menú Acciones Icono Acciones.
  3. En la página « Asignar rango de direcciones públicas », selecciona la VPC y la zona de disponibilidad correspondiente a la que quieras asignar el rango de direcciones.
  4. Haga clic en Vincular para vincular el intervalo de direcciones públicas a la VPC.

Desvinculación de un rango de direcciones públicas en la consola

Para desvincular un rango de direcciones públicas en la consola IBM Cloud, siga estos pasos:

Después de desvincular una dirección pública, sigue estando reservada y disponible para ser vinculada de nuevo.

  1. Desde la consola IBM Cloud, seleccione el ícono Menú del menú de Navegación, luego haga clic en el ícono VPC de Infraestructura > Red > Rangos de direcciones públicas. Aparece la página Rangos de direcciones públicas para VPC.
  2. Resalte la fila del rango de direcciones en la tabla, luego haga clic en Desenlazar en el menú Acciones Ícono Acciones.
  3. Haga clic en Desvincular para confirmar que desea desvincular este intervalo de direcciones de la VPC.

Mover un rango de direcciones públicas en la consola

Si el rango de direcciones públicas está vinculado a una VPC en una zona de disponibilidad, puede actualizarlo y vincularlo (moverlo) a una VPC y zona de disponibilidad diferentes. El rango de direcciones públicas se desvincula automáticamente de su VPC y zona de disponibilidad y, a continuación, se vincula a la nueva VPC y zona de disponibilidad especificadas.

No es necesario desvincular primero el rango de direcciones de su destino original.

Para mover un rango de direcciones públicas en la consola, siga estos pasos:

  1. Desde la consola IBM Cloud, seleccione el ícono Menú del menú de Navegación, luego haga clic en el ícono VPC de Infraestructura > Red > Rangos de direcciones públicas. Aparece la página Rangos de direcciones públicas para VPC.
  2. Resalte la fila del rango de direcciones en la tabla, luego haga clic en Editar en el menú Acciones Ícono Acciones.
  3. En la página « Editar rango de direcciones públicas », selecciona la VPC y la zona de disponibilidad a la que deseas trasladar el rango de direcciones.
  4. Haga clic en Guardar para vincular el intervalo de direcciones públicas a la nueva VPC.

Vincular, desvincular y mover rangos de direcciones públicas desde la CLI

Para vincular, desvincular o mover una dirección IP reservada desde la línea de comandos, siga estos pasos:

  1. Configure el entorno de la CLI.

  2. Inicie sesión en sus entornos CLI. Después de especificar la contraseña, el sistema solicita qué cuenta y región desea utilizar:

    ibmcloud login --sso
    
  3. Activa el indicador de función siguiente:

    export IBMCLOUD_IS_FEATURE_PUBLIC_ADDRESS_RANGE=true
    

    Recibirás una notificación en la línea comando cuando haya actualizaciones disponibles para la CLI de IBM Cloud y sus complementos. Es importante mantener la CLI actualizada para acceder a los comandos más recientes. Para comprobar la versión actual de todos los plug-ins instalados, ejecute ibmcloud plugin list.

  4. Ejecute el mandato siguiente:

    ibmcloud is public-address-range-update PUBLIC_ADDRESS_RANGE [--name NAME] ([--vpc VPC --zone ZONE] | [--reset-target]) [--output JSON] [-q, --quiet]
    

    Donde:

    PUBLIC_ADDRESS_RANGE
    El ID o nombre del rango de direcciones públicas a actualizar.
    --name
    Un nuevo identificador para el rango de direcciones públicas, si desea cambiarle el nombre.
    --vpc
    La VPC a la que desea asociar el rango de direcciones públicas. Cuando se especifica la opción --vpc, se requiere --zone.
    --zone
    La zona en la que desea que resida este rango de direcciones públicas. Cuando se especifica la opción --zone, se requiere --vpc.
    --reset-target
    Desvincular un rango de direcciones públicas.
    -f, --force
    Forzar la operación sin confirmación.
    --output
    En cuanto al formato de salida, solo se admite JSON. Valores posibles: JSON.
    -q, --quiet
    Suprimir la salida detallada.

Ejemplos de mandato

Si una dirección pública no está vinculada a una VPC, puede vincularla a una VPC en cualquier zona de disponibilidad:

ibmcloud is public-address-range-update r006-81222eee-b3e0-4dc3-b429-aee9e5c0abf2 --name public-address-range-1 --vpc cli-test-vpc --zone us-south-1

Desvincular un rango de direcciones públicas de una VPC y dejarlo sin vincular:

ibmcloud is public-address-range-update r006-81222eee-b3e0-4dc3-b429-aee9e5c0abf2 --name public-address-range-1 --reset-target

Mover un rango de direcciones públicas de una VPC a otra:

ibmcloud is public-address-range-update r006-81222eee-b3e0-4dc3-b429-aee9e5c0abf2 --vpc cli-test-vpc --zone us-south-2

Vinculación, desvinculación y traslado de rangos de direcciones públicas con la API

Para vincular, desvincular o mover rangos de direcciones públicas con la API, siga estos pasos:

  1. Configure el entorno de la API.
  2. Almacene los valores siguientes en variables que se utilizarán en el mandato de la API:

version (cadena): La versión de la API, en formato YYYY-MM-DD.

  1. Una vez iniciadas todas las variables, selecciona una de las siguientes acciones:

    • Vincula un rango de direcciones públicas a una VPC específica:
         curl -X PATCH \
                "$vpc_api_endpoint/v1/public_address_ranges/$par_id?version=$api_version&generation=2" \
                -H "Authorization: Bearer $iam_token" \
                -H "Content-Type: application/json" \
                -d '{
                      "target": {
                         "vpc": {
                            "id": "r006-4727d842-f94f-4a2d-824a-9bc9b02c523b"
                         },
                         "zone": {
                            "name": "us-south-2"
                         }
                      }
                   }'
    
  • Desvincula un rango de direcciones públicas de una VPC específica:

      curl -X PATCH \
            "$vpc_api_endpoint/v1/public_address_ranges/$par_id?version=$api_version&generation=2" \
            -H "Authorization: Bearer $iam_token" \
            -H "Content-Type: application/json" \
            -d '{
                  "target": null
               }'
   ```
   Después de desvincular una dirección pública, sigue estando reservada y se puede volver a vincular.
   {: note}

* Mover un rango de direcciones públicas de una VPC a otra:

```sh {: pre}
      curl -X PATCH \
            "$vpc_api_endpoint/v1/public_address_ranges/$par_id?version=$api_version&generation=2" \
            -H "Authorization: Bearer $iam_token" \
            -H "Content-Type: application/json" \
            -d '{
                  "target": {
                     "vpc": {
                        "id": "r006-9999aaaa-bbbb-cccc-dddd-1234567890ab"
                     },
                     "zone": {
                        "name": "us-south-3"
                     }
                  }
               }'
   ```
## Vinculación, desvinculación y traslado de rangos de direcciones públicas con Terraform {: #par-bind-unbind-terraform terraform}

Para vincular, desvincular o mover un rango de direcciones públicas con Terraform, utilice el siguiente ejemplo:

```terraform {: codeblock}
resource "ibm_is_public_address_range" "public_address_range_instance" {
 ipv4_address_count = "16"
name = "example-public-address-range"
resource_group{
   id = "11caaa983d9c4beb82690daab08717e9"
}
target{
 vpc {
   id = ibm_is_vpc.testacc_vpc.id
 }
 zone {
   name = "us-south-3"
 }
}
}

Enlaces relacionados