Tasks - Get Task

BatchTask

Die Anforderung ist erfolgreich.

Header

• DataServiceId: string
• ETag: string
• Last-Modified: string
• client-request-id: string
• request-id: string

BatchError

Unerwartete Fehlerantwort.

BatchAccessScope[]

Die Batch-Ressourcen, auf die der Token Zugriff gewährt. Der Authentifizierungstoken gewährt Zugriff auf eine begrenzte Anzahl von Batch-Service-Operationen. Derzeit ist der einzige unterstützte Wert für die Zugriffseigenschaft 'Job', der Zugriff auf alle Operationen gewährt, die mit dem Job zusammenhängen, der die Aufgabe enthält.

ElevationLevel

Die Höhenstufe des automatischen Benutzers. Der Standardwert ist "nonAdmin".

AutoUserScope

Der Bereich für den automatischen Benutzer. Der Standardwert ist Pool. Wenn der Pool Windows ausführt, sollte ein Wert der Aufgabe angegeben werden, wenn eine strengere Isolierung zwischen Vorgängen erforderlich ist. Dies ist beispielsweise der Fall, wenn die Aufgabe die Registrierung in einer Weise ändert, die sich auf andere Aufgaben auswirken kann.

string

Eine undurchsichtige Zeichenkette, die den Standort eines Rechenknotens oder einer Aufgabe darstellt, die zuvor ausgeführt wurde. Man kann die affinityId eines Knotens weitergeben, um anzuzeigen, dass diese Aufgabe auf diesem Rechenknoten ausgeführt werden muss. Beachten Sie, dass dies nur eine weiche Affinität ist. Wenn der Ziel-Computeknoten zum Zeitpunkt der Planung des Vorgangs ausgelastet oder nicht verfügbar ist, wird der Vorgang an anderer Stelle geplant.

string

Die ID der zu implementierenden Anwendung. Beim Erstellen eines Pools muss die Anwendungs-ID des Pakets vollqualifizierte sein (/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Batch/batchAccounts/{accountName}/applications/{applicationName}).

string

Die Version der bereitzustellenden Anwendung. Wenn sie weggelassen wird, wird die Standardversion bereitgestellt. Wenn dies in einem Pool weggelassen wird und für diese Anwendung keine Standardversion angegeben ist, schlägt die Anfrage mit dem Fehlercode InvalidApplicationPackageReferences und dem HTTP-Statuscode 409 fehl. Wenn dies bei einer Aufgabe weggelassen wird und für diese Anwendung keine Standardversion angegeben ist, scheitert die Aufgabe mit einem Vorverarbeitungsfehler.

string

Ein Bezeichner für den Fehler. Codes sind unveränderlich und sollen programmgesteuert genutzt werden.

BatchErrorMessage

Eine Meldung, die den Fehler beschreibt, der für die Anzeige in einer Benutzeroberfläche geeignet ist.

BatchErrorDetail[]

Eine Sammlung von Schlüssel-Wert-Paaren, die zusätzliche Details zum Fehler enthalten.

string

Ein Bezeichner, der die Bedeutung der Value-Eigenschaft angibt.

string

Die zusätzlichen Informationen, die in der Fehlerantwort enthalten sind.

string

Der Sprachcode der Fehlermeldung.

string

Der Text der Nachricht.

string (arm-id)

Die ARM-Ressourcen-ID der vom Benutzer zugewiesenen Identität.

string

Eine Identifikatorin für den Knoten, auf dem die Aufgabe lief, die beim Hinzufügen einer Aufgabe weitergegeben werden kann, um zu verlangen, dass die Aufgabe auf diesem Rechenknoten geplant wird.

string

Die ID des Rechenknotens, auf dem die Aufgabe lief.

string (uri)

Die URL des Compute-Knotens, auf dem die Aufgabe lief.

string

Die ID des Pools, auf dem die Aufgabe lief.

string

Das Wurzelverzeichnis der Aufgabe auf dem Compute-Knoten.

string (uri)

Die URL zum Root-Verzeichnis der Task auf dem Compute Node.

BatchAffinityInfo

Ein Lokalitätshinweis, den der Batch-Service nutzen kann, um einen Compute-Knoten auszuwählen, auf dem die neue Aufgabe gestartet wird.

BatchApplicationPackageReference[]

Eine Liste von Paketen, die der Batch-Service vor dem Ausführen der Kommandozeile an den Compute Node ausliefert. Anwendungspakete werden heruntergeladen und in einem gemeinsamen Verzeichnis bereitgestellt, nicht im Arbeitsverzeichnis Task. Daher wird ein referenziertes Paket, das bereits auf dem Node ist und aktuell ist, nicht erneut heruntergeladen; die vorhandene Kopie auf dem Compute-Node wird verwendet. Wenn ein referenziertes Paket nicht installiert werden kann, zum Beispiel weil das Paket gelöscht wurde oder der Download fehlgeschlagen ist, schlägt die Aufgabe fehl.

