Para gerenciar sua frota de agentes de forma eficaz, é necessário manter a rede de endpoints precisa. Este documento detalha como descobrir endpoints disponíveis, atualizar os detalhes da conexão ou remover quando não estiverem mais em uso.
Antes de começar
Antes de gerenciar endpoints, registre-os no Agent Registry. Você também precisa do ID do projeto para realizar essas tarefas.
Para usar os comandos da CLI gcloud Cloud neste documento, verifique se você configurou seu ambiente da Google Cloud CLI.
Funções exigidas
Para receber as permissões necessárias para gerenciar endpoints no Agent Registry, peça ao administrador para conceder a você os seguintes papéis do IAM no projeto:
-
Descobrir endpoints:
Leitor da API Agent Registry (
roles/agentregistry.viewer) -
Endpoints de atualização e exclusão:
Editor da API Agent Registry (
roles/agentregistry.editor)
Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.
Também é possível conseguir as permissões necessárias usando papéis personalizados ou outros papéis predefinidos.
Descobrir endpoints
Para navegar pelos URLs de destino e APIs REST registrados no seu ambiente, liste os recursos de endpoint disponíveis.
Listar todos os endpoints
Liste todos os endpoints registrados no seu ambiente:
Console
No console do Google Cloud , acesse Registro de agentes:
No seletor de projetos, selecione o projeto Google Cloud em que você configurou o Agent Registry.
Selecione a guia Endpoints.
A página mostra uma lista de todos os endpoints registrados e os detalhes deles, como nome, descrição e local.
Para ver todos os detalhes da conexão de um endpoint, clique no nome dele.
gcloud
Para listar todos os endpoints em um local específico, use o comando endpoints list:
gcloud alpha agent-registry endpoints list \
--project=PROJECT_ID \
--location=REGION
Substitua:
PROJECT_ID: o ID do projeto.REGION: a região do registro.
Filtrar endpoints registrados
Se você tiver vários endpoints, filtre a lista pelos metadados deles:
Console
No console do Google Cloud , acesse Registro de agentes:
No seletor de projetos, selecione o projeto Google Cloud em que você configurou o Agent Registry.
Selecione a guia Endpoints.
A página mostra uma lista de todos os endpoints registrados e os detalhes deles, como nome, descrição e local.
Para filtrar por local, clique no menu Local, selecione os locais que você quer filtrar e clique em Aplicar.
A página mostra uma lista filtrada dos endpoints registrados para as condições selecionadas.
gcloud
Filtre sua lista para retornar apenas recursos que correspondam a metadados específicos usando a flag --filter:
gcloud alpha agent-registry endpoints list \
--project=PROJECT_ID \
--location=REGION \
--filter="FILTER_EXPRESSION"
Substitua FILTER_EXPRESSION pela expressão de filtro
dos endpoints que você quer filtrar. Por exemplo, para filtrar por nome de exibição, use displayName='DISPLAY_NAME'.
Ver detalhes de um endpoint
Confira detalhes de um endpoint específico, incluindo detalhes da conexão e vinculações de protocolo:
Console
No console do Google Cloud , acesse Registro de agentes:
No seletor de projetos, selecione o projeto Google Cloud em que você configurou o Agent Registry.
Selecione a guia Endpoints.
A página mostra uma lista de todos os endpoints registrados e os detalhes deles, como nome, descrição e local.
Clique no nome do endpoint que você quer visualizar.
A página Visão geral mostra o nome, a descrição, a localização e os detalhes de conexão do endpoint, incluindo o URL de destino e as vinculações de protocolo.
gcloud
Recupere metadados detalhados sobre um endpoint específico, incluindo o URL completo da interface e a vinculação de protocolo:
gcloud alpha agent-registry endpoints describe ENDPOINT_NAME \
--project=PROJECT_ID \
--location=REGION
Substitua:
PROJECT_ID: o ID do projeto.REGION: a região do registro.ENDPOINT_NAME: o nome do seu endpoint, por exemplo,my-external-api.
Atualizar um endpoint
Se o URL de um serviço externo mudar, você poderá atualizar os detalhes da interface do endpoint.
Siga estas etapas para atualizar um endpoint:
Console
No console do Google Cloud , acesse Registro de agentes:
No seletor de projetos, selecione o projeto Google Cloud em que você configurou o Agent Registry.
Selecione a guia Endpoints.
A página mostra uma lista de todos os endpoints registrados e os detalhes deles, como nome, descrição e local.
Clique no nome do endpoint que você quer atualizar.
A página Visão geral mostra o nome, a descrição, a localização e os detalhes de conexão do endpoint, incluindo o URL de destino e as vinculações de protocolo.
Clique em Editar.
No painel Editar serviço, insira as informações atualizadas do endpoint, como nome de exibição, descrição e URL de destino. Você pode testar a conexão com o endpoint neste painel.
Clique em Salvar.
gcloud
Para a API Agent Registry, os recursos Endpoint são usados para descoberta. Portanto, é necessário atualizar o recurso Service registrado diretamente.
Use a flag --interfaces para especificar o novo URL de destino:
gcloud alpha agent-registry services update SERVICE_NAME \
--project=PROJECT_ID \
--location=REGION \
--interfaces=url=ENDPOINT_URL,protocolBinding=PROTOCOL
Substitua:
SERVICE_NAME: o nome do recurso, por exemplo,my-external-api.PROJECT_ID: o ID do projeto.REGION: a região do registro.ENDPOINT_URL: o novo URL de destino, por exemplo,https://new-api.example.com/v1/data.PROTOCOL: a vinculação de protocolo para a interface. Os valores válidos sãoHTTP_JSON,GRPCouJSONRPC.
Remover um endpoint
Para remover um endpoint do registro, exclua o recurso Service subjacente. Essa ação remove imediatamente o endpoint dos resultados da pesquisa
de descoberta.
Siga estas etapas para remover um endpoint do seu registro:
Console
No console do Google Cloud , acesse Registro de agentes:
No seletor de projetos, selecione o projeto Google Cloud em que você configurou o Agent Registry.
Selecione a guia Endpoints.
A página mostra uma lista de todos os endpoints registrados e os detalhes deles, como nome, descrição e local.
Clique no nome do endpoint que você quer remover.
A página Visão geral mostra o nome, a descrição, a localização e os detalhes de conexão do endpoint, incluindo o URL de destino e as vinculações de protocolo.
Clique em Excluir.
Na janela Excluir endpoint, digite DELETE para confirmar a ação.
Clique em Excluir.
gcloud
gcloud alpha agent-registry services delete SERVICE_NAME \
--project=PROJECT_ID \
--location=REGION