Diese Seite wurde von der Cloud Translation API übersetzt.

Warteschlangen und Aufgaben verwalten

Sie können Warteschlangen und Aufgaben auf folgende Arten verwalten:

In der Google Cloud Console
Über die Google Cloud CLI in Ihrem Terminal oder in Cloud Shell
Durch Senden einer Anfrage an die Cloud Tasks API

Aufgabe aus einer Warteschlange löschen

Sie können eine Aufgabe löschen, wenn sie geplant oder zugewiesen ist. Das Löschen einer Aufgabe ist mitunter erforderlich, wenn sie trotz wiederholter Versuche nicht erfolgreich abgeschlossen werden kann. Sie können eine Aufgabe nicht löschen, wenn sie erfolgreich abgeschlossen wurde oder wenn die Anzahl der Wiederholungsversuche nach wiederholten Fehlern überschritten wurde.

Console

Rufen Sie in der Google Cloud Console die Seite Cloud Tasks > Warteschlangen auf.

Zu Warteschlangen
Klicken Sie auf den Namen der Warteschlange für die Aufgabe, die Sie löschen möchten.
Klicken Sie auf das Kästchen neben der Aufgabe, die Sie löschen möchten.
Klicken Sie auf Aufgabe löschen.
Klicken Sie dann noch einmal auf Löschen.

gcloud

Löschen Sie eine Aufgabe mit dem Befehl gcloud tasks delete:

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

Ersetzen Sie Folgendes:

TASK_NAME: Name der Aufgabe, die Sie löschen möchten
QUEUE_ID: Der Name der Warteschlange, zu der die Aufgabe gehört.
LOCATION: die Region, in der die Warteschlange bereitgestellt wird, z. B. us-central1

REST

Wenn Sie eine Aufgabe löschen möchten, verwenden Sie die Methode projects.locations.queues.tasks.delete.

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

QUEUE_ID: der Name der Warteschlange, zu der die Aufgabe gehört
TASK_NAME: der Name der Aufgabe, die Sie löschen möchten
PROJECT_ID: Ihre Google Cloud Projekt-ID
LOCATION: die Region, in der sich die Warteschlange befindet, z. B. us-central1

Der Anfragetext muss leer sein.

Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

curl (Linux, macOS oder Cloud Shell)

Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto bei der gcloud-Befehlszeile angemeldet haben. Dazu haben Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt, die Sie automatisch bei der gcloud-Befehlszeile anmeldet. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

Führen Sie folgenden Befehl aus:

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)

Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto bei der gcloud-Befehlszeile angemeldet haben. Dazu führen Sie gcloud init oder gcloud auth login aus. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

Führen Sie folgenden Befehl aus:

$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 (Browser)

Öffnen Sie die Methodenreferenzseite. Der API Explorer wird rechts auf der Seite geöffnet. Sie können mit diesem Tool interagieren, um Anfragen zu senden. Füllen Sie die Pflichtfelder aus und klicken Sie auf Ausführen.

Wenn der Vorgang erfolgreich ist, ist der Antworttext leer.

Alle Aufgaben aus einer Warteschlange löschen

Sie können alle Aufgaben aus einer Warteschlange löschen, indem Sie sie löschen. Alle vor dem Löschen erstellten Aufgaben werden endgültig gelöscht. Es kann jedoch bis zu einer Minute dauern, bis der Löschvorgang wirksam wird. Aufgaben werden möglicherweise vor dem Löschen zugewiesen.

Console

Rufen Sie in der Google Cloud Console die Seite Cloud Tasks > Warteschlangen auf.

Zu Warteschlangen
Klicken Sie auf den Namen der Warteschlange für die Aufgaben, die Sie löschen möchten.
Klicken Sie auf Warteschlange endgültig löschen.
Klicken Sie in der Eingabeaufforderung auf Endgültig löschen.

gcloud

Leeren Sie eine Warteschlange mit dem Befehl gcloud tasks queues purge:

gcloud tasks queues purge QUEUE_ID \
    --location=LOCATION

Ersetzen Sie Folgendes:

QUEUE_ID: Der Name der Warteschlange, die Sie leeren möchten.
LOCATION: die Region, in der die Warteschlange bereitgestellt wird, z. B. us-central1

REST

Verwenden Sie zum Leeren einer Warteschlange die Methode projects.locations.queues.purge.

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

QUEUE_ID: Der Name der Warteschlange, die Sie leeren möchten.
PROJECT_ID: Ihre Google Cloud Projekt-ID
LOCATION: die Region, in der die Warteschlange bereitgestellt wird, z. B. us-central1

Der Anfragetext muss leer sein.

Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

curl (Linux, macOS oder Cloud Shell)

Führen Sie folgenden Befehl aus:

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)

Führen Sie folgenden Befehl aus:

$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 (Browser)

Wenn der Vorgang erfolgreich abgeschlossen wurde, enthält der Antworttext eine Instanz von 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"
}