AuthenticationTokenSettings

Die Einstellungen für ein Authentifizierungstoken, das von der Aufgabe zum Ausführen von Batchdienstvorgängen verwendet werden kann. Wenn diese Eigenschaft gesetzt ist, stellt der Batch-Service der Aufgabe ein Authentifizierungstoken zur Verfügung, das zur Authentifizierung von Batch-Service-Operationen ohne Konto-Zugriffsschlüssel verwendet werden kann. Das Token wird über die AZ_BATCH_AUTHENTICATION_TOKEN Umgebungsvariable bereitgestellt. Die Operationen, die die Aufgabe mit dem Token ausführen kann, hängen von den Einstellungen ab. Zum Beispiel kann eine Aufgabe Job-Berechtigungen anfordern, um weitere Aufgaben zum Job hinzuzufügen oder den Status des Jobs oder anderer Aufgaben unter dem Job überprüfen.

string

Die Befehlszeile der Aufgabe. Bei Multi-Instanz-Aufgaben wird die Befehlszeile als primäre Aufgabe ausgeführt, nachdem die Hauptaufgabe und alle Unteraufgaben die Koordinationskommandozeile ausgeführt haben. 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://v4.hkg1.meaqua.org/azure/batch/batch-compute-node-environment-variables) verwenden.

BatchTaskConstraints

Die Ausführungsbeschränkungen, die für diese Aufgabe gelten.

BatchTaskContainerSettings

Die Einstellungen für den Container, unter dem die Aufgabe ausgeführt wird. Wenn der Pool, der diese Aufgabe ausführen wird, containerConfiguration gesetzt hat, muss dies ebenfalls gesetzt werden. Wenn der Pool, der diese Aufgabe ausführen soll, keine containerConfiguration gesetzt hat, darf dies nicht gesetzt werden. Wenn dies angegeben ist, werden alle Verzeichnisse rekursiv unterhalb der AZ_BATCH_NODE_ROOT_DIR (der Wurzel der Azure Batch-Verzeichnisse auf dem Knoten) in den Container abgebildet, alle Task-Umgebungsvariablen werden in den Container abgebildet und die Task-Befehlszeile wird im Container ausgeführt. Dateien, die außerhalb AZ_BATCH_NODE_ROOT_DIR im Container erzeugt werden, werden möglicherweise nicht auf die Host-Festplatte zurückgewiesen, was bedeutet, dass Batch-Datei-APIs nicht auf diese Dateien zugreifen können.

string (date-time)

Die Entstehungszeit der Aufgabe.

BatchTaskDependencies

Die Aufgaben, von denen diese Aufgabe abhängt. Diese Aufgabe wird erst eingeplant, wenn alle Aufgaben, von denen sie abhängt, erfolgreich abgeschlossen sind. Wenn eine dieser Aufgaben scheitert und ihre Wiederholungszahlen erschöpft sind, wird diese Aufgabe niemals geplant.

string

Ein Anzeigename für die Aufgabe. Der Anzeigename muss nicht eindeutig sein und kann alle Unicode-Zeichen bis zu einer maximalen Länge von 1024 enthalten.

string

Der ETag der Aufgabe. Dies ist eine undurchsichtige Zeichenfolge. Sie können damit erkennen, ob sich die Aufgabe zwischen den Anfragen geändert hat. Insbesondere kann man beim Aktualisieren einer Aufgabe das ETag übergeben, um festzulegen, dass die Änderungen nur dann in Kraft treten sollen, wenn in der Zwischenzeit niemand sonst die Aufgabe geändert hat.

EnvironmentSetting[]

Eine Liste der Umgebungsvariablen-Einstellungen für die Aufgabe.

BatchTaskExecutionInfo

Informationen über die Ausführung der Aufgabe.

ExitConditions

Wie der Batch-Service reagieren sollte, wenn die Aufgabe abgeschlossen ist.

string

Eine Zeichenkette, die die 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.

string (date-time)

Die letzte modifizierte Zeit der Aufgabe.

MultiInstanceSettings

Ein Objekt, das anzeigt, dass die Aufgabe eine Multi-Instanz-Aufgabe ist, und enthält Informationen darüber, wie die Multi-Instanz-Aufgabe ausgeführt werden soll.

BatchNodeInfo

Informationen über den Rechenknoten, auf dem die Aufgabe lief.

OutputFile[]

