Se usó la API de Cloud Translation para traducir esta página.

Administra tareas y colas

Puedes administrar las colas y las tareas de las siguientes maneras:

En la consola de Google Cloud
Con Google Cloud CLI en la terminal o en Cloud Shell
Envía una solicitud a la API de Cloud Tasks.

Cómo borrar 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 las reintentos después de fallar de forma continua.

Console

En la consola de Google Cloud, ve a la página Cloud Tasks > Colas.

Ir a Listas de aplicaciones en cola
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 nombre de la tarea que quieres borrar.
QUEUE_ID: Es el nombre de la fila a la que pertenece la tarea.
LOCATION: la región en la que se implementa la fila, 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: Es el nombre de la fila a la que pertenece la tarea.
TASK_NAME: Es el nombre de la tarea que deseas borrar.
PROJECT_ID: El Google Cloud ID de tu proyecto
LOCATION: 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:

curl (Linux, macOS o Cloud Shell)

Nota: Con el siguiente comando, se supone que accediste a la CLI de gcloud con tu cuenta de usuario a través de la ejecución de gcloud init o gcloud auth login, o a través del uso de Cloud Shell, que accede de forma automática a la CLI de gcloud. Para comprobar la cuenta activa actual, ejecuta gcloud auth list.

Ejecuta el siguiente comando:

curl -X DELETE \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://cloudtasks.googleapis.com/v2/projects/PROJECT_ID/locations/LOCATION/queues/QUEUE_ID/tasks/TASK_NAME"

PowerShell (Windows)

Nota: El siguiente comando supone que accediste a la CLI de gcloud con tu cuenta de usuario mediante la ejecución de gcloud init o gcloud auth login. Para comprobar la cuenta activa actual, ejecuta gcloud auth list.

Ejecuta el siguiente comando:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method DELETE `
    -Headers $headers `
    -Uri "https://cloudtasks.googleapis.com/v2/projects/PROJECT_ID/locations/LOCATION/queues/QUEUE_ID/tasks/TASK_NAME" | Select-Object -Expand Content

Explorador de APIs (navegador)

Abre la página de referencia del método. El panel del Explorador de API se abre en la parte derecha de la página. Puedes interactuar con esta herramienta para enviar solicitudes. Completa los campos obligatorios y haz clic en Ejecutar.

Si se ejecuta correctamente, el cuerpo de la respuesta está vacío.

Borra definitivamente todas las tareas de una cola

Puedes borrar todas las tareas de una cola borrándolas definitivamente. Todas las tareas creadas antes de la llamada de purga se borran definitivamente. Sin embargo, las operaciones de purga pueden tardar hasta un minuto en aplicarse, y es posible que las tareas se envíen antes de que se aplique la purga.

Console

En la consola de Google Cloud, ve a la página Cloud Tasks > Colas.

Ir a Listas de aplicaciones en cola
Haz clic en el nombre de la cola de las tareas que deseas borrar.
Haz clic en Borrar definitivamente la fila.
En el mensaje, haz clic en Borrar definitivamente.

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 fila que deseas borrar.
LOCATION: la región en la que se implementa la cola, por ejemplo, us-central1

REST

Para purgar una fila, 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 fila que deseas purgar.
PROJECT_ID: El Google Cloud ID de tu proyecto
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:

curl (Linux, macOS o Cloud Shell)

Ejecuta el siguiente comando:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d "" \
     "https://cloudtasks.googleapis.com/v2/projects/PROJECT_ID/locations/LOCATION/queues/QUEUE_ID:purge"

PowerShell (Windows)

Ejecuta el siguiente comando:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -Uri "https://cloudtasks.googleapis.com/v2/projects/PROJECT_ID/locations/LOCATION/queues/QUEUE_ID:purge" | Select-Object -Expand Content

Explorador de APIs (navegador)

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 fila. Si pausas una cola, se detienen la ejecución y la entrega de tareas. Aún puedes crear tareas y enviarlas o agregarlas a la cola, pero no se procesarán. Una vez que se reanuda la cola, las tareas pendientes se procesan en el orden en que se agregaron al backlog de la cola.

Console

En la consola de Google Cloud, ve a la página Cloud Tasks > Colas.

Ir a Listas de aplicaciones en cola
Selecciona la casilla de verificación de la cola que quieres pausar.
Haz clic en Pausar cola.
En el mensaje, haz clic en Pausar.
Para reanudar la cola, haz clic en Reanudar la 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 fila que deseas pausar.
- LOCATION: 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 fila, 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 fila que deseas pausar.
- PROJECT_ID: El Google Cloud ID de tu proyecto
- 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:
curl (Linux, macOS o Cloud Shell)

Nota: Con el siguiente comando, se supone que accediste a la CLI de gcloud con tu cuenta de usuario a través de la ejecución de gcloud init o gcloud auth login, o a través del uso de Cloud Shell, que accede de forma automática a la CLI de gcloud. Para comprobar la cuenta activa actual, ejecuta gcloud auth list.

