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
- Assurez-vous de disposer d'une file d'attente Cloud Tasks. Pour en savoir plus, consultez Créer des files d'attente Cloud Tasks.
- 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
Dans la console Google Cloud , accédez à la page Cloud Tasks > Files d'attente.
Cliquez sur le nom de la file d'attente de la tâche que vous souhaitez supprimer.
Cochez la case correspondant à la tâche que vous souhaitez supprimer.
Cliquez sur Supprimer la tâche.
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 supprimerQUEUE_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 exempleus-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 supprimerPROJECT_ID: ID de votre projet Google CloudLOCATION: région dans laquelle la file d'attente existe, par exempleus-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_IDPROJECT_ID: ID de votre projet Google CloudREGION: région dans laquelle la file d'attente existe, par exempleus-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
Dans la console Google Cloud , accédez à la page Cloud Tasks > Files d'attente.
Cliquez sur le nom de la file d'attente contenant les tâches que vous souhaitez supprimer.
Cliquez sur Vider la file d'attente.
À 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 purgerLOCATION: région dans laquelle la file d'attente est déployée, par exempleus-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 purgerPROJECT_ID: ID de votre projet Google CloudLOCATION: région dans laquelle la file d'attente est déployée, par exempleus-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
Dans la console Google Cloud , accédez à la page Cloud Tasks > Files d'attente.
Cochez la case de la file d'attente que vous souhaitez mettre en pause ou réactiver.
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é.
Pour reprendre une file d'attente mise en pause, cliquez sur Reprendre la file d'attente.
gcloud
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 suspendreLOCATION: région dans laquelle la file d'attente est déployée, par exempleus-central1.
Réactivez une file d'attente à l'aide de la commande
gcloud tasks queues resume:gcloud tasks queues resume QUEUE_ID \ --location=LOCATION
REST
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 suspendrePROJECT_ID: ID de votre projet Google CloudLOCATION: région dans laquelle la file d'attente est déployée, par exempleus-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" }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 CloudLOCATION: région dans laquelle la file d'attente est déployée, par exempleus-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
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.
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 :
Supprimer définitivement la file d'attente : supprimez toutes les tâches de la file d'attente tout en la maintenant active en supprimant définitivement toutes les tâches de la file d'attente à l'aide de la commande
gcloud tasks queues purgeou de la méthodeprojects.locations.queues.purge.Mettre à jour la file d'attente en place : modifiez les limites de débit, les paramètres de nouvelle tentative ou le routage de la file d'attente existante à l'aide de la commande
gcloud tasks queues updateou de la méthodeprojects.locations.queues.patch. Pour en savoir plus, consultez Configurer le routage, les limites et les nouvelles tentatives de la file d'attente.Suspendre la file d'attente : arrêtez temporairement les envois de tâches tout en conservant les tâches en file d'attente en suspendant la file d'attente à l'aide de la commande
gcloud tasks queues pauseou de la méthodeprojects.locations.queues.pause.Configurer des garde-fous de cycle de vie : évitez la suppression accidentelle de files d'attente lors des déploiements automatisés en configurant la protection contre la suppression dans vos modèles d'infrastructure as code, par exemple en définissant
prevent_destroy = truedans un bloc Terraformlifecycle.
Pour supprimer une file d'attente, utilisez la console Google Cloud , la gcloud CLI ou l'API Cloud Tasks :
Console
Dans la console Google Cloud , accédez à la page Cloud Tasks > Files d'attente.
Cochez la case correspondant à la file d'attente que vous souhaitez supprimer.
Cliquez sur Supprimer la file d'attente.
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 exempleus-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 supprimerPROJECT_ID: ID de votre projet Google CloudLOCATION: région dans laquelle la file d'attente est déployée, par exempleus-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.