Eine Liste von Dateien, die der Batch-Service nach Ausführung der Kommandozeile vom Compute Node hochlädt. Bei Mehrinstanz-Aufgaben werden die Dateien nur vom Rechenknoten hochgeladen, auf dem die Hauptaufgabe ausgeführt wird.

BatchTaskState

Der vorherige Zustand der Aufgabe. Diese Eigenschaft ist nicht gesetzt, wenn sich die Aufgabe im Anfangszustand der Aktivität befindet.

string (date-time)

Der Zeitpunkt, zu dem die Aufgabe in ihren vorherigen Zustand eintrat. Diese Eigenschaft ist nicht gesetzt, wenn sich die Aufgabe im Anfangszustand der Aktivität befindet.

integer (int32)

Die Anzahl der Planungsplätze, die die Aufgabe benötigt, um ausgeführt zu werden. Der Standardwert ist 1. Eine Aufgabe kann nur dann auf einem Rechenknoten ausgeführt werden, wenn dieser genügend freie Planungsplätze zur Verfügung hat. Für Aufgaben mit mehreren Instanzen muss dies 1 sein.

ResourceFile[]

Eine Liste der Dateien, die der Batchdienst vor dem Ausführen der Befehlszeile auf den Computeknoten herunterladen wird. Für Aufgaben mit mehreren Instanzen werden die Ressourcendateien nur auf den Rechenknoten heruntergeladen, auf dem die Hauptaufgabe ausgeführt wird. 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.

BatchTaskState

Der aktuelle Stand der Aufgabe.

string (date-time)

Der Zeitpunkt, zu dem die Aufgabe in ihren heutigen Zustand eintrat.

BatchTaskStatistics

Ressourcenverbrauchsstatistiken für die Aufgabe.

string (uri)

Die URL der Aufgabe.

UserIdentity

Die Benutzeridentität, unter der die Aufgabe ausgeführt wird. Wenn sie weggelassen wird, läuft die Aufgabe als nicht-administrativer Benutzer, der einzigartig für die Aufgabe ist.

integer (int32)

Die maximale Anzahl der Wiederholungsversuche des Vorgangs. Der Batchdienst ruft eine Aufgabe erneut auf, wenn der Beendigungscode nicht null ist. Beachten Sie, dass dieser Wert speziell die Anzahl der Versuche für die ausführbare Task-Datei aufgrund eines von null verschiedenen Exit-Codes steuert. Der Batchdienst versucht die Aufgabe einmal, und kann dann bis zu diesem Grenzwert erneut versuchen. Wenn die maximale Wiederholungsanzahl beispielsweise 3 ist, versucht Batch die Aufgabe bis zu 4 Mal (ein erster Versuch und 3 Wiederholungsversuche). Wenn die maximale Anzahl der Wiederholungen 0 beträgt, versucht der Batch-Service die Aufgabe nach dem ersten Versuch nicht erneut. Wenn die maximale Wiederholungsanzahl -1 ist, wiederholt der Batchdienst den Vorgang ohne Beschränkung, dies wird jedoch nicht für einen Startvorgang oder einen Vorgang empfohlen. Der Standardwert ist 0 (keine Wiederholungen).

string (duration)

Die maximal vergangene Zeit, die die Aufgabe laufen kann, gemessen ab dem Zeitpunkt des Beginns der Aufgabe. Wenn die Aufgabe nicht innerhalb des Zeitlimits abgeschlossen wird, beendet der Batch-Service sie. Wenn dies nicht angegeben ist, gibt es keine Zeitbegrenzung, wie lange die Aufgabe laufen darf.

string (duration)

Die Mindestzeit, um das Task-Verzeichnis auf dem Compute Node, in dem es lief, zu behalten, ab dem Zeitpunkt, an dem die Ausführung abgeschlossen ist. Nach dieser Zeit kann der Batch-Service das Task-Verzeichnis und alle Inhalte löschen. Standardmäßig sind 7 Tage, d. h. das Aufgabenverzeichnis wird 7 Tage lang aufbewahrt, es sei denn, der Compute-Knoten wird entfernt oder der Job gelöscht.

string

ID des Containers.

string

Detaillierte Fehlerinformationen zum Container. Dies ist die detaillierte Fehlerfolge des Docker-Dienstes, falls verfügbar. Es entspricht dem Fehlerfeld, das von "docker inspect" zurückgegeben wird.

string

Der Zustand des Behälters. Dies ist der Zustand des Containers laut dem Docker-Service. Es entspricht dem Statusfeld, das von "docker inspect" zurückgegeben wird.

ContainerHostBatchBindMountEntry[]

Die Pfade, die Sie an containeraufgaben bereitstellen möchten. Wenn dieses Array null ist oder nicht vorhanden ist, stellt die Containeraufgabe das gesamte temporäre Laufwerk in Windows (oder AZ_BATCH_NODE_ROOT_DIR in Linux) ein. Es werden keine Datenpfade in Container bereitgestellt, wenn dieses Array als leer festgelegt ist.

