Cloud Tasks te permite controlar la ejecución de cargas de trabajo asíncronas, pausar el procesamiento de colas y solucionar problemas de flujos de tareas activos. Puedes configurar y mantener tus colas y tareas con la consola de Google Cloud , Google Cloud CLI o la API de Cloud Tasks.
Antes de comenzar
- Asegúrate de tener una lista de tareas en cola de Cloud Tasks existente. Para obtener más información, consulta Crea listas de tareas en cola de Cloud Tasks.
- Asegúrate de tener los roles de Identity and Access Management (IAM) necesarios para administrar listas de tareas en cola y tareas, como Administrador de Cloud Tasks (
roles/cloudtasks.admin), Administrador de listas de tareas en cola de Cloud Tasks (roles/cloudtasks.queueAdmin) o Borrador de tareas de Cloud Tasks (roles/cloudtasks.taskDeleter).
Borra una tarea de una cola
Puedes borrar una tarea si está programada o enviada. Por ejemplo, es posible que necesites borrar una tarea que no se puede completar de manera correcta, sin importar cuántas veces se intente. No puedes borrar una tarea si se completó correctamente o si se agotaron los reintentos después de fallar de forma constante. Una tarea se borra de forma automática si se alcanza el límite de retención máxima de tareas.
Console
En la consola de Google Cloud , ve a la página Cloud Tasks > Colas.
Haz clic en el nombre de la cola de la tarea que deseas borrar.
Selecciona la casilla de verificación de la tarea que deseas borrar.
Haz clic en Borrar tarea.
En el mensaje, haz clic en Borrar.
gcloud
Borra una tarea con el comando
gcloud tasks delete:
gcloud tasks delete TASK_NAME \ --queue=QUEUE_ID \ --location=LOCATION
Reemplaza lo siguiente:
TASK_NAME: Es el ID o el nombre completo del recurso de la tarea que deseas borrar.QUEUE_ID: Es el nombre de la cola a la que pertenece la tarea.LOCATION: Es la región en la que se implementa la cola, por ejemplo,us-central1.
REST
Para borrar una tarea, usa el método
projects.locations.queues.tasks.delete.
Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:
QUEUE_ID: el nombre de la cola a la que pertenece la tareaTASK_NAME: Es el nombre de la tarea que quieres borrar.PROJECT_ID: Es el ID del proyecto de Google Cloud.LOCATION: Es la región en la que existe la cola, por ejemplo,us-central1.
El cuerpo de la solicitud debe estar vacío.
Para enviar tu solicitud, expande una de estas opciones:
Si se ejecuta correctamente, el cuerpo de la respuesta está vacío.
Borra un lote de tareas de una cola
Puedes borrar un lote de tareas de una cola con el método
projects.locations.queues.tasks.batchDelete
para borrar una lista de nombres de tareas.
Ten en cuenta lo siguiente:
Todas las tareas se deben borrar de la misma cola.
Existe un límite para la cantidad de tareas que se pueden borrar en un solo lote. Para obtener más información, consulta Cuotas y límites.
Las solicitudes por lotes, que agregan operaciones individuales en una sola solicitud, no son atómicas porque es posible que algunas de las operaciones contenidas en el lote fallen mientras que otras se realicen correctamente.
Solo puedes borrar una tarea si está programada o enviada. No puedes borrar una tarea si se completó correctamente o si se agotaron los reintentos después de fallar de forma constante. Una tarea se borra automáticamente si se alcanza el límite de retención máxima de tareas.
También puedes crear un lote de tareas. Para obtener más información, consulta Crea un lote de tareas.
Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:
TASK_NAME: Es el nombre de las tareas que se borrarán con el siguiente formato:projects/PROJECT_ID/locations/REGION/queues/QUEUE_ID/tasks/TASK_IDPROJECT_ID: Es el ID del proyecto de Google Cloud.REGION: Es la región en la que existe la cola, por ejemplo,us-central1.QUEUE_ID: el nombre de la cola a la que pertenecen las tareas
El cuerpo de la solicitud contiene una lista de nombres de tareas.
Cuerpo JSON de la solicitud:
{
"names": [
"TASK_NAME"
]
}
Para enviar tu solicitud, expande una de estas opciones:
Si se ejecuta de forma correcta, el cuerpo de la respuesta contiene una instancia de
Operation.
{
"name": "projects/PROJECT_ID/locations/REGION/operations/OPERATION_ID",
"metadata": {
"@type": "type.googleapis.com/google.cloud.tasks.v2.BatchDeleteTasksMetadata"
},
"done": false
}
Borra definitivamente todas las tareas de una cola
Puedes borrar todas las tareas de una cola purgándolas. Todas las tareas creadas antes de la llamada de limpieza se borran de forma permanente. Sin embargo, las operaciones de limpieza pueden tardar hasta un minuto en aplicarse, y las tareas podrían enviarse antes de que se aplique la limpieza.
Console
En la consola de Google Cloud , ve a la página Cloud Tasks > Colas.
Haz clic en el nombre de la cola de las tareas que quieres borrar.
Haz clic en Purgar cola.
En el mensaje, haz clic en Purgar.
gcloud
Borra una cola con el comando
gcloud tasks queues purge:
gcloud tasks queues purge QUEUE_ID \ --location=LOCATION
Reemplaza lo siguiente:
QUEUE_ID: Es el nombre de la cola que deseas limpiar.LOCATION: Es la región en la que se implementa la cola, por ejemplo,us-central1.
REST
Para borrar una cola, usa el método
projects.locations.queues.purge.
Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:
QUEUE_ID: Es el nombre de la cola que quieres borrar.PROJECT_ID: Es el ID del proyecto de Google Cloud.LOCATION: la región en la que se implementa la cola, por ejemplo,us-central1
El cuerpo de la solicitud debe estar vacío.
Para enviar tu solicitud, expande una de estas opciones:
Si se ejecuta de forma correcta, el cuerpo de la respuesta contiene una instancia de
Queue:
{
"name": "projects/PROJECT_ID/locations/LOCATION/queues/QUEUE_ID",
"rateLimits": {
"maxDispatchesPerSecond": 500,
"maxBurstSize": 100,
"maxConcurrentDispatches": 1000
},
"retryConfig": {
"maxAttempts": 100,
"minBackoff": "0.100s",
"maxBackoff": "3600s",
"maxDoublings": 16
},
"state": "RUNNING",
"purgeTime": "2025-03-28T13:06:30.110255Z"
}
Pausar o reanudar colas
Puedes pausar o reanudar una cola. Pausar una cola detiene la ejecución y la entrega de tareas. Aún puedes crear tareas y enviarlas o agregarlas a la fila, pero las tareas no se procesarán hasta que se reanude la fila. Cuando reanudas una cola, Cloud Tasks comienza a enviar las tareas pendientes sin un orden de ejecución definido. Si reanudas las colas de tráfico alto con una gran cantidad de tareas pendientes, sigue la guía de aumento para evitar la sobrecarga del destino.
Console
En la consola de Google Cloud , ve a la página Cloud Tasks > Colas.
Selecciona la casilla de verificación de la cola que deseas pausar o reanudar.
Para pausar la cola, haz clic en Pausar cola y, luego, en Pausar en el mensaje.
Para reanudar una cola detenida, haz clic en Reanudar cola.
gcloud
Pausa una cola con el comando
gcloud tasks queues pause:gcloud tasks queues pause QUEUE_ID \ --location=LOCATION
Reemplaza lo siguiente:
QUEUE_ID: Es el nombre de la cola que deseas pausar.LOCATION: Es la región en la que se implementa la cola, por ejemplo,us-central1.
Reanuda una cola con el comando
gcloud tasks queues resume:gcloud tasks queues resume QUEUE_ID \ --location=LOCATION
REST
Para pausar una cola, usa el método
projects.locations.queues.pause.Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:
QUEUE_ID: Es el nombre de la cola que deseas pausar.PROJECT_ID: Es el ID del proyecto de Google Cloud.LOCATION: la región en la que se implementa la cola, por ejemplo,us-central1
El cuerpo de la solicitud debe estar vacío.
Para enviar tu solicitud, expande una de estas opciones:
Si se ejecuta de forma correcta, el cuerpo de la respuesta contiene una instancia de
Queue:{ "name": "projects/PROJECT_ID/locations/LOCATION/queues/QUEUE_ID", "rateLimits": { "maxDispatchesPerSecond": 500, "maxBurstSize": 100, "maxConcurrentDispatches": 1000 }, "retryConfig": { "maxAttempts": 100, "minBackoff": "0.100s", "maxBackoff": "3600s", "maxDoublings": 16 }, "state": "PAUSED" }Para reanudar una cola, usa el método
projects.locations.queues.resume.Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:
QUEUE_ID: Es el nombre de la cola que deseas reanudar.PROJECT_ID: Es el ID del proyecto de Google Cloud.LOCATION: la región en la que se implementa la cola, por ejemplo,us-central1
El cuerpo de la solicitud debe estar vacío.
Para enviar tu solicitud, expande una de estas opciones:
Si se ejecuta de forma correcta, el cuerpo de la respuesta contiene una instancia de
Queue:{ "name": "projects/PROJECT_ID/locations/LOCATION/queues/QUEUE_ID", "rateLimits": { "maxDispatchesPerSecond": 500, "maxBurstSize": 100, "maxConcurrentDispatches": 1000 }, "retryConfig": { "maxAttempts": 100, "minBackoff": "0.100s", "maxBackoff": "3600s", "maxDoublings": 16 }, "state": "RUNNING" }
Enumerar filas
Puedes enumerar las colas. Cuando se enumeran las colas, se devuelven algunos detalles del límite de frecuencia y del parámetro de reintento. Ten en cuenta que los siguientes campos son equivalentes:
- Tasa máxima (consola),
MAX_RATE(gcloud),maxDispatchesPerSecond(REST) Máximo de simultáneas (consola),
MAX_NUM_OF_TASKS(gcloud),maxConcurrentDispatches(REST)
Console
En la consola de Google Cloud , ve a la página Cloud Tasks > Colas.
Se enumeran todas las colas de tu proyecto de Google Cloud .
Para obtener más detalles, haz clic en el nombre de una cola y, luego, en la pestaña Configuración.
Se muestran los detalles de los parámetros de límite de frecuencia y reintentos.
gcloud
Enumera las colas con el comando
gcloud tasks queues list:
gcloud tasks queues list \ --location=LOCATION
Reemplaza LOCATION por la
región en la que se implementa
la cola, por ejemplo, us-central1. Si no se especifica una ubicación, se usa la ubicación de la app de App Engine de tu proyecto de Google Cloud , si existe; de lo contrario, debes especificar una ubicación.
El resultado debería ser similar al siguiente ejemplo:
QUEUE_NAME: my-queue STATE: PAUSED MAX_NUM_OF_TASKS: 1000 MAX_RATE (/sec): 500.0 MAX_ATTEMPTS: 100 ...
REST
Para enumerar las colas, usa el método
projects.locations.queues.list.
Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:
PROJECT_ID: Es el ID del proyecto de Google Cloud.LOCATION: la región en la que se crean las colas, por ejemplo,us-central1.
Para enviar tu solicitud, expande una de estas opciones:
Si se ejecuta de forma correcta, el cuerpo de la respuesta contiene instancias de
recursos Queue
y la respuesta debe ser similar a la siguiente:
{
"queues": [
{
"name": "projects/PROJECT_ID/locations/LOCATION/queues/QUEUE_ID",
"rateLimits": {
"maxDispatchesPerSecond": 500,
"maxBurstSize": 100,
"maxConcurrentDispatches": 1000
},
"retryConfig": {
"maxAttempts": 100,
"minBackoff": "0.100s",
"maxBackoff": "3600s",
"maxDoublings": 16
},
"state": "PAUSED",
"purgeTime": "2025-03-28T13:37:32.292552Z"
},
...
],
"nextPageToken": "CjQKCHppcHBlcjIAEgwI9-GExAYQ_oDc1AMaGioLeWlrZXMtYWdhaW4yC3VzLWNlbnRyYWwx"
}
Borra colas
Puedes borrar cualquier cola cuando ya no la necesites, excepto la
cola default de App Engine.
Después de borrar una cola, debes esperar 3 días para volver a crearla con el
mismo nombre. Este período de espera se aplica a las colas que se borran a través de cualquier interfaz,
incluidas la consola de Google Cloud , gcloud CLI, la API de REST o
RPC, o Terraform. Esto evita el comportamiento inesperado en las tareas que se
ejecutan en el momento de la eliminación y evita las fallas de los procesos internos durante
el ciclo de eliminación y recreación.
Durante este período de eliminación lógica de hasta 3 días, es posible que una solicitud de creación de cola
parezca tener éxito sin volver a crear la cola. Para confirmar que se volvió a crear una cola con
el mismo nombre, recupérala con el comando
gcloud tasks queues describe
o el método
projects.locations.queues.get. Una respuesta correcta (200 OK) confirma que se volvió a crear la cola.
Para borrar tareas, modificar la configuración de las colas o administrarlas en las canalizaciones de CI/CD sin perder la cola ni activar el período de espera de 3 días, usa las siguientes alternativas en lugar de borrar y volver a crear una cola:
Borra definitivamente la cola: Borra todas las tareas de la cola mientras la mantienes activa borrando definitivamente todas las tareas de la cola con el comando
gcloud tasks queues purgeo el métodoprojects.locations.queues.purge.Actualiza la cola en su lugar: Modifica los límites de frecuencia, los parámetros de reintento o el enrutamiento en la cola existente con el comando
gcloud tasks queues updateo el métodoprojects.locations.queues.patch. Para obtener más información, consulta Configura el enrutamiento, los límites y los reintentos de la cola.Pausa la cola: Detén de forma temporal los envíos de tareas mientras conservas las tareas en cola. Para ello, pausa la cola con el comando
gcloud tasks queues pauseo el métodoprojects.locations.queues.pause.Configura protecciones del ciclo de vida: Evita la eliminación accidental de colas durante las implementaciones automatizadas configurando la protección contra eliminaciones en tus plantillas de infraestructura como código, como establecer
prevent_destroy = trueen un bloquelifecyclede Terraform.
Para borrar una cola, usa la consola de Google Cloud , gcloud CLI o la API de Cloud Tasks:
Console
En la consola de Google Cloud , ve a la página Cloud Tasks > Colas.
Selecciona la casilla de verificación de la cola que deseas borrar.
Haz clic en Borrar cola.
En el mensaje, ingresa el nombre de la cola y, luego, haz clic en Confirmar.
gcloud
Borra una cola con el comando
gcloud tasks queues delete:
gcloud tasks queues delete QUEUE_ID \ --location=LOCATION
Reemplaza lo siguiente:
QUEUE_ID: Es el ID o el identificador completamente calificado de la cola que deseas borrar.LOCATION: Es la región en la que se implementa la cola, por ejemplo,us-central1.
La gcloud CLI solicita confirmación antes de borrar la
cola, a menos que pases la marca --quiet.
REST
Para borrar una cola, usa el método
projects.locations.queues.delete.
Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:
QUEUE_ID: el nombre de la cola que deseas borrarPROJECT_ID: Es el ID del proyecto de Google Cloud.LOCATION: la región en la que se implementa la cola, por ejemplo,us-central1
El cuerpo de la solicitud debe estar vacío.
Para enviar tu solicitud, expande una de estas opciones:
Si se ejecuta correctamente, el cuerpo de la respuesta está vacío.
¿Qué sigue?
- Configura el enrutamiento, los límites y los reintentos de la cola
- Establece parámetros de reintento para una tarea.