Cette page a été traduite par l'API Cloud Translation.

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

Vous pouvez gérer les files d'attente et les tâches de différentes manières:

Google Cloud Console
à l'aide de la Google Cloud CLI dans votre terminal ou Cloud Shell ;
En envoyant une requête à 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 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 a bien été effectuée ou si elle a atteint la limite de tentatives après avoir échoué de manière répétée.

Console

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

Accéder à "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 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 ci-dessous, effectuez les remplacements suivants :

QUEUE_ID: nom de la file d'attente à laquelle la tâche appartient
TASK_NAME: nom de la tâche que vous souhaitez supprimer
PROJECT_ID: ID de votre Google Cloud projet
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 :

curl (Linux, macOS ou Cloud Shell)

Remarque : La commande suivante suppose que vous êtes connecté à la CLI gcloud avec votre compte utilisateur en exécutant la commande gcloud init ou gcloud auth login, ou en utilisant Cloud Shell, qui vous connecte automatiquement à la CLI gcloud. Vous pouvez exécuter la commande gcloud auth list pour vérifier quel est le compte actuellement actif.

Exécutez la commande suivante :

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)

Remarque : La commande suivante suppose que vous vous êtes connecté à la CLI gcloud avec votre compte utilisateur en exécutant la commande gcloud init ou gcloud auth login. Vous pouvez exécuter la commande gcloud auth list pour vérifier quel est le compte actuellement actif.

Exécutez la commande suivante :

$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

APIs Explorer (navigateur)

Ouvrez la page de référence de la méthode. Le panneau APIs Explorer s'ouvre dans la partie droite de la page. Vous pouvez interagir avec cet outil pour envoyer des requêtes. Renseignez tous les champs obligatoires, puis cliquez sur Execute (Exécuter).

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

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 supprimées définitivement. Toutefois, la prise en compte des opérations de suppression définitive peut prendre jusqu'à une minute et les tâches peuvent être distribuées avant que la suppression définitive ne prenne effet.

Console

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

Accéder à "Files d'attente"
Cliquez sur le nom de la file d'attente des tâches que vous souhaitez supprimer.
Cliquez sur Supprimer définitivement la file d'attente.
Dans l'invite, cliquez sur Purger.

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 purger
LOCATION: région dans laquelle la file d'attente est déployée (par exemple, us-central1)

REST

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

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

QUEUE_ID: nom de la file d'attente que vous souhaitez purger
PROJECT_ID: ID de votre Google Cloud projet
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 :

curl (Linux, macOS ou Cloud Shell)

Exécutez la commande suivante :

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)

Exécutez la commande suivante :

$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

APIs Explorer (navigateur)

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 reprendre les files d'attente

Vous pouvez mettre en veille ou réactiver une file d'attente. La suspension d'une file d'attente signifie que l'exécution et la diffusion des tâches sont arrêtées. Vous pouvez toujours créer des tâches et les ajouter 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 de leur ajout au backlog de la file d'attente.

Console

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

Accéder à "Files d'attente"
Cochez la case correspondant à la file d'attente que vous souhaitez suspendre.
Cliquez sur Suspendre la file d'attente.
Dans l'invite, cliquez sur Suspendre.
Pour réactiver la file d'attente, cliquez sur Réactiver 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 mettre en pause
- LOCATION: 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 suspendre une file d'attente, utilisez la méthode projects.locations.queues.pause.

Avant d'utiliser les données de requête ci-dessous, effectuez les remplacements suivants :
- QUEUE_ID: nom de la file d'attente que vous souhaitez mettre en pause
- PROJECT_ID: ID de votre Google Cloud projet
- 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 :
curl (Linux, macOS ou Cloud Shell)

Remarque : La commande suivante suppose que vous êtes connecté à la CLI gcloud avec votre compte utilisateur en exécutant la commande gcloud init ou gcloud auth login, ou en utilisant Cloud Shell, qui vous connecte automatiquement à la CLI gcloud. Vous pouvez exécuter la commande gcloud auth list pour vérifier quel est le compte actuellement actif.

Exécutez la commande suivante :
```
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)

Remarque : La commande suivante suppose que vous vous êtes connecté à la CLI gcloud avec votre compte utilisateur en exécutant la commande gcloud init ou gcloud auth login. Vous pouvez exécuter la commande gcloud auth list pour vérifier quel est le compte actuellement actif.

Exécutez la commande suivante :
```
$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
```
APIs Explorer (navigateur)

Ouvrez la page de référence de la méthode. Le panneau APIs Explorer s'ouvre dans la partie droite de la page. Vous pouvez interagir avec cet outil pour envoyer des requêtes. Renseignez tous les champs obligatoires, puis cliquez sur Execute (Exécuter).

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 ci-dessous, effectuez les remplacements suivants :
- QUEUE_ID: nom de la file d'attente que vous souhaitez reprendre
- PROJECT_ID: ID de votre Google Cloud projet
- 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 :
curl (Linux, macOS ou Cloud Shell)

Remarque : La commande suivante suppose que vous êtes connecté à la CLI gcloud avec votre compte utilisateur en exécutant la commande gcloud init ou gcloud auth login, ou en utilisant Cloud Shell, qui vous connecte automatiquement à la CLI gcloud. Vous pouvez exécuter la commande gcloud auth list pour vérifier quel est le compte actuellement actif.

Exécutez la commande suivante :
```
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)

Remarque : La commande suivante suppose que vous vous êtes connecté à la CLI gcloud avec votre compte utilisateur en exécutant la commande gcloud init ou gcloud auth login. Vous pouvez exécuter la commande gcloud auth list pour vérifier quel est le compte actuellement actif.

Exécutez la commande suivante :
```
$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
```
APIs Explorer (navigateur)

Ouvrez la page de référence de la méthode. Le panneau APIs Explorer s'ouvre dans la partie droite de la page. Vous pouvez interagir avec cet outil pour envoyer des requêtes. Renseignez tous les champs obligatoires, puis cliquez sur Execute (Exécuter).

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

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. Cette période d'attente empêche tout comportement inattendu dans les tâches en cours d'exécution au moment de la suppression ou en attente d'exécution. Cela évite également les échecs de processus internes au cours du cycle de suppression ou de recréation.

Console

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

Accéder à "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 supprimer
LOCATION: 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 ci-dessous, effectuez les remplacements suivants :

QUEUE_ID: nom de la file d'attente que vous souhaitez supprimer
PROJECT_ID: ID de votre Google Cloud projet
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 :

curl (Linux, macOS ou Cloud Shell)

Exécutez la commande suivante :

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)

Exécutez la commande suivante :

$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

APIs Explorer (navigateur)

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

Gérer les files d'attente et les tâches Restez organisé à l'aide des collections Enregistrez et classez les contenus selon vos préférences.

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

Console

gcloud

REST

curl (Linux, macOS ou Cloud Shell)

PowerShell (Windows)

APIs Explorer (navigateur)

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

Console

gcloud

REST

curl (Linux, macOS ou Cloud Shell)

PowerShell (Windows)

APIs Explorer (navigateur)

Suspendre ou reprendre les files d'attente

Console

gcloud

REST

curl (Linux, macOS ou Cloud Shell)

PowerShell (Windows)

APIs Explorer (navigateur)

curl (Linux, macOS ou Cloud Shell)

PowerShell (Windows)

APIs Explorer (navigateur)

Supprimer des files d'attente

Console

gcloud

REST

curl (Linux, macOS ou Cloud Shell)

PowerShell (Windows)

APIs Explorer (navigateur)

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