string

Zusätzliche Optionen für den Befehl "Container erstellen". Diese zusätzlichen Optionen werden zusätzlich zu den vom Batchdienst gesteuerten Befehlen als Argumente für den Befehl "docker create" bereitgestellt.

string

Das Image, das verwendet wird, um den Container zu erstellen, in dem die Aufgabe ausgeführt wird. Dies ist die vollständige Image-Referenz, wie sie bei "docker pull" angegeben wäre. Wenn kein Tag im Bildnamen angegeben ist, wird standardmäßig das Tag ":latest" verwendet.

ContainerRegistryReference

Das private Register, das das Container-Image enthält. Diese Einstellung kann weggelassen werden, wenn sie bereits bei der Poolerstellung bereitgestellt wurde.

ContainerWorkingDirectory

Der Standort des Arbeitsverzeichnisses Container Task. Der Standardwert ist "taskWorkingDirectory".

BatchTaskIdRange[]

Die Liste der Aufgaben-ID-Bereiche, auf denen diese Aufgabe basiert. Alle Aufgaben in allen Bereichen müssen erfolgreich abgeschlossen werden, bevor die abhängige Aufgabe geplant werden kann.

string[]

Die Liste der Task-IDs, von denen diese Aufgabe abhängt. Alle Aufgaben in dieser Liste müssen erfolgreich abgeschlossen werden, bevor die abhängige Aufgabe geplant werden kann. Die taskIds-Sammlung ist auf insgesamt 64.000 Zeichen begrenzt (d. h. die kombinierte Länge aller Task-IDs). Wenn die TaskIds-Sammlung die maximale Länge überschreitet, scheitert die Aufgabe hinzufügen-Anfrage mit dem Fehlercode TaskDependencyListTooLong. In diesem Fall sollten Sie stattdessen Task-ID-Bereiche verwenden.

BatchTaskContainerExecutionInfo

Informationen über den Container, unter dem die Aufgabe ausgeführt wird. Diese Eigenschaft wird nur gesetzt, wenn die Aufgabe in einem Containerkontext ausgeführt wird.

string (date-time)

Der Zeitpunkt, zu dem die Aufgabe abgeschlossen wurde. Diese Eigenschaft wird nur gesetzt, wenn sich die Aufgabe im Zustand "abgeschlossen" befindet.

integer (int32)

Der Exit-Code des Programms ist in der Task-Befehlszeile angegeben. Diese Eigenschaft wird nur gesetzt, wenn sich die Aufgabe im abgeschlossenen Zustand befindet. Im Allgemeinen spiegelt der Ausgangscode eines Prozesses die spezifische Konvention wider, die vom Anwendungsentwickler für diesen Prozess implementiert wurde. Wenn Sie den Exit-Code-Wert verwenden, um Entscheidungen in Ihrem Code zu treffen, stellen Sie sicher, dass Sie die Exit-Code-Konvention kennen, die vom Anwendungsprozess verwendet wird. Wenn der Batch-Service jedoch die Aufgabe beendet (aufgrund von Timeout oder Benutzerbeendigung über die API), könnten Sie einen vom Betriebssystem definierten Exit-Code sehen.

BatchTaskFailureInfo

Informationen, die das Misserfolg der Aufgabe beschreiben, falls vorhanden. Diese Eigenschaft wird nur gesetzt, wenn sich die Aufgabe im abgeschlossenen Zustand befindet und auf einen Fehler stößt.

string (date-time)

Der letzte Zeitpunkt, zu dem die Aufgabe vom Batch-Service infolge einer Benutzeranforderung wieder in die Warteschlange gestellt wurde. Diese Eigenschaft wird nur gesetzt, wenn die requeueCount nicht null ist.

string (date-time)

Das letzte Mal, als ein erneuter Versuch der Aufgabe begann. Dieses Element ist nur vorhanden, wenn die Aufgabe erneut versucht wurde (d. h. retryCount ist nicht null). Wenn vorhanden, ist dies typischerweise dasselbe wie startTime, kann aber anders sein, wenn die Aufgabe aus anderen Gründen als dem erneuten Versuch neu gestartet wurde; zum Beispiel, wenn der Compute-Knoten während eines erneuten Versuchs neu gestartet wurde, wird startTime aktualisiert, aber der lastRetryTime nicht.

integer (int32)

