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 :

Dans la console Google Cloud
En utilisant 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 été effectuée ou si elle a épuisé ses tentatives après avoir échoué à plusieurs reprises.

Console

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

Accéder aux 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 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 :

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 supprimant définitivement. Toutes les tâches créées avant l'appel de suppression définitive 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 la prise en compte de la suppression définitive.

Console

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

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

QUEUE_ID : nom de la file d'attente que vous souhaitez vider
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 :

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

Mettre en pause 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 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.

Accéder aux 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 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 suspendre
- 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 mettre en veille 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 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 :
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 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 :
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"
}
```

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 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 aux 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 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 ci-dessous, 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 :

curl (Linux, macOS ou Cloud Shell)

Exécutez la commande suivante :

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

PowerShell (Windows)

Exécutez la commande suivante :

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

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

APIs Explorer (navigateur)

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. Vous éviterez ainsi 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 aux files d'attente
Cochez la case correspondant à la file d'attente que vous souhaitez supprimer.
Cliquez sur Supprimer la file d'attente.
À l'invite, 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 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 :

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)

Mettre en pause 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)

Répertorier les files d'attente

Console

gcloud

REST

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