Pour gérer efficacement votre parc d'agents, vous devez maintenir l'exactitude de votre réseau de points de terminaison. Ce document explique comment découvrir les points de terminaison disponibles, mettre à jour leurs informations de connexion ou les supprimer lorsqu'ils ne sont plus utilisés.
Avant de commencer
Avant de pouvoir gérer les points de terminaison, enregistrez-les dans le registre d'agents. Vous aurez également besoin de l'ID de votre projet pour effectuer ces tâches.
Pour utiliser les commandes gcloud CLI de ce document, assurez-vous d'avoir configuré votre environnement Google Cloud 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 :
-
Découvrez les points de terminaison :
Lecteur de l'API Agent Registry (
roles/agentregistry.viewer) -
Points de terminaison de mise à jour et de suppression :
É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 les points de terminaison
Pour parcourir les URL cibles et les API REST enregistrées dans votre environnement, listez les ressources de point de terminaison 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 dans lequel vous avez configuré Agent Registry. Google Cloud
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 tous les détails de connexion d'un point de terminaison, cliquez sur son nom.
gcloud
Pour lister tous les points de terminaison d'un emplacement spécifique, utilisez la commande endpoints list :
gcloud alpha 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 avez plusieurs points de terminaison, vous pouvez filtrer la liste par 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 dans lequel vous avez configuré Agent Registry. Google Cloud
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 zone géographique, cliquez sur le menu Zone géographique, sélectionnez les zones géographiques à filtrer, puis cliquez sur Appliquer.
La page affiche une liste filtrée des points de terminaison enregistrés pour les conditions que vous avez sélectionnées.
gcloud
Filtrez votre liste pour n'afficher que les ressources correspondant à des métadonnées spécifiques à l'aide de l'indicateur --filter :
gcloud alpha agent-registry endpoints list \
--project=PROJECT_ID \
--location=REGION \
--filter="FILTER_EXPRESSION"
Remplacez FILTER_EXPRESSION par l'expression de filtre pour les points de terminaison que vous souhaitez filtrer. Par exemple, pour filtrer par nom à afficher, utilisez displayName='DISPLAY_NAME'.
Afficher les détails d'un point de terminaison
Affichez les détails d'un point de terminaison spécifique, y compris ses informations 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 dans lequel vous avez configuré Agent Registry. Google Cloud
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 des métadonnées détaillées sur un point de terminaison spécifique, y compris son URL d'interface complète et sa liaison de protocole :
gcloud alpha 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.
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.
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 dans lequel vous avez configuré Agent Registry. Google Cloud
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
Pour l'API Agent Registry, les ressources Endpoint sont utilisées pour la découverte. Par conséquent, vous devez mettre à jour directement la ressource Service enregistrée.
Utilisez l'option --interfaces pour spécifier la nouvelle URL cible :
gcloud alpha 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.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.
Supprimer un point de terminaison
Pour supprimer un point de terminaison du registre, vous devez supprimer sa ressource Service sous-jacente. 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 dans lequel vous avez configuré Agent Registry. Google Cloud
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 DELETE pour confirmer l'action.
Cliquez sur Supprimer.
gcloud
gcloud alpha agent-registry services delete ENDPOINT_NAME \
--project=PROJECT_ID \
--location=REGION