Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Regions-ID
REGION_ID ist ein abgekürzter Code, den Google anhand der Region zuweist, die Sie beim Erstellen Ihrer Anwendung ausgewählt haben. Der Code bezieht sich nicht auf ein Land oder eine Provinz, auch wenn einige Regions-IDs häufig verwendeten Länder- und Provinzcodes ähneln können. Bei Anwendungen, die nach Februar 2020 erstellt wurden, ist REGION_ID.r in den App Engine-URLs enthalten. Bei Anwendungen, die vor diesem Datum erstellt wurden, ist die Regions-ID in der URL optional.
Mit der Konfigurationsdatei queue.yaml werden fast alle Aufgabenwarteschlangen erstellt und konfiguriert (Push), die Ihre Anwendung verwendet. Alle App Engine-Anwendungen enthalten eine automatisch vorkonfigurierte Push-Warteschlange mit dem Namen default. Obwohl Sie die Warteschlange default nicht selbst erstellen, können Sie mithilfe der Datei queue.yaml andere Warteschlangen hinzufügen oder die Konfiguration der Warteschlange default ändern.
Zum Konfigurieren von Push-Warteschlangen können Sie entweder die Methode queue.yaml oder die Warteschlangenverwaltung von Cloud Tasks verwenden, aber nicht gleichzeitig. Die Kombination der Uploadmethode queue.yaml mit den Methoden zur Warteschlangenverwaltung kann zu unerwarteten Ergebnissen führen und wird nicht empfohlen.
Beispiel
Das folgende grundlegende Beispiel definiert eine benannte Warteschlange und überschreibt die Standardverarbeitungsrate:
queue:- name: my-push-queue rate: 1/s
Im Folgenden sehen Sie ein komplexeres Beispiel für eine queue.yaml-Konfiguration, die das Einrichten der Anzahl der Aufgabenversuche und das Ändern der Standardverarbeitungsrate veranschaulicht.
Die Datei queue.yaml ist eine YAML-Datei, deren Stammanweisung queue lautet.
Diese Anweisung enthält null oder mehr benannte Warteschlangen. In jeder Warteschlangendefinition können die folgenden Elemente angegeben sein:
Element
Beschreibung
bucket_size Push-Warteschlangen
Optional. Eine Aufgabenwarteschlange steuert die Ausführungsrate von Aufgaben mit dem Token-Bucket-Algorithmus. Jede benannte Warteschlange hat einen Token-Bucket mit Tokens, deren maximale Anzahl durch den Wert von bucket_size angegeben wird. Bei jeder Ausführung einer Aufgabe durch die Anwendung wird ein Token aus dem Bucket entnommen.
Die Verarbeitung der Aufgaben in der Warteschlange wird fortgesetzt, bis keine Tokens mehr im Bucket der Warteschlange vorhanden sind. App Engine füllt den Bucket auf der Basis der Rate, die Sie für die Warteschlange angegeben haben, kontinuierlich mit neuen Tokens auf.
Wenn die Warteschlange viele Aufgaben enthält und die Rate hoch ist, wird die Verarbeitungsgeschwindigkeit der Warteschlange von der Bucket-Größe beschränkt. Der maximale Wert für die Bucket-Größe beträgt 500. So können Sie eine hohe Rate festlegen, damit eine Aufgabe sofort nach Einreihung in der Warteschlange verarbeitet wird, gleichzeitig jedoch die Ressourcennutzung beschränken, wenn viele Aufgaben innerhalb eines kurzen Zeitraums in die Warteschlange eingereiht werden.
Wenn Sie für eine Warteschlange keinen Wert für bucket_size festlegen, beträgt der Standardwert 5. Wir empfehlen, einen größeren Wert anzugeben, da die Standardgröße für viele Anwendungsfälle eventuell zu klein ist. Sie können beispielsweise die Bucket-Größe anhand der Verarbeitungsrate ermitteln.
Weitere Informationen zu diesem Element finden Sie in der vergleichenden Beschreibung von max_burst_size.
in der Cloud Tasks API-Referenz.
max_concurrent_requests Push-Warteschlangen
Optional.
Legt die maximale Anzahl von Aufgaben fest, die in der angegebenen Warteschlange gleichzeitig ausgeführt werden können. Bei dem Wert handelt es sich um eine ganze Zahl. Das Limit liegt standardmäßig bei 1.000 Aufgaben pro Warteschlange. Die empfohlene Obergrenze liegt bei 5.000 Aufgaben pro Warteschlange. Beachten Sie, dass die Warteschlangen möglicherweise langsam anlaufen, wenn sie neu erstellt oder längere Zeit nicht verwendet wurden.
Durch Beschränkung der Anzahl gleichzeitig ausgeführter Aufgaben können Sie die Ausführungsrate der Warteschlange besser kontrollieren und verhindern, dass zu viele Aufgaben gleichzeitig ausgeführt werden. Außerdem lassen sich damit Konflikte im Datenspeicher vermeiden und Ressourcen für andere Warteschlangen oder für die Onlineverarbeitung verfügbar machen.
Weitere Informationen zu diesem Element finden Sie in der vergleichenden Beschreibung von max_concurrent_dispatches in der Cloud Tasks API-Referenz.
name
Erforderlich.
Der Name der Warteschlange.
Ein Warteschlangenname kann Groß- und Kleinbuchstaben, Zahlen und Bindestriche enthalten. Warteschlangennamen dürfen maximal 100 Zeichen lang sein.
Alle Anwendungen haben eine Push-Warteschlange mit dem Namen "default". Bei dieser Warteschlange ist eine Rate von 5 Aufgaben pro Sekunde voreingestellt. Beachten Sie, dass diese Standardwarteschlange erst in der Google Cloud Console angezeigt wird, wenn sie zum ersten Mal verwendet oder konfiguriert wird.
Sie können die Standardwarteschlange konfigurieren und damit die Standardrate ändern. Dazu definieren Sie eine Warteschlange mit dem Namen "default" in der Datei queue.yaml.
rate Push-Warteschlangen
Erforderlich.
Die Häufigkeit, mit der Aufgaben in dieser Warteschlange verarbeitet werden. Der Wert ist eine Zahl, nach der ein Schrägstrich und eine Zeiteinheit folgen: s für Sekunden, m für Minuten, h für Stunden oder d für Tage. Zum Beispiel gibt der Wert 5/m an, dass Aufgaben mit einer Rate von fünfmal pro Minute verarbeitet werden. Der Maximalwert für rate ist 500/s.
Wenn die Zahl 0 lautet (also 0/s), gilt die Warteschlange als "angehalten" und es werden keine Aufgaben verarbeitet.
Weitere Informationen zu diesem Element finden Sie in der vergleichenden Beschreibung von max_dispatches_per_second in der Cloud Tasks API-Referenz.
retry_parameters
Optional.
Konfiguriert Wiederholungsversuche für fehlgeschlagene Aufgaben in Push-Warteschlangen. Durch diese Ergänzung können Sie die maximale Anzahl an erneuten Versuchen für nicht ausgeführte Aufgaben in einer bestimmten Warteschlange angeben. Sie können auch ein Zeitlimit für Wiederholungsversuche festlegen und den Zeitabstand zwischen den Versuchen steuern.
Die Wiederholungsparameter können folgende Unterelemente enthalten:
task_retry_limit
Die Anzahl der Wiederholungen. Wenn beispielsweise 0 angegeben ist und die Aufgabe fehlschlägt, wird sie nicht wiederholt. Wenn 1 angegeben ist und die Aufgabe fehlschlägt, wird die Aufgabe einmal wiederholt. Wenn dieser Parameter nicht angegeben ist, wird die Aufgabe unbegrenzt wiederholt. Wenn task_retry_limit mit task_age_limit angegeben wird, wird die Aufgabe wiederholt, bis beide Limits erreicht sind.
task_age_limit Push-Warteschlangen
Das Zeitlimit für die Wiederholung einer fehlgeschlagenen Aufgabe, gemessen ab der ersten Ausführung der Aufgabe. Der Wert ist eine Zahl, auf die eine Zeiteinheit folgt: s für Sekunden, m für Minuten, h für Stunden oder d für Tage.
Der Wert 5d gibt beispielsweise ein Zeitlimit von fünf Tagen nach dem ersten Ausführungsversuch der Aufgabe an. Falls dieser Parameter nicht angegeben ist, wird die Aufgabe unbegrenzt wiederholt. Bei Angabe mit task_retry_limit wiederholt App Engine die Ausführung der Aufgabe, bis beide Limits erreicht sind.
min_backoff_seconds Push-Warteschlangen
Die minimale Wartezeit in Sekunden, bevor eine fehlgeschlagene Aufgabe wiederholt wird. Der Standardwert ist 0.1.
max_backoff_seconds Push-Warteschlangen
Die maximale Wartezeit in Sekunden, bevor eine fehlgeschlagene Aufgabe wiederholt wird. Der Standardwert ist 3600.
max_doublings Push-Warteschlangen
Die maximale Häufigkeit, mit der das Intervall zwischen fehlgeschlagenen Aufgabenwiederholungen verdoppelt wird, bevor die Erhöhung konstant wird. Die Konstante lautet 2**max_doublings * min_backoff_seconds.
Der Standardwert ist 16.
target Push-Warteschlangen
Optional.
Ein String mit dem Namen eines Dienstes/einer Version, einer Frontend-Version oder eines Back-Ends für die Ausführung aller Aufgaben in der jeweiligen Warteschlange. Der Standardwert ist ein leerer String.
Der String wird beim Erstellen der HTTP-Anfrage für eine Aufgabe dem Domainnamen der Anwendung vorangestellt. Beispiel: Wenn Ihre Anwendungs-ID my-app lautet und Sie das Ziel auf my-version-dot-my-service setzen, wird der URL-Hostname auf my-version-dot-my-service-dot-my-app.REGION_ID.r.appspot.com gesetzt.
Wird kein Ziel angegeben, werden Aufgaben in der gleichen Version der Anwendung aufgerufen, aus der sie in die Warteschlange gestellt wurden. Wenn Sie also eine Aufgabe aus der Standardversion der Anwendung in die Warteschlange stellen, ohne ein Ziel für die Warteschlange anzugeben, wird die Aufgabe in der Standardversion der Anwendung aufgerufen.
Wenn sich die Standardversion der Anwendung zwischen dem Zeitpunkt, an dem die Aufgabe in die Warteschlange gestellt wurde, und dem Zeitpunkt ihrer Ausführung ändert, wird die Aufgabe in der neuen Standardversion ausgeführt.
Wenn Sie Dienste zusammen mit einer Weiterleitungsdatei verwenden, kann die HTTP-Anfrage der Aufgabe abgefangen und an einen anderen Dienst weitergeleitet werden.
Folgende Elemente können für alle Warteschlangen in einer Anwendung angegeben werden:
Element
Beschreibung
Konfigurationsdatei für Warteschlangen erstellen
Die Datei queue.yaml sollte sich im Stammverzeichnis oder im Verzeichnis befinden, das den Standarddienst definiert.
Mit dem folgenden Befehl stellen Sie die Warteschlangen-Konfigurationsdatei bereit:
gcloud app deploy queue.yaml
Warteschlangen löschen
So löschen Sie eine Warteschlange:
Entfernen Sie die Warteschlangendefinition aus der Datei queue.yaml.
Laden Sie die Änderung in Ihre queue.yaml-Datei hoch.
gcloud app deploy queue.yaml
Löschen Sie die Warteschlange in der Google Cloud Console, wählen Sie die Warteschlange aus und klicken Sie auf Warteschlange löschen:
Wenn Sie eine Warteschlange über die Google Cloud Console löschen, können Sie erst nach sieben Tagen eine Warteschlange mit dem gleichen Namen erstellen.
[[["Leicht verständlich","easyToUnderstand","thumb-up"],["Mein Problem wurde gelöst","solvedMyProblem","thumb-up"],["Sonstiges","otherUp","thumb-up"]],[["Schwer verständlich","hardToUnderstand","thumb-down"],["Informationen oder Beispielcode falsch","incorrectInformationOrSampleCode","thumb-down"],["Benötigte Informationen/Beispiele nicht gefunden","missingTheInformationSamplesINeed","thumb-down"],["Problem mit der Übersetzung","translationIssue","thumb-down"],["Sonstiges","otherDown","thumb-down"]],["Zuletzt aktualisiert: 2025-04-21 (UTC)."],[[["\u003cp\u003eThe \u003ccode\u003eREGION_ID\u003c/code\u003e is a code assigned by Google based on the region selected during app creation, included in App Engine URLs for apps created after February 2020, but it does not directly correspond to specific countries or provinces.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003equeue.yaml\u003c/code\u003e file configures push task queues for App Engine apps, including the default queue, and allows adding additional queues or altering the default queue's settings.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003equeue.yaml\u003c/code\u003e and Cloud Tasks Queue Management methods should not be mixed when configuring push queues, as doing so can cause unexpected issues, which is why it is recommended to use one method or the other.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003equeue.yaml\u003c/code\u003e file defines queue elements like \u003ccode\u003ebucket_size\u003c/code\u003e, \u003ccode\u003emax_concurrent_requests\u003c/code\u003e, \u003ccode\u003ename\u003c/code\u003e, \u003ccode\u003erate\u003c/code\u003e, \u003ccode\u003eretry_parameters\u003c/code\u003e, and \u003ccode\u003etarget\u003c/code\u003e, which control how tasks are processed and managed.\u003c/p\u003e\n"],["\u003cp\u003eTo deploy changes made in \u003ccode\u003equeue.yaml\u003c/code\u003e you need to run \u003ccode\u003egcloud app deploy queue.yaml\u003c/code\u003e, and to delete a queue, its definition must be removed from the file, deployed, and then deleted in the Google Cloud console.\u003c/p\u003e\n"]]],[],null,["# queue.yaml Reference\n\n### Region ID\n\nThe \u003cvar translate=\"no\"\u003eREGION_ID\u003c/var\u003e is an abbreviated code that Google assigns\nbased on the region you select when you create your app. The code does not\ncorrespond to a country or province, even though some region IDs may appear\nsimilar to commonly used country and province codes. For apps created after\nFebruary 2020, \u003cvar translate=\"no\"\u003eREGION_ID\u003c/var\u003e`.r` is included in\nApp Engine URLs. For existing apps created before this date, the\nregion ID is optional in the URL.\n\nLearn more\n[about region IDs](/appengine/docs/legacy/standard/php/how-requests-are-routed#region-id). \nOK\n\nThe `queue.yaml` configuration file is used to create and configure almost all\nof the task queues\n\n\n([push](/appengine/docs/legacy/standard/php/taskqueue/push))\nyour app uses. All App Engine apps come with\nan automatically preconfigured push queue named `default`. Although you do not\ncreate the `default` queue yourself, you can add other queues or change the\nconfiguration of the `default` queue using the `queue.yaml` file.\n\n\u003cbr /\u003e\n\nTo configure push queues, you can use either `queue.yaml` or\n[Queue Management](/tasks/docs/queue-yaml) methods from Cloud Tasks, but\n[not both](/tasks/docs/queue-yaml#pitfalls) at the same time. Mixing the\n`queue.yaml` upload method with Queue Management methods can produce unexpected\nresults and is not recommended.\n\n\u003cbr /\u003e\n\n| **Caution:** Uploading a `queue.yaml` file via the gcloud CLI below version `332.0.0` uses a deprecated interface to the service. Starting on `2022-09-20`, attempts to use the upload method can fail with server errors. To resolve this, make sure the Cloud Tasks API is enabled in your project and your gcloud CLI is updated to at least version `332.0.0`.\n\nExample\n-------\n\nThe following a basic example that defines a named queue and overrides the\ndefault processing rate: \n\n queue:\n - name: my-push-queue\n rate: 1/s\n\nThe following is a more complex example of a `queue.yaml` configuration that\ndemonstrates setting up the number of task tries and modifying the default processing rate. \n\n queue:\n - name: fooqueue\n rate: 1/s\n retry_parameters:\n task_retry_limit: 7\n task_age_limit: 2d\n - name: barqueue\n rate: 1/s\n retry_parameters:\n min_backoff_seconds: 10\n max_backoff_seconds: 200\n max_doublings: 0\n - name: bazqueue\n rate: 1/s\n retry_parameters:\n min_backoff_seconds: 10\n max_backoff_seconds: 200\n max_doublings: 3\n\nSyntax\n------\n\nThe `queue.yaml` file is a YAML file whose root directive is `queue`.\nThis directive contains zero or more named queues. Each queue definition can\nspecify the following elements:\n\nThe following elements can be specified for all queues within an app:\n\nDeploying the queue configuration file\n--------------------------------------\n\nThe `queue.yaml` file should reside in the root directory or in the directory that defines the default service.\n\nTo deploy the queue configuration file, run the following command: \n\n gcloud app deploy queue.yaml\n\nDeleting queues\n---------------\n\nTo delete a queue:\n\n1. Remove the queue definition from your `queue.yaml` file.\n\n2. Upload the change to your `queue.yaml` file.\n\n gcloud app deploy queue.yaml\n3. Delete the queue in the Google Cloud console, select the queue and click\n **Delete queue**:\n\n [Go to the Task queues page](https://console.cloud.google.com/appengine/taskqueues)\n\nIf you delete a queue from the Google Cloud console, you must wait 7 days\nbefore recreating with the same name."]]
