az batch job
Batchaufträge verwalten.
Befehle
Name | Beschreibung | Typ | Status |
---|---|---|---|
az batch job create |
Fügen Sie einem Batchkonto einen Auftrag hinzu. |
Kern | GA |
az batch job delete |
Löscht einen Auftrag aus einem Batchkonto. |
Kern | GA |
az batch job disable |
Deaktivieren Sie einen Batchauftrag. |
Kern | GA |
az batch job enable |
Aktivieren sie einen Batchauftrag. |
Kern | GA |
az batch job list |
Listet alle Aufträge oder Auftragspläne in einem Batchkonto auf. |
Kern | GA |
az batch job prep-release-status |
Zeigen Sie den Status der Batchauftragsvorbereitung an und geben Sie Aufgaben frei. |
Kern | GA |
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. |
Kern | GA |
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. |
Kern | GA |
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. |
Kern | GA |
az batch job show |
Ruft Informationen zum angegebenen Batchauftrag ab. |
Kern | GA |
az batch job stop |
Beenden eines ausgeführten Batchauftrags. |
Kern | GA |
az batch job task-counts |
Zeigen Sie die Anzahl der Aufgaben und Slots in einem Batchauftrag und deren Zuständen an. |
Kern | GA |
az batch job task-counts show |
Ruft die Vorgangsanzahl für den angegebenen Auftrag ab. |
Kern | GA |
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-application-package-references]
[--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]
[--on-all-tasks-complete]
[--pool-id]
[--priority]
[--required-slots]
[--uses-task-dependencies]
Beispiele
Erstellen Sie einen neuen Auftrag, der einem vorhandenen Pool zugeordnet ist.
az batch job create --id job1 --pool-id pool1
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.
Eine Zeichenfolge, die den Auftrag innerhalb des Kontos 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. 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.
Eine Liste der Anwendungspakete, die der Batchdienst vor dem Ausführen der Befehlszeile auf dem Computeknoten bereitstellen wird. Anwendungspakete werden heruntergeladen und in einem freigegebenen Verzeichnis bereitgestellt, nicht im Arbeitsverzeichnis "Aufgabe". Wenn sich daher bereits ein referenziertes Anwendungspaket auf dem Computeknoten befindet und auf dem neuesten Stand ist, wird es nicht erneut heruntergeladen. die vorhandene Kopie auf dem Computeknoten verwendet wird. Wenn ein referenziertes Anwendungspaket nicht installiert werden kann, z. B. weil das Paket gelöscht wurde oder weil der Download fehlgeschlagen ist, schlägt die Aufgabe fehl. Leerzeichentrennte Anwendungs-IDs mit optionaler Version im Format "id[#version]".
Die Befehlszeile der Auftrags-Manager-Aufgabe. 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) verwenden. Erforderlich.
Eine Liste der Umgebungsvariableneinstellungen für die Auftrags-Manager-Aufgabe. Leerzeichentrennte Werte im Format "key=value".
Eine Zeichenfolge, die die Auftrags-Manager-Aufgabe 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. Erforderlich.
Eine Liste der Dateien, die der Batchdienst vor dem Ausführen der Befehlszeile auf den Computeknoten herunterladen wird. 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 speziell die Anzahl der Wiederholungen 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 Wiederholungen).
Die maximale verstrichene Zeit, die der Auftrag ausführen kann, gemessen vom Zeitpunkt der Erstellung des Auftrags. 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 bei Angabe -1 oder größer als 0 sein. 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.
Eine Liste von Name-Wert-Paaren, die dem Auftrag als Metadaten zugeordnet sind. 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 Aktion, die der Batchdienst ausführen soll, wenn sich alle Aufgaben im Auftrag im Abgeschlossenen Zustand befinden. Beachten Sie, dass alle Vorgänge als erledigt betrachtet werden, wenn ein Auftrag keine Aufgaben enthält. Diese Option wird daher am häufigsten mit einer Job Manager-Aufgabe verwendet; Wenn Sie die automatische Beendigung des Auftrags ohne Job Manager verwenden möchten, sollten Sie zunächst "onAllTasksComplete" auf "noaction" festlegen und die Auftragseigenschaften so aktualisieren, dass "onAllTasksComplete" auf "terminatejob" festgelegt wird, nachdem Sie das Hinzufügen von Aufgaben abgeschlossen haben. Der Standardwert ist keine Aktion. Bekannte Werte sind: "noaction" und "terminatejob".
Die ID eines vorhandenen Pools. Alle Aufgaben des Auftrags werden im angegebenen Pool ausgeführt. Sie müssen sicherstellen, dass der Pool, auf den von dieser Eigenschaft verwiesen wird, vorhanden ist. Wenn der Pool zum Zeitpunkt, zu dem der Batchdienst versucht, einen Auftrag zu planen, nicht vorhanden ist, werden keine Aufgaben für den Auftrag ausgeführt, bis Sie einen Pool mit dieser ID erstellen. Beachten Sie, dass der Batchdienst die Auftragsanforderung nicht ablehnt. Es wird nur Aufgaben ausgeführt, bis der Pool vorhanden ist. Sie müssen entweder die Pool-ID oder die Spezifikation für den automatischen Pool angeben, aber nicht beides.
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
Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.
Diese Hilfenachricht anzeigen und beenden.
Nur Fehler anzeigen, Warnungen unterdrücken.
Ausgabeformat.
JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.
Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_ID
konfigurieren.
Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.
az batch job delete
Löscht einen Auftrag aus einem Batchkonto.
az batch job delete --job-id
[--account-endpoint]
[--account-key]
[--account-name]
[--if-match]
[--if-modified-since]
[--if-none-match]
[--if-unmodified-since]
[--yes]
Beispiele
Löschen Sie einen Auftrag mithilfe der Auftrags-ID ohne Bestätigungsaufforderung.
az batch job delete --job-id job1 --yes
Erforderliche Parameter
Die ID des zu löschenden Auftrags. Erforderlich.
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 geändert wurde.
Zur Bestätigung nicht auffordern.
Globale Parameter
Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.
Diese Hilfenachricht anzeigen und beenden.
Nur Fehler anzeigen, Warnungen unterdrücken.
Ausgabeformat.
JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.
Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_ID
konfigurieren.
Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.
az batch job disable
Deaktivieren Sie einen Batchauftrag.
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]
[--json-file]
Beispiele
Deaktivieren Sie einen Auftrag, und stellen Sie alle ausgeführten Aufgaben erneut ab.
az batch job disable --job-id job1 --disable-tasks requeue
Erforderliche Parameter
Die ID des zu deaktivierenden Auftrags. Erforderlich.
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.
Was mit aktiven Vorgängen zu tun ist, die dem Auftrag zugeordnet sind. Erforderlich. Bekannte Werte sind: "requeue", "terminate" und "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 geändert wurde.
Eine Datei, die die Inhaltsspezifikation in JSON enthält (formatiert mit dem jeweiligen REST-API-Textkörper). Wenn dieser Parameter angegeben ist, werden alle Inhaltsargumente ignoriert.
Globale Parameter
Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.
Diese Hilfenachricht anzeigen und beenden.
Nur Fehler anzeigen, Warnungen unterdrücken.
Ausgabeformat.
JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.
Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_ID
konfigurieren.
Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.
az batch job enable
Aktivieren sie einen Batchauftrag.
az batch job enable --job-id
[--account-endpoint]
[--account-key]
[--account-name]
[--if-match]
[--if-modified-since]
[--if-none-match]
[--if-unmodified-since]
Beispiele
Aktivieren sie einen Auftrag.
az batch job enable --job-id job1
Erforderliche Parameter
Die ID des zu aktivierenden Auftrags. Erforderlich.
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 geändert wurde.
Globale Parameter
Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.
Diese Hilfenachricht anzeigen und beenden.
Nur Fehler anzeigen, Warnungen unterdrücken.
Ausgabeformat.
JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.
Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_ID
konfigurieren.
Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.
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]
Beispiele
Auflisten aller Aufträge in einem Batchkonto
az batch job list
Auflisten des gesamten Auftragszeitplans in einem Batchkonto
az batch job list --job-schedule-id jobschedule1
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 Batchkontos. Nur erforderlich, festgelegt nach Umgebungsvariable: AZURE_BATCH_ACCOUNT.
Eine OData-$expand-Klausel.
Eine OData-$filter-Klausel. Weitere Informationen zum Erstellen dieses Filters finden Sie unter https://learn.microsoft.com/rest/api/batchservice/odata-filters-in-batch.
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
Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.
Diese Hilfenachricht anzeigen und beenden.
Nur Fehler anzeigen, Warnungen unterdrücken.
Ausgabeformat.
JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.
Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_ID
konfigurieren.
Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.
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]
[--pool-id]
[--priority]
Beispiele
Setzen Sie alle Auftragseigenschaften außer Priorität zurück.
az batch job reset --job-id job1 --priority 100
Erforderliche Parameter
Die ID des Auftrags, dessen Eigenschaften Sie aktualisieren möchten. Erforderlich.
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 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 speziell die Anzahl der Wiederholungen 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 Wiederholungen).
Die maximale verstrichene Zeit, die der Auftrag ausführen kann, gemessen vom Zeitpunkt der Erstellung des Auftrags. 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 bei Angabe -1 oder größer als 0 sein. 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.
Eine Liste von Name-Wert-Paaren, die dem Auftrag als Metadaten zugeordnet sind. 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 Aktion, die der Batchdienst ausführen soll, wenn sich alle Aufgaben im Auftrag im Abgeschlossenen Zustand befinden. Der Standardwert ist keine Aktion. Bekannte Werte sind: "noaction" und "terminatejob".
Die ID eines vorhandenen Pools. Alle Aufgaben des Auftrags werden im angegebenen Pool ausgeführt. Sie müssen sicherstellen, dass der Pool, auf den von dieser Eigenschaft verwiesen wird, vorhanden ist. Wenn der Pool zum Zeitpunkt, zu dem der Batchdienst versucht, einen Auftrag zu planen, nicht vorhanden ist, werden keine Aufgaben für den Auftrag ausgeführt, bis Sie einen Pool mit dieser ID erstellen. Beachten Sie, dass der Batchdienst die Auftragsanforderung nicht ablehnt. Es wird nur Aufgaben ausgeführt, bis der Pool vorhanden ist. Sie müssen entweder die Pool-ID oder die Spezifikation für den automatischen Pool angeben, aber nicht beides.
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.
Globale Parameter
Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.
Diese Hilfenachricht anzeigen und beenden.
Nur Fehler anzeigen, Warnungen unterdrücken.
Ausgabeformat.
JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.
Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_ID
konfigurieren.
Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.
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]
[--pool-id]
[--priority]
Beispiele
Auftragpriorität aktualisieren.
az batch job set --job-id job1 --priority 100
Erforderliche Parameter
Die ID des Auftrags, dessen Eigenschaften Sie aktualisieren möchten. Erforderlich.
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 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 speziell die Anzahl der Wiederholungen 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 Wiederholungen).
Die maximale verstrichene Zeit, die der Auftrag ausführen kann, gemessen vom Zeitpunkt der Erstellung des Auftrags. 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 bei Angabe -1 oder größer als 0 sein. 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.
Eine Liste von Name-Wert-Paaren, die dem Auftrag als Metadaten zugeordnet sind. 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). Bekannte Werte sind: "noaction" und "terminatejob".
Die ID eines vorhandenen Pools. Alle Aufgaben des Auftrags werden im angegebenen Pool ausgeführt. Sie müssen sicherstellen, dass der Pool, auf den von dieser Eigenschaft verwiesen wird, vorhanden ist. Wenn der Pool zum Zeitpunkt, zu dem der Batchdienst versucht, einen Auftrag zu planen, nicht vorhanden ist, werden keine Aufgaben für den Auftrag ausgeführt, bis Sie einen Pool mit dieser ID erstellen. Beachten Sie, dass der Batchdienst die Auftragsanforderung nicht ablehnt. Es wird nur Aufgaben ausgeführt, bis der Pool vorhanden ist. Sie müssen entweder die Pool-ID oder die Spezifikation für den automatischen Pool angeben, aber nicht beides.
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
Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.
Diese Hilfenachricht anzeigen und beenden.
Nur Fehler anzeigen, Warnungen unterdrücken.
Ausgabeformat.
JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.
Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_ID
konfigurieren.
Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.
az batch job show
Ruft Informationen zum angegebenen Batchauftrag 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]
Beispiele
Zeigt Informationen zu einem Auftrag an.
az batch job show --job-id job1
Erforderliche Parameter
Die ID des Auftrags. Erforderlich.
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 geändert wurde.
Eine OData-$select-Klausel.
Globale Parameter
Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.
Diese Hilfenachricht anzeigen und beenden.
Nur Fehler anzeigen, Warnungen unterdrücken.
Ausgabeformat.
JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.
Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_ID
konfigurieren.
Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.
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, verbleiben sie im aktiven Zustand. Nachdem 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]
Beispiele
Beenden eines Auftrags und Kündigungsgrund
az batch job stop --job-id job1 --terminate-reason "Completed workflow"
Erforderliche Parameter
Die ID des zu beendenden Auftrags. Erforderlich.
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 geändert wurde.
Kündigungsgrund.
Der Text, der als TerminateReason des Auftrags angezeigt werden soll. Der Standardwert ist "UserTerminate".
Globale Parameter
Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.
Diese Hilfenachricht anzeigen und beenden.
Nur Fehler anzeigen, Warnungen unterdrücken.
Ausgabeformat.
JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.
Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_ID
konfigurieren.
Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.