Ejecuta el siguiente comando:
```
curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d "" \
     "https://cloudtasks.googleapis.com/v2/projects/PROJECT_ID/locations/LOCATION/queues/QUEUE_ID:pause"
```
PowerShell (Windows)

Nota: El siguiente comando supone que accediste a la CLI de gcloud con tu cuenta de usuario mediante la ejecución de gcloud init o gcloud auth login. Para comprobar la cuenta activa actual, ejecuta gcloud auth list.

Ejecuta el siguiente comando:
```
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -Uri "https://cloudtasks.googleapis.com/v2/projects/PROJECT_ID/locations/LOCATION/queues/QUEUE_ID:pause" | Select-Object -Expand Content
```
Explorador de APIs (navegador)

Abre la página de referencia del método. El panel del Explorador de API se abre en la parte derecha de la página. Puedes interactuar con esta herramienta para enviar solicitudes. Completa los campos obligatorios y haz clic en Ejecutar.

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 fila que deseas reanudar.
- PROJECT_ID: El Google Cloud ID de tu proyecto
- 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:
curl (Linux, macOS o Cloud Shell)

Nota: Con el siguiente comando, se supone que accediste a la CLI de gcloud con tu cuenta de usuario a través de la ejecución de gcloud init o gcloud auth login, o a través del uso de Cloud Shell, que accede de forma automática a la CLI de gcloud. Para comprobar la cuenta activa actual, ejecuta gcloud auth list.

Ejecuta el siguiente comando:
```
curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d "" \
     "https://cloudtasks.googleapis.com/v2/projects/PROJECT_ID/locations/LOCATION/queues/QUEUE_ID:resume"
```
PowerShell (Windows)

Nota: El siguiente comando supone que accediste a la CLI de gcloud con tu cuenta de usuario mediante la ejecución de gcloud init o gcloud auth login. Para comprobar la cuenta activa actual, ejecuta gcloud auth list.

Ejecuta el siguiente comando:
```
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -Uri "https://cloudtasks.googleapis.com/v2/projects/PROJECT_ID/locations/LOCATION/queues/QUEUE_ID:resume" | Select-Object -Expand Content
```
Explorador de APIs (navegador)

Abre la página de referencia del método. El panel del Explorador de API se abre en la parte derecha de la página. Puedes interactuar con esta herramienta para enviar solicitudes. Completa los campos obligatorios y haz clic en Ejecutar.

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"
}
```

Borra colas

Puedes borrar una cola. También se borrarán las tareas de la cola. Si borras una cola, debes esperar 3 días antes de volver a crearla con el mismo nombre. Este período de espera evita un comportamiento inesperado en las tareas que se ejecutan en el momento de la eliminación o que esperan a ejecutarse. También evita fallas en el proceso interno en el ciclo de eliminación o recreación.

Console

En la consola de Google Cloud, ve a la página Cloud Tasks > Colas.

Ir a Listas de aplicaciones en cola
Selecciona la casilla de verificación de la cola que deseas borrar.
Haz clic en Borrar cola.
En el mensaje, escribe 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 nombre de la fila que deseas borrar.
LOCATION: la región en la que se implementa la fila, por ejemplo, us-central1

REST

Para borrar una fila, 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: Es el nombre de la fila que deseas borrar.
PROJECT_ID: El Google Cloud ID de tu proyecto
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:

curl (Linux, macOS o Cloud Shell)

Ejecuta el siguiente comando:

curl -X DELETE \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://cloudtasks.googleapis.com/v2/projects/PROJECT_ID/locations/LOCATION/queues/QUEUE_ID"

PowerShell (Windows)

Ejecuta el siguiente comando:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method DELETE `
    -Headers $headers `
    -Uri "https://cloudtasks.googleapis.com/v2/projects/PROJECT_ID/locations/LOCATION/queues/QUEUE_ID" | Select-Object -Expand Content

Explorador de APIs (navegador)

Si se ejecuta correctamente, el cuerpo de la respuesta está vacío.

Administra tareas y colas Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.

Cómo borrar una tarea de una cola

Console

gcloud

REST

curl (Linux, macOS o Cloud Shell)

PowerShell (Windows)

Explorador de APIs (navegador)

Borra definitivamente todas las tareas de una cola

Console

gcloud

REST

curl (Linux, macOS o Cloud Shell)

PowerShell (Windows)

Explorador de APIs (navegador)

Pausar o reanudar colas

Console

gcloud

REST

curl (Linux, macOS o Cloud Shell)

PowerShell (Windows)

Explorador de APIs (navegador)

curl (Linux, macOS o Cloud Shell)

PowerShell (Windows)

Explorador de APIs (navegador)

Borra colas

Console

gcloud

REST

curl (Linux, macOS o Cloud Shell)

PowerShell (Windows)

Explorador de APIs (navegador)

Administra tareas y colas