az batch task
Batchaufgaben verwalten.
Befehle
| az batch task create |
Erstellen sie Batchaufgaben. |
| az batch task delete |
Löscht einen Vorgang aus dem angegebenen Auftrag. |
| az batch task file |
Verwalten von Batchaufgabendateien. |
| az batch task file delete |
Löscht die angegebene Taskdatei aus dem ComputeKnoten, in dem die Aufgabe ausgeführt wurde. |
| az batch task file download |
Laden Sie den Inhalt einer Batchaufgabendatei herunter. |
| az batch task file list |
Listet die Dateien im Verzeichnis eines Vorgangs auf dem Computeknoten auf. |
| az batch task file show |
Ruft die Eigenschaften der angegebenen Taskdatei ab. |
| az batch task list |
Listet alle Aufgaben auf, die dem angegebenen Auftrag zugeordnet sind. |
| az batch task reactivate |
Reaktiviert eine Aufgabe, sodass sie erneut ausgeführt werden kann, auch wenn die Wiederholungsanzahl ausgelastet wurde. |
| az batch task reset |
Setzen Sie die Eigenschaften einer Batchaufgabe zurück. |
| az batch task show |
Ruft Informationen über den angegebenen Vorgang ab. |
| az batch task stop |
Beendet den angegebenen Vorgang. |
| az batch task subtask |
Verwalten von Teilvorgängen einer Batchaufgabe. |
| az batch task subtask list |
Listet alle Teilvorgänge auf, die der angegebenen Multiinstanzenaufgabe zugeordnet sind. |
az batch task create
Erstellen sie Batchaufgaben.
az batch task create --job-id
[--account-endpoint]
[--account-key]
[--account-name]
[--affinity-id]
[--application-package-references]
[--command-line]
[--environment-settings]
[--json-file]
[--max-task-retry-count]
[--max-wall-clock-time]
[--resource-files]
[--retention-time]
[--task-id]Erforderliche Parameter
Die ID des Auftrags, der den Task enthält.
Optionale Parameter
Batchdienstendpunkt. Alternativ können Sie eine Umgebungsvariable festlegen: AZURE_BATCH_ENDPOINT.
Der Batchkontoschlüssel. Alternativ können Sie eine Umgebungsvariable festlegen: AZURE_BATCH_ACCESS_KEY.
Der Name des Batch-Kontos. Alternativ können Sie eine Umgebungsvariable festlegen: AZURE_BATCH_ACCOUNT.
Erforderlich. Sie können die Affinitäts-ID eines Knotens übergeben, um anzugeben, dass diese Aufgabe auf diesem Computeknoten ausgeführt werden muss. Beachten Sie, dass dies nur eine weiche Affinität ist. Wenn der Ziel-Computeknoten ausgelastet ist oder zur Zeit, zu dem der Vorgang geplant ist, nicht verfügbar ist, wird der Vorgang an anderer Stelle geplant.
Die leer getrennte Liste der IDs, die die zu installierenden Anwendungspakete angeben. Leertrennte Anwendungs-IDs mit optionaler Version im Format "id[#version]".
Die Befehlszeile der Aufgabe. Die Befehlszeile wird nicht unter einer Shell ausgeführt und kann daher keine Shellfeatures wie die Erweiterung von Umgebungsvariablen nutzen. Wenn Sie solche Features nutzen möchten, sollten Sie die Shell in der Befehlszeile aufrufen, z. B. mit "cmd /c MyCommand" in Windows oder "/bin/bin/sh -c MyCommand" in Linux.
Eine Liste der Umgebungsvariableneinstellungen für die Aufgabe. Leerzeichentrennte Werte im Format "key=value".
Die Datei, die die Aufgabe(n) enthält, die in JSON(formatiert, um dem REST-API-Anforderungstext zu entsprechen). Akzeptiert beim Übermitteln mehrerer Aufgaben entweder ein Array von Aufgaben oder ein TaskAddCollectionParamater. Wenn dieser Parameter angegeben wird, werden alle anderen Parameter ignoriert.
Die maximale Anzahl der Wiederholungen des Vorgangs. Der Batchdienst ruft eine Aufgabe erneut auf, wenn der Ausgangscode nicht zero ist. Beachten Sie, dass dieser Wert die Anzahl der Wiederholungen für die ausführbare Task-Datei aufgrund eines Nichtzero-Ausgangscodes steuert. Der Batchdienst versucht den Vorgang einmal, und kann dann bis zu diesem Grenzwert erneut versuchen. Wenn beispielsweise die maximale Wiederholungsanzahl 3 beträgt, versucht Batch die Aufgabe bis zu 4 Mal (ein erster Versuch und 3 Wiederholungen). Wenn die maximale Wiederholungsanzahl 0 ist, versucht der Batchdienst den Vorgang nach dem ersten Versuch nicht erneut. Wenn die maximale Wiederholungsanzahl -1 ist, wird der Batchdienst den Vorgang ohne Grenzwert erneut aufrufen.
Wenn dies nicht angegeben ist, gibt es kein Zeitlimit für die Dauer der Ausführung des Vorgangs.
Eine Liste der Dateien, die der Batchdienst auf den Computeknoten herunterlädt, bevor die Befehlszeile ausgeführt wird. Leergetrennte Ressourcenverweise im Filename=httpurl-Format, wobei httpurl jede HTTP-URL mit öffentlichem Zugriff oder eine SAS-URL mit Lesezugriff ist.
Der Standardwert ist 7 Tage, d. h. das Aufgabenverzeichnis wird 7 Tage lang aufbewahrt, es sei denn, der Computeknoten wird entfernt oder der Auftrag gelöscht.
Die ID des Tasks.
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 task delete
Löscht einen Vorgang aus dem angegebenen Auftrag.
Wenn eine Aufgabe gelöscht wird, werden alle Dateien im Verzeichnis des Computeknotens, in dem sie ausgeführt wurde, ebenfalls gelöscht (unabhängig von der Aufbewahrungszeit). Bei Vorgängen mit mehreren Instanzen gilt der Vorgangsvorgang synchron für den primären Vorgang; Teilvorgänge und deren Dateien werden dann asynchron im Hintergrund gelöscht.
az batch task delete --job-id
--task-id
[--account-endpoint]
[--account-key]
[--account-name]
[--if-match]
[--if-modified-since]
[--if-none-match]
[--if-unmodified-since]
[--yes]Erforderliche Parameter
Die ID des Auftrags, aus dem der Vorgang gelöscht werden soll.
Die ID des zu löschenden Vorgangs.
Optionale Parameter
Batchdienstendpunkt. Alternativ können Sie eine Umgebungsvariable festlegen: AZURE_BATCH_ENDPOINT.
Batchkontoschlüssel. Alternativ können Sie eine Umgebungsvariable festlegen: AZURE_BATCH_ACCESS_KEY.
Batchkontoname. Alternativ können Sie eine Umgebungsvariable 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 im Dienst genau mit dem vom Client angegebenen Wert übereinstimmt.
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.
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.
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.
Nicht zur Bestätigung auffordern
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 task list
Listet alle Aufgaben auf, die dem angegebenen Auftrag zugeordnet sind.
Informationen wie AffinityId, ExecutionInfo und NodeInfo finden Sie für multiinstanzische Aufgaben. Verwenden Sie die Api für Listenuntervorgänge, um Informationen zu Teilvorgängen abzurufen.
az batch task list --job-id
[--account-endpoint]
[--account-key]
[--account-name]
[--expand]
[--filter]
[--select]Erforderliche Parameter
Die ID des Auftrags.
Optionale Parameter
Batchdienstendpunkt. Alternativ können Sie eine Umgebungsvariable festlegen: AZURE_BATCH_ENDPOINT.
Batchkontoschlüssel. Alternativ können Sie eine Umgebungsvariable festlegen: AZURE_BATCH_ACCESS_KEY.
Batchkontoname. Alternativ können Sie eine Umgebungsvariable festlegen: AZURE_BATCH_ACCOUNT.
Eine OData-$expand-Klausel.
Eine OData-$filter-Klausel. Weitere Informationen zum Erstellen dieses Filters finden Sie unter https://docs.microsoft.com/en-us/rest/api/batchservice/odata-filters-in-batch#list-tasks.
Eine OData-$select-Klausel.
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 task reactivate
Reactivates a Task, sodass es erneut ausgeführt werden kann, auch wenn die Wiederholungsanzahl erschöpft wurde.
Die Reaktivierung macht einen Vorgang berechtigt, erneut bis zu seiner maximalen Wiederholungsanzahl zu retrihieren. Der Status des Vorgangs wird in "aktiv" geändert. Da der Vorgang nicht mehr im abgeschlossenen Zustand ist, ist nach der Reaktivierung kein vorheriger Exitcode oder Fehlerinformationen mehr verfügbar. Jedes Mal, wenn ein Vorgang neu aktiviert wird, wird die Wiederholungsanzahl auf 0 zurückgesetzt. Die Reaktivierung schlägt für Vorgänge fehl, die nicht abgeschlossen sind oder die zuvor erfolgreich abgeschlossen wurden (mit einem Exitcode von 0). Darüber hinaus schlägt es fehl, wenn der Auftrag abgeschlossen ist (oder beendet oder gelöscht wird).
az batch task reactivate --job-id
--task-id
[--account-endpoint]
[--account-key]
[--account-name]
[--if-match]
[--if-modified-since]
[--if-none-match]
[--if-unmodified-since]Erforderliche Parameter
Die ID des Auftrags, der den Vorgang enthält.
Die ID des Vorgangs, der reaktiviert werden soll.
Optionale Parameter
Batchdienstendpunkt. Alternativ können Sie eine Umgebungsvariable festlegen: AZURE_BATCH_ENDPOINT.
Batchkontoschlüssel. Alternativ können Sie eine Umgebungsvariable festlegen: AZURE_BATCH_ACCESS_KEY.
Batchkontoname. Alternativ können Sie eine Umgebungsvariable 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 im Dienst genau dem vom Client angegebenen Wert entspricht.
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.
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.
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.
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 task reset
Zurücksetzen der Eigenschaften einer Batchaufgabe.
az batch task reset --job-id
--task-id
[--account-endpoint]
[--account-key]
[--account-name]
[--if-match]
[--if-modified-since]
[--if-none-match]
[--if-unmodified-since]
[--json-file]
[--max-task-retry-count]
[--max-wall-clock-time]
[--retention-time]Erforderliche Parameter
Die ID des Auftrags, der den Vorgang enthält.
Die ID des Zu aktualisierenden Vorgangs.
Optionale Parameter
Batchdienstendpunkt. Alternativ können Sie eine Umgebungsvariable festlegen: AZURE_BATCH_ENDPOINT.
Batchkontoschlüssel. Alternativ können Sie eine Umgebungsvariable festlegen: AZURE_BATCH_ACCESS_KEY.
Batchkontoname. Alternativ können Sie eine Umgebungsvariable 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 im Dienst genau dem vom Client angegebenen Wert entspricht.
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.
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.
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.
Eine Datei, die die Einschränkungsspezifikation in JSON enthält (formatiert, um dem jeweiligen REST-API-Textkörper zu entsprechen). Wenn dieser Parameter angegeben wird, werden alle "Einschränkungensargumente" ignoriert.
Die maximale Anzahl der Zeiten, in denen der Vorgang erneut ausgeführt werden kann. Der Batchdienst ruft einen Vorgang zurück, wenn sein Exitcode nicht zero ist. Beachten Sie, dass dieser Wert insbesondere die Anzahl der Wiederholungen für die ausführbare Task-Datei aufgrund eines Nichtzero-Exitcodes steuert. Der Batchdienst versucht den Vorgang einmal, und kann dann bis zu diesem Grenzwert erneut versuchen. Wenn beispielsweise die maximale Wiederholungsanzahl 3 beträgt, versucht Batch die Aufgabe bis zu 4 Mal (ein anfänglicher Versuch und 3 Wiederholungen). Wenn die maximale Wiederholungsanzahl 0 ist, wird der Batchdienst den Vorgang nach dem ersten Versuch nicht erneut wiederholen. Wenn die maximale Wiederholungsanzahl -1 lautet, wird der Batchdienst den Vorgang ohne Begrenzung erneut zurückverwenden.
Wenn dies nicht angegeben ist, gibt es keine Zeitbeschränkung für die Dauer der Ausführung des Vorgangs. Das erwartete Format ist eine ISO-8601-Dauer.
Der Standardwert ist 7 Tage, d. h. das Aufgabenverzeichnis wird für 7 Tage aufbewahrt, es sei denn, der Computeknoten wird entfernt, oder der Auftrag wird gelöscht. Das erwartete Format ist eine ISO-8601-Dauer.
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 task show
Ruft Informationen zu dem angegebenen Vorgang ab.
Informationen wie AffinityId, ExecutionInfo und NodeInfo finden Sie für multiinstanzische Aufgaben. Verwenden Sie die Api für Listenuntervorgänge, um Informationen zu Teilvorgängen abzurufen.
az batch task show --job-id
--task-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, der den Vorgang enthält.
Die ID des Vorgangs, um Informationen zu erhalten.
Optionale Parameter
Batchdienstendpunkt. Alternativ können Sie eine Umgebungsvariable festlegen: AZURE_BATCH_ENDPOINT.
Batchkontoschlüssel. Alternativ können Sie eine Umgebungsvariable festlegen: AZURE_BATCH_ACCESS_KEY.
Batchkontoname. Alternativ können Sie eine Umgebungsvariable 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 im Dienst genau dem vom Client angegebenen Wert entspricht.
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.
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.
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.
Eine OData-$select-Klausel.
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 task stop
Beendet den angegebenen Vorgang.
Wenn der Vorgang beendet wurde, wird er zum abgeschlossenen Zustand verschoben. Für mehrere Instanzen bezieht sich der Vorgang "Vorgang beenden" synchron auf den primären Vorgang; Teilvorgänge werden dann asynchron im Hintergrund beendet.
az batch task stop --job-id
--task-id
[--account-endpoint]
[--account-key]
[--account-name]
[--if-match]
[--if-modified-since]
[--if-none-match]
[--if-unmodified-since]Erforderliche Parameter
Die ID des Auftrags, der den Vorgang enthält.
Die ID der zu beendenden Aufgabe.
Optionale Parameter
Batchdienstendpunkt. Alternativ können Sie eine Umgebungsvariable festlegen: AZURE_BATCH_ENDPOINT.
Batchkontoschlüssel. Alternativ können Sie eine Umgebungsvariable festlegen: AZURE_BATCH_ACCESS_KEY.
Batchkontoname. Alternativ können Sie eine Umgebungsvariable 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 im Dienst genau mit dem vom Client angegebenen Wert übereinstimmt.
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.
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.
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.
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.
Feedback
Feedback senden und anzeigen für