Feedback

az batch job

  • Referenz

Batchaufträge verwalten.

Befehle

az batch job all-statistics

Anzeigen von Statistiken aller Aufträge unter einem Batchkonto.
az batch job all-statistics show

Abrufen von Lebenszykluszusammenfassungsstatistiken für alle Aufträge in einem Batchkonto.
az batch job create

Fügen Sie einem Batchkonto einen Auftrag hinzu.
az batch job delete

Löscht einen Auftrag.
az batch job disable

Deaktiviert den angegebenen Auftrag, um zu verhindern, dass neue Vorgänge ausgeführt werden.
az batch job enable

Aktiviert den angegebenen Auftrag, sodass neue Vorgänge ausgeführt werden können.
az batch job list

Alle Aufträge oder Auftragspläne in einem Batchkonto auflisten.
az batch job prep-release-status

Zeigen Sie den Status der Batchauftragsvorbereitung und -freigabeaufgaben an.
az batch job prep-release-status list

Enthält den Ausführungsstatus des Auftragsvorbereitungs- und Auftragsfreigabevorgangs für den angegebenen Auftrag über die Computeknoten, in denen der Auftrag ausgeführt wird.
az batch job reset

Aktualisieren sie die Eigenschaften eines Batchauftrags. Nicht angegebene Eigenschaften, die aktualisiert werden können, werden auf ihre Standardeinstellungen zurückgesetzt.
az batch job set

Aktualisieren sie die Eigenschaften eines Batchauftrags. Das Aktualisieren einer Eigenschaft in einer Untergruppe setzt die nicht angegebenen Eigenschaften dieser Gruppe zurück.
az batch job show

Ruft Informationen zu dem angegebenen Auftrag ab.
az batch job stop

Beenden Eines ausgeführten Batchauftrags.
az batch job task-counts

Zeigen Sie die Anzahl der Aufgaben und Steckplätze in einem Batchauftrag und ihren Status an.
az batch job task-counts show

Ruft die Aufgabenanzahl für den angegebenen Auftrag ab.

az batch job create

Bearbeiten

Fügen Sie einem Batchkonto einen Auftrag hinzu.

az batch job create [--account-endpoint]
                    [--account-key]
                    [--account-name]
                    [--allow-task-preemption]
                    [--id]
                    [--job-manager-task-command-line]
                    [--job-manager-task-environment-settings]
                    [--job-manager-task-id]
                    [--job-manager-task-resource-files]
                    [--job-max-task-retry-count]
                    [--job-max-wall-clock-time]
                    [--json-file]
                    [--max-parallel-tasks]
                    [--metadata]
                    [--pool-id]
                    [--priority]
                    [--required-slots]
                    [--uses-task-dependencies]

Optionale Parameter

--account-endpoint

Batchdienstendpunkt. Alternativ können Sie eine Umgebungsvariable festlegen: AZURE_BATCH_ENDPOINT.

--account-key

Batchkontoschlüssel. Alternativ können Sie eine Umgebungsvariable festlegen: AZURE_BATCH_ACCESS_KEY.

--account-name

Batchkontoname. Alternativ können Sie eine Umgebungsvariable festlegen: AZURE_BATCH_ACCOUNT.

--allow-task-preemption

Ob Aufgaben in diesem Auftrag von anderen hohen Prioritätsaufträgen vorgesetzt werden können. Wenn der Wert auf "True" festgelegt ist, nehmen andere an das System übermittelte Aufträge Vorrang und können Vorgänge aus diesem Auftrag erneut queue. Sie können die AllowTaskPreemption eines Auftrags aktualisieren, nachdem sie mithilfe der Updateauftrags-API erstellt wurde. True, wenn das Flag vorhanden ist.

--id

Erforderlich. Die ID kann eine beliebige Kombination aus alphanumerischen Zeichen enthalten, einschließlich Bindestrichen und Unterstrichen, und kann nicht mehr als 64 Zeichen enthalten. Die ID ist groß- und kleinschreibungsgeschützt (das heißt, Sie verfügen möglicherweise nicht über zwei IDs innerhalb eines Kontos, die sich nur nach Groß-/Kleinschreibung unterscheiden).

--job-manager-task-command-line