Die Anzahl der Male, in denen die Aufgabe vom Batch-Service infolge einer Benutzeranforderung erneut in die Warteschlange gestellt wurde. Wenn der Benutzer Compute-Knoten aus einem Pool entfernt (indem er den Pool verkleinert/verkleinert) oder wenn der Job deaktiviert wird, kann er festlegen, dass ausführende Aufgaben auf den Compute-Knoten zur Ausführung erneut in die Warteschlange gestellt werden. Diese Zählung zeigt, wie oft die Aufgabe aus diesen Gründen neu in die Warteschlange gestellt wurde.

BatchTaskExecutionResult

Das Ergebnis der Ausführung der Aufgabe. Wenn der Wert 'fehlgeschlagen' ist, können die Details des Scheiterns in der Eigenschaft failureInfo gefunden werden.

integer (int32)

Die Anzahl der Male, in denen die Aufgabe vom Batch-Service erneut versucht wurde. Task-Anwendungsfehler (nicht-null-Exit-Code) werden erneut versucht, Vorverarbeitungsfehler (die Aufgabe konnte nicht ausgeführt werden) und Datei-Upload-Fehler werden nicht erneut versucht. Der Batch-Service versucht die Aufgabe bis zum durch die Einschränkungen festgelegten Limit erneut.

string (date-time)

Die Zeit, zu der die Aufgabe zu laufen begann. 'Laufend' entspricht dem laufenden Zustand, sodass wenn die Aufgabe Ressourcendateien oder Pakete angibt, die Startzeit den Zeitpunkt widerspiegelt, zu dem die Aufgabe mit dem Herunterladen oder Bereitstellen begonnen hat. Wenn die Aufgabe neu gestartet oder erneut versucht wurde, ist dies der letzte Zeitpunkt, in dem die Aufgabe ausgeführt wurde. Diese Eigenschaft ist nur für Aufgaben vorhanden, die sich im laufenden oder abgeschlossenen Zustand befinden.

BatchErrorSourceCategory

Die Kategorie des Aufgabenfehlers.

string

Ein Kennzeichen für den Task-Fehler. Codes sind unveränderlich und sollen programmgesteuert genutzt werden.

NameValuePair[]

Eine Liste zusätzlicher Details zu dem Fehler.

string

Eine Meldung, die den Aufgabenfehler beschreibt und für die Darstellung in einer Benutzeroberfläche geeignet sein soll.

integer (int32)

Die letzte Task ID im Bereich.

integer (int32)

Die erste Task-ID im Bereich.

string (duration)

Die gesamte CPU-Zeit im Kernel-Modus (summiert über alle Kerne und alle Rechenknoten), die von der Aufgabe verbraucht wird.

string (date-time)

Die Zeit, zu der die Statistiken zuletzt aktualisiert wurden. Alle Statistiken sind auf den Bereich zwischen startTime und lastUpdateTime beschränkt.

number (float)

Die Gesamtzahl der Gibibytes, die von der Task von der Festplatte gelesen wird.

string (int64)

Die Gesamtzahl der von der Aufgabe durchgeführten Festplattenleseoperationen.

string (date-time)

Die Startzeit des in den Statistiken abgedeckten Zeitspannes.

string (uri)

Die URL der Statistiken.

string (duration)

Die gesamte CPU-Zeit im Benutzermodus (summiert über alle Kerne und alle Rechenknoten), die von der Aufgabe verbraucht wird.

string (duration)

Die gesamte Wartezeit der Aufgabe. Die Wartezeit für eine Aufgabe ist definiert als die vergangene Zeit zwischen der Erstellung der Aufgabe und dem Beginn der Aufgabenausführung. (Wenn die Aufgabe aufgrund von Fehlern erneut versucht wird, ist die Wartezeit die Zeit bis zur letzten Ausführung der Aufgabe.)

string (duration)

Die gesamte Wanduhrzeit der Aufgabe. Die Wanduhrzeit ist die vergangene Zeit von dem Zeitpunkt, an dem die Aufgabe auf einem Rechenknoten ausgeführt wurde, bis zu ihrem Ende (oder bis zum letzten Mal die Statistiken aktualisiert wurden, falls die Aufgabe bis dahin nicht abgeschlossen war). Wenn die Aufgabe erneut ausprobiert wurde, beinhaltet das die Wanduhrzeit aller Aufgaben-Wiederholungen.

number (float)

Die Gesamtzahl der Gibibytes, die von der Aufgabe auf die Festplatte geschrieben werden.

string (int64)

Die Gesamtzahl der von der Aufgabe durchgeführten Diskettenschreiboperationen.

boolean

Stellen Sie diesen Quellpfad als schreibgeschützten Modus ein oder nicht. Der Standardwert ist false (Lese-/Schreibmodus). Wenn Sie diesen Pfad für Linux als Lese-/Schreibmodus bereitstellen, bedeutet dies nicht, dass alle Benutzer im Container über den Lese-/Schreibzugriff für den Pfad verfügen, hängt sie vom Zugriff auf die Host-VM ab. Wenn dieser Pfad schreibgeschützt bereitgestellt wird, können alle Benutzer im Container den Pfad nicht ändern.