Warteschlangen pausieren oder fortsetzen

Sie können eine Warteschlange pausieren oder fortsetzen. Wenn Sie eine Warteschlange pausieren, werden die Ausführung und die Bereitstellung von Aufgaben angehalten. Sie können weiterhin Aufgaben erstellen und in die Warteschlange einfügen oder anhängen, aber die Aufgaben werden nicht verarbeitet. Sobald die Warteschlange fortgesetzt wird, werden alle zurückgestellten Aufgaben in der Reihenfolge ihrer Hinzufügung zur Warteschlange verarbeitet.

Console

Rufen Sie in der Google Cloud Console die Seite Cloud Tasks > Warteschlangen auf.

Zu Warteschlangen
Klicken Sie das Kästchen neben der Warteschlange an, die Sie pausieren möchten.
Klicken Sie auf Warteschlange pausieren.
Klicken Sie in der Eingabeaufforderung auf Pausieren.
Klicken Sie auf Warteschlange fortsetzen, um die Warteschlange fortzusetzen.

gcloud

Pausieren Sie eine Warteschlange mit dem Befehl gcloud tasks queues pause:
```
gcloud tasks queues pause QUEUE_ID \
    --location=LOCATION
```
Ersetzen Sie Folgendes:
- QUEUE_ID: Name der Warteschlange, die Sie pausieren möchten
- LOCATION: die Region, in der die Warteschlange bereitgestellt wird, z. B. us-central1
Setzen Sie eine Warteschlange mit dem Befehl gcloud tasks queues resume fort:
```
gcloud tasks queues resume QUEUE_ID \
    --location=LOCATION
```

REST

Verwenden Sie zum Pausieren einer Warteschlange die Methode projects.locations.queues.pause.

Ersetzen Sie diese Werte in den folgenden Anfragedaten:
- QUEUE_ID: Name der Warteschlange, die Sie pausieren möchten
- PROJECT_ID: Ihre Google Cloud Projekt-ID
- LOCATION: die Region, in der die Warteschlange bereitgestellt wird, z. B. us-central1
Der Anfragetext muss leer sein.

Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:
curl (Linux, macOS oder Cloud Shell)

Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto bei der gcloud-Befehlszeile angemeldet haben. Dazu haben Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt, die Sie automatisch bei der gcloud-Befehlszeile anmeldet. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

Führen Sie folgenden Befehl aus:
```
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)

Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto bei der gcloud-Befehlszeile angemeldet haben. Dazu führen Sie gcloud init oder gcloud auth login aus. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

Führen Sie folgenden Befehl aus:
```
$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 (Browser)

Öffnen Sie die Methodenreferenzseite. Der API Explorer wird rechts auf der Seite geöffnet. Sie können mit diesem Tool interagieren, um Anfragen zu senden. Füllen Sie die Pflichtfelder aus und klicken Sie auf Ausführen.

Wenn der Vorgang erfolgreich abgeschlossen wurde, enthält der Antworttext eine Instanz von 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"
}
```
Verwenden Sie die Methode projects.locations.queues.resume, um eine Warteschlange fortzusetzen.

Ersetzen Sie diese Werte in den folgenden Anfragedaten:
- QUEUE_ID: Der Name der Warteschlange, die Sie fortsetzen möchten
- PROJECT_ID: Ihre Google Cloud Projekt-ID
- LOCATION: die Region, in der die Warteschlange bereitgestellt wird, z. B. us-central1
Der Anfragetext muss leer sein.

Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:
curl (Linux, macOS oder Cloud Shell)

Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto bei der gcloud-Befehlszeile angemeldet haben. Dazu haben Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt, die Sie automatisch bei der gcloud-Befehlszeile anmeldet. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

Führen Sie folgenden Befehl aus:
```
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)

Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto bei der gcloud-Befehlszeile angemeldet haben. Dazu führen Sie gcloud init oder gcloud auth login aus. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

Führen Sie folgenden Befehl aus:
```
$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 (Browser)

Öffnen Sie die Methodenreferenzseite. Der API Explorer wird rechts auf der Seite geöffnet. Sie können mit diesem Tool interagieren, um Anfragen zu senden. Füllen Sie die Pflichtfelder aus und klicken Sie auf Ausführen.

Wenn der Vorgang erfolgreich abgeschlossen wurde, enthält der Antworttext eine Instanz von 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"
}
```

Warteschlangen auflisten

Sie können Warteschlangen auflisten. Beim Auflisten von Warteschlangen werden einige Details zu Ratenlimits und Wiederholungsparametern zurückgegeben. Die folgenden Felder sind gleichwertig:

Max. Rate (Console), MAX_RATE (gcloud), maxDispatchesPerSecond (REST)
Max concurrent (Konsole), MAX_NUM_OF_TASKS (gcloud), maxConcurrentDispatches (REST)

Console

