Gérer les files d'attente et les tâches

Cloud Tasks vous permet de contrôler l'exécution des charges de travail asynchrones, de suspendre le traitement des files d'attente et de résoudre les problèmes liés aux flux de tâches actifs. Vous pouvez configurer et gérer vos files d'attente et vos tâches à l'aide de la console Google Cloud , de la Google Cloud CLI ou de l'API Cloud Tasks.

Avant de commencer

  1. Assurez-vous de disposer d'une file d'attente Cloud Tasks. Pour en savoir plus, consultez Créer des files d'attente Cloud Tasks.
  2. Assurez-vous de disposer des rôles IAM (Identity and Access Management) requis pour gérer les files d'attente et les tâches, tels que l'administrateur Cloud Tasks (roles/cloudtasks.admin), l'administrateur de files d'attente Cloud Tasks (roles/cloudtasks.queueAdmin) ou le suppresseur de tâches Cloud Tasks (roles/cloudtasks.taskDeleter).

Supprimer une tâche d'une file d'attente

Vous pouvez supprimer une tâche si elle est planifiée ou distribuée. Par exemple, vous devrez peut-être supprimer une tâche qui ne peut pas être effectuée, quel que soit le nombre de tentatives. Vous ne pouvez pas supprimer une tâche si elle s'est terminée correctement ou si elle a épuisé le nombre de nouvelles tentatives après avoir échoué de manière répétée. Une tâche est automatiquement supprimée si la limite de durée de conservation maximale des tâches est atteinte.

Console

  1. Dans la console Google Cloud , accédez à la page Cloud Tasks > Files d'attente.

    Accéder à la page "Files d'attente"

  2. Cliquez sur le nom de la file d'attente de la tâche que vous souhaitez supprimer.

  3. Cochez la case correspondant à la tâche que vous souhaitez supprimer.

  4. Cliquez sur Supprimer la tâche.

  5. Dans l'invite, cliquez sur Supprimer.

gcloud

Supprimez une tâche à l'aide de la commande gcloud tasks delete :

gcloud tasks delete TASK_NAME \
    --queue=QUEUE_ID \
    --location=LOCATION

Remplacez les éléments suivants :

  • TASK_NAME : ID ou nom complet de la ressource de la tâche que vous souhaitez supprimer
  • QUEUE_ID : nom de la file d'attente à laquelle appartient la tâche.
  • LOCATION : région dans laquelle la file d'attente est déployée, par exemple us-central1.

REST

Pour supprimer une tâche, utilisez la méthode projects.locations.queues.tasks.delete.

Avant d'utiliser les données de requête, effectuez les remplacements suivants :

  • QUEUE_ID : nom de la file d'attente à laquelle appartient la tâche.
  • TASK_NAME : nom de la tâche que vous souhaitez supprimer
  • PROJECT_ID : ID de votre projet Google Cloud
  • LOCATION : région dans laquelle la file d'attente existe, par exemple us-central1.

Le corps de la requête doit être vide.

Pour envoyer votre requête, développez l'une des options suivantes :

Si la requête aboutit, le corps de la réponse est vide.

Supprimer un lot de tâches d'une file d'attente

Vous pouvez supprimer un lot de tâches d'une file d'attente en utilisant la méthode projects.locations.queues.tasks.batchDelete pour supprimer une liste de noms de tâches.

Veuillez noter les points suivants :

  • Toutes les tâches doivent être supprimées de la même file d'attente.

  • Le nombre de tâches pouvant être supprimées dans un seul lot est limité. Pour en savoir plus, consultez la page Quotas et limites.

  • Les requêtes par lot, qui agrègent des opérations individuelles dans une seule requête, ne sont pas atomiques, car il est possible que certaines des opérations contenues dans le lot échouent tandis que d'autres réussissent.

  • Vous ne pouvez supprimer une tâche que si elle est planifiée ou distribuée. Vous ne pouvez pas supprimer une tâche si elle s'est terminée correctement ou si elle a épuisé ses tentatives après avoir échoué de manière répétée. Une tâche est automatiquement supprimée si la limite de durée de conservation maximale des tâches est atteinte.

  • Vous pouvez également créer un lot de tâches. Pour en savoir plus, consultez Créer un lot de tâches.

Avant d'utiliser les données de requête, effectuez les remplacements suivants :

  • TASK_NAME : nom des tâches à supprimer, au format suivant : projects/PROJECT_ID/locations/REGION/queues/QUEUE_ID/tasks/TASK_ID
  • PROJECT_ID : ID de votre projet Google Cloud
  • REGION : région dans laquelle la file d'attente existe, par exemple us-central1.
  • QUEUE_ID : nom de la file d'attente à laquelle appartiennent les tâches.

Le corps de la requête contient une liste de noms de tâches.

Corps JSON de la requête :

{
  "names": [
    "TASK_NAME"
  ]
}

Pour envoyer votre requête, développez l'une des options suivantes :