ContainerHostDataPath

Der Pfad, der für containerkunden bereitgestellt werden kann.

BatchNodeIdentityReference

Der Verweis auf die vom Benutzer zugewiesene Identität, die für den Zugriff auf eine Azure-Containerregistrierung anstelle von Benutzername und Kennwort verwendet werden soll.

string (password)

Das Kennwort für die Anmeldung beim Registrierungsserver.

string (uri)

Die Registrierungs-URL Wenn nicht angegeben, lautet der Standardwert "docker.io".

string

Der Benutzername, der sich beim Registrierungsserver anmeldet.

string

Der Name der Umgebungsvariable.

string

Der Wert der Umgebungsvariable.

integer (int32)

Ein Prozess-Exit-Code.

ExitOptions

Wie der Batch-Service reagieren sollte, wenn die Aufgabe mit diesem Exit-Code endet.

integer (int32)

Der letzte Ausgangscode im Bereich.

ExitOptions

Wie der Batch-Service reagieren sollte, wenn die Aufgabe mit einem Ausgangscode im Bereich von Anfang bis Ende (inklusiv) ausgeht.

integer (int32)

Der erste Ausgangscode im Bereich.

ExitOptions

Wie der Batch-Service reagieren sollte, wenn die Aufgabe mit einer Exit-Bedingung fehlschlägt, die von keiner der anderen Eigenschaften abgedeckt wird. Dieser Wert wird verwendet, wenn die Aufgabe mit einem von null verschiedenen Ausgangscode ausgeht, der nicht in der exitCode- oder exitCodeRanges-Sammlung aufgeführt ist, mit einem Vorverarbeitungsfehler, wenn die preProcessingError-Eigenschaft nicht vorhanden ist, oder mit einem Datei-Upload-Fehler, wenn die fileUploadError-Eigenschaft nicht vorhanden ist. Wenn du ein nicht-standardmäßiges Verhalten am Exitcode 0 möchtest, musst du es explizit mit der Collection exitCodes oder exitCodeRanges angeben.

ExitCodeRangeMapping[]

Eine Liste der Task-Exitcode-Bereiche und wie der Batch-Service darauf reagieren sollte.

ExitCodeMapping[]

Eine Liste der einzelnen Task-Exit-Codes und wie der Batch-Service darauf reagieren sollte.

ExitOptions

Wie der Batch-Dienst reagieren sollte, wenn ein Datei-Upload-Fehler auftritt. Wenn die Aufgabe mit einem über exitCodes oder exitCodeRanges angegebenen Exit-Code beendet wurde und dann auf einen Datei-Upload-Fehler stößt, hat die vom Exit-Code angegebene Aktion Vorrang.

ExitOptions

Wie der Batch-Service reagieren sollte, wenn die Aufgabe aufgrund eines Fehlers nicht startet.

DependencyAction

Eine Aktion, die der Batch-Service auf Aufgaben ausführt, die von dieser Aufgabe abhängen. Mögliche Werte sind 'satisfy' (ermöglicht den Fortschreiten abhängiger Aufgaben) und 'block' (abhängige Aufgaben warten weiter). Batch unterstützt noch nicht die Stornierung abhängiger Aufgaben.

BatchJobActionKind

Eine Aktion für den Job, der die Aufgabe enthält, wenn die Aufgabe mit der angegebenen Exit-Bedingung abgeschlossen wird und die Eigenschaft des Jobs onTaskFailed ausgeführt wird, ist 'performExitOptionsJobAction'. Standardmäßig ist none für den Ausgangscode 0 und das Beenden für alle anderen Ausgangsbedingungen. Wenn die onTaskFailed-Eigenschaft des Jobs keine Aktion ist, gibt die Angabe dieser Eigenschaft einen Fehler zurück und die Hinzufügungs-Aufgabe-Anfrage schlägt mit einem ungültigen Eigenschaftsfehler fehl; wenn du die REST-API direkt aufrufst, ist der HTTP-Statuscode 400 (Bad Request).

ResourceFile[]

Eine Liste von Dateien, die der Batch-Service vor dem Ausführen der Koordinationskommandozeile herunterlädt. Der Unterschied zwischen gemeinsamen Ressourcendateien und Aufgabenressourcendateien besteht darin, dass gemeinsame Ressourcendateien für alle Unteraufgaben, einschließlich der primären, heruntergeladen werden, während Aufgabenressourcendateien nur für die primäre heruntergeladen werden. Beachten Sie auch, dass diese Ressourcendateien nicht in das Arbeitsverzeichnis Task heruntergeladen werden, sondern stattdessen in das Task-Root-Verzeichnis (ein Verzeichnis über dem Arbeitsverzeichnis). 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.

