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 l'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 avec des rôles personnalisés ou d'autres rôles prédéfinis.

Afficher l'utilisation des adresses IP

Vous pouvez afficher l'utilisation des adresses IP pour les plages découvertes ou personnalisées.

Afficher l'utilisation d'une plage découverte

gcloud

Affichez l'utilisation d'une plage découverte à l'aide de la commande gcloud alpha number-registry discovered-ranges show-utilization.

gcloud alpha number-registry discovered-ranges show-utilization DISCOVERED_RANGE_NAME \
    --location=global

Remplacez les éléments suivants :

  • DISCOVERED_RANGE_NAME : nom de la plage détectée.

Afficher l'utilisation d'une plage personnalisée

gcloud

Affichez l'utilisation d'une plage personnalisée à l'aide de la commande gcloud alpha number-registry custom-ranges show-utilization.

gcloud alpha number-registry custom-ranges show-utilization CUSTOM_RANGE_NAME \
    --location=global

Remplacez les éléments suivants :

  • CUSTOM_RANGE_NAME : nom de la plage personnalisée.

Trouver des plages d'adresses IP libres

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

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

Lorsque vous trouvez des plages d'adresses IP libres dans les plages détectées, les limites suivantes s'appliquent :

gcloud

Recherchez les plages d'adresses IP disponibles dans les plages détectées à l'aide de la commande gcloud alpha number-registry discovered-ranges find-free-ip-ranges.

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étecté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.

Trouver 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, cette plage est considérée comme une plage d'adresses IP libre. Si vous souhaitez utiliser Cloud Number Registry pour trouver des plages d'adresses IP disponibles dans des plages personnalisées, assurez-vous que toutes les adresses IP et plages d'adresses IP utilisées ont une plage personnalisée correspondante.

gcloud

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

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 sur les adresses IP

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

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

  • realm : nom du domaine dans lequel effectuer la recherche (par exemple, prod-realm-5).
  • parent_range : URI de la plage parente dans laquelle vous souhaitez effectuer la recherche (par exemple, projects/project3/locations/global/customRanges/range7).
  • ip_address : adresse IP à rechercher (par exemple, 10.10.10.46).
  • ip_version : version de l'adresse IP à filtrer.
  • attribute_text : texte de l'attribut à rechercher dans les plages (par exemple, production).
  • attribute : clé et valeur de l'attribut à filtrer (par exemple, attribute:(environment=production)).

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

  • Vous pouvez combiner deux filtres ou plus dans la même requête en utilisant AND.
  • Vous ne pouvez utiliser AND NOT qu'avec le filtre attribute:(KEY=VALUE).

  • Vous pouvez utiliser attribute ou attribute_text dans une requête donnée, mais pas les deux.

gcloud

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

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 recherche (par exemple,
      )
    • "attribute:(resourceName=projects/project123/regions/us-east1/subnetworks/subnet1)"
    • "realm=vpc-global-123456789 AND ip_address=10.10.10.46"
    • "realm=vpc-global-123456789 AND ip_version=IPV6"
    • "ip_address=\"2001:db8::/64\""
    • "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 AND attribute:(team=marketing)"
    • "parent_range=projects/project3/locations/global/customRanges/range7 AND NOT attribute:(environment=production)"