Questa pagina è stata tradotta dall'API Cloud Translation.

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 ha esaurito i tentativi dopo aver avuto esito negativo.

Console

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

Vai a Code
Fai clic sul nome della coda per l'attività che vuoi eliminare.
Seleziona la casella di controllo dell'attività da eliminare.
Fai clic su Elimina attività.
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à che vuoi eliminare
QUEUE_ID: il nome della coda a cui appartiene l'attività
LOCATION: la regione in cui viene implementata la 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:

curl (Linux, macOS o Cloud Shell)

Nota: il seguente comando presuppone che tu abbia eseguito l'accesso all'interfaccia a riga di comando gcloud con il tuo account utente eseguendo gcloud init o gcloud auth login oppure utilizzando Cloud Shell, che consente di accedere automaticamente all'interfaccia a riga di comando gcloud. Puoi controllare l'account attualmente attivo eseguendo gcloud auth list.

Esegui questo comando:

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)

Nota: il comando seguente presuppone che tu abbia eseguito l'accesso all'interfaccia a riga di comando gcloud con il tuo account utente eseguendo gcloud init o gcloud auth login . Puoi controllare l'account attualmente attivo eseguendo gcloud auth list.

Esegui questo comando:

$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

Explorer API (browser)

Apri la pagina di riferimento del metodo. Sul lato destro della pagina si apre il riquadro Explorer API. Puoi interagire con questo strumento per inviare richieste. Compila i campi obbligatori e fai clic su Esegui.

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

Elimina 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 definitiva vengono eliminate definitivamente. Tuttavia, le operazioni di eliminazione possono richiedere fino a un minuto per avere effetto e le attività potrebbero essere inviate prima che l'eliminazione abbia effetto.

Console

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

Vai a Code
Fai clic sul nome della coda per le attività che vuoi eliminare.
Fai clic su Svuota coda.
Al prompt, fai clic su Elimina.

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 che vuoi eliminare
LOCATION: la regione in cui viene implementata la coda, ad esempio us-central1

REST

Per eliminare 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
PROJECT_ID: il tuo Google Cloud ID progetto
LOCATION: la regione in cui viene eseguito il deployment della coda, ad esempio us-central1

Il corpo della richiesta deve essere vuoto.

Per inviare la richiesta, espandi una di queste opzioni:

curl (Linux, macOS o Cloud Shell)

Esegui questo comando:

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)

Esegui questo comando:

$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

Explorer API (browser)

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 interrompere l'esecuzione e la pubblicazione delle attività. Puoi comunque creare attività e inviarle o aggiungerle alla coda, ma non verranno elaborate. Una volta ripresa la coda, le attività in attesa vengono elaborate nell'ordine in cui sono state aggiunte alla coda in attesa.

Console

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

Vai a Code
Seleziona la casella di controllo della coda che vuoi mettere in pausa.
Fai clic su Metti in pausa la coda.
Al prompt, fai clic su Metti in pausa.
Per riprendere la coda, fai clic su Riprendi coda.

gcloud

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 implementata la coda, ad esempio us-central1

Riprendi una coda utilizzando il comando gcloud tasks queues resume:

gcloud tasks queues resume QUEUE_ID \
    --location=LOCATION

REST

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 che vuoi mettere in pausa
- PROJECT_ID: il tuo Google Cloud ID progetto
- LOCATION: la regione in cui viene eseguito il deployment della coda, ad esempio us-central1
Il corpo della richiesta deve essere vuoto.

Per inviare la richiesta, espandi una di queste opzioni:
curl (Linux, macOS o Cloud Shell)

Nota: il seguente comando presuppone che tu abbia eseguito l'accesso all'interfaccia a riga di comando gcloud con il tuo account utente eseguendo gcloud init o gcloud auth login oppure utilizzando Cloud Shell, che consente di accedere automaticamente all'interfaccia a riga di comando gcloud. Puoi controllare l'account attualmente attivo eseguendo gcloud auth list.

Esegui questo comando:
```
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)

Nota: il comando seguente presuppone che tu abbia eseguito l'accesso all'interfaccia a riga di comando gcloud con il tuo account utente eseguendo gcloud init o gcloud auth login . Puoi controllare l'account attualmente attivo eseguendo gcloud auth list.

Esegui questo comando:
```
$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
```
Explorer API (browser)

Apri la pagina di riferimento del metodo. Sul lato destro della pagina si apre il riquadro Explorer API. Puoi interagire con questo strumento per inviare richieste. Compila i campi obbligatori e fai clic su Esegui.

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"
}
```
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 viene eseguito il deployment della coda, ad esempio us-central1
Il corpo della richiesta deve essere vuoto.

