Gestire code e attività

Puoi gestire le code e le attività nei seguenti modi:

  • Nella console Google Cloud
  • Utilizzando Google Cloud CLI nel terminale o in Cloud Shell
  • Inviando una richiesta all'API Cloud Tasks

Eliminare un'attività da una coda

Puoi eliminare un'attività se è programmata o inviata. Ad esempio, potresti dover eliminare un'attività che non può essere completata correttamente, indipendentemente dal numero di tentativi. Non puoi eliminare un'attività se è stata completata correttamente o se non sono rimaste più riprove dopo che i tentativi sono falliti ripetutamente.

Console

  1. Nella console Google Cloud, vai alla pagina Cloud Tasks > Code di attesa.

    Vai a Code

  2. Fai clic sul nome della coda per l'attività che vuoi eliminare.

  3. Seleziona la casella di controllo per l'attività da eliminare.

  4. Fai clic su Elimina attività.

  5. Al prompt, fai clic su Elimina.

gcloud

Elimina un'attività utilizzando il comando gcloud tasks delete:

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

Sostituisci quanto segue:

  • TASK_NAME: il nome dell'attività da eliminare
  • QUEUE_ID: il nome della coda a cui appartiene l'attività
  • LOCATION: la regione in cui viene eseguito il deployment della coda, ad esempio us-central1

REST

Per eliminare un'attività, utilizza il metodo projects.locations.queues.tasks.delete.

Prima di utilizzare i dati della richiesta, apporta le seguenti sostituzioni:

  • QUEUE_ID: il nome della coda a cui appartiene l'attività
  • TASK_NAME: il nome dell'attività che vuoi eliminare
  • PROJECT_ID: il tuo Google Cloud ID progetto
  • LOCATION: la regione in cui esiste la coda, ad esempio us-central1

Il corpo della richiesta deve essere vuoto.

Per inviare la richiesta, espandi una di queste opzioni:

In caso di esito positivo, il corpo della risposta è vuoto.

Eliminare definitivamente tutte le attività da una coda

Puoi eliminare tutte le attività da una coda eliminandole definitivamente. Tutte le attività create prima della chiamata di eliminazione vengono eliminate definitivamente. Tuttavia, le operazioni di eliminazione possono richiedere fino a un minuto prima di essere applicate e le attività potrebbero essere inviate prima dell'applicazione dell'eliminazione.

Console

  1. Nella console Google Cloud, vai alla pagina Cloud Tasks > Code di attesa.

    Vai a Code

  2. Fai clic sul nome della coda per le attività che vuoi eliminare.

  3. Fai clic su Svuota coda.

  4. Al prompt, fai clic su Svuota.

gcloud

Elimina una coda utilizzando il comando gcloud tasks queues purge:

gcloud tasks queues purge QUEUE_ID \
    --location=LOCATION

Sostituisci quanto segue:

  • QUEUE_ID: il nome della coda da svuotare
  • LOCATION: la regione in cui viene eseguito il deployment della coda, ad esempio us-central1

REST

Per svuotare una coda, utilizza il metodo projects.locations.queues.purge.

Prima di utilizzare i dati della richiesta, apporta le seguenti sostituzioni:

  • QUEUE_ID: il nome della coda che vuoi eliminare definitivamente
  • PROJECT_ID: il tuo Google Cloud ID progetto
  • LOCATION: la regione in cui è dipiattata la coda, ad esempio us-central1

Il corpo della richiesta deve essere vuoto.

Per inviare la richiesta, espandi una di queste opzioni:

In caso di esito positivo, il corpo della risposta contiene un'istanza di 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"
}

Mettere in pausa o riprendere le code

Puoi mettere in pausa o riprendere una coda. Mettere in pausa una coda significa che l'esecuzione e la pubblicazione delle attività vengono interrotte. Puoi comunque creare attività e inviarle o aggiungerle alla coda, ma non verranno elaborate. Una volta ripresa la coda, tutte le attività in coda vengono elaborate nell'ordine in cui sono state aggiunte al backlog della coda.

