Gérer les routeurs cloud

Ce document explique comment lister, mettre à jour, obtenir l'état et supprimer Cloud Router.

Avant de commencer

gcloud

Si vous souhaitez utiliser les exemples de ligne de commande de ce guide, procédez comme suit :

  1. Installez la dernière version de la CLI Google Cloud ou appliquez la mise à jour correspondante.
  2. Définissez une région et une zone par défaut.

API

Si vous voulez utiliser les exemples d'API de ce guide, configurez l'accès aux API.

Lister les routeurs Cloud Router

Pour répertorier tous les routeurs cloud d'un projet, procédez comme suit :

Console

  1. Dans la console Google Cloud , accédez à la page Routeurs cloud.

    Accéder aux routeurs cloud

  2. Sur la page Routeurs cloud, affichez une liste de vos routeurs cloud.

gcloud

Exécutez la commande list. Pour limiter la liste à une seule région, spécifiez --filter="region:(<var>REGION</var>).

  gcloud compute routers list \
      --project=PROJECT_ID \
      [--filter="region:(REGION)]

Remplacez les éléments suivants :

  • PROJECT_ID : ID du projet pour lequel vous souhaitez lister les routeurs Cloud Router.
  • REGION : région pour laquelle vous souhaitez répertorier les routeurs, par exemple asia-east1.

Le résultat ressemble à ce qui suit :

  NAME        REGION       NETWORK
  my-router   asia-east1   my-network

API

Utilisez la méthode routers.aggregatedList :

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/aggregated/routers

Remplacez PROJECT_ID par l'ID du projet pour lequel vous souhaitez lister les routeurs Cloud Router.

Pour répertorier uniquement les routeurs cloud d'une région spécifique, utilisez la méthode routers.list :

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/routers

Remplacez les éléments suivants :

  • PROJECT_ID : ID du projet pour lequel vous souhaitez lister les routeurs Cloud Router.
  • REGION : région pour laquelle vous souhaitez lister les routeurs Cloud Router.

Mettre à jour les routeurs cloud

Si un routeur Cloud Router est associé à une passerelle NCC, gardez à l'esprit les points suivants:

  • Vous ne pouvez pas modifier le champ ncc_gateway.

  • Les méthodes patch ou update n'acceptent pas le champ network dans le corps de la requête.

gcloud

Exécutez la commande gcloud compute routers update :

gcloud compute routers update ROUTER_NAME
    --region=REGION

Remplacez les éléments suivants :

  • ROUTER_NAME: nom du routeur Cloud Router que vous souhaitez mettre à jour
  • REGION: région où se trouve le routeur Cloud Router.

API

Exécutez la méthode routers.update :

PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/routers/ROUTER_NAME

Remplacez les éléments suivants :

  • PROJECT_ID: ID du projet pour lequel vous souhaitez lister les routeurs Cloud Router.
  • REGION: région où se trouve le routeur Cloud Router.
  • ROUTER_NAME: nom du routeur Cloud Router que vous souhaitez mettre à jour

Obtenir l'état du routeur cloud

gcloud

Utilisez la commande gcloud compute routers get-status.

gcloud compute routers get-status ROUTER_NAME \
    --project=PROJECT_ID \
    --region=REGION

Remplacez les éléments suivants :

  • ROUTER_NAME: nom du routeur Cloud Router dont vous souhaitez obtenir l'état
  • PROJECT_ID: ID du projet auquel appartient Cloud Router
  • REGION: région où se trouve le routeur Cloud Router.

API

Utilisez la méthode routers.getRouterStatus avec un corps de requête vide:

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/routers/ROUTER_NAME/getRouterStatus

Remplacez les éléments suivants :

  • PROJECT_ID: ID du projet auquel appartient Cloud Router
  • REGION: région où se trouve le routeur Cloud Router.
  • ROUTER_NAME: nom du routeur Cloud Router dont vous souhaitez obtenir l'état

Supprimer des routeurs Cloud Router

Avant de supprimer un routeur Cloud Router, vérifiez qu'il n'est pas utilisé par une autre ressource, telle qu'un tunnel Cloud VPN ou un rattachement de VLAN. Vous devez supprimer la ressource associée pour pouvoir supprimer le routeur Cloud Router. Toutefois, vous n'êtes pas obligé de supprimer les sessions BGP avant de supprimer le routeur Cloud Router.

Pour supprimer le routeur cloud, procédez comme suit :

Console

  1. Dans la console Google Cloud , accédez à la page Routeurs cloud.

    Accéder aux routeurs cloud

  2. Cochez la case à côté du routeur cloud que vous souhaitez supprimer.

  3. Cliquez sur Supprimer.

gcloud

Exécutez la commande delete. Spécifiez le nom et l'emplacement du routeur cloud que vous souhaitez supprimer.

gcloud compute routers delete ROUTER_NAME \
    --project=PROJECT_ID \
    --region=REGION

Remplacez les éléments suivants :

  • ROUTER_NAME: nom du routeur Cloud Router que vous souhaitez supprimer

  • PROJECT_ID: ID du projet contenant Cloud Router que vous souhaitez supprimer

  • REGION: région dans laquelle se trouve le routeur Cloud Router

Le résultat ressemble à ce qui suit :

Deleted [https://www.googleapis.com/compute/v1/projects/PROJECT_ID/regions/asia-east1/routers/ROUTER_NAME].

API

Exécutez la méthode routers.delete :

DELETE https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/routers/ROUTER_NAME

Remplacez les éléments suivants :

  • PROJECT_ID: ID du projet contenant Cloud Router que vous souhaitez supprimer
  • REGION : région où se trouve le routeur cloud.
  • ROUTER_NAME : nom du routeur cloud

Étapes suivantes

  • Consultez la page Afficher les détails du routeur pour savoir comment afficher la configuration d'un routeur Cloud Router, de ses sessions BGP et des routes annoncées par Cloud Router.
  • Pour résoudre les problèmes liés à l'utilisation de Cloud Router, consultez la page Dépannage.