Gestire e scoprire gli endpoint

Anteprima

Questo prodotto o funzionalità sono soggetti ai "Termini delle Offerte pre-GA" nella sezione Termini di servizio generali dei Termini specifici dei servizi. I prodotti e le funzionalità pre-GA sono disponibili "così come sono" e potrebbero avere un supporto limitato. Per ulteriori informazioni, consulta le descrizioni della fase di lancio.

Per gestire in modo efficace il parco agenti, è necessario mantenere accurata la rete di endpoint. Questo documento descrive in dettaglio come scoprire gli endpoint disponibili, aggiornare i dettagli di connessione o rimuoverli quando non sono più in uso.

Prima di iniziare

Prima di poter gestire gli endpoint, registrali in Agent Registry. Per eseguire queste attività, devi anche disporre dell'ID progetto.

Per utilizzare i comandi gcloud CLI in questo documento, assicurati di aver configurato l'ambiente Google Cloud CLI.

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per gestire gli endpoint in Agent Registry, chiedi all'amministratore di concederti i seguenti ruoli IAM sul progetto:

• Endpoint di rilevamento: Agent Registry API Viewer (roles/agentregistry.viewer)
• Endpoint di aggiornamento ed eliminazione: Agent Registry API Editor (roles/agentregistry.editor)

Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.

Potresti anche riuscire a ottenere le autorizzazioni richieste tramite i ruoli personalizzati o altri ruoli predefiniti.

Scopri gli endpoint

Per sfogliare gli URL di destinazione e le API REST registrati nel tuo ambiente, elenca le risorse endpoint disponibili.

Elenca tutti gli endpoint

Elenca tutti gli endpoint registrati nel tuo ambiente:

Console

1. Nella console Google Cloud , vai a Registro agenti:

   Vai al registry degli agenti

2. Nel selettore di progetti, seleziona il Google Cloud progetto in cui hai configurato Agent Registry.

3. Seleziona la scheda Endpoint.

   La pagina mostra un elenco di tutti gli endpoint registrati e i relativi dettagli, come nome, descrizione e posizione.

4. Per visualizzare tutti i dettagli della connessione di un endpoint, fai clic sul nome dell'endpoint.

gcloud

Per elencare tutti gli endpoint in una località specifica, utilizza il comando endpoints list:

gcloud alpha agent-registry endpoints list \
  --project=PROJECT_ID \
  --location=REGION

Sostituisci quanto segue:

• PROJECT_ID: l'ID progetto.
• REGION: la regione del registro.

Filtrare gli endpoint registrati

Se hai più endpoint, puoi filtrare l'elenco in base ai metadati dell'endpoint:

Console

1. Nella console Google Cloud , vai a Registro agenti:

   Vai al registry degli agenti

2. Nel selettore di progetti, seleziona il Google Cloud progetto in cui hai configurato Agent Registry.

3. Seleziona la scheda Endpoint.

   La pagina mostra un elenco di tutti gli endpoint registrati e i relativi dettagli, come nome, descrizione e posizione.

4. Per filtrare in base alla località, fai clic sul menu Località, seleziona le località che vuoi filtrare e fai clic su Applica.

   La pagina mostra un elenco filtrato degli endpoint registrati per le condizioni selezionate.

gcloud

Filtra l'elenco in modo da restituire solo le risorse corrispondenti a metadati specifici utilizzando il flag --filter:

gcloud alpha agent-registry endpoints list \
  --project=PROJECT_ID \
  --location=REGION \
  --filter="FILTER_EXPRESSION"

Sostituisci FILTER_EXPRESSION con l'espressione di filtro per gli endpoint che vuoi filtrare. Ad esempio, per filtrare in base al nome visualizzato, utilizza displayName='DISPLAY_NAME'.

Visualizzare i dettagli di un endpoint

Visualizza i dettagli di un endpoint specifico, inclusi i dettagli della connessione e i binding del protocollo:

Console

1. Nella console Google Cloud , vai a Registro agenti:

   Vai al registry degli agenti

2. Nel selettore di progetti, seleziona il Google Cloud progetto in cui hai configurato Agent Registry.

