Administración de grupos de agentes

Los agentes son tipos de software que el Servicio de transferencia de datos locales utiliza para transferir datos a Cloud Storage. Un grupo de agentes es una colección de agentes que usan la misma configuración, con acceso uniforme a tu fuente y destino y visibilidad de ellos.

En esta guía, se describe cómo usar grupos de agentes del Servicio de transferencia para datos locales.

Antes de comenzar

Debes tener ciertos permisos en tu proyecto para trabajar con grupos de agentes. Consulta Control de acceso con IAM para obtener detalles sobre los permisos y roles.

Puedes ver tus permisos actuales.

Crea un grupo de agentes

Para crear un grupo de agentes, haz lo siguiente:

Cloud Console

  1. En Cloud Console, ve a la página Servicio de transferencia de datos locales.

    Ir a Servicio de transferencia de datos locales

  2. Haz clic en Configuración de conexión.

    Se mostrará la página Grupos de agentes, que enumera tus grupos de agentes existentes. Todos los proyectos incluyen un grupo predeterminado llamado transfer_service_default.

  3. Haz clic en Crear otro grupo.

  4. Asigna un nombre a tu grupo y, de manera opcional, una descripción.

  5. Puedes optar por establecer un límite de ancho de banda que se aplicará al grupo en general. El ancho de banda especificado en MB/s se dividirá entre todos los agentes del grupo.

  6. Haga clic en Crear.

API de REST

Usa projects.agentPools.create:

POST https://storagetransfer.googleapis.com/v1/projects/{PROJECT_ID}/agentPools/{agent_pool_id=AGENT_POOL_ID}:create

Aquí:

  • PROJECT_ID: Es el ID del proyecto en el que creas el grupo de agentes.
  • AGENT_POOL_ID: Es el ID del grupo de agentes que creas.

Si un grupo de agentes se detuvo en el estado Creating durante más de 30 minutos, recomendamos borrar el grupo de agentes y volver a crearlo.

Revocar los permisos necesarios de transferencia de datos locales de un proyecto mientras un grupo de agentes se encuentra en el estado Creating genera un comportamiento de servicio incorrecto.

Asigna agentes a un grupo

Los grupos de agentes nuevos están vacíos y deben tener agentes asignados. Solo se puede asignar un agente a un grupo de agentes en el momento de la creación del agente mediante el campo --agent-pool.

Si no se especifica --agent-pool, el agente se asigna al grupo transfer_service_default.

Para crear un agente y asignarlo a un grupo, haz lo siguiente:

  1. En la página Grupos de agentes, selecciona el grupo al que se asignarán los agentes.

  2. Haz clic en Instalar agente. Aparecerá la guía de instalación del agente.

  3. Sigue las instrucciones para crear el agente en este grupo de agentes.

Para obtener más opciones, consulta Configuración avanzada del agente.

Si deseas administrar agentes, consulta Administra agentes para la transferencia de datos locales.

Asigna un grupo de agentes a un trabajo

Una vez que se creó el grupo de agentes, se puede asignar a un trabajo durante la creación o actualización del trabajo.

Actualiza un grupo de agentes

Puedes actualizar el nombre visible y el límite de ancho de banda de un grupo de agentes.

Para actualizar un grupo de agentes, haz lo siguiente:

Cloud Console

En Cloud Console, ve a la página Grupos de agentes.

Ir a los grupos de agentes

Puedes editar los siguientes elementos:

  • El nombre visible del grupo de agentes: haz clic en Editar junto al nombre actual del Grupo de agentes.

  • El límite de ancho de banda del grupo de agentes: haz clic en Configurar límite de ancho de banda y, luego, ingresa un límite nuevo en el cuadro de diálogo Configurar límite de ancho de banda. Haz clic en Configurar límite para aplicar el nuevo límite de ancho de banda. El ancho de banda se comparte entre todos los agentes del grupo.

API de REST

Para actualizar un grupo de agentes, usa projects.agentPools.patch con una máscara de campo de los campos que se actualizarán. Se pueden actualizar los siguientes campos del grupo de agentes:

Por ejemplo, para actualizar displayName a my-transfer, debes proporcionar la máscara de campo "displayName,my-transfer".

El siguiente es un ejemplo de una solicitud de parche para actualizar el nombre visible:

PATCH https://storagetransfer.googleapis.com/v1/projects/{PROJECT_ID}/agentPools/{AGENT_POOL_ID}:"displayName,NEW_NAME"

Aquí:

  • PROJECT_ID: Es el ID del proyecto en el que actualizas el grupo de agentes.
  • AGENT_POOL_ID: Es el ID del grupo de agentes que deseas actualizar.
  • NEW_NAME: Es el nombre visible nuevo para este grupo de agentes.

El siguiente es un ejemplo de una solicitud de parche para actualizar el límite de ancho de banda:

PATCH https://storagetransfer.googleapis.com/v1/projects/{PROJECT_ID}/agentPools/{AGENT_POOL_ID}:"bandwidthLimit,NEW_LIMIT"

Aquí:

  • PROJECT_ID: Es el ID del proyecto en el que actualizas el grupo de agentes.
  • AGENT_POOL_ID: Es el ID del grupo de agentes que deseas actualizar.
  • NEW_LIMIT: Es el nuevo límite de ancho de banda para este grupo de agentes.

Borra un grupo de agentes

Puedes borrar un grupo de agentes que no tenga agentes activos ni ejecuciones de trabajos activas.

Para borrar un grupo de agentes, haz lo siguiente:

Cloud Console

  1. En Cloud Console, ve a la página Grupos de agentes.

    Ir a los grupos de agentes

  2. Haz clic en Borrar. Lee la ventana emergente y, luego, haz clic en Borrar para confirmar.

    Si el botón de borrar no está activo, deberás detener todos los agentes y trabajos asociados con este grupo.

API de REST

Usa projects.agentPools.delete:

DELETE https://storagetransfer.googleapis.com/v1/{name=PROJECT_ID/*/agentPools/}

Aquí:

  • PROJECT_ID: Es el ID del proyecto en el que deseas borrar el grupo de agentes.

Obtén un grupo de agentes

Para obtener un grupo de agentes, haz lo siguiente:

Cloud Console

En Cloud Console, ve a la página Grupos de agentes.

Ir a los grupos de agentes

En la página, se muestra una lista de todos los grupos de agentes asociados con tu proyecto y la siguiente información para cada grupo de agentes:

  • Nombre del grupo de agentes
  • Estado de conexión
  • Cantidad de agentes conectados
  • Límite de ancho de banda, si está configurado
  • Cantidad de trabajos de transferencia asociados
  • El nombre visible del grupo de agentes

Para ver un grupo de agentes específico, haz clic en el Nombre del grupo de agentes.

Las siguientes acciones están disponibles en la página de información de un grupo de agentes:

  • Agente de instalación: muestra instrucciones para instalar agentes de transferencia de datos locales.
  • Detener agente: selecciona un agente en la tabla y haz clic en Detener agente.
  • Enumera los trabajos de transferencia: haz clic en Trabajos de transferencia para mostrar los trabajos de transferencia a los que están conectados los agentes de este grupo.

API de REST

Usa projects.agentPools.get:

GET https://storagetransfer.googleapis.com/v1/{name=PROJECT_ID/*/agentPools/}

Aquí:

  • PROJECT_ID: Es el ID del proyecto del que obtienes un grupo de agentes.

Enumera grupos de agentes

Para enumerar tus grupos de agentes, haz lo siguiente:

Cloud Console

En Cloud Console, ve a la página Grupos de agentes.

Ir a los grupos de agentes

Se muestran todos los grupos de agentes.

API de REST

Usa projects.agentPools.list:

GET https://storagetransfer.googleapis.com/v1/projects/{project_id=PROJECT_ID}/agentPools

Aquí:

  • PROJECT_ID: Es el ID del proyecto del que obtienes un grupo de agentes.