Le registre d'agents vous permet de découvrir, de mettre à jour et de supprimer des points de terminaison enregistrés afin que vos agents acheminent le trafic vers des URL cibles valides. Vous pouvez inspecter les points de terminaison disponibles dans votre projet, mettre à jour leurs informations de connexion à mesure que votre infrastructure évolue et supprimer les points de terminaison qui ne sont plus utilisés.
Avant de commencer
- Configurer le registre d'agents.
Pour une configuration à projet unique, obtenez l'ID de projet du projet de gouvernance où le registre d'agents est activé. Si vous avez configuré une limite de gestion pour plusieurs projets, utilisez l'ID de votre projet de gestion pour la découverte et l'enregistrement à l'échelle de la limite, ou spécifiez l'ID d'un projet membre pour les opérations sur un seul projet.
Enregistrez des points de terminaison dans Agent Registry.
Pour utiliser les commandes de la Google Cloud CLI dans ce document, configurez votre environnement gcloud CLI.
Rôles requis
Pour obtenir les autorisations nécessaires pour gérer les points de terminaison dans le registre d'agents, demandez à votre administrateur de vous accorder les rôles IAM suivants sur le projet de gouvernance où le registre d'agents est activé :
-
Découvrir les points de terminaison : Lecteur de l'API Agent Registry (
roles/agentregistry.viewer) -
Mettre à jour et supprimer des points de terminaison : Éditeur de l'API Agent Registry (
roles/agentregistry.editor)
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.
Découvrir des points de terminaison
Pour parcourir les URL cibles et les API REST enregistrées dans votre environnement, listez les ressources Endpoint disponibles.
Lister tous les points de terminaison
Répertoriez tous les points de terminaison enregistrés dans votre environnement :
Console
Dans la console Google Cloud , accédez à Agent Registry :
Dans le sélecteur de projets, sélectionnez le projet Google Cloud dans lequel vous avez configuré Agent Registry.
Sélectionnez l'onglet Points de terminaison.
La page affiche la liste de tous les points de terminaison enregistrés et leurs détails, tels que le nom, la description et l'emplacement.
Pour afficher toutes les informations de connexion d'un point de terminaison, cliquez sur son nom.
gcloud
Pour lister tous les points de terminaison d'un emplacement spécifique, exécutez la commande gcloud agent-registry endpoints list :
gcloud agent-registry endpoints list \
--project=PROJECT_ID \
--location=REGION
Remplacez les éléments suivants :
PROJECT_ID: ID du projet.REGION: région du registre.
Filtrer les points de terminaison enregistrés
Si vous disposez de plusieurs points de terminaison, vous pouvez filtrer la liste en fonction des métadonnées du point de terminaison :
Console
Dans la console Google Cloud , accédez à Agent Registry :
Dans le sélecteur de projets, sélectionnez le projet Google Cloud dans lequel vous avez configuré le registre d'agents.
Sélectionnez l'onglet Points de terminaison.
La page affiche la liste de tous les points de terminaison enregistrés et leurs détails, tels que le nom, la description et l'emplacement.
Pour filtrer par emplacement, cliquez sur le menu Emplacement, sélectionnez les emplacements que vous souhaitez filtrer, puis cliquez sur Appliquer.
La page affiche une liste filtrée des points de terminaison enregistrés pour les conditions sélectionnées.
gcloud
Filtrez votre liste pour ne renvoyer que les ressources correspondant à des métadonnées spécifiques en transmettant l'option --filter à la commande gcloud agent-registry endpoints list :
gcloud agent-registry endpoints list \
--project=PROJECT_ID \
--location=REGION \
--filter="FILTER_EXPRESSION"
Remplacez les éléments suivants :
PROJECT_ID: ID du projet.REGION: région du registre.FILTER_EXPRESSION: expression de filtre pour les points de terminaison que vous souhaitez filtrer. Par exemple, pour filtrer par nom à afficher, utilisezdisplayName='DISPLAY_NAME'. Pour filtrer par identifiant de point de terminaison (URN) unique au monde, utilisezendpointId='urn:endpoint:ENDPOINT_URN'.
Terraform
Pour récupérer un point de terminaison enregistré spécifique en filtrant ses métadonnées, configurez la source de données google_agent_registry_endpoint avec l'argument filter :
data "google_agent_registry_endpoint" "filtered_endpoint" {
location = "REGION"
filter = "displayName=\"DISPLAY_NAME\""
}
Remplacez les éléments suivants :
REGION: région du registre.DISPLAY_NAME: nom lisible par l'humain du point de terminaison à utiliser pour le filtrage, par exempleExample API Endpoint.
Afficher les détails d'un point de terminaison
Affichez les détails d'un point de terminaison spécifique, y compris ses détails de connexion et ses liaisons de protocole :
Console
Dans la console Google Cloud , accédez à Agent Registry :
Dans le sélecteur de projets, sélectionnez le projet Google Cloud dans lequel vous avez configuré le registre d'agents.
Sélectionnez l'onglet Points de terminaison.
La page affiche la liste de tous les points de terminaison enregistrés et leurs détails, tels que le nom, la description et l'emplacement.
Cliquez sur le nom du point de terminaison que vous souhaitez afficher.
La page Présentation affiche le nom, la description, l'emplacement et les détails de connexion du point de terminaison, y compris l'URL de destination et les liaisons de protocole.
gcloud
Récupérez les métadonnées détaillées d'un point de terminaison spécifique, y compris l'URL complète de son interface et sa liaison de protocole, en exécutant la commande gcloud agent-registry endpoints describe :
gcloud agent-registry endpoints describe ENDPOINT_NAME \
--project=PROJECT_ID \
--location=REGION
Remplacez les éléments suivants :
PROJECT_ID: ID du projet.REGION: région du registre.ENDPOINT_NAME: nom de votre point de terminaison, par exemplemy-external-api.
Terraform
Pour récupérer des informations sur un point de terminaison enregistré spécifique à l'aide de son ID, configurez la source de données google_agent_registry_endpoint :
data "google_agent_registry_endpoint" "my_endpoint" {
location = "REGION"
endpoint_id = "ENDPOINT_NAME"
}
output "endpoint_create_time" {
description = "The timestamp when the endpoint was registered."
value = data.google_agent_registry_endpoint.my_endpoint.create_time
}
output "endpoint_update_time" {
description = "The timestamp when the endpoint was last updated."
value = data.google_agent_registry_endpoint.my_endpoint.update_time
}
Remplacez les éléments suivants :
REGION: région du registre.ENDPOINT_NAME: identifiant unique de votre point de terminaison, par exemplemy-external-api.
Mettre à jour un point de terminaison
Si l'URL sous-jacente d'un point de terminaison cible externe change, vous pouvez mettre à jour les détails de l'interface du point de terminaison.
Dans Agent Registry, les ressources Endpoint sont des ressources de découverte en lecture seule.
Par conséquent, pour mettre à jour un point de terminaison enregistré, vous devez mettre à jour directement sa ressource Service accessible en écriture.
Pour mettre à jour un point de terminaison, procédez comme suit :
Console
Dans la console Google Cloud , accédez à Agent Registry :
Dans le sélecteur de projets, sélectionnez le projet Google Cloud dans lequel vous avez configuré le registre d'agents.
Sélectionnez l'onglet Points de terminaison.
La page affiche la liste de tous les points de terminaison enregistrés et leurs détails, tels que le nom, la description et l'emplacement.
Cliquez sur le nom du point de terminaison que vous souhaitez mettre à jour.
La page Présentation affiche le nom, la description, l'emplacement et les détails de connexion du point de terminaison, y compris l'URL de destination et les liaisons de protocole.
Cliquez sur Modifier.
Dans le panneau Modifier le service, saisissez les informations mises à jour pour le point de terminaison, telles que le nom à afficher, la description et l'URL de destination. Vous pouvez tester la connexion au point de terminaison à partir de ce panneau.
Cliquez sur Enregistrer.
gcloud
Exécutez la commande gcloud agent-registry services update avec l'option --interfaces pour spécifier la nouvelle URL cible :
gcloud agent-registry services update ENDPOINT_NAME \
--project=PROJECT_ID \
--location=REGION \
--interfaces=url=ENDPOINT_URL,protocolBinding=PROTOCOL
Remplacez les éléments suivants :
ENDPOINT_NAME: nom de votre point de terminaison, par exemplemy-external-api.PROJECT_ID: ID du projet dans lequel la ressourceServicea été créée.REGION: région du registre.ENDPOINT_URL: nouvelle URL cible, par exemplehttps://new-api.example.com/v1/data.PROTOCOL: liaison de protocole pour l'interface. Les valeurs valides sonthttp-json,grpcoujsonrpc.
Terraform
Pour mettre à jour l'URL d'un point de terminaison ou une liaison de protocole à l'aide de Terraform, modifiez le bloc interfaces de votre ressource google_agent_registry_service existante dans votre configuration, puis exécutez terraform apply :
resource "google_agent_registry_service" "endpoint" {
location = "REGION"
service_id = "ENDPOINT_NAME"
display_name = "DISPLAY_NAME"
interfaces {
url = "ENDPOINT_URL"
protocol_binding = "PROTOCOL"
}
endpoint_spec {
type = "NO_SPEC"
}
}
Remplacez les éléments suivants :
REGION: région du registre.ENDPOINT_NAME: nom de votre point de terminaison.DISPLAY_NAME: nom lisible par l'humain du point de terminaison.ENDPOINT_URL: nouvelle URL cible, par exemplehttps://new-api.example.com/v1/data.PROTOCOL: liaison de protocole pour l'interface. Les valeurs valides sontHTTP_JSON,GRPCouJSONRPC.
Supprimer un point de terminaison
Pour supprimer un point de terminaison du registre, vous devez supprimer sa ressource Service. Cette action supprime immédiatement le point de terminaison des résultats de recherche de découverte.
Pour supprimer un point de terminaison de votre registre, procédez comme suit :
Console
Dans la console Google Cloud , accédez à Agent Registry :
Dans le sélecteur de projets, sélectionnez le projet Google Cloud dans lequel vous avez configuré le registre d'agents.
Sélectionnez l'onglet Points de terminaison.
La page affiche la liste de tous les points de terminaison enregistrés et leurs détails, tels que le nom, la description et l'emplacement.
Cliquez sur le nom du point de terminaison que vous souhaitez supprimer.
La page Présentation affiche le nom, la description, l'emplacement et les détails de connexion du point de terminaison, y compris l'URL de destination et les liaisons de protocole.
Cliquez sur Supprimer.
Dans la fenêtre Supprimer le point de terminaison, saisissez
DELETEpour confirmer l'action.Cliquez sur Supprimer.
gcloud
Exécutez la commande gcloud agent-registry services delete :
gcloud agent-registry services delete ENDPOINT_NAME \
--project=PROJECT_ID \
--location=REGION
Remplacez les éléments suivants :
ENDPOINT_NAME: nom du point de terminaison que vous souhaitez supprimer, par exemplemy-external-api.PROJECT_ID: ID du projet dans lequel la ressourceServicea été créée.REGION: région du registre.
Terraform
Supprimez la ressource google_agent_registry_service représentant le point de terminaison de votre configuration Terraform, puis exécutez terraform apply.