string

Die Kommandozeile soll auf allen Compute-Knoten ausgeführt werden, damit sie sich koordinieren können, wenn der Primary den Haupt-Task-Befehl ausführt. Eine typische Koordinationskommandozeile startet einen Hintergrunddienst und überprüft, ob der Dienst bereit ist, Inter-Knoten-Nachrichten zu verarbeiten.

integer (int32)

Die Anzahl der Compute-Knoten, die von der Aufgabe benötigt werden. Wenn es weggelassen wird, lautet standardmäßig 1.

string

Der Name im Namen-Wert-Paar.

string

Der Wert im Namen-Wert-Paar.

OutputFileDestination

Das Ziel für die Ausgabedatei(n).

string

Ein Muster, das anzeigt, welche Datei(en) hochgeladen werden sollen. Sowohl relative als auch absolute Wege werden unterstützt. Relative Pfade sind relativ zum Arbeitsverzeichnis Task. Folgende Wildcards werden unterstützt: * entspricht 0 oder mehr Zeichen (zum Beispiel würde Pattern abc* abc oder abcdef übereinstimmen), ** entspricht jedem Verzeichnis, ? entspricht jedem einzelnen Zeichen, [ABC] einem Zeichen in den Klammern, und [A-C] einem Zeichen im Bereich. Klammern können eine Negation enthalten, um jedem nicht spezifizierten Zeichen zu entsprechen (zum Beispiel [!abc] entspricht jedem Zeichen außer a, b oder c). Wenn ein Dateiname mit "." beginnt, wird er standardmäßig ignoriert, kann aber durch explizite Angabe abgestimmt werden (zum Beispiel wird.gif nicht mit .a.gifübereinstimmen, aber ..gif schon). Ein einfaches Beispiel: ***.txt entspricht jeder Datei, die nicht mit '.' beginnt, und endet mit .txt im Arbeitsverzeichnis Task oder in einem beliebigen Unterverzeichnis. Wenn der Dateiname ein Jokerzeichen enthält, kann er durch Klammern escaped werden (zum Beispiel abc[] würde mit einer Datei namens abc übereinstimmen). Beachte, dass sowohl \ als auch / unter Windows als Verzeichnistrenner behandelt werden, aber nur / unter Linux. Umgebungsvariablen (%var% unter Windows oder $var unter Linux) werden vor der Anwendung des Musters erweitert.

OutputFileUploadConfig

Zusätzliche Optionen für die Upload-Operation, einschließlich unter welchen Bedingungen der Upload durchgeführt werden soll.

string (uri)

Die URL des Containers innerhalb von Azure Blob Storage, in die die Datei(en) hochgeladen werden können. Wenn keine verwaltete Identität verwendet wird, muss die URL eine Shared Access Signature (SAS) enthalten, die dem Container Schreibrechte gewährt.

BatchNodeIdentityReference

Der Verweis auf die vom Benutzer zugewiesene Identität, die zum Zugriff auf Azure Blob Storage verwendet werden soll, spezifiziert durch containerUrl. Die Identität muss Schreibzugriff auf den Azure Blob Storage Container haben.

string

Der Ziel-Blob oder das virtuelle Verzeichnis innerhalb des Azure Storage-Containers. Wenn filePattern sich auf eine bestimmte Datei bezieht (d. h. keine Wildcards enthält), dann ist path der Name des Blobs, auf den diese Datei hochgeladen werden soll. Wenn filePattern eine oder mehrere Wildcards enthält (und daher mehrere Dateien übereinstimmen kann), dann ist path der Name des virtuellen Blob-Verzeichnisses (das jedem Blob-Namen vorangestellt ist), in das die Datei(en) hochgeladen werden kann. Wenn sie weggelassen werden, werden Datei(en) mit einem Blob-Namen, der mit ihrem Dateinamen übereinstimmt, in die Wurzel des Containers hochgeladen.

OutputFileUploadHeader[]

Eine Liste von Name-Wert-Paaren für Header, die beim Hochladen von Ausgabedateien verwendet werden sollen. Diese Header werden beim Hochladen von Dateien in Azure Storage angegeben. Offizielles Dokument zu erlaubten Headern beim Hochladen von Blobs: https://v4.hkg1.meaqua.org/rest/api/storageservices/put-blob#request-headers-all-blob-types.

OutputFileBlobContainerDestination

Ein Ort im Azure-Blob-Speicher, an den Dateien hochgeladen werden.

OutputFileUploadCondition

