Für eine effektive Verwaltung Ihrer Agentenflotte ist es erforderlich, dass Ihr Netzwerk von Endpunkten korrekt ist. In diesem Dokument wird beschrieben, wie Sie verfügbare Endpunkte ermitteln, ihre Verbindungsdetails aktualisieren oder sie entfernen, wenn sie nicht mehr verwendet werden.
Hinweis
Bevor Sie Endpunkte verwalten können, müssen Sie sie in der Agent Registry registrieren. Außerdem benötigen Sie Ihre Projekt-ID, um diese Aufgaben auszuführen.
Wenn Sie die gcloud CLI-Befehle in diesem Dokument verwenden möchten, müssen Sie Ihre Google Cloud CLI-Umgebung einrichten.
Erforderliche Rollen
Bitten Sie Ihren Administrator, Ihnen die folgenden IAM-Rollen für das Projekt zuzuweisen, damit Sie die nötigen Berechtigungen zum Verwalten von Endpunkten in der Agent Registry haben:
-
Endpunkte ermitteln:
Agent Registry API Viewer (
roles/agentregistry.viewer) -
Endpunkte zum Aktualisieren und Löschen:
Agent Registry API Editor (
roles/agentregistry.editor)
Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.
Sie können die erforderlichen Berechtigungen auch über benutzerdefinierte Rollen oder andere vordefinierte Rollen erhalten.
Endpunkte ermitteln
Wenn Sie die in Ihrer Umgebung registrierten Ziel-URLs und REST APIs aufrufen möchten, listen Sie die verfügbaren Endpunktressourcen auf.
Alle Endpunkte auflisten
Alle registrierten Endpunkte in Ihrer Umgebung auflisten:
Console
Rufen Sie in der Google Cloud Console die Agent Registry auf:
Wählen Sie in der Projektauswahl das Google Cloud Projekt aus, in dem Sie die Agent Registry eingerichtet haben.
Wählen Sie den Tab Endpunkte aus.
Auf der Seite wird eine Liste aller registrierten Endpunkte und ihrer Details wie Name, Beschreibung und Ort angezeigt.
Wenn Sie die vollständigen Verbindungsdetails eines Endpunkts aufrufen möchten, klicken Sie auf den Namen des Endpunkts.
gcloud
Verwenden Sie den Befehl endpoints list, um alle Endpunkte an einem bestimmten Standort aufzulisten:
gcloud alpha agent-registry endpoints list \
--project=PROJECT_ID \
--location=REGION
Ersetzen Sie Folgendes:
PROJECT_ID: die Projekt-IDREGION: Die Registry-Region.
Registrierte Endpunkte filtern
Wenn Sie mehrere Endpunkte haben, können Sie die Liste nach den Metadaten des Endpunkts filtern:
Console
Rufen Sie in der Google Cloud Console die Agent Registry auf:
Wählen Sie in der Projektauswahl das Google Cloud Projekt aus, in dem Sie die Agent Registry eingerichtet haben.
Wählen Sie den Tab Endpunkte aus.
Auf der Seite wird eine Liste aller registrierten Endpunkte und ihrer Details wie Name, Beschreibung und Ort angezeigt.
Wenn Sie nach Standort filtern möchten, klicken Sie auf das Menü Standort, wählen Sie die gewünschten Standorte aus und klicken Sie auf Übernehmen.
Auf der Seite wird eine gefilterte Liste der registrierten Endpunkte für die ausgewählten Bedingungen angezeigt.
gcloud
Filtern Sie die Liste mit dem Flag --filter, um nur Ressourcen zurückzugeben, die bestimmten Metadaten entsprechen:
gcloud alpha agent-registry endpoints list \
--project=PROJECT_ID \
--location=REGION \
--filter="FILTER_EXPRESSION"
Ersetzen Sie FILTER_EXPRESSION durch den Filterausdruck für die Endpunkte, die Sie filtern möchten. Wenn Sie beispielsweise nach dem Anzeigenamen filtern möchten, verwenden Sie displayName='DISPLAY_NAME'.
Details zu einem Endpunkt ansehen
Details zu einem bestimmten Endpunkt ansehen, einschließlich seiner Verbindungsdetails und Protokollbindungen:
Console
Rufen Sie in der Google Cloud Console die Agent Registry auf:
Wählen Sie in der Projektauswahl das Google Cloud Projekt aus, in dem Sie die Agent Registry eingerichtet haben.
Wählen Sie den Tab Endpunkte aus.
Auf der Seite wird eine Liste aller registrierten Endpunkte und ihrer Details wie Name, Beschreibung und Ort angezeigt.
Klicken Sie auf den Namen des Endpunkts, den Sie aufrufen möchten.
Auf der Seite Übersicht werden Name, Beschreibung, Standort und Verbindungsdetails des Endpunkts angezeigt, einschließlich der Ziel-URL und der Protokollbindungen.
gcloud
Detaillierte Metadaten zu einem bestimmten Endpunkt abrufen, einschließlich der vollständigen Schnittstellen-URL und der Protokollbindung:
gcloud alpha agent-registry endpoints describe ENDPOINT_NAME \
--project=PROJECT_ID \
--location=REGION
Ersetzen Sie Folgendes:
PROJECT_ID: die Projekt-IDREGION: Die Registry-Region.ENDPOINT_NAME: Der Name Ihres Endpunkts, z. B.my-external-api.
Endpunkt aktualisieren
Wenn sich die zugrunde liegende URL eines externen Dienstes ändert, können Sie die Endpunktschnittstellendetails aktualisieren.
So aktualisieren Sie einen Endpunkt:
Console
Rufen Sie in der Google Cloud Console die Agent Registry auf:
Wählen Sie in der Projektauswahl das Google Cloud Projekt aus, in dem Sie die Agent Registry eingerichtet haben.
Wählen Sie den Tab Endpunkte aus.
Auf der Seite wird eine Liste aller registrierten Endpunkte und ihrer Details wie Name, Beschreibung und Ort angezeigt.
Klicken Sie auf den Namen des Endpunkts, den Sie aktualisieren möchten.
Auf der Seite Übersicht werden Name, Beschreibung, Standort und Verbindungsdetails des Endpunkts angezeigt, einschließlich der Ziel-URL und der Protokollbindungen.
Klicken Sie auf Bearbeiten.
Geben Sie im Bereich Dienst bearbeiten die aktualisierten Informationen für den Endpunkt ein, z. B. den Anzeigenamen, die Beschreibung und die Ziel-URL. In diesem Bereich können Sie die Verbindung zum Endpunkt testen.
Klicken Sie auf Speichern.
gcloud
Für die Agent Registry API werden Endpoint-Ressourcen für die Ermittlung verwendet. Daher müssen Sie die registrierte Service-Ressource direkt aktualisieren.
Verwenden Sie das Flag --interfaces, um die neue Ziel-URL anzugeben:
gcloud alpha agent-registry services update SERVICE_NAME \
--project=PROJECT_ID \
--location=REGION \
--interfaces=url=ENDPOINT_URL,protocolBinding=PROTOCOL
Ersetzen Sie Folgendes:
SERVICE_NAME: Der Name Ihrer Ressource, z. B.my-external-api.PROJECT_ID: die Projekt-IDREGION: Die Registry-Region.ENDPOINT_URL: Die neue Ziel-URL, z. B.https://new-api.example.com/v1/data.PROTOCOL: Die Protokollbindung für die Schnittstelle. Gültige Werte sindHTTP_JSON,GRPCundJSONRPC.
Endpunkt entfernen
Wenn Sie einen Endpunkt aus der Registry entfernen möchten, müssen Sie die zugrunde liegende Service-Ressource löschen. Dadurch wird der Endpunkt sofort aus den Discovery-Suchergebnissen entfernt.
So entfernen Sie einen Endpunkt aus Ihrer Registrierung:
Console
Rufen Sie in der Google Cloud Console die Agent Registry auf:
Wählen Sie in der Projektauswahl das Google Cloud Projekt aus, in dem Sie die Agent Registry eingerichtet haben.
Wählen Sie den Tab Endpunkte aus.
Auf der Seite wird eine Liste aller registrierten Endpunkte und ihrer Details wie Name, Beschreibung und Ort angezeigt.
Klicken Sie auf den Namen des Endpunkts, den Sie entfernen möchten.
Auf der Seite Übersicht werden Name, Beschreibung, Standort und Verbindungsdetails des Endpunkts angezeigt, einschließlich der Ziel-URL und der Protokollbindungen.
Klicken Sie auf Löschen.
Geben Sie im Fenster Endpunkt löschen DELETE ein, um die Aktion zu bestätigen.
Klicken Sie auf Löschen.
gcloud
gcloud alpha agent-registry services delete SERVICE_NAME \
--project=PROJECT_ID \
--location=REGION