Per inviare la richiesta, espandi una di queste opzioni:
curl (Linux, macOS o Cloud Shell)

Nota: il seguente comando presuppone che tu abbia eseguito l'accesso all'interfaccia a riga di comando gcloud con il tuo account utente eseguendo gcloud init o gcloud auth login oppure utilizzando Cloud Shell, che consente di accedere automaticamente all'interfaccia a riga di comando gcloud. Puoi controllare l'account attualmente attivo eseguendo gcloud auth list.

Esegui questo comando:
```
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)

Nota: il comando seguente presuppone che tu abbia eseguito l'accesso all'interfaccia a riga di comando gcloud con il tuo account utente eseguendo gcloud init o gcloud auth login . Puoi controllare l'account attualmente attivo eseguendo gcloud auth list.

Esegui questo comando:
```
$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
```
Explorer API (browser)

Apri la pagina di riferimento del metodo. Sul lato destro della pagina si apre il riquadro Explorer API. Puoi interagire con questo strumento per inviare richieste. Compila i campi obbligatori e fai clic su Esegui.

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

Elenca code

Puoi elencare le code. Quando vengono elencate le code, vengono restituiti alcuni dettagli relativi al limite di frequenza e al parametro di riprova. Tieni presente che i seguenti campi sono equivalenti:

Max rate (console), MAX_RATE (gcloud), maxDispatchesPerSecond (REST)
Max concurrent (Console), MAX_NUM_OF_TASKS (gcloud), maxConcurrentDispatches (REST)

Console

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

Vai a Code

Vengono elencate tutte le code nel tuo progetto Google Cloud .
Per ulteriori dettagli, fai clic sul nome di una coda e poi sulla scheda Configurazione.

Vengono visualizzati i dettagli del limite di frequenza e del parametro di riprova.

gcloud

Elenca le code utilizzando il comando gcloud tasks queues list:

gcloud tasks queues list \
    --location=LOCATION

Sostituisci LOCATION con la regione in cui viene eseguito il deployment della coda, ad esempio us-central1. Se non viene specificata una località, viene utilizzata la località dell'app App Engine del tuo progetto, se esiste; in caso contrario, devi specificare una località. Google Cloud

L'output dovrebbe essere simile al seguente:

QUEUE_NAME: my-queue
STATE: PAUSED
MAX_NUM_OF_TASKS: 1000
MAX_RATE (/sec): 500.0
MAX_ATTEMPTS: 100
...

REST

Per elencare le code, utilizza il metodo projects.locations.queues.list.

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

PROJECT_ID: il tuo ID progetto Google Cloud.
LOCATION: la regione in cui vengono create le code, ad esempio us-central1.

Per inviare la richiesta, espandi una di queste opzioni:

curl (Linux, macOS o Cloud Shell)

Esegui questo comando:

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

PowerShell (Windows)

Esegui questo comando:

$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

Explorer API (browser)

In caso di esito positivo, il corpo della risposta contiene istanze di risorse Queue e la risposta dovrebbe essere simile alla seguente:

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

Elimina code

Puoi eliminare una coda. Vengono 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 errori nei processi interni durante il ciclo di eliminazione o ricreazione.

Console

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

Vai a Code
Seleziona la casella di controllo della coda da eliminare.
Fai clic su Elimina coda.
Al prompt, 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 che vuoi eliminare
LOCATION: la regione in cui viene implementata la 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 viene eseguito il deployment della coda, ad esempio us-central1

Il corpo della richiesta deve essere vuoto.

Per inviare la richiesta, espandi una di queste opzioni:

curl (Linux, macOS o Cloud Shell)

Esegui questo comando:

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)

Esegui questo comando:

$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

Explorer API (browser)

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

Gestire code e attività Mantieni tutto organizzato con le raccolte Salva e classifica i contenuti in base alle tue preferenze.

Eliminare un'attività da una coda

Console

gcloud

REST

curl (Linux, macOS o Cloud Shell)

PowerShell (Windows)

Explorer API (browser)

Elimina definitivamente tutte le attività da una coda

Console

gcloud

REST

curl (Linux, macOS o Cloud Shell)

PowerShell (Windows)

Explorer API (browser)

Mettere in pausa o riprendere le code

Console

gcloud

REST

curl (Linux, macOS o Cloud Shell)

PowerShell (Windows)

Explorer API (browser)

curl (Linux, macOS o Cloud Shell)

PowerShell (Windows)

Explorer API (browser)

Elenca code

Console

gcloud

REST

curl (Linux, macOS o Cloud Shell)

PowerShell (Windows)

Explorer API (browser)

Elimina code

Console

gcloud

REST

curl (Linux, macOS o Cloud Shell)

PowerShell (Windows)

Explorer API (browser)

Gestire code e attività