3. Seleziona la scheda Endpoint.

   La pagina mostra un elenco di tutti gli endpoint registrati e i relativi dettagli, come nome, descrizione e posizione.

4. Fai clic sul nome dell'endpoint che vuoi visualizzare.

   La pagina Panoramica mostra il nome, la descrizione, la posizione e i dettagli di connessione dell'endpoint, inclusi l'URL di destinazione e i binding del protocollo.

gcloud

Recupera i metadati dettagliati di un endpoint specifico, inclusi l'URL completo dell'interfaccia e l'associazione del protocollo:

gcloud alpha agent-registry endpoints describe ENDPOINT_NAME \
  --project=PROJECT_ID \
  --location=REGION

Sostituisci quanto segue:

• PROJECT_ID: l'ID progetto.
• REGION: la regione del registro.
• ENDPOINT_NAME: il nome dell'endpoint, ad esempio my-external-api.

Aggiornare un endpoint

Se l'URL sottostante di un servizio esterno cambia, puoi aggiornare i dettagli dell'interfaccia dell'endpoint.

Per aggiornare un endpoint:

Console

1. Nella console Google Cloud , vai a Registro agenti:

   Vai al registry degli agenti

2. Nel selettore di progetti, seleziona il Google Cloud progetto in cui hai configurato Agent Registry.

3. Seleziona la scheda Endpoint.

   La pagina mostra un elenco di tutti gli endpoint registrati e i relativi dettagli, come nome, descrizione e posizione.

4. Fai clic sul nome dell'endpoint da aggiornare.

   La pagina Panoramica mostra il nome, la descrizione, la posizione e i dettagli di connessione dell'endpoint, inclusi l'URL di destinazione e i binding del protocollo.

5. Fai clic su Modifica.

6. Nel riquadro Modifica servizio, inserisci le informazioni aggiornate per l'endpoint, ad esempio nome visualizzato, descrizione e URL di destinazione. Da questo pannello puoi testare la connessione all'endpoint.

7. Fai clic su Salva.

gcloud

Per l'API Agent Registry, le risorse Endpoint vengono utilizzate per l'individuazione. Pertanto, devi aggiornare direttamente la risorsa Service registrata.

Utilizza il flag --interfaces per specificare il nuovo URL di destinazione:

gcloud alpha agent-registry services update SERVICE_NAME \
  --project=PROJECT_ID \
  --location=REGION \
  --interfaces=url=ENDPOINT_URL,protocolBinding=PROTOCOL

Sostituisci quanto segue:

• SERVICE_NAME: il nome della risorsa, ad esempio my-external-api.
• PROJECT_ID: l'ID progetto.
• REGION: la regione del registro.
• ENDPOINT_URL: il nuovo URL di destinazione, ad esempio https://new-api.example.com/v1/data.
• PROTOCOL: l'associazione del protocollo per l'interfaccia. I valori validi sono HTTP_JSON, GRPC o JSONRPC.

Rimuovere un endpoint

Per rimuovere un endpoint dal registro, devi eliminare la risorsa Service sottostante. Questa azione rimuove immediatamente l'endpoint dai risultati di ricerca di discovery.

Per rimuovere un endpoint dal registro:

Console

1. Nella console Google Cloud , vai a Registro agenti:

   Vai al registry degli agenti

2. Nel selettore di progetti, seleziona il Google Cloud progetto in cui hai configurato Agent Registry.

3. Seleziona la scheda Endpoint.

   La pagina mostra un elenco di tutti gli endpoint registrati e i relativi dettagli, come nome, descrizione e posizione.

4. Fai clic sul nome dell'endpoint che vuoi rimuovere.

   La pagina Panoramica mostra il nome, la descrizione, la posizione e i dettagli di connessione dell'endpoint, inclusi l'URL di destinazione e i binding del protocollo.

5. Fai clic su Elimina.

6. Nella finestra Elimina endpoint, inserisci DELETE per confermare l'azione.

7. Fai clic su Elimina.

gcloud

gcloud alpha agent-registry services delete SERVICE_NAME \
  --project=PROJECT_ID \
  --location=REGION