Interroger Cloud Number Registry

Cette page explique comment interroger les informations stockées dans Cloud Number Registry.

Avant de commencer

  1. Configurez Cloud Number Registry.
  2. Sélectionnez le projet de votre organisation qui a été configuré pour fournir un accès à Cloud Number Registry.
  3. Vérifiez que vous disposez des autorisations requises pour suivre les instructions de ce guide.

Rôles requis

Pour obtenir les autorisations nécessaires pour afficher les informations stockées dans Cloud Number Registry, demandez à votre administrateur de vous accorder le rôle IAM Lecteur IPAM Cloud Number Registry (roles/cloudnumberregistry.ipamViewer) sur votre projet. Pour en savoir plus sur l'attribution de rôles, consultez Gérer l'accès aux projets, aux dossiers et aux organisations.

Vous pouvez également obtenir les autorisations requises via des rôles personnalisés ou d'autres rôles prédéfinis.

Rechercher des plages d'adresses IP libres

Vous pouvez trouver des plages d'adresses IP disponibles dans des plages découvertes ou personnalisées.

Rechercher des plages d'adresses IP libres dans des plages découvertes

Lorsque vous recherchez des plages d'adresses IP libres dans des plages découvertes, les limites suivantes s'appliquent :

Console

  1. Dans la Google Cloud console, accédez à la page Cloud Number Registry.

    Accéder à Cloud Number Registry

  2. Cliquez sur l'onglet Registres.

  3. Cliquez sur un registre.

  4. Cliquez sur l'onglet Domaines découverts.

  5. Cliquez sur un domaine découvert, puis sur une plage découverte dans ce domaine.

  6. Cliquez sur Rechercher des plages d'adresses IP libres.

  7. Dans Longueur du préfixe, sélectionnez la taille de la plage que vous souhaitez trouver.

    Les plages disponibles de la taille spécifiée s'affichent.

gcloud

Recherchez des plages d'adresses IP libres dans des plages découvertes à l'aide de la gcloud alpha number-registry discovered-ranges find-free-ip-ranges commande.

gcloud alpha number-registry discovered-ranges find-free-ip-ranges DISCOVERED_RANGE_NAME \
    --cidr-prefix-length=PREFIX_LENGTH \
    --range-count=RANGE_COUNT \
    --location=global

Remplacez les éléments suivants :

  • DISCOVERED_RANGE_NAME : nom de la plage découverte.
  • PREFIX_LENGTH: longueur du préfixe CIDR des plages à trouver. Utilisez 32 pour trouver des adresses IPv4 individuelles.
  • RANGE_COUNT : nombre de plages libres à trouver.

Rechercher des plages d'adresses IP libres dans des plages personnalisées

Si aucune plage personnalisée n'existe pour une plage d'adresses IP donnée, elle est considérée comme une plage d'adresses IP libre. Si vous souhaitez utiliser Cloud Number Registry pour rechercher des plages d'adresses IP libres dans des plages personnalisées, assurez-vous que toutes les adresses IP et plages d'adresses IP en cours d'utilisation disposent d'une plage personnalisée correspondante.

Console

  1. Dans la Google Cloud console, accédez à la page Cloud Number Registry.

    Accéder à Cloud Number Registry

  2. Cliquez sur l'onglet Registres.

  3. Cliquez sur un registre.

  4. Cliquez sur l'onglet Domaines personnalisés.

  5. Cliquez sur un domaine personnalisé, puis sur une plage personnalisée dans ce domaine.

  6. Cliquez sur Rechercher des plages d'adresses IP libres.

  7. Dans Longueur du préfixe, sélectionnez la taille de la plage que vous souhaitez trouver.

    Les plages disponibles de la taille spécifiée s'affichent.

gcloud

Recherchez des plages d'adresses IP libres dans des plages personnalisées à l'aide de la gcloud alpha number-registry custom-ranges find-free-ip-ranges commande.

