Administra y descubre extremos

Vista previa

Este producto o función está sujeto a las "Condiciones de la Oferta de la Fase Previa a la DG" en la sección Condiciones Generales del Servicio de las Condiciones Específicas del Servicio. Los productos y las funciones de la fase previa a la DG están disponibles “tal como están” y pueden estar sujetos a asistencia limitada. Para obtener más información, consulta las descripciones de la etapa de lanzamiento.

Para administrar de manera eficaz tu flota de agentes, debes mantener actualizada tu red de extremos. En este documento, se detalla cómo descubrir los extremos disponibles, actualizar sus detalles de conexión o quitarlos cuando ya no se usen.

Antes de comenzar

Antes de administrar extremos, regístralos en Agent Registry. También necesitarás el ID de tu proyecto para realizar estas tareas.

Para usar los comandos de gcloud CLI en este documento, asegúrate de configurar tu entorno de Google Cloud CLI.

Roles obligatorios

Para obtener los permisos que necesitas para administrar extremos en Agent Registry, pídele a tu administrador que te otorgue los siguientes roles de IAM en el proyecto:

• Descubre los extremos: Visualizador de la API de Agent Registry (roles/agentregistry.viewer)
• Extremos de actualización y eliminación: Editor de la API de Agent Registry (roles/agentregistry.editor)

Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.

También puedes obtener los permisos necesarios a través de roles personalizados o cualquier otro rol predefinido.

Descubre extremos

Para explorar las URLs de destino y las APIs de REST registradas en tu entorno, enumera los recursos de extremos disponibles.

Enumera todos los extremos

Enumera todos los extremos registrados en tu entorno:

Console

1. En la consola de Google Cloud , ve a Agent Registry:

   Ir a Agent Registry

2. En el selector de proyectos, selecciona el proyecto en el que configuraste Agent Registry. Google Cloud

3. Selecciona la pestaña Endpoints.

   En la página, se muestra una lista de todos los extremos registrados y sus detalles, como el nombre, la descripción y la ubicación.

4. Para ver los detalles de conexión completos de un extremo, haz clic en su nombre.

gcloud

Para enumerar todos los extremos en una ubicación específica, usa el comando endpoints list:

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

Reemplaza lo siguiente:

• PROJECT_ID: El ID del proyecto
• REGION: Es la región del registro.

Cómo filtrar extremos registrados

Si tienes varios extremos, puedes filtrar la lista por los metadatos del extremo:

Console

1. En la consola de Google Cloud , ve a Agent Registry:

   Ir a Agent Registry

2. En el selector de proyectos, selecciona el proyecto en el que configuraste Agent Registry. Google Cloud

3. Selecciona la pestaña Endpoints.

   En la página, se muestra una lista de todos los extremos registrados y sus detalles, como el nombre, la descripción y la ubicación.

4. Para filtrar por ubicación, haz clic en el menú Ubicación, selecciona las ubicaciones por las que deseas filtrar y haz clic en Aplicar.

   En la página, se muestra una lista filtrada de los extremos registrados para las condiciones que seleccionaste.

gcloud

Filtra tu lista para que solo muestre los recursos que coincidan con metadatos específicos usando la marca --filter:

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

Reemplaza FILTER_EXPRESSION por la expresión de filtro para los extremos que deseas filtrar. Por ejemplo, para filtrar por nombre visible, usa displayName='DISPLAY_NAME'.

Cómo ver los detalles de un extremo

Consulta los detalles de un extremo específico, incluidos los detalles de conexión y las vinculaciones de protocolos:

Console

1. En la consola de Google Cloud , ve a Agent Registry:

   Ir a Agent Registry

2. En el selector de proyectos, selecciona el proyecto en el que configuraste Agent Registry. Google Cloud

3. Selecciona la pestaña Endpoints.

   En la página, se muestra una lista de todos los extremos registrados y sus detalles, como el nombre, la descripción y la ubicación.

4. Haz clic en el nombre del extremo que deseas ver.

   En la página Descripción general, se muestran el nombre, la descripción, la ubicación y los detalles de conexión del extremo, incluidos la URL de destino y las vinculaciones de protocolo.

gcloud

Recupera metadatos detallados sobre un extremo específico, incluida su URL de interfaz completa y su vinculación de protocolo:

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

Reemplaza lo siguiente:

• PROJECT_ID: El ID del proyecto
• REGION: Es la región del registro.
• ENDPOINT_NAME: Es el nombre de tu extremo, por ejemplo, my-external-api.

Actualiza un extremo

Si cambia la URL subyacente de un servicio externo, puedes actualizar los detalles de la interfaz del extremo.

Sigue estos pasos para actualizar un extremo:

Console

1. En la consola de Google Cloud , ve a Agent Registry:

   Ir a Agent Registry

2. En el selector de proyectos, selecciona el proyecto en el que configuraste Agent Registry. Google Cloud

3. Selecciona la pestaña Endpoints.

   En la página, se muestra una lista de todos los extremos registrados y sus detalles, como el nombre, la descripción y la ubicación.

4. Haz clic en el nombre del extremo que deseas actualizar.

   En la página Descripción general, se muestran el nombre, la descripción, la ubicación y los detalles de conexión del extremo, incluidos la URL de destino y las vinculaciones de protocolo.

5. Haz clic en Editar.

6. En el panel Editar servicio, ingresa la información actualizada del extremo, como el nombre visible, la descripción y la URL de destino. Puedes probar la conexión al extremo desde este panel.

7. Haz clic en Guardar.

gcloud

En el caso de la API de Agent Registry, los recursos de Endpoint se usan para el descubrimiento. Por lo tanto, debes actualizar el recurso Service registrado directamente.

Usa la marca --interfaces para especificar la nueva URL de destino:

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

Reemplaza lo siguiente:

• SERVICE_NAME: Es el nombre de tu recurso, por ejemplo, my-external-api.
• PROJECT_ID: El ID del proyecto
• REGION: Es la región del registro.
• ENDPOINT_URL: Es la nueva URL de destino, por ejemplo, https://new-api.example.com/v1/data.
• PROTOCOL: Es la vinculación del protocolo para la interfaz. Los valores válidos son HTTP_JSON, GRPC o JSONRPC.

Cómo quitar un extremo

Para quitar un extremo del registro, debes borrar su recurso Service subyacente. Esta acción quita inmediatamente el extremo de los resultados de la búsqueda de descubrimiento.

Sigue estos pasos para quitar un extremo de tu registro:

Console

1. En la consola de Google Cloud , ve a Agent Registry:

   Ir a Agent Registry

2. En el selector de proyectos, selecciona el proyecto en el que configuraste Agent Registry. Google Cloud

3. Selecciona la pestaña Endpoints.

   En la página, se muestra una lista de todos los extremos registrados y sus detalles, como el nombre, la descripción y la ubicación.

4. Haz clic en el nombre del extremo que deseas quitar.

   En la página Descripción general, se muestran el nombre, la descripción, la ubicación y los detalles de conexión del extremo, incluidos la URL de destino y las vinculaciones de protocolo.

5. Haz clic en Borrar.

6. En la ventana Borrar extremo, ingresa DELETE para confirmar la acción.

7. Haz clic en Borrar.

gcloud

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