Console

  1. Nella console Google Cloud, vai alla pagina Cloud Tasks > Code di attesa.

    Vai a Code

  2. Seleziona la casella di controllo per la coda che vuoi mettere in pausa.

  3. Fai clic su Metti in pausa la coda.

  4. Al prompt, fai clic su Metti in pausa.

  5. Per riprendere la coda, fai clic su Ripristina coda.

gcloud

  1. Metti in pausa una coda utilizzando il comando gcloud tasks queues pause:

    gcloud tasks queues pause QUEUE_ID \
        --location=LOCATION

    Sostituisci quanto segue:

    • QUEUE_ID: il nome della coda che vuoi mettere in pausa
    • LOCATION: la regione in cui viene eseguito il deployment della coda, ad esempio us-central1
  2. Riprendi una coda utilizzando il comando gcloud tasks queues resume:

    gcloud tasks queues resume QUEUE_ID \
        --location=LOCATION

REST

  1. Per mettere in pausa una coda, utilizza il metodo projects.locations.queues.pause.

    Prima di utilizzare i dati della richiesta, apporta le seguenti sostituzioni:

    • QUEUE_ID: il nome della coda da mettere in pausa
    • PROJECT_ID: il tuo Google Cloud ID progetto
    • LOCATION: la regione in cui è dipiattata la coda, ad esempio us-central1

    Il corpo della richiesta deve essere vuoto.

    Per inviare la richiesta, espandi una di queste opzioni:

    In caso di esito positivo, il corpo della risposta contiene un'istanza di 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. Per riprendere una coda, utilizza il metodo projects.locations.queues.resume.

    Prima di utilizzare i dati della richiesta, apporta le seguenti sostituzioni:

    • QUEUE_ID: il nome della coda che vuoi riprendere
    • PROJECT_ID: il tuo Google Cloud ID progetto
    • LOCATION: la regione in cui è dipiattata la coda, ad esempio us-central1

    Il corpo della richiesta deve essere vuoto.

    Per inviare la richiesta, espandi una di queste opzioni:

    In caso di esito positivo, il corpo della risposta contiene un'istanza di 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"
    }
    

Eliminare le code

Puoi eliminare una coda. Verranno eliminate anche le attività in coda. Se elimini una coda, devi attendere 3 giorni prima di ricrearla con lo stesso nome. Questo periodo di attesa impedisce comportamenti imprevisti nelle attività in esecuzione al momento dell'eliminazione o in attesa di esecuzione. Inoltre, evita i fallimenti dei processi interni nel ciclo di eliminazione o ricreazione.

Console

  1. Nella console Google Cloud, vai alla pagina Cloud Tasks > Code di attesa.

    Vai a Code

  2. Seleziona la casella di controllo per la coda che vuoi eliminare.

  3. Fai clic su Elimina coda.

  4. Quando richiesto, digita il nome della coda e fai clic su Conferma.

gcloud

Elimina una coda utilizzando il comando gcloud tasks queues delete:

gcloud tasks queues delete QUEUE_ID \
    --location=LOCATION

Sostituisci quanto segue:

  • QUEUE_ID: il nome della coda da eliminare
  • LOCATION: la regione in cui viene eseguito il deployment della coda, ad esempio us-central1

REST

Per eliminare una coda, utilizza il metodo projects.locations.queues.delete.

Prima di utilizzare i dati della richiesta, apporta le seguenti sostituzioni:

  • QUEUE_ID: il nome della coda che vuoi eliminare
  • PROJECT_ID: il tuo Google Cloud ID progetto
  • LOCATION: la regione in cui è dipiattata la coda, ad esempio us-central1

Il corpo della richiesta deve essere vuoto.

Per inviare la richiesta, espandi una di queste opzioni:

In caso di esito positivo, il corpo della risposta è vuoto.