gcloud alpha number-registry custom-ranges find-free-ip-ranges CUSTOM_RANGE_NAME \
    --cidr-prefix-length=PREFIX_LENGTH \
    --range-count=RANGE_COUNT \
    --location=global

Remplacez les éléments suivants :

  • CUSTOM_RANGE_NAME : nom de la plage personnalisée.
  • PREFIX_LENGTH: longueur du préfixe CIDR des plages à trouver. Utilisez 32 pour trouver des adresses IPv4 individuelles.
  • RANGE_COUNT : nombre de plages libres à trouver.

Rechercher des ressources d'adresses IP

Vous pouvez rechercher des ressources d'adresses IP dans un registre.

Vous pouvez utiliser les filtres suivants dans les requêtes :

  • Adresse IP : adresse IP à rechercher, par exemple 10.10.10.46.
  • Domaine : nom du domaine dans lequel effectuer la recherche, par exemple vpc-global-123456789.
  • Plage parente : URI de la plage parente dans laquelle effectuer la recherche, par exemple projects/project3/locations/global/customRanges/range7.
  • Version IP : version IP à filtrer.

  • Attributs : vous pouvez filtrer par texte d'attribut ou par clés et valeurs, mais vous ne pouvez pas inclure les deux dans la même requête.

    • Filtrer par texte : texte d'attribut à rechercher dans les plages, par exemple europe-west1.
    • Filtrer par clés et valeurs : clé et valeur d'attribut à filtrer, par exemple la clé addressType avec la valeur INTERNAL.

Console

  1. Dans la Google Cloud console, accédez à la page Cloud Number Registry.

    Accéder à Cloud Number Registry

  2. Cliquez sur l'onglet Registres.

  3. Cliquez sur un registre.

  4. Cliquez sur l'onglet Recherche d'adresses IP.

  5. Saisissez votre requête de recherche à l'aide du champ Adresse IP et de la section Filtres, puis cliquez sur Rechercher.

    • Pour rechercher une adresse IP spécifique, saisissez-la dans le champ Adresse IP.
    • Pour filtrer votre recherche par version IP, domaine, plage parente ou attributs, saisissez votre requête de recherche dans la section Filtres.

gcloud

Recherchez des ressources IP à l'aide de la gcloud alpha number-registry registry-books search-ip-resources commande.

Vous pouvez combiner des filtres de différentes manières :

  • Vous pouvez combiner deux filtres ou plus dans la même requête à l'aide de AND.
  • Vous ne pouvez utiliser AND NOT qu'en combinaison avec le attribute:(KEY=VALUE) filtre.
  • Vous pouvez utiliser attribute ou attribute_text dans une requête donnée, mais pas les deux.
gcloud alpha number-registry registry-books search-ip-resources REGISTRY_BOOK \
    --query=QUERY \
    --show-utilization \
    --location=global

Remplacez les éléments suivants :

  • REGISTRY_BOOK: nom du registre dans lequel effectuer la recherche.
  • QUERY: requête de votre recherche, par exemple :
    • "ip_address=\"2001:db8::/64\""
    • "attribute_text=europe-west1"
    • "attribute:(resourceName=projects/project123/regions/us-east1/subnetworks/subnet1)"
    • "realm=vpc-global-123456789"
    • "realm=vpc-global-123456789 AND ip_address=10.10.10.46"
    • "realm=vpc-global-123456789 AND ip_version=IPV6"
    • "realm=vpc-global-123456789 AND attribute_text=production"
    • "realm=vpc-global-123456789 AND attribute:(team=\"Sales Europe\")"
    • "parent_range=projects/project3/locations/global/customRanges/range7"
    • "parent_range=projects/project3/locations/global/customRanges/range7 AND attribute:(team=marketing)"
    • "parent_range=projects/project3/locations/global/customRanges/range7 AND NOT attribute:(environment=production)"