Si la requête aboutit, le corps de la réponse contient une instance de Operation.

{
  "name": "projects/PROJECT_ID/locations/REGION/operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.tasks.v2.BatchDeleteTasksMetadata"
  },
  "done": false
}

Supprimer définitivement toutes les tâches d'une file d'attente

Vous pouvez supprimer toutes les tâches d'une file d'attente en les purgeant. Toutes les tâches créées avant l'appel de purge sont définitivement supprimées. Toutefois, l'application des opérations de suppression peut prendre jusqu'à une minute, et des tâches peuvent être distribuées avant que la suppression ne prenne effet.

Console

  1. Dans la console Google Cloud , accédez à la page Cloud Tasks > Files d'attente.

    Accéder à la page "Files d'attente"

  2. Cliquez sur le nom de la file d'attente contenant les tâches que vous souhaitez supprimer.

  3. Cliquez sur Vider la file d'attente.

  4. À l'invite, cliquez sur Purger.

gcloud

Pour purger une file d'attente, utilisez la commande gcloud tasks queues purge :

gcloud tasks queues purge QUEUE_ID \
    --location=LOCATION

Remplacez les éléments suivants :

  • QUEUE_ID : nom de la file d'attente que vous souhaitez purger
  • LOCATION : région dans laquelle la file d'attente est déployée, par exemple us-central1.

REST

Pour vider une file d'attente, utilisez la méthode projects.locations.queues.purge.

Avant d'utiliser les données de requête, effectuez les remplacements suivants :

  • QUEUE_ID : nom de la file d'attente que vous souhaitez purger
  • PROJECT_ID : ID de votre projet Google Cloud
  • LOCATION : région dans laquelle la file d'attente est déployée, par exemple us-central1.

Le corps de la requête doit être vide.

Pour envoyer votre requête, développez l'une des options suivantes :

Si la requête aboutit, le corps de la réponse contient une instance 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"
}

Suspendre ou réactiver des files d'attente

Vous pouvez suspendre ou réactiver une file d'attente. La mise en pause d'une file d'attente arrête l'exécution et la distribution des tâches. Vous pouvez toujours créer des tâches et les transférer ou les ajouter à la file d'attente, mais elles ne seront pas traitées tant que la file d'attente n'aura pas été réactivée. Lorsque vous réactivez une file d'attente, Cloud Tasks commence à distribuer les tâches en attente sans ordre d'exécution défini. Si vous reprenez des files d'attente à fort trafic avec un backlog important, suivez les instructions de montée en puissance pour éviter la surcharge de la cible.

Console

  1. Dans la console Google Cloud , accédez à la page Cloud Tasks > Files d'attente.

    Accéder à la page "Files d'attente"

  2. Cochez la case de la file d'attente que vous souhaitez mettre en pause ou réactiver.

  3. Pour mettre la file d'attente en pause, cliquez sur Mettre la file d'attente en pause, puis sur Mettre en pause lorsque vous y êtes invité.

  4. Pour reprendre une file d'attente mise en pause, cliquez sur Reprendre la file d'attente.

gcloud

  1. Mettez en pause une file d'attente à l'aide de la commande gcloud tasks queues pause :

    gcloud tasks queues pause QUEUE_ID \
        --location=LOCATION

    Remplacez les éléments suivants :

    • QUEUE_ID : nom de la file d'attente que vous souhaitez suspendre
    • LOCATION : région dans laquelle la file d'attente est déployée, par exemple us-central1.
  2. Réactivez une file d'attente à l'aide de la commande gcloud tasks queues resume :

    gcloud tasks queues resume QUEUE_ID \
        --location=LOCATION

REST

  1. Pour suspendre une file d'attente, utilisez la méthode projects.locations.queues.pause.

    Avant d'utiliser les données de requête, effectuez les remplacements suivants :

    • QUEUE_ID : nom de la file d'attente que vous souhaitez suspendre
    • PROJECT_ID : ID de votre projet Google Cloud
    • LOCATION : région dans laquelle la file d'attente est déployée, par exemple us-central1.

    Le corps de la requête doit être vide.

    Pour envoyer votre requête, développez l'une des options suivantes :

    Si la requête aboutit, le corps de la réponse contient une instance 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"
    }
    

  2. Pour réactiver une file d'attente, utilisez la méthode projects.locations.queues.resume.

    Avant d'utiliser les données de requête, effectuez les remplacements suivants :

    • QUEUE_ID : nom de la file d'attente que vous souhaitez réactiver.
    • PROJECT_ID : ID de votre projet Google Cloud
    • LOCATION : région dans laquelle la file d'attente est déployée, par exemple us-central1.

    Le corps de la requête doit être vide.

    Pour envoyer votre requête, développez l'une des options suivantes :

    Si la requête aboutit, le corps de la réponse contient une instance 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"
    }
    

Répertorier les files d'attente

