Cloud Tasks vous permet de contrôler l'exécution des charges de travail asynchrones, de mettre en pause 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.
Supprimer une tâche d'une file d'attente
Vous pouvez supprimer une tâche si elle est planifiée ou attribué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 a été effectuée ou si elle a épuisé ses tentatives après avoir échoué à plusieurs reprises. Une tâche est automatiquement supprimée si la limite de rétention 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: nom de la tâche que vous souhaitez supprimerQUEUE_ID: nom de la file d'attente à laquelle appartient la tâcheLOCATION: 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âcheTASK_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 à l'aide de 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 en une seule opération 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 attribué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é à plusieurs reprises. Une tâche est automatiquement supprimée si la limite de rétention 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-central1QUEUE_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 supprimant définitivement. Toutes les tâches créées avant l'appel de purge sont supprimées définitivement. Toutefois, les opérations de suppression peuvent prendre jusqu'à une minute pour prendre effet, et les 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 des tâches que vous souhaitez supprimer.
Cliquez sur Vider la file d'attente.
Dans l'invite, cliquez sur Supprimer définitivement.
gcloud
Videz une file d'attente à l'aide de 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 viderLOCATION: 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 viderPROJECT_ID: ID de votre projet Google CloudLOCATION: 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"
}
Mettre en pause ou reprendre les files d'attente
Vous pouvez suspendre ou reprendre une file d'attente. La suspension d'une file d'attente signifie que l'exécution et la distribution des tâches sont arrêtées. Vous pouvez toujours créer des tâches et les envoyer ou les ajouter à la file d'attente, mais elles ne seront pas traitées. Une fois la file d'attente reprise, toutes les tâches en attente sont traitées dans l'ordre dans lequel elles ont été ajoutées à la file d'attente.
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 suspendre.
Cliquez sur Mettre en veille la file d'attente.
Dans l'invite, cliquez sur Suspendre.
Pour reprendre la lecture de la file d'attente, cliquez sur Reprendre la file d'attente.
gcloud
Mettez en veille 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 mettre en veilleLOCATION: région dans laquelle la file d'attente est déployée (par exemple,us-central1)
Reprenez une file d'attente à l'aide de la commande
gcloud tasks queues resume:gcloud tasks queues resume QUEUE_ID \ --location=LOCATION
REST
Pour mettre en veille 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 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" }Pour reprendre 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 reprendrePROJECT_ID: ID de votre projet Google CloudLOCATION: 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, des informations sur les limites de fréquence et les paramètres de réessai sont renvoyées. Notez que les champs suivants sont équivalents :
- Taux max (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.
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 sur la limite de débit et les paramètres de réessai 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 une file d'attente. Toutes les tâches de la file d'attente sont également supprimées. Si vous supprimez une file d'attente, vous devez attendre trois jours avant de pouvoir la recréer avec le même nom. Ce délai d'attente permet d'éviter tout comportement inattendu dans les tâches en cours d'exécution ou en attente d'exécution au moment de la suppression. Cela évite également les échecs de processus internes lors du cycle de suppression ou de recréation.
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: nom de la file d'attente que vous souhaitez supprimerLOCATION: région dans laquelle la file d'attente est déployée (par exemple,us-central1)
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 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
- Configurer le routage, les limites et les nouvelles tentatives des files d'attente
- Définir les paramètres de nouvelle tentative pour une tâche