Die Bedingungen, unter denen die Task-Ausgabedatei oder die Dateisammlung hochgeladen werden sollte. Die Standardeinstellung ist Task-Completion (Aufgabenabschluss).

string

Der groß- und kleinschreibungsunsensitive Name des Headers, der beim Hochladen von Ausgabedateien verwendet werden soll.

string

Der Wert des Headers, der beim Hochladen von Ausgabedateien verwendet werden soll.

string

Der Name des Speichercontainers im automatischen Speicherkonto. Die Eigenschaften autoStorageContainerName, storageContainerUrl und httpUrl schließen sich gegenseitig aus, und eine davon muss angegeben werden.

string

Das Blobpräfix, das beim Herunterladen von Blobs aus einem Azure Storage-Container verwendet werden soll. Nur die Blobs, deren Namen mit dem angegebenen Präfix beginnen, werden heruntergeladen. Die Eigenschaft ist nur gültig, wenn autoStorageContainerName oder storageContainerUrl verwendet wird. Dieses Präfix kann ein teilweiser Dateiname oder ein Unterverzeichnis sein. Wenn kein Präfix angegeben ist, werden alle Dateien im Container heruntergeladen.

string

Das Attribut für den Dateiberechtigungsmodus im oktalen Format. Diese Eigenschaft gilt nur für Dateien, die auf Linux Compute Nodes heruntergeladen werden. Sie wird ignoriert, wenn sie für eine ResourceFile angegeben ist, die auf einen Windows-Compute-Node heruntergeladen wird. Wenn diese Eigenschaft für einen Linux Compute Node nicht angegeben ist, wird der Standardwert 0770 auf die Datei angewendet.

string

Der Ort auf dem Compute-Knoten, zu dem die Datei(en) heruntergeladen werden sollen, relativ zum Arbeitsverzeichnis der Task. Wenn die httpUrl-Eigenschaft angegeben ist, ist der FilePath erforderlich und beschreibt den Pfad, in den die Datei heruntergeladen wird, einschließlich des Dateinamens. Andernfalls ist filePath optional, wenn die autoStorageContainerName- oder storageContainerUrl-Eigenschaft angegeben ist, und das Verzeichnis, in das die Dateien heruntergeladen werden sollen. Wenn FilePath als Verzeichnis verwendet wird, werden alle bereits den Eingabedaten zugeordneten Verzeichnisstruktur vollständig aufbewahrt und an das angegebene FilePath-Verzeichnis angefügt. Der angegebene relative Pfad kann nicht aus dem Arbeitsverzeichnis der Aufgabe herausbrechen (zum Beispiel durch die Verwendung von '..').

string (uri)

Die URL der herunterzuladenden Datei. Die Eigenschaften autoStorageContainerName, storageContainerUrl und httpUrl schließen sich gegenseitig aus, und eine davon muss angegeben werden. Wenn die URL auf Azure Blob Storage verweist, muss sie von Computeknoten gelesen werden. Es gibt drei Möglichkeiten, eine solche URL für ein Blob im Azure-Speicher abzurufen: Fügen Sie eine SAS (Shared Access Signature) hinzu, die Leseberechtigungen für das Blob gewährt, eine verwaltete Identität mit Leseberechtigung verwenden oder die ACL für das Blob oder dessen Container so festlegen, dass der öffentliche Zugriff zulässig ist.

BatchNodeIdentityReference

Die Referenz auf die vom Benutzer zugewiesene Identität, die zum Zugriff auf Azure Blob Storage verwendet wird, spezifiziert durch storageContainerUrl oder httpUrl.

string (uri)

Die URL des Blobcontainers in Azure Blob Storage. Die Eigenschaften autoStorageContainerName, storageContainerUrl und httpUrl schließen sich gegenseitig aus, und eine davon muss angegeben werden. Diese URL muss von Computeknoten lesbar und auflistenbar sein. Es gibt drei Möglichkeiten, eine solche URL für einen Container in Azure Storage abzurufen: Fügen Sie eine SAS (Shared Access Signature) hinzu, die Lese- und Listenberechtigungen für den Container gewährt, eine verwaltete Identität mit Lese- und Listenberechtigungen verwenden oder die ACL für den Container so festlegen, dass der öffentliche Zugriff zugelassen wird.

AutoUserSpecification

Der automatische Benutzer, unter dem die Aufgabe ausgeführt wird. Die Eigenschaften "userName" und "autoUser" schließen sich gegenseitig aus; Sie müssen einen, aber nicht beide angeben.

string

Der Name der Benutzeridentität, unter der die Aufgabe ausgeführt wird. Die Eigenschaften "userName" und "autoUser" schließen sich gegenseitig aus; Sie müssen einen, aber nicht beide angeben.