Vous pouvez lister les files d'attente. Lorsque vous listez des files d'attente, certains détails sur la limitation du débit et les paramètres de nouvelle tentative sont renvoyés. Notez que les champs suivants sont équivalents :

  • Taux maximal (Console), MAX_RATE (gcloud), maxDispatchesPerSecond (REST)
  • Nombre maximal de requêtes simultanées (Console), MAX_NUM_OF_TASKS (gcloud), maxConcurrentDispatches (REST)

Console

  1. Dans la console Google Cloud , accédez à la page Cloud Tasks > Files d'attente.

    Accéder à la page "Files d'attente"

    Toutes les files d'attente de votre projet Google Cloud sont listées.

  2. Pour en savoir plus, cliquez sur le nom d'une file d'attente, puis sur l'onglet Configuration.

    Les détails des paramètres de limitation du débit et de nouvelle tentative s'affichent.

gcloud

Répertoriez les files d'attente à l'aide de la commande gcloud tasks queues list :

gcloud tasks queues list \
    --location=LOCATION

Remplacez LOCATION par la région dans laquelle la file d'attente est déployée (par exemple, us-central1). Si aucun emplacement n'est spécifié, l'emplacement de l'application App Engine de votre projet Google Cloud est utilisé s'il existe. Sinon, vous devez spécifier un emplacement.

La sortie devrait ressembler à ce qui suit :

QUEUE_NAME: my-queue
STATE: PAUSED
MAX_NUM_OF_TASKS: 1000
MAX_RATE (/sec): 500.0
MAX_ATTEMPTS: 100
...

REST

Pour lister les files d'attente, utilisez la méthode projects.locations.queues.list.

Avant d'utiliser les données de requête, effectuez les remplacements suivants :

  • PROJECT_ID : ID de votre projet Google Cloud.
  • LOCATION : région dans laquelle les files d'attente sont créées (par exemple, us-central1).

Pour envoyer votre requête, développez l'une des options suivantes :

Si la requête aboutit, le corps de la réponse contient des instances de ressources Queue et la réponse doit ressembler à ce qui suit :

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

Supprimer des files d'attente

Vous pouvez supprimer n'importe quelle file d'attente lorsque vous n'en avez plus besoin, à l'exception de la file d'attente default d'App Engine. Après avoir supprimé une file d'attente, vous devez attendre trois jours avant de la recréer avec le même nom. Ce délai d'attente s'applique aux files d'attente supprimées via n'importe quelle interface, y compris la console Google Cloud , la gcloud CLI, l'API REST ou RPC, ou Terraform. Cela évite tout comportement inattendu dans les tâches en cours d'exécution au moment de la suppression et évite les échecs de processus internes pendant le cycle de suppression et de recréation.

Pendant cette période de suppression définitive (jusqu'à trois jours), une demande de création de file d'attente peut sembler aboutir sans que la file d'attente soit recréée. Pour vérifier qu'une file d'attente portant le même nom a été recréée, récupérez-la à l'aide de la commande gcloud tasks queues describe ou de la méthode projects.locations.queues.get. Une réponse positive (200 OK) confirme que la file d'attente a été recréée.

Pour effacer des tâches, modifier des configurations de file d'attente ou gérer des files d'attente dans des pipelines de CI/CD sans perdre la file d'attente ni déclencher le délai d'attente de trois jours, utilisez les alternatives suivantes au lieu de supprimer et de recréer une file d'attente :

Pour supprimer une file d'attente, utilisez la console Google Cloud , la gcloud CLI ou l'API Cloud Tasks :

Console

  1. Dans la console Google Cloud , accédez à la page Cloud Tasks > Files d'attente.

    Accéder à la page "Files d'attente"

  2. Cochez la case correspondant à la file d'attente que vous souhaitez supprimer.

  3. Cliquez sur Supprimer la file d'attente.

  4. Lorsque vous y êtes invité, saisissez le nom de la file d'attente, puis cliquez sur Confirmer.

gcloud

Supprimez une file d'attente à l'aide de la commande gcloud tasks queues delete :

gcloud tasks queues delete QUEUE_ID \
    --location=LOCATION

Remplacez les éléments suivants :

  • QUEUE_ID : ID ou identifiant complet de la file d'attente que vous souhaitez supprimer.
  • LOCATION : région dans laquelle la file d'attente est déployée, par exemple us-central1.

La gcloud CLI vous demande de confirmer la suppression de la file d'attente, sauf si vous transmettez l'option --quiet.

REST

Pour supprimer une file d'attente, utilisez la méthode projects.locations.queues.delete.

Avant d'utiliser les données de requête, effectuez les remplacements suivants :

  • QUEUE_ID : nom de la file d'attente que vous souhaitez supprimer
  • PROJECT_ID : ID de votre projet Google Cloud
  • LOCATION : région dans laquelle la file d'attente est déployée, par exemple us-central1.

Le corps de la requête doit être vide.

Pour envoyer votre requête, développez l'une des options suivantes :

Si la requête aboutit, le corps de la réponse est vide.

Étapes suivantes