Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

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 registrato errori costanti. Un'attività viene eliminata automaticamente se viene raggiunto il limite di conservazione massima delle attività.

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 per l'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 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 sostituzioni seguenti:

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.

Eliminare un batch di attività da una coda

Puoi eliminare un batch di attività da una coda utilizzando il metodo projects.locations.queues.tasks.batchDelete per eliminare un elenco di nomi di attività.

Tieni presente quanto segue:

Tutte le attività devono essere eliminate dalla stessa coda.
Esiste un limite al numero di attività che possono essere eliminate in un singolo batch. Per saperne di più, consulta Quote e limiti.
Le richieste batch, che aggregano singole operazioni in un'unica richiesta, non sono atomiche perché è possibile che alcune delle operazioni contenute nel batch non vadano a buon fine, mentre altre sì.
Puoi eliminare un'attività solo se è pianificata o inviata. Non puoi eliminare un'attività se è stata completata correttamente o se ha esaurito i tentativi dopo errori ripetuti. Un'attività viene eliminata automaticamente se viene raggiunto il limite di conservazione massima delle attività.
Puoi anche creare un batch di attività. Per ulteriori informazioni, vedi Creare un batch di attività.

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

TASK_NAME: il nome delle attività da eliminare nel seguente formato: projects/PROJECT_ID/locations/REGION/queues/QUEUE_ID/tasks/TASK_ID
PROJECT_ID: il tuo Google Cloud ID progetto
REGION: la regione in cui esiste la coda, ad esempio us-central1
QUEUE_ID: il nome della coda a cui appartengono i task

Il corpo della richiesta contiene un elenco di nomi di attività.

Corpo JSON della richiesta:

{
  "names": [
    "TASK_NAME"
  ]
}

Per inviare la richiesta, espandi una di queste opzioni:

curl (Linux, macOS o Cloud Shell)

Salva il corpo della richiesta in un file denominato request.json. Esegui questo comando nel terminale per creare o sovrascrivere questo file nella directory corrente:

cat > request.json << 'EOF'
{
  "names": [
    "TASK_NAME"
  ]
}
EOF

Quindi esegui questo comando per inviare la richiesta REST:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://cloudtasks.googleapis.com/v2beta3/projects/PROJECT_ID/locations/REGION/queues/QUEUE_ID/tasks:batchDelete"

PowerShell (Windows)

Salva il corpo della richiesta in un file denominato request.json. Esegui questo comando nel terminale per creare o sovrascrivere questo file nella directory corrente:

@'
{
  "names": [
    "TASK_NAME"
  ]
}
'@  | Out-File -FilePath request.json -Encoding utf8

Quindi esegui questo comando per inviare la richiesta REST:

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

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://cloudtasks.googleapis.com/v2beta3/projects/PROJECT_ID/locations/REGION/queues/QUEUE_ID/tasks:batchDelete" | Select-Object -Expand Content

Explorer API (browser)

Copia il corpo della richiesta e 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. Incolla il corpo della richiesta in questo strumento, compila gli altri campi obbligatori e fai clic su Esegui.

In caso di esito positivo, il corpo della risposta contiene un'istanza di Operation.

{
  "name": "projects/PROJECT_ID/locations/REGION/operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.tasks.v2beta3.BatchDeleteTasksMetadata"
  },
  "done": false
}

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 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 eseguito il deployment della 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 sostituzioni seguenti:

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. La messa in pausa di una coda comporta l'interruzione dell'esecuzione e della distribuzione 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 per la 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 eseguito il deployment della 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 sostituzioni seguenti:
- 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 sostituzioni seguenti:
- 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 ripetizione. Tieni presente che i seguenti campi sono equivalenti:

Frequenza massima (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 dei parametri di limitazione della frequenza e dei tentativi.

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 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 sostituzioni seguenti:

PROJECT_ID: il tuo Google Cloud ID progetto.
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 tutte 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 essere eseguite. 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 per la 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 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 sostituzioni seguenti:

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)

Eliminare un batch di attività da una coda

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)

Passaggi successivi

Gestire code e attività