Erforderlich. Die Befehlszeile wird nicht unter einer Shell ausgeführt und kann daher nicht von Shellfeatures wie der Erweiterung von Umgebungsvariablen profitieren. Wenn Sie solche Features nutzen möchten, sollten Sie die Shell in der Befehlszeile aufrufen, z. B. mithilfe von "cmd /c MyCommand" in Windows oder "/bin/bin-c MyCommand" in Linux. Wenn sich die Befehlszeile auf Dateipfade bezieht, sollte ein relativer Pfad (relativ zum Arbeitsverzeichnis "Vorgang") verwendet werden, oder verwenden Sie die bereitgestellte Batch-Umgebungsvariable (https://docs.microsoft.com/en-us/azure/batch/batch-compute-node-environment-variables).

--job-manager-task-environment-settings

Leerzeichentrennte Werte im Format 'key=value'.

--job-manager-task-id

Erforderlich. Die ID kann eine beliebige Kombination aus alphanumerischen Zeichen enthalten, einschließlich Bindestrichen und Unterstrichen und kann nicht mehr als 64 Zeichen enthalten.

--job-manager-task-resource-files

Dateien, die unter diesem Element aufgeführt sind, befinden sich im Arbeitsverzeichnis des Vorgangs. Es gibt eine maximale Größe für die Liste der Ressourcendateien. Wenn die maximale Größe überschritten wird, schlägt die Anforderung fehl, und der Antwortfehlercode ist RequestEntityTooLarge. Wenn dies geschieht, muss die Auflistung von ResourceFiles in der Größe reduziert werden. Dies kann mithilfe von .zip Dateien, Anwendungspaketen oder Docker-Containern erreicht werden. Leergetrennte Ressourcenbezüge im Dateiname=httpurl-Format.

--job-max-task-retry-count

Die maximale Anzahl der Zeiten, in denen jeder Vorgang erneut ausgeführt werden kann. Der Batchdienst ruft einen Vorgang zurück, wenn sein Exitcode nicht zero ist. Beachten Sie, dass dieser Wert die Anzahl der Wiederholungen ausdrücklich steuert. Der Batchdienst versucht einmal jeden Vorgang, und kann dann bis zu diesem Grenzwert erneut versuchen. Wenn beispielsweise die maximale Wiederholungsanzahl 3 beträgt, versucht Batch bis zu 4 Mal einen Vorgang (ein anfängliches Versuch und 3 Wiederholungsversuche). Wenn die maximale Wiederholungsanzahl 0 ist, wird der Batchdienst keine Aufgaben erneut wiederholen. Wenn die maximale Wiederholungsanzahl -1 lautet, werden die Aufgaben des Batchdiensts ohne Grenzwert erneut aktualisiert. Der Standardwert ist 0 (keine Wiederholungsversuche).

--job-max-wall-clock-time

Wenn der Auftrag innerhalb des Zeitlimits nicht abgeschlossen ist, beendet der Batchdienst sie und alle Vorgänge, die noch ausgeführt werden. In diesem Fall wird der Kündigungsgrund MaxWallClockTimeExpiry sein. Wenn diese Eigenschaft nicht angegeben ist, gibt es keine Zeitbeschränkung für die Dauer des Auftrags. Das erwartete Format ist eine ISO-8601-Dauer.

--json-file

Eine Datei, die die Auftragsspezifikation in JSON enthält (formatiert, um dem jeweiligen REST-API-Textkörper zu entsprechen). Wenn dieser Parameter angegeben wird, werden alle 'Jobargumente' ignoriert.

--max-parallel-tasks

Die maximale Anzahl von Vorgängen, die parallel für den Auftrag ausgeführt werden können. Der Wert von maxParallelTasks muss -1 oder größer als 0 sein, wenn angegeben. Wenn nicht angegeben, ist der Standardwert -1, was bedeutet, dass es keine Beschränkung auf die Anzahl der Vorgänge gibt, die gleichzeitig ausgeführt werden können. Sie können die maxParallelTasks eines Auftrags aktualisieren, nachdem sie mithilfe der Updateauftrags-API erstellt wurde. Standardwert: -1 .

--metadata

Der Batchdienst weist keine Bedeutung für Metadaten zu; es ist ausschließlich für die Verwendung von Benutzercode. Leerzeichentrennte Werte im Format 'key=value'.

--pool-id

Die ID eines vorhandenen Pools. Alle Aufgaben des Auftrags werden im angegebenen Pool ausgeführt.

--priority

Die Priorität des Auftrags. Die Prioritätswerte reichen von -1.000 bis 1.000. Dabei ist -1.000 die niedrigste Priorität und 1000 die höchste Priorität. Der Standardwert ist 0.

--required-slots

Die Anzahl der Terminplanungsplätze, die der Vorgang ausführen muss. Der Standardwert ist 1. Eine Aufgabe kann nur für die Ausführung auf einem Berechnungsknoten geplant werden, wenn der Knoten genügend freie Terminplanungsplätze zur Verfügung hat. Für Multiinstanzenaufgaben wird diese Eigenschaft nicht unterstützt und darf nicht angegeben werden.

--uses-task-dependencies

Ob Aufgaben im Auftrag Abhängigkeiten voneinander definieren können. Die Standardeinstellung ist „false“. True, wenn das Flag vorhanden ist.

az batch job delete

Bearbeiten

Löscht einen Auftrag.

Das Löschen eines Auftrags löscht auch alle Aufgaben, die Teil dieses Auftrags sind, und alle Auftragsstatistiken. Dadurch wird auch der Aufbewahrungszeitraum für Aufgabendaten außer Kraft gesetzt; das heißt, wenn der Auftrag Aufgaben enthält, die weiterhin auf Computeknoten aufbewahrt werden, löscht die Batchdienste die Arbeitsverzeichnisse der Aufgaben und alle ihre Inhalte. Wenn eine Löschauftragsanforderung empfangen wird, legt der Batchdienst den Auftrag auf den Löschzustand fest. Alle Aktualisierungsvorgänge auf einem Auftrag, der sich im Löschenzustand befindet, schlägt mit Statuscode 409 (Konflikt) fehl, mit zusätzlichen Informationen, die angeben, dass der Auftrag gelöscht wird.

az batch job delete --job-id
                    [--account-endpoint]
                    [--account-key]
                    [--account-name]
                    [--if-match]
                    [--if-modified-since]
                    [--if-none-match]
                    [--if-unmodified-since]
                    [--yes]

Erforderliche Parameter

--job-id

Die ID des zu löschenden Auftrags.

Optionale Parameter

--account-endpoint

Batchdienstendpunkt. Alternativ können Sie eine Umgebungsvariable festlegen: AZURE_BATCH_ENDPOINT.

--account-key

Batchkontoschlüssel. Alternativ können Sie eine Umgebungsvariable festlegen: AZURE_BATCH_ACCESS_KEY.

--account-name

Batchkontoname. Alternativ können Sie eine Umgebungsvariable festlegen: AZURE_BATCH_ACCOUNT.

--if-match

Ein ETag-Wert, der der Version der Ressource zugeordnet ist, die dem Client bekannt ist. Der Vorgang wird nur ausgeführt, wenn das aktuelle ETag der Ressource im Dienst genau dem vom Client angegebenen Wert entspricht.

--if-modified-since

Ein Zeitstempel, der die letzte Änderungszeit der Ressource angibt, die dem Client bekannt ist. Der Vorgang wird nur ausgeführt, wenn die Ressource im Dienst seit dem angegebenen Zeitpunkt geändert wurde.

--if-none-match

Ein ETag-Wert, der der Version der Ressource zugeordnet ist, die dem Client bekannt ist. Der Vorgang wird nur ausgeführt, wenn das aktuelle ETag des Diensts nicht mit dem vom Client angegebenen Wert übereinstimmt.

--if-unmodified-since

Ein Zeitstempel, der die letzte Änderungszeit der Ressource angibt, die dem Client bekannt ist. Der Vorgang wird nur ausgeführt, wenn die Ressource im Dienst seit dem angegebenen Zeitpunkt nicht geändert wurde.

--yes -y

Nicht zur Bestätigung auffordern

az batch job disable

Bearbeiten

Deaktiviert den angegebenen Auftrag, um zu verhindern, dass neue Vorgänge ausgeführt werden.

Der Batchdienst verschiebt den Auftrag sofort in den Deaktivierungszustand. Batch verwendet dann den Parameter disableTasks, um zu bestimmen, was mit den derzeit ausgeführten Aufgaben des Auftrags zu tun ist. Der Auftrag bleibt im Deaktivierungszustand, bis der Deaktivierenvorgang abgeschlossen ist und alle Vorgänge gemäß der Option "DisableTasks" behandelt wurden; Der Auftrag wird dann zum deaktivierten Zustand verschoben. Es werden keine neuen Vorgänge unter dem Auftrag gestartet, bis er wieder in den aktiven Zustand wechselt. Wenn Sie versuchen, einen Auftrag zu deaktivieren, der nicht aktiv, deaktiviert oder deaktiviert ist, schlägt die Anforderung mit dem Statuscode 409 fehl.

az batch job disable --job-id
                     [--account-endpoint]
                     [--account-key]
                     [--account-name]
                     [--disable-tasks]
                     [--if-match]
                     [--if-modified-since]
                     [--if-none-match]
                     [--if-unmodified-since]

Erforderliche Parameter

--job-id

Die ID des Auftrags, der deaktiviert werden soll.

Optionale Parameter

--account-endpoint

Batchdienstendpunkt. Alternativ können Sie eine Umgebungsvariable festlegen: AZURE_BATCH_ENDPOINT.

--account-key

Batchkontoschlüssel. Alternativ können Sie eine Umgebungsvariable festlegen: AZURE_BATCH_ACCESS_KEY.

--account-name

Batchkontoname. Alternativ können Sie eine Umgebungsvariable festlegen: AZURE_BATCH_ACCOUNT.

--disable-tasks

Mögliche Werte umfassen: 'requeue', 'end', 'wait'.

--if-match

Ein ETag-Wert, der der Version der Ressource zugeordnet ist, die dem Client bekannt ist. Der Vorgang wird nur ausgeführt, wenn das aktuelle ETag der Ressource im Dienst genau dem vom Client angegebenen Wert entspricht.

--if-modified-since

Ein Zeitstempel, der die letzte Änderungszeit der Ressource angibt, die dem Client bekannt ist. Der Vorgang wird nur ausgeführt, wenn die Ressource im Dienst seit dem angegebenen Zeitpunkt geändert wurde.

--if-none-match

Ein ETag-Wert, der der Version der Ressource zugeordnet ist, die dem Client bekannt ist. Der Vorgang wird nur ausgeführt, wenn das aktuelle ETag des Diensts nicht mit dem vom Client angegebenen Wert übereinstimmt.

--if-unmodified-since

Ein Zeitstempel, der die letzte Änderungszeit der Ressource angibt, die dem Client bekannt ist. Der Vorgang wird nur ausgeführt, wenn die Ressource im Dienst seit dem angegebenen Zeitpunkt nicht geändert wurde.

az batch job enable

Bearbeiten

Aktiviert den angegebenen Auftrag, sodass neue Aufgaben ausgeführt werden können.

Wenn Sie diese API aufrufen, legt der Batchdienst einen deaktivierten Auftrag auf den Aktivierungszustand fest. Nachdem der Vorgang abgeschlossen wurde, wird der Auftrag in den aktiven Zustand verschoben und die Planung neuer Vorgänge unter dem Vorgang fortgesetzt. Der Batchdienst ermöglicht es einem Vorgang nicht, für mehr als 180 Tage im aktiven Zustand zu bleiben. Wenn Sie daher einen Auftrag aktivieren, der aktive Aufgaben enthält, die vor mehr als 180 Tagen hinzugefügt wurden, werden diese Vorgänge nicht ausgeführt.

az batch job enable --job-id
                    [--account-endpoint]
                    [--account-key]
                    [--account-name]
                    [--if-match]
                    [--if-modified-since]
                    [--if-none-match]
                    [--if-unmodified-since]

Erforderliche Parameter

--job-id

Die ID des Auftrags, der aktiviert werden soll.

Optionale Parameter

--account-endpoint

Batchdienstendpunkt. Alternativ können Sie eine Umgebungsvariable festlegen: AZURE_BATCH_ENDPOINT.

--account-key

Batchkontoschlüssel. Alternativ können Sie eine Umgebungsvariable festlegen: AZURE_BATCH_ACCESS_KEY.

--account-name

Batchkontoname. Alternativ können Sie eine Umgebungsvariable festlegen: AZURE_BATCH_ACCOUNT.

--if-match

Ein ETag-Wert, der der Version der Ressource zugeordnet ist, die dem Client bekannt ist. Der Vorgang wird nur ausgeführt, wenn das aktuelle ETag der Ressource im Dienst genau dem vom Client angegebenen Wert entspricht.

--if-modified-since

Ein Zeitstempel, der die letzte Änderungszeit der Ressource angibt, die dem Client bekannt ist. Der Vorgang wird nur ausgeführt, wenn die Ressource im Dienst seit dem angegebenen Zeitpunkt geändert wurde.

--if-none-match

Ein ETag-Wert, der der Version der Ressource zugeordnet ist, die dem Client bekannt ist. Der Vorgang wird nur ausgeführt, wenn das aktuelle ETag des Diensts nicht mit dem vom Client angegebenen Wert übereinstimmt.

--if-unmodified-since

Ein Zeitstempel, der die letzte Änderungszeit der Ressource angibt, die dem Client bekannt ist. Der Vorgang wird nur ausgeführt, wenn die Ressource im Dienst seit dem angegebenen Zeitpunkt nicht geändert wurde.

az batch job list

Bearbeiten

Listet alle Aufträge oder Auftragspläne in einem Batchkonto auf.

az batch job list [--account-endpoint]
                  [--account-key]
                  [--account-name]
                  [--expand]
                  [--filter]
                  [--job-schedule-id]
                  [--select]

Optionale Parameter

--account-endpoint

Batchdienstendpunkt. Alternativ können Sie eine Umgebungsvariable festlegen: AZURE_BATCH_ENDPOINT.

--account-key

Der Batchkontoschlüssel. Alternativ können Sie eine Umgebungsvariable festlegen: AZURE_BATCH_ACCESS_KEY.

--account-name

Der Name des Batch-Kontos. Alternativ können Sie eine Umgebungsvariable festlegen: AZURE_BATCH_ACCOUNT.

--expand

Eine OData-$expand-Klausel.

--filter

Eine OData-$filter-Klausel.

--job-schedule-id

Die ID des Auftragsplans, aus dem Sie eine Liste der Aufträge abrufen möchten. Wenn nicht angegeben, werden alle Aufträge im Konto aufgelistet.

--select

Eine OData-$select-Klausel.

az batch job reset

Bearbeiten

Aktualisieren der Eigenschaften eines Batchauftrags. Nicht angegebene Eigenschaften, die aktualisiert werden können, werden auf ihre Standardwerte zurückgesetzt.

az batch job reset --job-id
                   [--account-endpoint]
                   [--account-key]
                   [--account-name]
                   [--allow-task-preemption]
                   [--if-match]
                   [--if-modified-since]
                   [--if-none-match]
                   [--if-unmodified-since]
                   [--job-max-task-retry-count]
                   [--job-max-wall-clock-time]
                   [--json-file]
                   [--max-parallel-tasks]
                   [--metadata]
                   [--on-all-tasks-complete {noaction, terminatejob}]
                   [--pool-id]
                   [--priority]

Erforderliche Parameter

--job-id

Die ID des Auftrags, dessen Eigenschaften Sie aktualisieren möchten.

Optionale Parameter

--account-endpoint

Batchdienstendpunkt. Alternativ können Sie eine Umgebungsvariable festlegen: AZURE_BATCH_ENDPOINT.

--account-key

Batchkontoschlüssel. Alternativ können Sie eine Umgebungsvariable festlegen: AZURE_BATCH_ACCESS_KEY.

--account-name

Batchkontoname. Alternativ können Sie eine Umgebungsvariable festlegen: AZURE_BATCH_ACCOUNT.

--allow-task-preemption

Gibt an, ob Aufgaben in diesem Auftrag von anderen Aufträgen mit hoher Priorität vorgebeutet werden können. Wenn der Wert auf "True" festgelegt ist, haben andere aufträge mit hoher Priorität, die an das System übermittelt werden, Vorrang und können Aufgaben aus diesem Auftrag erneut abrufen. Sie können die AllowTaskPreemption eines Auftrags aktualisieren, nachdem sie mithilfe der Updateauftrags-API erstellt wurde. True, wenn flag vorhanden ist.

--if-match

Ein ETag-Wert, der der Version der Ressource zugeordnet ist, die dem Client bekannt ist. Der Vorgang wird nur ausgeführt, wenn das aktuelle ETag der Ressource im Dienst genau mit dem vom Client angegebenen Wert übereinstimmt.

--if-modified-since

Ein Zeitstempel, der die letzte Änderungszeit der Ressource angibt, die dem Client bekannt ist. Der Vorgang wird nur ausgeführt, wenn die Ressource für den Dienst seit der angegebenen Zeit geändert wurde.

--if-none-match

Ein ETag-Wert, der der Version der Ressource zugeordnet ist, die dem Client bekannt ist. Der Vorgang wird nur ausgeführt, wenn das aktuelle ETag der Ressource auf dem Dienst nicht mit dem vom Client angegebenen Wert übereinstimmt.

--if-unmodified-since

Ein Zeitstempel, der die letzte Änderungszeit der Ressource angibt, die dem Client bekannt ist. Der Vorgang wird nur ausgeführt, wenn die Ressource für den Dienst seit der angegebenen Zeit nicht geändert wurde.

--job-max-task-retry-count

Die maximale Anzahl der Wiederholungen jedes Vorgangs. Der Batchdienst ruft eine Aufgabe erneut auf, wenn der Ausgangscode nicht zero ist. Beachten Sie, dass dieser Wert die Anzahl der Wiederholungen ausdrücklich steuert. Der Batchdienst versucht die einzelnen Vorgänge einmal, und kann dann bis zu diesem Grenzwert erneut versuchen. Wenn beispielsweise die maximale Wiederholungsanzahl 3 beträgt, versucht Batch eine Aufgabe bis zu 4 Mal (ein anfänglicher Versuch und 3 Wiederholungen). Wenn die maximale Wiederholungsanzahl 0 ist, führt der Batchdienst keine Wiederholungsaufgaben durch. Wenn die maximale Wiederholungsanzahl -1 ist, wird der Batchdienst Vorgänge ohne Grenzwert erneut aufrufen. Der Standardwert ist 0 (keine Wiederholungsversuche).

--job-max-wall-clock-time

Wenn der Auftrag nicht innerhalb des Zeitlimits abgeschlossen wird, beendet der Batchdienst ihn und alle Vorgänge, die noch ausgeführt werden. In diesem Fall wird der Kündigungsgrund MaxWallClockTimeExpiry sein. Wenn diese Eigenschaft nicht angegeben ist, gibt es kein Zeitlimit für die Dauer der Ausführung des Auftrags. Das erwartete Format ist eine ISO-8601-Dauer.

--json-file

Eine Datei, die die Spezifikation des Auftragsupdateparameters in JSON enthält (formatiert, um dem jeweiligen REST-API-Textkörper zu entsprechen). Wenn dieser Parameter angegeben ist, werden alle 'Auftragsargumente' ignoriert.

--max-parallel-tasks

Die maximale Anzahl von Vorgängen, die parallel für den Auftrag ausgeführt werden können. Der Wert von maxParallelTasks muss -1 oder größer als 0 sein, wenn angegeben. Wenn nicht angegeben, ist der Standardwert -1, was bedeutet, dass es keine Beschränkung auf die Anzahl der Vorgänge gibt, die gleichzeitig ausgeführt werden können. Sie können die maxParallelTasks eines Auftrags aktualisieren, nachdem sie mithilfe der Updateauftrags-API erstellt wurde. Standardwert: -1 .

--metadata

Wenn sie nicht angegeben wird, wird der Standardwert einer leeren Liste verwendet; tatsächlich werden alle vorhandenen Metadaten gelöscht. Leerzeichentrennte Werte im Format "key=value".

--on-all-tasks-complete

Die Aktion, die der Batchdienst ausführen soll, wenn sich alle Vorgänge im Auftrag im abgeschlossenen Zustand befinden. Wenn nicht angegeben, wird das Abschlussverhalten auf keine Aktion festgelegt. Wenn der aktuelle Wert beendet wird, ist dies ein Fehler, da das Abschlussverhalten eines Auftrags möglicherweise nicht von "terminatejob" in "noaction" geändert wird. Sie können den Wert möglicherweise nicht von "terminatejob" in "noaction" ändern – das heißt, wenn Sie die automatische Beendigung des Auftrags aktiviert haben, können Sie ihn nicht erneut deaktivieren. Wenn Sie versuchen, dies zu tun, schlägt die Anforderung fehl, und Batch gibt Statuscode 400 (Ungültige Anforderung) und eine Fehlerantwort für ungültige Eigenschaft zurück. Wenn Sie dieses Element in einer PUT-Anforderung nicht angeben, entspricht es der Übergabe von Noaction. Dies ist ein Fehler, wenn der aktuelle Wert beendet wird.

Zulässige Werte: noaction, terminatejob
--pool-id

Die ID eines vorhandenen Pools. Alle Aufgaben des Auftrags werden im angegebenen Pool ausgeführt.

--priority

Die Priorität des Auftrags. Die Prioritätswerte reichen von -1.000 bis 1.000. Dabei ist -1.000 die niedrigste Priorität und 1000 die höchste Priorität. Wenn sie nicht angegeben wird, wird er auf den Standardwert 0 festgelegt.

az batch job set

Bearbeiten

Aktualisieren der Eigenschaften eines Batchauftrags. Durch das Aktualisieren einer Eigenschaft in einer Untergruppe werden die nicht angegebenen Eigenschaften dieser Gruppe zurückgesetzt.

az batch job set --job-id
                 [--account-endpoint]
                 [--account-key]
                 [--account-name]
                 [--allow-task-preemption]
                 [--if-match]
                 [--if-modified-since]
                 [--if-none-match]
                 [--if-unmodified-since]
                 [--job-max-task-retry-count]
                 [--job-max-wall-clock-time]
                 [--json-file]
                 [--max-parallel-tasks]
                 [--metadata]
                 [--on-all-tasks-complete {noaction, terminatejob}]
                 [--pool-id]
                 [--priority]

Erforderliche Parameter

--job-id

Die ID des Auftrags, dessen Eigenschaften Sie aktualisieren möchten.

Optionale Parameter

--account-endpoint

Batchdienstendpunkt. Alternativ können Sie eine Umgebungsvariable festlegen: AZURE_BATCH_ENDPOINT.

--account-key

Batchkontoschlüssel. Alternativ können Sie eine Umgebungsvariable festlegen: AZURE_BATCH_ACCESS_KEY.

--account-name

Batchkontoname. Alternativ können Sie eine Umgebungsvariable festlegen: AZURE_BATCH_ACCOUNT.

--allow-task-preemption

Gibt an, ob Aufgaben in diesem Auftrag von anderen Aufträgen mit hoher Priorität vorgebeutet werden können. Wenn der Wert auf "True" festgelegt ist, haben andere aufträge mit hoher Priorität, die an das System übermittelt werden, Vorrang und können Aufgaben aus diesem Auftrag erneut abrufen. Sie können die AllowTaskPreemption eines Auftrags aktualisieren, nachdem sie mithilfe der Updateauftrags-API erstellt wurde. Geben Sie entweder "true" oder "false" an, um die Eigenschaft zu aktualisieren.

--if-match

Ein ETag-Wert, der der Version der Ressource zugeordnet ist, die dem Client bekannt ist. Der Vorgang wird nur ausgeführt, wenn das aktuelle ETag der Ressource im Dienst genau mit dem vom Client angegebenen Wert übereinstimmt.

--if-modified-since

Ein Zeitstempel, der die letzte Änderungszeit der Ressource angibt, die dem Client bekannt ist. Der Vorgang wird nur ausgeführt, wenn die Ressource für den Dienst seit der angegebenen Zeit geändert wurde.

--if-none-match

Ein ETag-Wert, der der Version der Ressource zugeordnet ist, die dem Client bekannt ist. Der Vorgang wird nur ausgeführt, wenn das aktuelle ETag der Ressource auf dem Dienst nicht mit dem vom Client angegebenen Wert übereinstimmt.

--if-unmodified-since

Ein Zeitstempel, der die letzte Änderungszeit der Ressource angibt, die dem Client bekannt ist. Der Vorgang wird nur ausgeführt, wenn die Ressource für den Dienst seit der angegebenen Zeit nicht geändert wurde.

--job-max-task-retry-count

Die maximale Anzahl der Wiederholungen jedes Vorgangs. Der Batchdienst ruft eine Aufgabe erneut auf, wenn der Ausgangscode nicht zero ist. Beachten Sie, dass dieser Wert die Anzahl der Wiederholungen ausdrücklich steuert. Der Batchdienst versucht die einzelnen Vorgänge einmal, und kann dann bis zu diesem Grenzwert erneut versuchen. Wenn beispielsweise die maximale Wiederholungsanzahl 3 beträgt, versucht Batch eine Aufgabe bis zu 4 Mal (ein anfänglicher Versuch und 3 Wiederholungen). Wenn die maximale Wiederholungsanzahl 0 ist, führt der Batchdienst keine Wiederholungsaufgaben durch. Wenn die maximale Wiederholungsanzahl -1 ist, wird der Batchdienst Vorgänge ohne Grenzwert erneut aufrufen. Der Standardwert ist 0 (keine Wiederholungsversuche).

--job-max-wall-clock-time

Wenn der Auftrag nicht innerhalb des Zeitlimits abgeschlossen wird, beendet der Batchdienst ihn und alle Vorgänge, die noch ausgeführt werden. In diesem Fall wird der Kündigungsgrund MaxWallClockTimeExpiry sein. Wenn diese Eigenschaft nicht angegeben ist, gibt es kein Zeitlimit für die Dauer der Ausführung des Auftrags. Das erwartete Format ist eine ISO-8601-Dauer.

--json-file

Eine Datei, die die Spezifikation des Auftragspatchparameters in JSON enthält (formatiert, um dem jeweiligen REST-API-Textkörper zu entsprechen). Wenn dieser Parameter angegeben ist, werden alle 'Auftragsargumente' ignoriert.

--max-parallel-tasks

Die maximale Anzahl von Vorgängen, die parallel für den Auftrag ausgeführt werden können. Der Wert von maxParallelTasks muss -1 oder größer als 0 sein, wenn angegeben. Wenn nicht angegeben, ist der Standardwert -1, was bedeutet, dass es keine Beschränkung auf die Anzahl der Vorgänge gibt, die gleichzeitig ausgeführt werden können. Sie können die maxParallelTasks eines Auftrags aktualisieren, nachdem sie mithilfe der Updateauftrags-API erstellt wurde.

--metadata

Wenn nicht angegeben, bleiben die vorhandenen Auftragsmetadaten unverändert. Leerzeichentrennte Werte im Format "key=value".

--on-all-tasks-complete

Die Aktion, die der Batchdienst ausführen soll, wenn sich alle Vorgänge im Auftrag im abgeschlossenen Zustand befinden. Wenn nicht angegeben, bleibt das Abschlussverhalten unverändert. Sie können den Wert möglicherweise nicht von "terminatejob" in "noaction" ändern – das heißt, wenn Sie die automatische Beendigung des Auftrags aktiviert haben, können Sie ihn nicht erneut deaktivieren. Wenn Sie versuchen, dies zu tun, schlägt die Anforderung mit der Fehlerantwort "ungültiger Eigenschaftswert" fehl; Wenn Sie die REST-API direkt aufrufen, lautet der HTTP-Statuscode 400 (Ungültige Anforderung).

Zulässige Werte: noaction, terminatejob
--pool-id

Die ID eines vorhandenen Pools. Alle Aufgaben des Auftrags werden im angegebenen Pool ausgeführt.

--priority

Die Priorität des Auftrags. Die Prioritätswerte reichen von -1.000 bis 1.000. Dabei ist -1.000 die niedrigste Priorität und 1000 die höchste Priorität. Wenn nicht angegeben, bleibt die Priorität des Auftrags unverändert.

az batch job show

Bearbeiten

Ruft Informationen zum angegebenen Auftrag ab.

az batch job show --job-id
                  [--account-endpoint]
                  [--account-key]
                  [--account-name]
                  [--expand]
                  [--if-match]
                  [--if-modified-since]
                  [--if-none-match]
                  [--if-unmodified-since]
                  [--select]

Erforderliche Parameter

--job-id

Die ID des Auftrags.

Optionale Parameter

--account-endpoint

Batchdienstendpunkt. Alternativ können Sie eine Umgebungsvariable festlegen: AZURE_BATCH_ENDPOINT.

--account-key

Batchkontoschlüssel. Alternativ können Sie eine Umgebungsvariable festlegen: AZURE_BATCH_ACCESS_KEY.

--account-name

Batchkontoname. Alternativ können Sie eine Umgebungsvariable festlegen: AZURE_BATCH_ACCOUNT.

--expand

Eine OData-$expand-Klausel.

--if-match

Ein ETag-Wert, der der Version der Ressource zugeordnet ist, die dem Client bekannt ist. Der Vorgang wird nur ausgeführt, wenn das aktuelle ETag der Ressource im Dienst genau mit dem vom Client angegebenen Wert übereinstimmt.

--if-modified-since

Ein Zeitstempel, der die letzte Änderungszeit der Ressource angibt, die dem Client bekannt ist. Der Vorgang wird nur ausgeführt, wenn die Ressource für den Dienst seit der angegebenen Zeit geändert wurde.

--if-none-match

Ein ETag-Wert, der der Version der Ressource zugeordnet ist, die dem Client bekannt ist. Der Vorgang wird nur ausgeführt, wenn das aktuelle ETag der Ressource auf dem Dienst nicht mit dem vom Client angegebenen Wert übereinstimmt.

--if-unmodified-since

Ein Zeitstempel, der die letzte Änderungszeit der Ressource angibt, die dem Client bekannt ist. Der Vorgang wird nur ausgeführt, wenn die Ressource für den Dienst seit der angegebenen Zeit nicht geändert wurde.

--select

Eine OData-$select-Klausel.

az batch job stop

Bearbeiten

Beenden Eines ausgeführten Batchauftrags.

Beenden Sie den angegebenen Auftrag, und markieren Sie ihn als abgeschlossen. Wenn eine Terminauftragsanforderung empfangen wird, legt der Batchdienst den Auftrag auf den Beendigungszustand fest. Der Batchdienst beendet dann alle ausgeführten Aufgaben, die dem Auftrag zugeordnet sind, und führt alle erforderlichen Aufgaben für die Auftragsfreigabe aus. Anschließend wechselt der Auftrag in den abgeschlossenen Zustand. Wenn aufgaben im aktiven Status vorhanden sind, bleiben sie im aktiven Zustand. Sobald ein Auftrag beendet wurde, können keine neuen Vorgänge hinzugefügt werden, und alle verbleibenden aktiven Vorgänge werden nicht geplant.

az batch job stop --job-id
                  [--account-endpoint]
                  [--account-key]
                  [--account-name]
                  [--if-match]
                  [--if-modified-since]
                  [--if-none-match]
                  [--if-unmodified-since]
                  [--terminate-reason]

Erforderliche Parameter

--job-id

Die ID des Zu beendenden Auftrags.

Optionale Parameter

--account-endpoint

Batchdienstendpunkt. Alternativ können Sie eine Umgebungsvariable festlegen: AZURE_BATCH_ENDPOINT.

--account-key

Batchkontoschlüssel. Alternativ können Sie eine Umgebungsvariable festlegen: AZURE_BATCH_ACCESS_KEY.

--account-name

Batchkontoname. Alternativ können Sie eine Umgebungsvariable festlegen: AZURE_BATCH_ACCOUNT.

--if-match

Ein ETag-Wert, der der Version der Ressource zugeordnet ist, die dem Client bekannt ist. Der Vorgang wird nur ausgeführt, wenn das aktuelle ETag der Ressource im Dienst genau mit dem vom Client angegebenen Wert übereinstimmt.

--if-modified-since

Ein Zeitstempel, der die letzte Änderungszeit der Ressource angibt, die dem Client bekannt ist. Der Vorgang wird nur ausgeführt, wenn die Ressource für den Dienst seit der angegebenen Zeit geändert wurde.

--if-none-match

Ein ETag-Wert, der der Version der Ressource zugeordnet ist, die dem Client bekannt ist. Der Vorgang wird nur ausgeführt, wenn das aktuelle ETag der Ressource auf dem Dienst nicht mit dem vom Client angegebenen Wert übereinstimmt.

--if-unmodified-since

Ein Zeitstempel, der die letzte Änderungszeit der Ressource angibt, die dem Client bekannt ist. Der Vorgang wird nur ausgeführt, wenn die Ressource für den Dienst seit der angegebenen Zeit nicht geändert wurde.

--terminate-reason

Kündigungsgrund.