Lier, délier et déplacer des plages d'adresses publiques
Vous pouvez lier, délier et déplacer des plages d'adresses publiques vers un VPC dans une zone de disponibilité à l'aide de la console, du CLI, de l'API et de Terraform.
Avant de commencer
Veuillez prendre connaissance des exigences et considérations suivantes avant de lier, de dissocier ou de déplacer une plage d'adresses publiques :
- Assurez-vous de revoir les considérations de planification pour les plages d’adresses publiques.
- La liaison d'une plage d'adresses publiques doit inclure à la fois un VPC et une zone de disponibilité.
- Lorsque vous utilisez une plage d'adresses publiques, vous devez configurer le routage entrant après avoir associé la plage d'adresses afin de diriger le trafic vers la ressource appropriée. L'association d'une plage d'adresses à un VPC n'entraîne pas automatiquement l'acheminement du trafic vers la ressource.
Lier, délier et déplacer des plages d'adresses publiques dans la console
Vous pouvez lier, délier et déplacer une plage d'adresses publiques vers un VPC dans une zone de disponibilité dans la console.
Liaison d'une plage d'adresses publiques dans la console
Pour lier une plage d'adresses publiques dans la console IBM Cloud®, procédez comme suit :
- Depuis la console IBM Cloud, sélectionnez l'
du menu Navigation, puis cliquez sur l'icône Infrastructure
> Réseau > Plages d'adresses publiques. La page Public Address Ranges for VPC s'affiche.
- Mettez en surbrillance la ligne de la plage d'adresses dans le tableau, puis cliquez sur Relier dans le menu Actions
.
- Sur la page « Bind public address range » (Lier une plage d'adresses publiques), sélectionnez le VPC et la zone de disponibilité correspondante auxquels vous souhaitez lier la plage d'adresses.
- Cliquez sur Bind pour lier la plage d'adresses publiques au VPC.
Dissociation d'une plage d'adresses publiques dans la console
Pour délier une plage d'adresses publiques dans la console IBM Cloud, procédez comme suit :
Lorsqu'une adresse publique est déliée, elle est toujours réservée et disponible pour être reliée à nouveau.
- Depuis la console IBM Cloud, sélectionnez l'
du menu Navigation, puis cliquez sur l'icône Infrastructure
> Réseau > Plages d'adresses publiques. La page Public Address Ranges for VPC s'affiche.
- Mettez en surbrillance la ligne de la plage d'adresses dans le tableau, puis cliquez sur Délier dans le menu Actions
.
- Cliquez sur Unbind pour confirmer que vous souhaitez délier cette plage d'adresses du VPC.
Déplacement d'une plage d'adresses publiques dans la console
Si la plage d'adresses publiques est liée à un VPC dans une zone de disponibilité, vous pouvez la mettre à jour et la lier (la déplacer) à un VPC et à une zone de disponibilité différents. La plage d'adresses publiques est automatiquement déliée de son VPC et de sa zone de disponibilité, puis liée au VPC et à la zone de disponibilité nouvellement spécifiés.
Il n'est pas nécessaire de délier la plage d'adresses de sa cible d'origine.
Pour déplacer une plage d'adresses publiques dans la console, procédez comme suit :
- Depuis la console IBM Cloud, sélectionnez l'
du menu Navigation, puis cliquez sur l'icône Infrastructure
> Réseau > Plages d'adresses publiques. La page Public Address Ranges for VPC s'affiche.
- Mettez en surbrillance la ligne de la plage d'adresses dans le tableau, puis cliquez sur Modifier dans le menu Actions
.
- Sur la page « Modifier la plage d'adresses publiques », sélectionnez le VPC et la zone de disponibilité vers lesquels vous souhaitez déplacer la plage d'adresses.
- Cliquez sur Enregistrer pour lier la plage d'adresses publiques au nouveau VPC.
Lier, délier et déplacer des plages d'adresses publiques à partir de la CLI
Pour lier, délier ou déplacer une adresse IP réservée à partir de la ligne de commande, procédez comme suit :
-
Configurez votre environnement d'interface de ligne de commande.
-
Connectez-vous à vos environnements CLI. Une fois que vous avez saisi le mot de passe, le système vous invite à indiquer le compte et la région à utiliser :
ibmcloud login --sso -
Activez l'indicateur de fonctionnalité suivant :
export IBMCLOUD_IS_FEATURE_PUBLIC_ADDRESS_RANGE=trueVous recevrez une notification dans la ligne de commande lorsque des mises à jour de l'interface CLI d' IBM Cloud et de ses plug-ins seront disponibles. Il est important de maintenir votre CLI à jour afin d'accéder aux commandes les plus récentes. Pour vérifier la version actuelle de tous les plug-ins installés, exécutez la commande suivante
ibmcloud plugin list. -
Exécutez la commande suivante :
ibmcloud is public-address-range-update PUBLIC_ADDRESS_RANGE [--name NAME] ([--vpc VPC --zone ZONE] | [--reset-target]) [--output JSON] [-q, --quiet]Où :
PUBLIC_ADDRESS_RANGE- L'ID ou le nom de la plage d'adresses publiques à mettre à jour.
--name- Un nouvel identifiant pour la plage d'adresses publiques, si vous souhaitez la renommer.
--vpc- Le VPC auquel vous souhaitez associer la plage d'adresses publiques. Lorsque l'option
--vpcest spécifiée, l'option--zoneest requise. --zone- La zone dans laquelle vous souhaitez que cette plage d'adresses publiques soit située. Lorsque l'option
--zoneest spécifiée, l'option--vpcest requise. --reset-target- Désaffecter une plage d'adresses publiques.
-f, --force- Forcer l'opération sans confirmation.
--output- Format de sortie : seul le format JSON est pris en charge. Valeur admise : JSON.
-q, --quiet- Supprimer la sortie prolixe.
Exemples de commande
Si une adresse publique n'est pas liée à un VPC, vous pouvez la lier à un VPC dans n'importe quelle zone de disponibilité :
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
Dissocier une plage d'adresses publiques d'un VPC et la laisser dissociée :
ibmcloud is public-address-range-update r006-81222eee-b3e0-4dc3-b429-aee9e5c0abf2 --name public-address-range-1 --reset-target
Déplacer une plage d'adresses publiques d'un VPC à un autre :
ibmcloud is public-address-range-update r006-81222eee-b3e0-4dc3-b429-aee9e5c0abf2 --vpc cli-test-vpc --zone us-south-2
Lier, délier et déplacer des plages d'adresses publiques avec l'API
Pour lier, délier ou déplacer des plages d'adresses publiques à l'aide de l'API, procédez comme suit :
- Configurez votre environnement d'API.
- Stockez les valeurs suivantes dans les variables destinées à être utilisées dans la commande d'API :
version (chaîne): La version de l'API, au format YYYY-MM-DD.
-
Une fois toutes les variables initialisées, sélectionnez l'une des actions suivantes :
- Lier une plage d'adresses publiques à un VPC spécifique :
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" } } }'
-
Dissocier une plage d'adresses publiques d'un VPC spécifique :
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
}'
```
Lorsqu'une adresse publique est déliée, elle est toujours réservée et peut être à nouveau liée.
{: note}
* Déplacer une plage d'adresses publiques d'un VPC à un autre :
```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"
}
}
}'
```
## Lier, délier et déplacer des plages d'adresses publiques avec Terraform {: #par-bind-unbind-terraform terraform}
Pour lier, délier ou déplacer une plage d'adresses publiques avec Terraform, utilisez l'exemple suivant :
```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"
}
}
}