Rufen Sie in der Google Cloud Console die Seite Cloud Tasks > Warteschlangen auf.

Zu Warteschlangen

Alle Warteschlangen in Ihrem Google Cloud Projekt werden aufgelistet.
Klicken Sie auf den Namen einer Warteschlange und dann auf den Tab Konfiguration, um weitere Informationen zu erhalten.

Details zu Ratenbegrenzung und Wiederholungsparametern werden angezeigt.

gcloud

Listen Sie Warteschlangen mit dem Befehl gcloud tasks queues list auf:

gcloud tasks queues list \
    --location=LOCATION

Ersetzen Sie LOCATION durch die Region, in der die Warteschlange bereitgestellt wird, z. B. us-central1. Wenn kein Standort angegeben ist, wird der Standort der App Engine-App Ihres Google Cloud Projekts verwendet, sofern sie vorhanden ist. Andernfalls müssen Sie einen Standort angeben.

Die Ausgabe sollte in etwa so aussehen:

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

REST

Verwenden Sie zum Auflisten von Warteschlangen die Methode projects.locations.queues.list.

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

PROJECT_ID: Ihre Google CloudProjekt-ID.
LOCATION: die Region, in der die Warteschlangen erstellt werden, z. B. us-central1.

Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

curl (Linux, macOS oder Cloud Shell)

Führen Sie folgenden Befehl aus:

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

PowerShell (Windows)

Führen Sie folgenden Befehl aus:

$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 (Browser)

Wenn der Vorgang erfolgreich ist, enthält der Antworttext Instanzen von Queue-Ressourcen und die Antwort sollte in etwa so aussehen:

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

Warteschlangen löschen

Sie können eine Warteschlange löschen. Alle Aufgaben in der Warteschlange werden ebenfalls gelöscht. Wenn Sie eine Warteschlange löschen, müssen Sie drei Tage warten, bevor Sie sie mit demselben Namen neu erstellen können. Diese Wartezeit verhindert unerwartetes Verhalten bei Aufgaben, die zum Zeitpunkt des Löschens ausgeführt werden oder auf die Ausführung warten. Außerdem werden dadurch Fehler bei internen Prozessen im Lösch- oder Neuerstellungszyklus vermieden.

Console

Rufen Sie in der Google Cloud Console die Seite Cloud Tasks > Warteschlangen auf.

Zu Warteschlangen
Klicken Sie auf das Kästchen neben der Warteschlange, die Sie löschen möchten.
Klicken Sie auf Warteschlange löschen.
Geben Sie an der Eingabeaufforderung den Namen der Warteschlange ein und klicken Sie auf Bestätigen.

gcloud

Löschen Sie eine Warteschlange mit dem Befehl gcloud tasks queues delete:

gcloud tasks queues delete QUEUE_ID \
    --location=LOCATION

Ersetzen Sie Folgendes:

QUEUE_ID: der Name der Warteschlange, die Sie löschen möchten
LOCATION: die Region, in der die Warteschlange bereitgestellt wird, z. B. us-central1

REST

Wenn Sie eine Warteschlange löschen möchten, verwenden Sie die Methode projects.locations.queues.delete.

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

QUEUE_ID: Der Name der Warteschlange, die Sie löschen möchten.
PROJECT_ID: Ihre Google Cloud Projekt-ID
LOCATION: die Region, in der die Warteschlange bereitgestellt wird, z. B. us-central1

Der Anfragetext muss leer sein.

Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

curl (Linux, macOS oder Cloud Shell)

Führen Sie folgenden Befehl aus:

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)

Führen Sie folgenden Befehl aus:

$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 (Browser)

Wenn der Vorgang erfolgreich ist, ist der Antworttext leer.

Warteschlangen und Aufgaben verwalten Mit Sammlungen den Überblick behalten Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.

Aufgabe aus einer Warteschlange löschen

Console

gcloud

REST

curl (Linux, macOS oder Cloud Shell)

PowerShell (Windows)

APIs Explorer (Browser)

Alle Aufgaben aus einer Warteschlange löschen

Console

gcloud

REST

curl (Linux, macOS oder Cloud Shell)

PowerShell (Windows)

APIs Explorer (Browser)

Warteschlangen pausieren oder fortsetzen

Console

gcloud

REST

curl (Linux, macOS oder Cloud Shell)

PowerShell (Windows)

APIs Explorer (Browser)

curl (Linux, macOS oder Cloud Shell)

PowerShell (Windows)

APIs Explorer (Browser)

Warteschlangen auflisten

Console

gcloud

REST

curl (Linux, macOS oder Cloud Shell)

PowerShell (Windows)

APIs Explorer (Browser)

Warteschlangen löschen

Console

gcloud

REST

curl (Linux, macOS oder Cloud Shell)

PowerShell (Windows)

APIs Explorer (Browser)

Warteschlangen und Aufgaben verwalten