az batch job
Hinweis
Diese Befehlsgruppe verfügt über Befehle, die sowohl in Azure CLI als auch in mindestens einer Erweiterung definiert sind. Installieren Sie jede Erweiterung, um von ihren erweiterten Funktionen zu profitieren. Weitere Informationen zu Erweiterungen
Batchaufträge verwalten.
Befehle
| Name | Beschreibung | Typ | Status |
|---|---|---|---|
| az batch job create |
Fügen Sie einem Batchkonto einen Auftrag hinzu. |
Kernspeicher | Allgemein verfügbar |
| az batch job create (azure-batch-cli-extensions Erweiterung) |
Fügen Sie einem Batchkonto einen Auftrag und zugeordnete Aufgaben hinzu. |
Durchwahl | Allgemein verfügbar |
| az batch job delete |
Löscht einen Auftrag. |
Kernspeicher | Allgemein verfügbar |
| az batch job disable |
Deaktiviert den angegebenen Auftrag und verhindert, dass neue Aufgaben ausgeführt werden. |
Kernspeicher | Allgemein verfügbar |
| az batch job enable |
Aktiviert den angegebenen Auftrag, sodass neue Aufgaben ausgeführt werden können. |
Kernspeicher | Allgemein verfügbar |
| az batch job list |
Listet alle Aufträge oder Auftragspläne in einem Batchkonto auf. |
Kernspeicher | Allgemein verfügbar |
| az batch job prep-release-status |
Zeigen Sie den Status der Batchauftragsvorbereitung an und geben Sie Aufgaben frei. |
Kernspeicher | Allgemein verfügbar |
| az batch job prep-release-status list |
Listet den Ausführungsstatus der Auftragsvorbereitungs- und Auftragsfreigabeaufgabe für den angegebenen Auftrag über die Computeknoten auf, auf denen der Auftrag ausgeführt wurde. |
Kernspeicher | Allgemein verfügbar |
| az batch job reset |
Dient zum Aktualisieren der Eigenschaften eines Batchauftrags. Nicht angegebene Eigenschaften, die aktualisiert werden können, werden auf ihre Standardwerte zurückgesetzt. |
Kernspeicher | Allgemein verfügbar |
| az batch job set |
Dient zum Aktualisieren der Eigenschaften eines Batchauftrags. Durch das Aktualisieren einer Eigenschaft in einer Untergruppe werden die nicht angegebenen Eigenschaften dieser Gruppe zurückgesetzt. |
Kernspeicher | Allgemein verfügbar |
| az batch job show |
Ruft Informationen zum angegebenen Auftrag ab. |
Kernspeicher | Allgemein verfügbar |
| az batch job stop |
Beenden eines ausgeführten Batchauftrags. |
Kernspeicher | Allgemein verfügbar |
| az batch job task-counts |
Zeigen Sie die Anzahl der Aufgaben und Slots in einem Batchauftrag und deren Zuständen an. |
Kernspeicher | Allgemein verfügbar |
| az batch job task-counts show |
Ruft die Vorgangsanzahl für den angegebenen Auftrag ab. |
Kernspeicher | Allgemein verfügbar |
az batch job create
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
Batchdienstendpunkt. Alternativ können Sie nach Umgebungsvariablen festlegen: AZURE_BATCH_ENDPOINT.
Batchkontoschlüssel. Alternativ können Sie nach Umgebungsvariablen festlegen: AZURE_BATCH_ACCESS_KEY.
Batchkontoname. Alternativ können Sie nach Umgebungsvariablen festlegen: AZURE_BATCH_ACCOUNT.
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 Vorgänge von diesem Auftrag erneut abfragn. Sie können die AllowTaskPreemption eines Auftrags aktualisieren, nachdem er mithilfe der Updateauftrags-API erstellt wurde. True, wenn die Kennzeichnung vorhanden ist.
Erforderlich. Die ID kann eine beliebige Kombination aus alphanumerischen Zeichen einschließlich Bindestrichen und Unterstrichen enthalten und darf nicht mehr als 64 Zeichen enthalten. Bei der ID wird die Groß-/Kleinschreibung beibehalten und die Groß-/Kleinschreibung nicht beachtet (d. h., Sie verfügen möglicherweise nicht über zwei IDs innerhalb eines Kontos, die nur nach Groß-/Kleinschreibung abweichen).
Erforderlich. Die Befehlszeile wird nicht unter einer Shell ausgeführt und kann daher nicht von Shellfeatures wie der Erweiterung der Umgebungsvariablen profitieren. Wenn Sie diese Features nutzen möchten, sollten Sie die Shell in der Befehlszeile aufrufen, z. B. mit "cmd /c MyCommand" in Windows oder "/bin/sh -c MyCommand" in Linux. Wenn sich die Befehlszeile auf Dateipfade bezieht, sollte sie einen relativen Pfad (relativ zum Arbeitsverzeichnis "Aufgabe") verwenden oder die vom Batch bereitgestellte Umgebungsvariable (https://docs.microsoft.com/en-us/azure/batch/batch-compute-node-environment-variables).
Leerzeichentrennte Werte im Format "key=value".
Erforderlich. Die ID kann eine beliebige Kombination aus alphanumerischen Zeichen einschließlich Bindestrichen und Unterstrichen enthalten und darf nicht mehr als 64 Zeichen enthalten.
Unter diesem Element aufgelistete Dateien befinden sich im Arbeitsverzeichnis der Aufgabe. 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 lautet "RequestEntityTooLarge". Wenn dies der Fall ist, muss die Sammlung von ResourceFiles in der Größe reduziert werden. Dies kann mithilfe von ZIP-Dateien, Anwendungspaketen oder Docker-Containern erreicht werden. Durch Leerzeichen getrennte Ressourcenverweise im Format "filename=httpurl".
Die maximale Anzahl von Wiederholungsversuchen für jeden Vorgang. Der Batchdienst ruft eine Aufgabe erneut auf, wenn der Beendigungscode nicht null ist. Beachten Sie, dass dieser Wert die Anzahl der Wiederholungen ausdrücklich steuert. Der Batchdienst versucht jeden Vorgang einmal und kann dann bis zu diesem Grenzwert erneut versuchen. Wenn die maximale Wiederholungsanzahl beispielsweise 3 ist, versucht Batch eine Aufgabe bis zu 4 Mal (ein erster Versuch und 3 Wiederholungsversuche). Wenn die maximale Wiederholungsanzahl 0 ist, führt der Batchdienst keine Wiederholungsaufgaben durch. Wenn die maximale Wiederholungsanzahl -1 ist, wiederholt der Batchdienst Vorgänge ohne Grenzwert. Der Standardwert ist 0 (keine Wiederholungsversuche).
Wenn der Auftrag nicht innerhalb des Zeitlimits abgeschlossen wird, beendet der Batchdienst ihn und alle Aufgaben, die noch ausgeführt werden. In diesem Fall ist der Kündigungsgrund MaxWallClockTimeExpiry. Wenn diese Eigenschaft nicht angegeben ist, gibt es kein Zeitlimit für die Ausführung des Auftrags. Das erwartete Format ist eine ISO-8601-Dauer.
Eine Datei, die die Auftragsspezifikation in JSON enthält (formatiert für den jeweiligen REST-API-Textkörper). Wenn dieser Parameter angegeben ist, werden alle 'Auftragsargumente' ignoriert.
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 für die Anzahl der Aufgaben gibt, die gleichzeitig ausgeführt werden können. Sie können die maxParallelTasks eines Auftrags aktualisieren, nachdem er mithilfe der Updateauftrags-API erstellt wurde. Standardwert: -1 .
Der Batchdienst weist Metadaten keine Bedeutung zu; sie ist ausschließlich für die Verwendung von Benutzercode vorgesehen. Leerzeichentrennte Werte im Format "key=value".
Die ID eines vorhandenen Pools. Alle Aufgaben des Auftrags werden im angegebenen Pool ausgeführt.
Die Priorität des Auftrags. Prioritätswerte können zwischen -1000 und 1000 liegen, wobei -1000 die niedrigste Priorität und 1000 die höchste Priorität sind. Der Standardwert ist 0.
Die Anzahl der Zeitplanungsplätze, die der Vorgang ausführen muss. Der Standardwert ist 1. Eine Aufgabe kann nur für die Ausführung auf einem Computeknoten geplant werden, wenn der Knoten über genügend freie Planungsplätze verfügt. Bei Aufgaben mit mehreren Instanzen wird diese Eigenschaft nicht unterstützt und darf nicht angegeben werden.
Gibt an, ob Aufgaben im Auftrag Abhängigkeiten voneinander definieren können. Der Standardwert ist FALSE. True, wenn die Kennzeichnung vorhanden ist.
Globale Parameter
Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.
Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.
Nur Fehler anzeigen und Warnungen unterdrücken.
Ausgabeformat.
JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.
Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.
Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.
az batch job create (azure-batch-cli-extensions Erweiterung)
Fügen Sie einem Batchkonto einen Auftrag und zugeordnete Aufgaben 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]
[--parameters]
[--pool-id]
[--priority]
[--required-slots]
[--resource-group]
[--template]
[--uses-task-dependencies]Optionale Parameter
Batchdienstendpunkt. Alternativ können Sie nach Umgebungsvariablen festlegen: AZURE_BATCH_ENDPOINT.
Der Batchkontoschlüssel. Alternativ können Sie nach Umgebungsvariablen festlegen: AZURE_BATCH_ACCESS_KEY.
Der Name des Batch-Kontos. Alternativ können Sie nach Umgebungsvariablen festlegen: AZURE_BATCH_ACCOUNT.
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 Vorgänge von diesem Auftrag erneut abfragn. Sie können die AllowTaskPreemption eines Auftrags aktualisieren, nachdem er mithilfe der Updateauftrags-API erstellt wurde.
Erforderlich. Die ID kann eine beliebige Kombination aus alphanumerischen Zeichen einschließlich Bindestrichen und Unterstrichen enthalten und darf nicht mehr als 64 Zeichen enthalten. Bei der ID wird die Groß-/Kleinschreibung beibehalten und die Groß-/Kleinschreibung nicht beachtet (d. h., Sie verfügen möglicherweise nicht über zwei IDs innerhalb eines Kontos, die nur nach Groß-/Kleinschreibung abweichen).
Die Befehlszeile der Aufgabe "Auftrags-Manager". Die Befehlszeile wird nicht unter einer Shell ausgeführt und kann daher nicht von Shellfeatures wie der Erweiterung der Umgebungsvariablen profitieren. Wenn Sie diese Features nutzen möchten, sollten Sie die Shell in der Befehlszeile aufrufen, z. B. mit "cmd /c MyCommand" in Windows oder "/bin/sh -c MyCommand" in Linux.
Eine Liste der Umgebungsvariableneinstellungen für die Aufgabe "Auftrags-Manager". Durch Leerzeichen getrennte Werte im Format "key=value".
Eine Zeichenfolge, die die Aufgabe des Auftrags-Managers innerhalb des Auftrags eindeutig identifiziert. Die ID kann eine beliebige Kombination aus alphanumerischen Zeichen einschließlich Bindestrichen und Unterstrichen enthalten und darf nicht mehr als 64 Zeichen enthalten.
Eine Liste der Dateien, die der Batchdienst vor dem Ausführen der Befehlszeile auf den Computeknoten herunterladen wird. Dateien, die unter diesem Element aufgeführt sind, befinden sich im Arbeitsverzeichnis der Aufgabe. Durch Leerzeichen getrennte Ressourcenverweise im Format "filename=httpurl".
Die maximale Anzahl von Wiederholungsversuchen für jeden Vorgang. Der Batch-Dienst wiederholt einen Task, wenn sein Exitcode ungleich null ist. Beachten Sie, dass dieser Wert die Anzahl der Wiederholungen ausdrücklich steuert. Der Batchdienst versucht jede Aufgabe einmal und kann dann bis zu diesem Grenzwert erneut versuchen. Wenn beispielsweise die maximale Anzahl von Wiederholungsversuchen 3 ist, versucht der Batch-Dienst einen Task bis zu viermal (ein erster Versuch und drei Wiederholungsversuche). Wenn die maximale Anzahl von Wiederholungsversuchen 0 ist, wiederholt der Batch-Dienst Tasks nicht. Wenn die maximale Anzahl von Wiederholungsversuchen -1 ist, wiederholt der Batch-Dienst Tasks unbegrenzt. Der Standardwert ist 0 (keine Wiederholungsversuche).
Die maximale verstrichene Zeit, die der Auftrag ausführen kann, gemessen ab dem Zeitpunkt, zu dem der Auftrag erstellt wird. Wenn der Auftrag nicht innerhalb des Zeitlimits abgeschlossen wird, beendet der Batchdienst ihn und alle aufgaben, die noch ausgeführt werden. In diesem Fall ist der Kündigungsgrund MaxWallClockTimeExpiry. Wenn diese Eigenschaft nicht angegeben ist, gibt es keine Zeitliche Begrenzung, wie lange der Auftrag ausgeführt werden kann. Das erwartete Format ist eine ISO-8601-Dauer.
Eine Datei, die die Auftragsspezifikation in JSON enthält (formatiert für den jeweiligen REST-API-Textkörper). Wenn dieser Parameter angegeben ist, werden alle 'Auftragsargumente' ignoriert.
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 für die Anzahl der Aufgaben gibt, die gleichzeitig ausgeführt werden können. Sie können die maxParallelTasks eines Auftrags aktualisieren, nachdem er mithilfe der Updateauftrags-API erstellt wurde. Standardwert: -1 .
Der Batchdienst weist Metadaten keine Bedeutung zu; sie ist ausschließlich für die Verwendung von Benutzercode vorgesehen.
Parameterwerte für eine JSON-Vorlagendatei für Batchaufträge. Kann nur mit --template verwendet werden.
Die ID eines vorhandenen Pools. Alle Aufgaben des Auftrags werden im angegebenen Pool ausgeführt.
Die Priorität des Auftrags. Prioritätswerte können zwischen -1000 und 1000 liegen, wobei -1000 die niedrigste Priorität und 1000 die höchste Priorität sind. Der Standardwert ist 0.
Die Anzahl der Zeitplanungsplätze, die der Vorgang ausführen muss. Der Standardwert ist 1. Eine Aufgabe kann nur für die Ausführung auf einem Computeknoten geplant werden, wenn der Knoten über genügend freie Planungsplätze verfügt. Bei Aufgaben mit mehreren Instanzen wird diese Eigenschaft nicht unterstützt und darf nicht angegeben werden.
Die Ressourcengruppe des Batchkontos.
Eine JSON-Vorlagendatei für Batchaufträge. Wenn dieser Parameter angegeben ist, werden alle anderen Parameter ignoriert.
Das Kennzeichen, das bestimmt, ob dieser Auftrag Aufgaben mit Abhängigkeiten verwendet. True, wenn die Kennzeichnung vorhanden ist.
Globale Parameter
Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.
Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.
Nur Fehler anzeigen und Warnungen unterdrücken.
Ausgabeformat.
JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.
Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.
Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.
az batch job delete
Löscht einen Auftrag.
Durch das Löschen eines Auftrags werden auch alle Aufgaben gelöscht, die Teil dieses Auftrags sind, und alle Auftragsstatistiken. Dadurch wird auch der Aufbewahrungszeitraum für Vorgangsdaten 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 dieser Aufgaben und alle ihre Inhalte. Wenn eine Löschauftragsanforderung empfangen wird, legt der Batchdienst den Auftrag auf den Löschstatus fest. Alle Aktualisierungsvorgänge für einen Auftrag, der sich im Löschzustand befindet, schlagen mit dem 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
Die ID des zu löschenden Auftrags.
Optionale Parameter
Batchdienstendpunkt. Alternativ können Sie nach Umgebungsvariablen festlegen: AZURE_BATCH_ENDPOINT.
Batchkontoschlüssel. Alternativ können Sie nach Umgebungsvariablen festlegen: AZURE_BATCH_ACCESS_KEY.
Batchkontoname. Alternativ können Sie nach Umgebungsvariablen festlegen: AZURE_BATCH_ACCOUNT.
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 für den Dienst exakt mit dem vom Client angegebenen Wert übereinstimmt.
Ein Zeitstempel, der die uhrzeit der letzten Änderung der Ressource angibt, die dem Client bekannt ist. Der Vorgang wird nur ausgeführt, wenn die Ressource für den Dienst seit dem angegebenen Zeitpunkt geändert wurde.
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 für den Dienst nicht mit dem vom Client angegebenen Wert übereinstimmt.
Ein Zeitstempel, der die uhrzeit der letzten Änderung der Ressource angibt, die dem Client bekannt ist. Der Vorgang wird nur ausgeführt, wenn die Ressource für den Dienst seit dem angegebenen Zeitpunkt nicht geändert wurde.
Nicht zur Bestätigung auffordern
Globale Parameter
Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.
Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.
Nur Fehler anzeigen und Warnungen unterdrücken.
Ausgabeformat.
JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.
Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.
Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.
az batch job disable
Deaktiviert den angegebenen Auftrag und verhindert, dass neue Aufgaben 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 wird im Deaktivierungszustand neu Standard, bis der Deaktivierungsvorgang abgeschlossen ist und alle Aufgaben gemäß der Option "disableTasks" behandelt wurden. Der Auftrag wechselt dann in den Status "Deaktiviert". Es werden keine neuen Aufgaben unter dem Auftrag gestartet, bis sie wieder in den aktiven Zustand verschoben wird. 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
Die ID des zu deaktivierenden Auftrags.
Optionale Parameter
Batchdienstendpunkt. Alternativ können Sie nach Umgebungsvariablen festlegen: AZURE_BATCH_ENDPOINT.
Batchkontoschlüssel. Alternativ können Sie nach Umgebungsvariablen festlegen: AZURE_BATCH_ACCESS_KEY.
Batchkontoname. Alternativ können Sie nach Umgebungsvariablen festlegen: AZURE_BATCH_ACCOUNT.
Mögliche Werte sind: 'requeue', 'terminate', 'wait'.
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 für den Dienst exakt mit dem vom Client angegebenen Wert übereinstimmt.
Ein Zeitstempel, der die uhrzeit der letzten Änderung der Ressource angibt, die dem Client bekannt ist. Der Vorgang wird nur ausgeführt, wenn die Ressource für den Dienst seit dem angegebenen Zeitpunkt geändert wurde.
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 für den Dienst nicht mit dem vom Client angegebenen Wert übereinstimmt.
Ein Zeitstempel, der die uhrzeit der letzten Änderung der Ressource angibt, die dem Client bekannt ist. Der Vorgang wird nur ausgeführt, wenn die Ressource für den Dienst seit dem angegebenen Zeitpunkt nicht geändert wurde.
Globale Parameter
Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.
Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.
Nur Fehler anzeigen und Warnungen unterdrücken.
Ausgabeformat.
JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.
Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.
Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.
az batch job enable
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 Aktivierungsstatus fest. Nach Abschluss dieses Vorgangs wechselt der Auftrag in den aktiven Zustand und die Planung neuer Vorgänge unter dem Auftrag fortsetzen. Der Batchdienst lässt eine Aufgabe nicht für mehr als 180 Tage in den aktiven Zustand zurück Standard. Wenn Sie daher einen Auftrag aktivieren, der aktive Aufgaben enthält, die vor mehr als 180 Tagen hinzugefügt wurden, werden diese Aufgaben 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
Die ID des zu aktivierenden Auftrags.
Optionale Parameter
Batchdienstendpunkt. Alternativ können Sie nach Umgebungsvariablen festlegen: AZURE_BATCH_ENDPOINT.
Batchkontoschlüssel. Alternativ können Sie nach Umgebungsvariablen festlegen: AZURE_BATCH_ACCESS_KEY.
Batchkontoname. Alternativ können Sie nach Umgebungsvariablen festlegen: AZURE_BATCH_ACCOUNT.
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 für den Dienst exakt mit dem vom Client angegebenen Wert übereinstimmt.
Ein Zeitstempel, der die uhrzeit der letzten Änderung der Ressource angibt, die dem Client bekannt ist. Der Vorgang wird nur ausgeführt, wenn die Ressource für den Dienst seit dem angegebenen Zeitpunkt geändert wurde.
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 für den Dienst nicht mit dem vom Client angegebenen Wert übereinstimmt.
Ein Zeitstempel, der die uhrzeit der letzten Änderung der Ressource angibt, die dem Client bekannt ist. Der Vorgang wird nur ausgeführt, wenn die Ressource für den Dienst seit dem angegebenen Zeitpunkt nicht geändert wurde.
Globale Parameter
Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.
Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.
Nur Fehler anzeigen und Warnungen unterdrücken.
Ausgabeformat.
JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.
Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.
Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.
az batch job list
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
Batchdienstendpunkt. Alternativ können Sie nach Umgebungsvariablen festlegen: AZURE_BATCH_ENDPOINT.
Der Batchkontoschlüssel. Alternativ können Sie nach Umgebungsvariablen festlegen: AZURE_BATCH_ACCESS_KEY.
Der Name des Batch-Kontos. Alternativ können Sie nach Umgebungsvariablen festlegen: AZURE_BATCH_ACCOUNT.
Eine OData-$expand-Klausel.
Eine OData-$filter-Klausel.
Die ID des Auftragsplans, aus dem Sie eine Liste von Aufträgen abrufen möchten. Wenn nicht angegeben, werden alle Aufträge im Konto aufgelistet.
Eine OData-$select-Klausel.
Globale Parameter
Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.
Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.
Nur Fehler anzeigen und Warnungen unterdrücken.
Ausgabeformat.
JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.
Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.
Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.
az batch job reset
Dient zum 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
Die ID des Auftrags, dessen Eigenschaften Sie aktualisieren möchten.
Optionale Parameter
Batchdienstendpunkt. Alternativ können Sie nach Umgebungsvariablen festlegen: AZURE_BATCH_ENDPOINT.
Batchkontoschlüssel. Alternativ können Sie nach Umgebungsvariablen festlegen: AZURE_BATCH_ACCESS_KEY.
Batchkontoname. Alternativ können Sie nach Umgebungsvariablen festlegen: AZURE_BATCH_ACCOUNT.
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 Vorgänge von diesem Auftrag erneut abfragn. Sie können die AllowTaskPreemption eines Auftrags aktualisieren, nachdem er mithilfe der Updateauftrags-API erstellt wurde. True, wenn die Kennzeichnung vorhanden ist.
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 für den Dienst exakt mit dem vom Client angegebenen Wert übereinstimmt.
Ein Zeitstempel, der die uhrzeit der letzten Änderung der Ressource angibt, die dem Client bekannt ist. Der Vorgang wird nur ausgeführt, wenn die Ressource für den Dienst seit dem angegebenen Zeitpunkt geändert wurde.
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 für den Dienst nicht mit dem vom Client angegebenen Wert übereinstimmt.
Ein Zeitstempel, der die uhrzeit der letzten Änderung der Ressource angibt, die dem Client bekannt ist. Der Vorgang wird nur ausgeführt, wenn die Ressource für den Dienst seit dem angegebenen Zeitpunkt nicht geändert wurde.
Die maximale Anzahl von Wiederholungsversuchen für jeden Vorgang. Der Batchdienst ruft eine Aufgabe erneut auf, wenn der Beendigungscode nicht null ist. Beachten Sie, dass dieser Wert die Anzahl der Wiederholungen ausdrücklich steuert. Der Batchdienst versucht jeden Vorgang einmal und kann dann bis zu diesem Grenzwert erneut versuchen. Wenn die maximale Wiederholungsanzahl beispielsweise 3 ist, versucht Batch eine Aufgabe bis zu 4 Mal (ein erster Versuch und 3 Wiederholungsversuche). Wenn die maximale Wiederholungsanzahl 0 ist, führt der Batchdienst keine Wiederholungsaufgaben durch. Wenn die maximale Wiederholungsanzahl -1 ist, wiederholt der Batchdienst Vorgänge ohne Grenzwert. Der Standardwert ist 0 (keine Wiederholungsversuche).
Wenn der Auftrag nicht innerhalb des Zeitlimits abgeschlossen wird, beendet der Batchdienst ihn und alle Aufgaben, die noch ausgeführt werden. In diesem Fall ist der Kündigungsgrund MaxWallClockTimeExpiry. Wenn diese Eigenschaft nicht angegeben ist, gibt es kein Zeitlimit für die Ausführung des Auftrags. Das erwartete Format ist eine ISO-8601-Dauer.
Eine Datei mit der Spezifikation des Auftragsaktualisierungsparameters in JSON (formatiert für den jeweiligen REST-API-Textkörper). Wenn dieser Parameter angegeben ist, werden alle 'Auftragsargumente' ignoriert.
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 für die Anzahl der Aufgaben gibt, die gleichzeitig ausgeführt werden können. Sie können die maxParallelTasks eines Auftrags aktualisieren, nachdem er mithilfe der Updateauftrags-API erstellt wurde. Standardwert: -1 .
Wenn dieser Wert weggelassen wird, wird der Standardwert einer leeren Liste verwendet. tatsächlich werden alle vorhandenen Metadaten gelöscht. Leerzeichentrennte Werte im Format "key=value".
Die Aktion, die der Batchdienst ausführen soll, wenn sich alle Aufgaben im Auftrag im Abgeschlossenen Zustand befinden. Wenn sie weggelassen wird, wird das Vervollständigungsverhalten auf "noaction" festgelegt. Wenn der aktuelle Wert terminatejob ist, ist dies ein Fehler, da das Vervollständigungsverhalten eines Auftrags möglicherweise nicht von "terminatejob" in "noaction" geändert wird. Sie können den Wert nicht von "terminatejob" in "noaction" ändern – d. h., nachdem Sie die automatische Beendigung des Auftrags aktiviert haben, können Sie ihn nicht wieder deaktivieren. Wenn Sie versuchen, dies zu tun, schlägt die Anforderung fehl, und Batch gibt statuscode 400 (ungültige Anforderung) und eine Fehlerantwort "ungültiger Eigenschaftswert" zurück. Wenn Sie dieses Element nicht in einer PUT-Anforderung angeben, entspricht es der Übergabe von Noaction. Dies ist ein Fehler, wenn der aktuelle Wert terminatejob ist.
Die ID eines vorhandenen Pools. Alle Aufgaben des Auftrags werden im angegebenen Pool ausgeführt.
Die Priorität des Auftrags. Prioritätswerte können zwischen -1000 und 1000 liegen, wobei -1000 die niedrigste Priorität und 1000 die höchste Priorität sind. Wenn sie weggelassen wird, wird sie auf den Standardwert 0 festgelegt.
Globale Parameter
Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.
Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.
Nur Fehler anzeigen und Warnungen unterdrücken.
Ausgabeformat.
JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.
Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.
Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.
az batch job set
Dient zum 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
Die ID des Auftrags, dessen Eigenschaften Sie aktualisieren möchten.
Optionale Parameter
Batchdienstendpunkt. Alternativ können Sie nach Umgebungsvariablen festlegen: AZURE_BATCH_ENDPOINT.
Batchkontoschlüssel. Alternativ können Sie nach Umgebungsvariablen festlegen: AZURE_BATCH_ACCESS_KEY.
Batchkontoname. Alternativ können Sie nach Umgebungsvariablen festlegen: AZURE_BATCH_ACCOUNT.
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 Vorgänge von diesem Auftrag erneut abfragn. Sie können die AllowTaskPreemption eines Auftrags aktualisieren, nachdem er mithilfe der Updateauftrags-API erstellt wurde. Geben Sie entweder 'true' oder 'false' an, um die Eigenschaft zu aktualisieren.
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 für den Dienst exakt mit dem vom Client angegebenen Wert übereinstimmt.
Ein Zeitstempel, der die uhrzeit der letzten Änderung der Ressource angibt, die dem Client bekannt ist. Der Vorgang wird nur ausgeführt, wenn die Ressource für den Dienst seit dem angegebenen Zeitpunkt geändert wurde.
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 für den Dienst nicht mit dem vom Client angegebenen Wert übereinstimmt.
Ein Zeitstempel, der die uhrzeit der letzten Änderung der Ressource angibt, die dem Client bekannt ist. Der Vorgang wird nur ausgeführt, wenn die Ressource für den Dienst seit dem angegebenen Zeitpunkt nicht geändert wurde.
Die maximale Anzahl von Wiederholungsversuchen für jeden Vorgang. Der Batchdienst ruft eine Aufgabe erneut auf, wenn der Beendigungscode nicht null ist. Beachten Sie, dass dieser Wert die Anzahl der Wiederholungen ausdrücklich steuert. Der Batchdienst versucht jeden Vorgang einmal und kann dann bis zu diesem Grenzwert erneut versuchen. Wenn die maximale Wiederholungsanzahl beispielsweise 3 ist, versucht Batch eine Aufgabe bis zu 4 Mal (ein erster Versuch und 3 Wiederholungsversuche). Wenn die maximale Wiederholungsanzahl 0 ist, führt der Batchdienst keine Wiederholungsaufgaben durch. Wenn die maximale Wiederholungsanzahl -1 ist, wiederholt der Batchdienst Vorgänge ohne Grenzwert. Der Standardwert ist 0 (keine Wiederholungsversuche).
Wenn der Auftrag nicht innerhalb des Zeitlimits abgeschlossen wird, beendet der Batchdienst ihn und alle Aufgaben, die noch ausgeführt werden. In diesem Fall ist der Kündigungsgrund MaxWallClockTimeExpiry. Wenn diese Eigenschaft nicht angegeben ist, gibt es kein Zeitlimit für die Ausführung des Auftrags. Das erwartete Format ist eine ISO-8601-Dauer.
Eine Datei mit der Spezifikation des Auftragspatchparameters in JSON (formatiert für den jeweiligen REST-API-Textkörper). Wenn dieser Parameter angegeben ist, werden alle 'Auftragsargumente' ignoriert.
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 für die Anzahl der Aufgaben gibt, die gleichzeitig ausgeführt werden können. Sie können die maxParallelTasks eines Auftrags aktualisieren, nachdem er mithilfe der Updateauftrags-API erstellt wurde.
Ohne Angabe bleiben die vorhandenen Auftragsmetadaten unverändert. Leerzeichentrennte Werte im Format "key=value".
Die Aktion, die der Batchdienst ausführen soll, wenn sich alle Aufgaben im Auftrag im Abgeschlossenen Zustand befinden. Wenn nicht angegeben, bleibt das Vervollständigungsverhalten unverändert. Sie können den Wert nicht von "terminatejob" in "noaction" ändern – d. h., nachdem Sie die automatische Beendigung des Auftrags aktiviert haben, können Sie ihn nicht wieder 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).
Die ID eines vorhandenen Pools. Alle Aufgaben des Auftrags werden im angegebenen Pool ausgeführt.
Die Priorität des Auftrags. Prioritätswerte können zwischen -1000 und 1000 liegen, wobei -1000 die niedrigste Priorität und 1000 die höchste Priorität sind. Wenn sie weggelassen wird, bleibt die Priorität des Auftrags unverändert.
Globale Parameter
Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.
Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.
Nur Fehler anzeigen und Warnungen unterdrücken.
Ausgabeformat.
JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.
Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.
Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.
az batch job show
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
Die ID des Auftrags.
Optionale Parameter
Batchdienstendpunkt. Alternativ können Sie nach Umgebungsvariablen festlegen: AZURE_BATCH_ENDPOINT.
Batchkontoschlüssel. Alternativ können Sie nach Umgebungsvariablen festlegen: AZURE_BATCH_ACCESS_KEY.
Batchkontoname. Alternativ können Sie nach Umgebungsvariablen festlegen: AZURE_BATCH_ACCOUNT.
Eine OData-$expand-Klausel.
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 für den Dienst exakt mit dem vom Client angegebenen Wert übereinstimmt.
Ein Zeitstempel, der die uhrzeit der letzten Änderung der Ressource angibt, die dem Client bekannt ist. Der Vorgang wird nur ausgeführt, wenn die Ressource für den Dienst seit dem angegebenen Zeitpunkt geändert wurde.
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 für den Dienst nicht mit dem vom Client angegebenen Wert übereinstimmt.
Ein Zeitstempel, der die uhrzeit der letzten Änderung der Ressource angibt, die dem Client bekannt ist. Der Vorgang wird nur ausgeführt, wenn die Ressource für den Dienst seit dem angegebenen Zeitpunkt nicht geändert wurde.
Eine OData-$select-Klausel.
Globale Parameter
Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.
Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.
Nur Fehler anzeigen und Warnungen unterdrücken.
Ausgabeformat.
JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.
Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.
Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.
az batch job stop
Beenden eines ausgeführten Batchauftrags.
Beenden Sie den angegebenen Auftrag, und markieren Sie ihn als abgeschlossen. Wenn eine Terminierungsauftragsanforderung 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 der Auftrag im aktiven Zustand ausgeführt wird, werden sie im aktiven Zustand wieder Standard. Nachdem ein Auftrag beendet wurde, können keine neuen Vorgänge hinzugefügt werden Standard, und das erneute Ausführen aktiver Vorgänge wird 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
Die ID des zu beendenden Auftrags.
Optionale Parameter
Batchdienstendpunkt. Alternativ können Sie nach Umgebungsvariablen festlegen: AZURE_BATCH_ENDPOINT.
Batchkontoschlüssel. Alternativ können Sie nach Umgebungsvariablen festlegen: AZURE_BATCH_ACCESS_KEY.
Batchkontoname. Alternativ können Sie nach Umgebungsvariablen festlegen: AZURE_BATCH_ACCOUNT.
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 für den Dienst exakt mit dem vom Client angegebenen Wert übereinstimmt.
Ein Zeitstempel, der die uhrzeit der letzten Änderung der Ressource angibt, die dem Client bekannt ist. Der Vorgang wird nur ausgeführt, wenn die Ressource für den Dienst seit dem angegebenen Zeitpunkt geändert wurde.
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 für den Dienst nicht mit dem vom Client angegebenen Wert übereinstimmt.
Ein Zeitstempel, der die uhrzeit der letzten Änderung der Ressource angibt, die dem Client bekannt ist. Der Vorgang wird nur ausgeführt, wenn die Ressource für den Dienst seit dem angegebenen Zeitpunkt nicht geändert wurde.
Kündigungsgrund.
Der Text, der als TerminateReason des Auftrags angezeigt werden soll. Der Standardwert ist "UserTerminate".
Globale Parameter
Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.
Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.
Nur Fehler anzeigen und Warnungen unterdrücken.
Ausgabeformat.
JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.
Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.
Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.
