Jobs - Create Job

Die Anforderung ist erfolgreich und eine neue Ressource wurde als Ergebnis erstellt.

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.

boolean

Gibt an, ob das Rollbackfeature des Betriebssystemimages deaktiviert werden soll.

boolean

Gibt an, ob Betriebssystemupgrades automatisch auf Skalierungssatzinstanzen angewendet werden sollen, wenn eine neuere Version des Betriebssystemimages verfügbar wird.

Wenn dies für Windows-basierte Pools auf "true" festgelegt ist, können "WindowsConfiguration.enableAutomaticUpdates"- nicht auf "true" festgelegt werden.

boolean

Verzögern Sie Betriebssystemupgrades auf tvMs, wenn sie Aufgaben ausführen.

boolean

Gibt an, ob die Rollupgraderichtlinie während des Automatischen Betriebssystemupgrades verwendet werden soll. Das automatische Betriebssystemupgrade wird auf die Standardrichtlinie zurückfallen, wenn keine Richtlinie für vmSS definiert ist.

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 (password)

Der Azure Storage-Kontoschlüssel. Diese Eigenschaft schließt sich gegenseitig mit sasKey und Identität aus; genau einer muss angegeben werden.

string

Der Azure-Speicherkontoname

string

Zusätzliche Befehlszeilenoptionen, die an den Bereitstellungsbefehl übergeben werden sollen. Dies sind "net use"-Optionen in Windows und "Mount"-Optionen in Linux.

string

Der Name des Azure Blob Storage-Containers.

BatchNodeIdentityReference

Die Referenz auf die vom Benutzer zugewiesene Identität, um auf containerName zuzugreifen. Diese Eigenschaft schließt sich gegenseitig mit accountKey und sasKey aus. genau einer muss angegeben werden.

string

Der relative Pfad auf dem Rechenknoten, an dem das Dateisystem eingebunden wird. Alle Dateisysteme werden relativ zum Batch-Bereitstellungsverzeichnis bereitgestellt, auf das über die Umgebungsvariable AZ_BATCH_NODE_MOUNTS_DIR zugegriffen werden kann.

string (password)

Das Azure Storage SAS-Token. Diese Eigenschaft schließt sich gegenseitig mit AccountKey und Identität aus; genau einer muss angegeben werden.

string (password)

Der Azure Storage-Kontoschlüssel.

string

Der Name des Azure Storage-Kontos.

string (uri)

Die Azure Files-URL. Dies ist das Format "https://{account}.file.core.windows.net/".

string

Zusätzliche Befehlszeilenoptionen, die an den Bereitstellungsbefehl übergeben werden sollen. Dies sind "net use"-Optionen in Windows und "Mount"-Optionen in Linux.

string

Der relative Pfad auf dem Rechenknoten, an dem das Dateisystem eingebunden wird. Alle Dateisysteme werden relativ zum Batch-Bereitstellungsverzeichnis bereitgestellt, auf das über die Umgebungsvariable AZ_BATCH_NODE_MOUNTS_DIR zugegriffen werden kann.

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 Präfix, das dem eindeutigen Identifikator hinzugefügt wird, wenn ein Pool automatisch erstellt wird. Der Batch-Service weist jedem Auto-Pool bei der Erstellung eine eindeutige Kennung zu. Um zwischen Pools zu unterscheiden, die für verschiedene Zwecke erstellt wurden, können Sie dieses Element angeben, um der zugewiesenen ID ein Präfix hinzuzufügen. Das Präfix kann bis zu 20 Zeichen lang sein.

boolean

Ob ein Auto-Pool nach Ablauf seiner Lebensdauer am Leben erhalten bleibt. Falls falsch, löscht der Batch-Service den Pool, sobald seine Lebensdauer (bestimmt durch die Einstellung poolLifetimeOption) abgelaufen ist; das heißt, wenn der Job oder der Jobplan abgeschlossen ist. Falls zutreffend, löscht der Batch-Service den Pool nicht automatisch. Es liegt am Benutzer, automatische Pools zu löschen, die mit dieser Option erstellt wurden.

BatchPoolSpecification

Die Pool-Spezifikation für den Auto-Pool.

BatchPoolLifetimeOption

Die Mindestlebensdauer erstellter Auto-Pools und wie mehrere Jobs in einem Zeitplan den Pools zugewiesen werden.

string[]

Die Sammlung von Container-Bildnamen. Dies ist die vollständige Image-Referenz, wie sie bei "docker pull" angegeben wäre. Ein Image wird aus dem Standard-Docker-Register bezogen, es sei denn, das Image ist vollständig mit einer alternativen Registry qualifiziert.

ContainerRegistryReference[]

Zusätzliche private Register, aus denen Container abgerufen werden können. Wenn Bilder aus einem privaten Register heruntergeladen werden müssen, das Zugangsdaten benötigt, müssen diese hier angegeben werden.

ContainerType

Die zu verwendende Containertechnologie.

DiffDiskPlacement

Gibt die kurzlebige Datenträgerplatzierung für den Betriebssystemdatenträger für alle virtuellen Computer im Pool an. Diese Eigenschaft kann vom Benutzer in der Anforderung verwendet werden, um den Speicherort auszuwählen, z. B. Cachespeicherplatz für die Bereitstellung ephemerer Betriebssystemdatenträger. Weitere Informationen zu den Anforderungen an ephemerale Betriebssystemdatenträgergrößen finden Sie unter ephemeren Betriebssystemgrößenanforderungen für Windows-VMs unter https://learn.microsoft.com/azure/virtual-machines/windows/ephemeral-os-disks#size-requirements und Linux-VMs unter https://learn.microsoft.com/azure/virtual-machines/linux/ephemeral-os-disks#size-requirements.

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.

integer (int32)

Die Portnummer des Compute Node. Dies muss innerhalb eines Batch-Pools einzigartig sein. Zulässige Werte liegen zwischen 1 und 65535, mit Ausnahme von 29876 und 29877, da diese reserviert sind. Wenn reservierte Werte bereitgestellt werden, schlägt die Anforderung mit dem HTTP-Statuscode 400 fehl.

integer (int32)

Die letzte Portnummer im Bereich der externen Ports, die verwendet werden, um eingehenden Zugriff auf den BackendPort auf einzelnen Rechenknoten zu ermöglichen. Zulässige Werte liegen zwischen 1 und 65534 mit Ausnahme von Ports von 50000 bis 55000, die vom Batchdienst reserviert sind. Alle Bereiche innerhalb eines Pools müssen unterschiedlich sein und dürfen sich nicht überlappen. Jeder Bereich muss mindestens 40 Ports enthalten. Wenn reservierte oder überlappende Werte bereitgestellt werden, schlägt die Anforderung mit dem HTTP-Statuscode 400 fehl.

integer (int32)

Die erste Portnummer im Bereich der externen Ports, die verwendet werden, um eingehenden Zugriff auf den BackendPort auf einzelnen Rechenknoten bereitzustellen. Zulässige Werte liegen zwischen 1 und 65534 mit Ausnahme von Ports von 50000 bis 55000, die reserviert sind. Alle Bereiche innerhalb eines Pools müssen unterschiedlich sein und dürfen sich nicht überlappen. Jeder Bereich muss mindestens 40 Ports enthalten. Wenn reservierte oder überlappende Werte bereitgestellt werden, schlägt die Anforderung mit dem HTTP-Statuscode 400 fehl.

string

Der Name des Endpunkts. Der Name muss innerhalb eines Batch-Pools eindeutig sein, kann Buchstaben, Zahlen, Unterstriche, Punkte und Bindestriche enthalten. Namen müssen mit einem Buchstaben oder einer Zahl beginnen, müssen mit einem Buchstaben, einer Zahl oder einem Unterstrich enden und dürfen 77 Zeichen nicht überschreiten. Wenn ungültige Werte bereitgestellt werden, schlägt die Anforderung mit dem HTTP-Statuscode 400 fehl.

NetworkSecurityGroupRule[]

Eine Liste der Regeln für Netzwerksicherheitsgruppen, die auf den Endpunkt angewendet werden. Die maximale Anzahl von Regeln, die über alle Endpunkte in einem Batch Pool festgelegt werden können, beträgt 25. Wenn keine Regeln für Netzwerksicherheitsgruppen angegeben sind, wird eine Standardregel erstellt, um den eingehenden Zugriff auf den angegebenen Back-EndPort zuzulassen. Wenn die maximale Anzahl von Netzwerksicherheitsgruppenregeln überschritten wird, schlägt die Anforderung mit dem HTTP-Statuscode 400 fehl.

InboundEndpointProtocol

Das Protokoll des Endpunkts.

integer (int32)

Die maximale Anzahl der Male jeder Aufgabe kann erneut versucht werden. 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 Batch-Service versucht jede Aufgabe einmal und kann es dann bis zu diesem Limit erneut versuchen. Wenn zum Beispiel die maximale Anzahl von Wiederholungen 3 beträgt, versucht Batch eine Aufgabe bis zu 4 Mal (ein erster Versuch und 3 Wiederholungen). Wenn die maximale Anzahl der Wiederholungen 0 beträgt, versucht der Batch-Service keine Aufgaben erneut. Wenn die maximale Anzahl von Wiederversuchen -1 beträgt, versucht der Batch-Service Aufgaben ohne Limit erneut. Der Standardwert ist 0 (keine Wiederholungen).

string (duration)

Die maximal vergangene Zeit, die der Job laufen darf, gemessen ab dem Zeitpunkt, an dem der Job erstellt wird. Wenn der Job nicht innerhalb des Zeitlimits abgeschlossen wird, beendet der Batch-Service ihn und alle noch laufenden Aufgaben. In diesem Fall ist der Terminationsgrund MaxWallClockTimeExpiry. Wenn diese Eigenschaft nicht angegeben ist, gibt es keine Zeitbegrenzung, wie lange der Auftrag laufen darf.

boolean

Ob Aufgaben in diesem Auftrag von anderen Aufträgen mit hoher Priorität vorgebeutet werden können. (Diese Eigenschaft ist standardmäßig nicht verfügbar. Wenden Sie sich für weitere Informationen an den Support.) Wenn der Wert auf "True" festgelegt ist, haben andere Aufträge mit hoher Priorität, die an das System übermittelt werden, Vorrang und können Aufgaben aus diesem Auftrag erneut in die Warteschlange einreihen. Sie können die AllowTaskPreemption eines Auftrags aktualisieren, nachdem er mithilfe der Updateauftrags-API erstellt wurde.

EnvironmentSetting[]

Die Liste der allgemeinen Umgebungsvariableneinstellungen. Diese Umgebungsvariablen werden für alle Aufgaben im Auftrag festgelegt (einschließlich job manager, Job Preparation and Job Release Tasks). Einzelne Aufgaben können eine hier angegebene Umgebungseinstellung außer Kraft setzen, indem sie denselben Einstellungsnamen mit einem anderen Wert angeben.

BatchJobConstraints

Die Ausführungseinschränkungen für den Auftrag.

string

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

string

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).

BatchJobManagerTask

Details zu einer Job Manager-Aufgabe, die gestartet werden soll, wenn der Auftrag gestartet wird. Wenn der Auftrag keine Auftrags-Manager-Aufgabe angibt, muss der Benutzer dem Auftrag explizit Aufgaben hinzufügen. Wenn der Auftrag eine Auftrags-Manager-Aufgabe angibt, erstellt der Batchdienst die Auftrags-Manager-Aufgabe, wenn der Auftrag erstellt wird, und versucht, die Auftrags-Manager-Aufgabe vor der Planung anderer Aufgaben im Auftrag zu planen. Der typische Zweck der Aufgabe des Auftrags-Managers besteht darin, die Ausführung des Auftrags zu steuern und/oder zu überwachen, z. B. indem sie entscheiden, welche zusätzlichen Aufgaben ausgeführt werden sollen, bestimmen, wann die Arbeit abgeschlossen ist usw. (Eine Auftrags-Manager-Aufgabe ist jedoch nicht auf diese Aktivitäten beschränkt - es handelt sich um einen vollständigen Vorgang im System und ausführen, welche Aktionen für den Auftrag erforderlich sind.) Beispielsweise kann eine Auftrags-Manager-Aufgabe eine datei herunterladen, die als Parameter angegeben ist, den Inhalt dieser Datei analysieren und zusätzliche Aufgaben basierend auf diesen Inhalten übermitteln.

BatchJobPreparationTask

Der Vorgang zur Auftragsvorbereitung. Wenn ein Auftrag über einen Auftragsvorbereitungsvorgang verfügt, führt der Batchdienst den Auftragvorbereitungsvorgang auf einem Knoten aus, bevor er Aufgaben dieses Auftrags auf diesem Computeknoten startet.

BatchJobReleaseTask

Die Aufgabe "Auftragsfreigabe". Eine Auftragsfreigabeaufgabe kann nicht angegeben werden, ohne auch einen Auftragsvorbereitungsvorgang für den Auftrag anzugeben. Der Batchdienst führt die Aufgabe "Auftragsfreigabe" auf den Knoten aus, die den Auftragsvorbereitungsvorgang ausgeführt haben. Der Hauptzweck der Aufgabe "Auftragsfreigabe" besteht darin, Änderungen an Computeknoten rückgängig zu machen, die von der Auftragsvorbereitungsaufgabe vorgenommen wurden. Beispielaktivitäten umfassen das Löschen lokaler Dateien oder das Herunterfahren von Diensten, die als Teil der Auftragsvorbereitung gestartet wurden.

integer (int32)

Die maximale Anzahl von Vorgängen, die parallel für den Auftrag ausgeführt werden können. (Diese Eigenschaft ist standardmäßig nicht verfügbar. Wenden Sie sich für weitere Informationen an den Support.) Der Wert von maxParallelTasks muss -1 oder größer als 0 sein, falls 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.

BatchMetadataItem[]

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.

BatchJobNetworkConfiguration

(Diese Eigenschaft ist standardmäßig nicht verfügbar. Weitere Informationen erhalten Sie vom Support) Die Netzwerkkonfiguration für den Job.

BatchAllTasksCompleteMode

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.

BatchTaskFailureMode

Die Aktion, die der Batchdienst ausführen soll, wenn eine Aufgabe im Auftrag fehlschlägt. Eine Aufgabe wird als fehlgeschlagen betrachtet, wenn eine failureInfo vorhanden ist. Eine failureInfo wird festgelegt, wenn der Vorgang mit einem Nicht-Null-Beendigungscode abgeschlossen wird, nachdem die Wiederholungsanzahl aufgebraucht wurde, oder wenn ein Fehler beim Starten des Vorgangs aufgetreten ist, z. B. aufgrund eines Fehlers beim Herunterladen einer Ressourcendatei. Der Standardwert ist keine Aktion.

BatchPoolInfo

Der Pool, in dem der Batchdienst die Aufgaben des Auftrags ausführt.

integer (int32)

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.

boolean

Gibt an, ob Aufgaben im Auftrag Abhängigkeiten voneinander definieren können. Der Standardwert ist "false".

boolean

Ob die Jobmanager-Aufgabe auf einem Spot-/Low-Priority-Compute-Knoten ausgeführt werden kann. Der Standardwert ist true.

BatchApplicationPackageReference[]

Eine Liste von Anwendungspaketen, die der Batch-Service vor dem Ausführen der Kommandozeile an den Compute Node ausliefert. Anwendungspakete werden in einem gemeinsamen Verzeichnis heruntergeladen und bereitgestellt, nicht im Arbeitsverzeichnis Task. Daher wird ein referenziertes Anwendungspaket, das bereits auf dem Rechenknoten ist und aktuell ist, nicht erneut heruntergeladen; die vorhandene Kopie auf dem Compute-Node wird verwendet. Wenn ein referenziertes Anwendungspaket 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 Job 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. Wenn sich die Befehlszeile auf Dateipfade bezieht, sollte sie einen relativen Pfad (relativ zum Arbeitsverzeichnis "Aufgabe") verwenden oder die vom Batch bereitgestellte Umgebungsvariable (https://learn.microsoft.com/azure/batch/batch-compute-node-environment-variables) verwenden.

BatchTaskConstraints

Einschränkungen, die auf die Aufgabe Jobmanager angewendet werden.

BatchTaskContainerSettings

Die Einstellungen für den Container, unter dem der Job Manager Task 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

Der Anzeigename der Aufgabe Job Manager. Es muss nicht eindeutig sein und kann beliebige Unicode-Zeichen bis zu einer maximalen Länge von 1024 enthalten.

EnvironmentSetting[]

Eine Liste von Umgebungsvariablen-Einstellungen für die Aufgabe Jobmanager.

string

Ein String, der die Job Manager Task innerhalb des Jobs eindeutig identifiziert. Die ID kann jede Kombination alphanumerischer Zeichen enthalten, einschließlich Bindestrichen und Unterstrichen, und darf nicht mehr als 64 Zeichen enthalten.

boolean

Ob der Abschluss der Aufgabe Job Manager bedeutet, dass der gesamte Job abgeschlossen ist. Wenn zutreffend, markiert der Batch-Service den Job nach Abschluss der Jobmanager-Aufgabe als abgeschlossen. Wenn zu diesem Zeitpunkt noch Aufgaben laufen (außer Job Release), werden diese Tasks beendet. Falls falsch, beeinflusst das Abschließen der Aufgabe Job Manager den Status des Jobs nicht. In diesem Fall sollten Sie entweder das Attribut onAllTasksComplete verwenden, um den Job zu beenden, oder einen Client oder Benutzer den Job explizit beenden lassen. Ein Beispiel dafür ist, wenn der Jobmanager eine Menge von Aufgaben erstellt, aber dann keine weitere Rolle bei deren Ausführung übernimmt. Der Standardwert ist true. Wenn Sie die Attribute onAllTasksComplete und onTaskFailure verwenden, um die Lebensdauer des Jobs zu steuern, und die Job Manager Task nur zur Erstellung der Aufgaben für den Job verwenden (nicht um den Fortschritt zu überwachen), ist es wichtig, killJobOnCompletion auf false zu setzen.

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.

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 wird diese Eigenschaft nicht unterstützt und darf nicht spezifiziert werden.

ResourceFile[]

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.

boolean

Ob die Jobmanager-Aufgabe ausschließlich die Nutzung des Compute-Knotens erfordert, in dem sie ausgeführt wird. Wenn zutreffend, werden keine anderen Aufgaben auf demselben Knoten laufen, solange der Jobmanager läuft. Wenn falsch, können andere Aufgaben gleichzeitig mit dem Jobmanager auf einem Rechenknoten ausgeführt werden. Die Job Manager Task zählt normalerweise gegen das gleichzeitige Task-Limit des Compute Node, daher ist dies nur relevant, wenn der Compute Node mehrere gleichzeitige Aufgaben zulässt. Der Standardwert ist true.

UserIdentity

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

boolean

Gibt an, ob Computeknoten vom virtuellen Netzwerk an DNC zurückgenommen werden sollen, wenn der Auftrag beendet oder gelöscht wird. Wenn true, bleiben Knoten mit dem virtuellen Netzwerk mit DNC verbunden. Wenn false, werden Knoten automatisch zurückgenommen, wenn der Auftrag endet. Der Standardwert ist „false“.

string

Der ARM-Ressourcenbezeichner des virtuellen Netzwerksubnetz, in dem Computerknoten ausgeführt werden, die Vorgänge aus dem Auftrag ausführen, werden für die Dauer des Vorgangs verknüpft. Das virtuelle Netzwerk muss sich in derselben Region und im gleichen Abonnement wie das Azure-Batchkonto befinden. Das angegebene Subnetz sollte über genügend kostenlose IP-Adressen verfügen, um die Anzahl der Computeknoten aufzunehmen, die Aufgaben aus dem Auftrag ausführen. Dies kann bis zur Anzahl der Computeknoten im Pool sein. Der Dienstprinzipal "MicrosoftAzureBatch" muss über die Rolle "Classic Virtual Machine Contributor" Role-Based Access Control (RBAC) für das angegebene VNet verfügen, damit der Azure-Batchdienst Aufgaben auf den Knoten planen kann. Dies kann überprüft werden, indem überprüft wird, ob das angegebene VNet über alle zugehörigen Netzwerksicherheitsgruppen (Network Security Groups, NSG) verfügt. Wenn die Kommunikation mit den Knoten im angegebenen Subnetz von einer NSG verweigert wird, legt der Batchdienst den Status der Computeknoten auf unbrauchbar fest. Dies ist das Format "/subscriptions/{subscription}/resourceGroups/{group}/providers/{provider}/virtualNetworks/{network}/subnets/{subnet}". Wenn das angegebene VNet über zugeordnete Netzwerksicherheitsgruppen (Network Security Groups, NSG) verfügt, müssen einige reservierte Systemports für eingehende Kommunikation vom Azure Batch-Dienst aktiviert werden. Aktivieren Sie für Pools, die mit einer Konfiguration für virtuelle Computer erstellt wurden, ports 29876 und 29877 sowie Port 22 für Linux und Port 3389 für Windows. Port 443 muss auch für ausgehende Verbindungen für die Kommunikation mit Azure Storage geöffnet sein. Weitere Informationen finden Sie unter: https://learn.microsoft.com/azure/batch/batch-api-basics#virtual-network-vnet-and-firewall-configuration.

string

Die Befehlszeile der Aufgabe zur Jobvorbereitung. 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://learn.microsoft.com/azure/batch/batch-compute-node-environment-variables) verwenden.

BatchTaskConstraints

Einschränkungen, die für die Aufgabe zur Jobvorbereitung gelten.

BatchTaskContainerSettings

Die Einstellungen für den Container, unter dem die Aufgabe zur Jobvorbereitung ausgeführt wird. 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.

EnvironmentSetting[]

Eine Liste von Umgebungsvariablen-Einstellungen für die Aufgabe zur Jobvorbereitung.

string

Eine Zeichenkette, die die Aufgabe zur Jobvorbereitung innerhalb der Stelle eindeutig identifiziert. Die ID kann jede Kombination alphanumerischer Zeichen enthalten, einschließlich Bindestrichen und Unterstrichen, und darf nicht mehr als 64 Zeichen enthalten. Wenn Sie diese Eigenschaft nicht angeben, weist der Batch-Service den Standardwert 'Jobpreparation' zu. Keine andere Aufgabe im Job kann dieselbe ID wie die Aufgabe zur Jobvorbereitung haben. Wenn Sie versuchen, eine Aufgabe mit derselben ID einzureichen, lehnt der Batch-Service die Anfrage mit dem Fehlercode TaskIdSameAsJobPreparationTask ab; wenn du die REST-API direkt aufrufst, ist der HTTP-Statuscode 409 (Konflikt).

boolean

Ob der Batch-Service die Job Preparation Task nach einem Neustart eines Compute Nodes erneut ausführen sollte. Die Job Preparation Task wird immer erneut ausgeführt, wenn ein Compute Node neu gebildet wird oder wenn die Job Preparation Task nicht abgeschlossen wurde (z. B. weil der Neustart während der Ausführung der Aufgabe stattfand). Daher sollten Sie immer eine Jobvorbereitungsaufgabe schreiben, die idempotent ist und sich korrekt verhält, wenn sie mehrmals ausgeführt wird. Der Standardwert ist true.

ResourceFile[]

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.

UserIdentity

Die Benutzeridentität, unter der die Aufgabe zur Jobvorbereitung ausgeführt wird. Wenn sie weggelassen wird, läuft die Aufgabe als nicht-administrativer Benutzer, der einzigartig für die Aufgabe auf Windows Compute Nodes ist, oder als nicht-administrativer Benutzer, der einzigartig für den Pool auf Linux Compute Nodes ist.

boolean

Ob der Batch-Service warten sollte, bis die Jobvorbereitungs-Aufgabe erfolgreich abgeschlossen ist, bevor weitere Aufgaben des Jobs auf dem Rechenknoten geplant werden. Eine Aufgabe zur Jobvorbereitung ist erfolgreich abgeschlossen, wenn sie mit dem Ausgangscode 0 abgeschlossen wird. Wenn true und die Job Preparation Task an einem Knoten fehlschlägt, versucht der Batch-Service die Job Preparation Task bis zu ihrer maximalen Anzahl von Wiederholungen (wie im Constraints-Element angegeben) erneut. Wenn die Aufgabe nach allen erneuten Versuchen immer noch nicht erfolgreich abgeschlossen wurde, wird der Batch-Service die Aufgaben des Jobs nicht an den Node einplanen. Der Knoten bleibt aktiv und berechtigt, Aufgaben anderer Jobs auszuführen. Falls falsch, wartet der Batch-Service nicht auf Abschluss der Aufgabe zur Jobvorbereitung. In diesem Fall können andere Aufgaben des Jobs auf dem Rechenknoten ausgeführt werden, während die Aufgabe zur Jobvorbereitung noch läuft; und selbst wenn die Aufgabe zur Jobvorbereitung fehlschlägt, werden neue Aufgaben weiterhin auf dem Rechenknoten geplant. Der Standardwert ist true.

string

Die Kommandozeile der Job Release Task. 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://learn.microsoft.com/azure/batch/batch-compute-node-environment-variables) verwenden.

BatchTaskContainerSettings

Die Einstellungen für den Container, unter dem die Job Release Task ausgeführt wird. 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.

EnvironmentSetting[]

Eine Liste von Umgebungsvariablen-Einstellungen für die Aufgabe Job Release.

string

Ein String, der die Job Release Task innerhalb des Jobs eindeutig identifiziert. Die ID kann jede Kombination alphanumerischer Zeichen enthalten, einschließlich Bindestrichen und Unterstrichen, und darf nicht mehr als 64 Zeichen enthalten. Wenn Sie diese Eigenschaft nicht angeben, weist der Batch-Service den Standardwert 'jobrelease' zu. Keine andere Aufgabe im Job kann dieselbe ID wie die Job Release-Aufgabe haben. Wenn Sie versuchen, eine Aufgabe mit derselben ID einzureichen, lehnt der Batch-Service die Anfrage mit dem Fehlercode TaskIdSameAsJobReleaseTask ab; wenn du die REST-API direkt aufrufst, ist der HTTP-Statuscode 409 (Konflikt).

string (duration)

Die maximal vergangene Zeit, die die Job Release Task auf einem gegebenen Compute Node, gemessen ab dem Zeitpunkt des Task-Starts. Wenn die Aufgabe nicht innerhalb des Zeitlimits abgeschlossen wird, beendet der Batch-Service sie. Der Standardwert beträgt 15 Minuten. Sie dürfen keine Auszeit von längerer als 15 Minuten angeben. Wenn du das tust, lehnt der Batch-Service es mit einem Fehler ab; wenn du die REST-API direkt aufrufst, ist der HTTP-Statuscode 400 (Bad Request).

ResourceFile[]

Eine Liste der Dateien, die der Batchdienst vor dem Ausführen der Befehlszeile auf den Computeknoten herunterladen 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. Unter diesem Element aufgelistete Dateien befinden sich im Arbeitsverzeichnis der Aufgabe.

string (duration)

Die Mindestzeit, um das Task-Verzeichnis für die Job Release-Aufgabe auf dem Compute Node, zu speichern. 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.

UserIdentity

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

string

Der Name des Metadatenelements.

string

Der Wert des Metadatenelements.

string (arm-id)

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

BatchNodePlacementPolicyType

Knotenplatzierungsrichtlinientyp in Batchpools. Zuordnungsrichtlinie, die vom Batchdienst zum Bereitstellen der Knoten verwendet wird. Wenn nicht angegeben, verwendet Batch die Regionalrichtlinie.

CachingType

Gibt die Zwischenspeicherungsanforderungen an. Mögliche Werte sind: None, ReadOnly, ReadWrite. Die Standardwerte sind: Keine für den Standardspeicher. ReadOnly für Premium-Speicher.

integer (int32)

Die anfängliche Datenträgergröße in GB beim Erstellen eines neuen Betriebssystemdatenträgers.

BatchDiffDiskSettings

Gibt die kurzlebigen Datenträgereinstellungen für den Betriebssystemdatenträger an, der vom Computeknoten (VM) verwendet wird.

ManagedDisk

Die Parameter des verwalteten Datenträgers.

boolean

Gibt an, ob writeAccelerator auf dem Datenträger aktiviert oder deaktiviert werden soll.

BatchInboundNatPool[]

Eine Liste von eingehenden NAT-Pools, die verwendet werden können, um spezifische Ports eines einzelnen Compute-Knotens extern zu adressieren. Die maximale Anzahl der eingehenden NAT-Pools pro Batch Pool beträgt 5. Wenn die maximale Anzahl eingehender NAT-Pools überschritten wird, scheitert die Anfrage mit HTTP-Statuscode 400. Dies kann nicht angegeben werden, wenn der IPAddressProvisioningType NoPublicIPAddresses ist.

string (arm-id)

Die ARM-Ressourcen-ID der vom Benutzer zugewiesenen Identität. Dieser Verweis muss in den Poolidentitäten enthalten sein.

BatchAutoPoolSpecification

Eigenschaften für einen temporären 'Autopool'. Der Batchdienst erstellt diesen automatischen Pool, wenn der Auftrag übermittelt wird. Wenn die automatische Pool-Erstellung fehlschlägt, versetzt der Batch-Service den Job in einen abgeschlossenen Zustand, und der Pool-Erstellungsfehler wird in der Planungsfehler-Eigenschaft des Jobs gesetzt. Der Batch-Service verwaltet die Lebensdauer (sowohl die Erstellung als, sofern nicht 'keepAlive' angegeben, die Löschung) des Auto-Pools. Alle Benutzeraktionen, die die Lebensdauer des Auto-Pools während der aktiven Job beeinflussen, führen zu unerwartetem Verhalten. Du musst entweder die Pool-ID oder die Auto-Pool-Spezifikation angeben, aber nicht beide.

string

Die ID eines bestehenden Pools. Alle Aufgaben des Jobs laufen im angegebenen Pool. Sie müssen sicherstellen, dass der von dieser Immobilie referenzierte Pool existiert. Wenn der Pool nicht existiert, wenn der Batch-Service versucht, einen Job zu planen, werden keine Aufgaben für den Job ausgeführt, bis du einen Pool mit dieser ID erstellst. Beachten Sie, dass der Batch-Service die Job-Anfrage nicht ablehnt; es wird einfach keine Aufgaben ausgeführt, bis der Pool existiert. Du musst entweder die Pool-ID oder die Auto-Pool-Spezifikation angeben, aber nicht beide.

BatchApplicationPackageReference[]

Die Liste der Pakete, die auf jedem Computeknoten im Pool installiert werden sollen. Beim Erstellen eines Pools muss die Anwendungs-ID des Pakets vollqualifizierte sein (/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Batch/batchAccounts/{accountName}/applications/{applicationName}). Änderungen an Paketverweise wirken sich auf alle neuen Knoten aus, die dem Pool beitreten, wirken sich jedoch nicht auf Computeknoten aus, die sich bereits im Pool befinden, bis sie neu gestartet oder umimages neu erstellt wurden. Es gibt maximal 10 Paketverweise für einen bestimmten Pool.

string (duration)

Das Zeitintervall, in dem die Poolgröße automatisch entsprechend der Autoskalenformel angepasst werden soll. Der Standardwert beträgt 15 Minuten. Der Mindest- und Maximalwert beträgt 5 Minuten bzw. 168 Stunden. Wenn Sie einen Wert angeben, der kleiner als 5 Minuten oder größer als 168 Stunden ist, lehnt der Batchdienst die Anforderung mit einem ungültigen Eigenschaftswertfehler ab; wenn Sie die REST-API direkt aufrufen, lautet der HTTP-Statuscode 400 (Ungültige Anforderung).

string

Die Formel für die gewünschte Anzahl von Computeknoten im Pool. Diese Eigenschaft darf nicht angegeben werden, wenn enableAutoScale auf "false" festgelegt ist. Es ist erforderlich, wenn enableAutoScale auf "true" festgelegt ist. Die Formel wird vor der Erstellung des Pools auf Gültigkeit überprüft. Wenn die Formel ungültig ist, lehnt der Batchdienst die Anforderung mit detaillierten Fehlerinformationen ab.

string

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

boolean

Gibt an, ob die Poolgröße im Laufe der Zeit automatisch angepasst werden soll. Wenn false, muss mindestens eine der targetDedicatedNodes und targetLowPriorityNodes angegeben werden. Bei "true" ist das autoScaleFormula-Element erforderlich. Der Pool ändert die Größe automatisch entsprechend der Formel. Der Standardwert ist "false".

boolean

Gibt an, ob der Pool die direkte Kommunikation zwischen Computeknoten zulässt. Das Aktivieren der Kommunikation zwischen Knoten begrenzt die maximale Größe des Pools aufgrund von Bereitstellungseinschränkungen auf den Computeknoten des Pools. Dies kann dazu führen, dass der Pool seine gewünschte Größe nicht erreicht. Der Standardwert ist "false".

BatchMetadataItem[]

Eine Liste von Name-Wert-Paaren, die dem Pool als Metadaten zugeordnet sind. Der Batchdienst weist Metadaten keine Bedeutung zu; sie ist ausschließlich für die Verwendung von Benutzercode vorgesehen.

MountConfiguration[]

Eine Liste der Dateisysteme, die auf jedem Knoten im Pool bereitgestellt werden sollen. Dies unterstützt Azure Files, NFS, CIFS/SMB und Blobfuse.

NetworkConfiguration

Die Netzwerkkonfiguration für den Pool.

string (duration)

Das Timeout für die Zuordnung von Computeknoten zum Pool. Dieses Timeout gilt nur für die manuelle Skalierung; es hat keine Auswirkung, wenn enableAutoScale auf "true" festgelegt ist. Der Standardwert beträgt 15 Minuten. Der Mindestwert beträgt 5 Minuten. Wenn Sie einen Wert kleiner als 5 Minuten angeben, lehnt der Batchdienst die Anforderung mit einem Fehler ab; wenn Sie die REST-API direkt aufrufen, lautet der HTTP-Statuscode 400 (Ungültige Anforderung).

BatchStartTask

Eine Aufgabe, die auf jedem Computeknoten ausgeführt werden soll, während er dem Pool beitritt. Die Aufgabe wird ausgeführt, wenn der Computeknoten dem Pool hinzugefügt wird oder wenn der Computeknoten neu gestartet wird.

integer (int32)

Die gewünschte Anzahl dedizierter Computeknoten im Pool. Diese Eigenschaft darf nicht angegeben werden, wenn enableAutoScale auf "true" festgelegt ist. Wenn "enableAutoScale" auf "false" festgelegt ist, müssen Sie entweder targetDedicatedNodes, targetLowPriorityNodes oder beides festlegen.

integer (int32)

Die gewünschte Anzahl von Computeknoten mit Spot-/Niedriger Priorität im Pool. Diese Eigenschaft darf nicht angegeben werden, wenn enableAutoScale auf "true" festgelegt ist. Wenn "enableAutoScale" auf "false" festgelegt ist, müssen Sie entweder targetDedicatedNodes, targetLowPriorityNodes oder beides festlegen.

BatchTaskSchedulingPolicy

Wie Aufgaben über Computeknoten in einem Pool verteilt werden. Wenn nicht angegeben, wird die Standardeinstellung verteilt.

integer (int32)

Die Anzahl von Taskslots, die verwendet werden können, um gleichzeitige Tasks auf einem einzelnen Computeknoten im Pool auszuführen. Der Standardwert ist 1. Der Maximalwert ist kleiner als 4 Mal die Anzahl der Kerne der vmSize des Pools oder 256.

UpgradePolicy

Die Upgraderichtlinie für den Pool. Beschreibt eine Upgraderichtlinie – automatisch, manuell oder rolliert.

UserAccount[]

Die Liste der Benutzerkonten, die auf jedem Computeknoten im Pool erstellt werden sollen.

VirtualMachineConfiguration

Die Konfiguration des virtuellen Computers für den Pool. Diese Eigenschaft muss angegeben werden.

string

Die Größe der virtuellen Computer im Pool. Alle virtuellen Computer in einem Pool haben die gleiche Größe. Informationen zu verfügbaren Größen virtueller Computer in Pools finden Sie unter Auswählen einer VM-Größe für Computeknoten in einem Azure-Batchpool (https://learn.microsoft.com/azure/batch/batch-pool-vm-sizes).

string[] (arm-id)

Die Liste der öffentlichen IPs, die der Batchdienst beim Bereitstellen von Computeknoten verwendet. Die hier angegebene Anzahl von IPs begrenzt die maximale Größe des Pools – 100 dedizierte Knoten oder 100 Spot/Low-Priority-Knoten können für jede öffentliche IP zugewiesen werden. Ein Pool, der 250 dedizierte VMs benötigt, benötigt beispielsweise mindestens 3 öffentliche IPs. Jedes Element dieser Auflistung weist das Format auf: /subscriptions/{subscription}/resourceGroups/{group}/providers/Microsoft.Network/publicIPAddresses/{ip}.

IPFamily[]

Die IP-Familien, die zum Angeben von IP-Versionen verwendet werden, die für den Pool verfügbar sind. IP-Familien werden verwendet, um Single-Stack- oder Dual-Stack-Pools zu bestimmen. Bei einem Einzelstapel lautet der erwartete Wert IPv4. Bei dualen Stapeln sind die erwarteten Werte IPv4 und IPv6.

IPTag[]

Eine Liste der IP-Tags, die den öffentlichen IP-Adressen des Pools zugeordnet sind. IP-Tags werden verwendet, um öffentliche IP-Adressen zu Abrechnungs- und Verwaltungszwecken zu kategorisieren und zu filtern.

IpAddressProvisioningType

Der Bereitstellungstyp für öffentliche IP-Adressen für den Pool. Der Standardwert ist BatchManaged.

string

Die Befehlszeile des StartTask. 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://learn.microsoft.com/azure/batch/batch-compute-node-environment-variables) verwenden.

BatchTaskContainerSettings

Die Einstellungen für den Container, unter dem der StartTask ausgeführt wird. 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.

EnvironmentSetting[]

Eine Liste der Umgebungsvariableneinstellungen für den StartTask.

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 Wiederholungen 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 Wiederholungsanzahl 0 ist, wird der Batchdienst den Vorgang nicht wiederholen. 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).

ResourceFile[]

Eine Liste der Dateien, die der Batchdienst vor dem Ausführen der Befehlszeile auf den Computeknoten herunterladen 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. Unter diesem Element aufgelistete Dateien befinden sich im Arbeitsverzeichnis der Aufgabe.

UserIdentity

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

boolean

Gibt an, ob der Batchdienst warten soll, bis der StartTask erfolgreich abgeschlossen wurde (d. h. zum Beenden mit Beendigungscode 0), bevor Aufgaben auf dem Computeknoten geplant werden. Wenn "true" und "StartTask" auf einem Knoten fehlschlägt, wiederholt der Batchdienst die StartTask bis zur maximalen Wiederholungsanzahl (maxTaskRetryCount). Wenn die Aufgabe nach allen Wiederholungen noch nicht erfolgreich abgeschlossen wurde, markiert der Batchdienst den Knoten nicht verwendbar und plant keine Vorgänge. Diese Bedingung kann über den Computerknotenstatus und Fehlerinformationen erkannt werden. Wenn "false" lautet, wartet der Batchdienst nicht, bis der StartTask abgeschlossen ist. In diesem Fall können andere Aufgaben mit der Ausführung auf dem Computeknoten beginnen, während der StartTask noch ausgeführt wird. und auch wenn der StartTask fehlschlägt, werden neue Aufgaben weiterhin auf dem Computeknoten geplant. Der Standardwert ist "true".

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.

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".

BatchJobDefaultOrder

Die Reihenfolge für die Planung von Aufgaben aus verschiedenen Einzelvorgängen mit derselben Priorität. Wenn nicht angegeben, ist der Standardwert keine.

BatchNodeFillType

Wie Aufgaben über Computeknoten in einem Pool verteilt werden. Wenn nicht angegeben, wird die Standardeinstellung verteilt.

boolean

Gibt an, ob der sichere Start auf dem virtuellen Computer aktiviert werden soll.

boolean

Gibt an, ob vTPM auf dem virtuellen Computer aktiviert werden soll.

SecurityEncryptionTypes

Gibt den EncryptionType des verwalteten Datenträgers an. Sie ist für die Verschlüsselung nur des VMGuestState-Blobs auf "VMGuestStateOnly" und "NonPersistedTPM" festgelegt, damit der Firmwarestatus im VMGuestState-Blob nicht beibehalten wird. Hinweis: Er kann nur für vertrauliche VMs festgelegt werden und ist erforderlich, wenn vertrauliche VMs verwendet werden.

string

Die eindeutige Kennung des Bildes in der Community-Galerie. Diese Eigenschaft schließt sich gegenseitig mit anderen Eigenschaften aus und kann aus dem Get-Aufruf der Communitygalerie abgerufen werden.

string

Die spezifische Version des Plattform- oder Marktplatzimages, die zur Erstellung des Knotens verwendet wurde. Dieses Nur-Lese-Feld unterscheidet sich von 'version' nur, wenn der für 'version' angegebene Wert bei der Erstellung des Pools 'neueste' war.

string

Der Angebotstyp des Azure Virtual Machines Marketplace Images. Beispiel: UbuntuServer oder WindowsServer.

string

Der Herausgeberin des Azure Virtual Machines Marketplace Image. Beispiel: Canonical oder MicrosoftWindowsServer.

string

Die einzigartige Identifikatorin des gemeinsamen Galeriebilds. Diese Eigenschaft schließt sich gegenseitig mit anderen Eigenschaften aus und kann aus dem GET-Aufruf des freigegebenen Katalogbilds abgerufen werden.

string

Die SKU des Azure Virtual Machines Marketplace Images. Beispiel: 18.04-LTS oder 2019-Datacenter.

string

Die Version des Azure Virtual Machines Marketplace Images. Ein Wert 'neueste' kann angegeben werden, um die neueste Version eines Images auszuwählen. Wenn dieser Wert nicht angegeben wird, lautet der Standardwert "latest".

string (arm-id)

Der ARM-Ressourcenbezeichner des Azure Compute Gallery Image. Compute-Knoten im Pool werden mit dieser Bild-ID erstellt. Dies ist in der Form /subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Compute/galleries/{galleryName}/images/{imageDefinitionName}/versions/{VersionId} oder /subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Compute/galleries/{galleryName}/images/{imageDefinitionName}, um immer auf die neueste Image-Version zu setzen. Diese Eigenschaft schließt sich gegenseitig mit anderen ImageReference-Eigenschaften aus. Das Azure Compute Gallery Image muss Replikate in derselben Region haben und im selben Abonnement wie das Azure Batch-Konto sein. Wenn die Image-Version nicht in der imageID angegeben ist, wird die neueste Version verwendet. Informationen zu den Firewall-Einstellungen für den Batch Compute Node-Agenten zur Kommunikation mit dem Batch-Service finden https://learn.microsoft.com/azure/batch/nodes-and-pools#virtual-network-vnet-and-firewall-configurationSie unter .

string

Zusätzliche Befehlszeilenoptionen, die an den Bereitstellungsbefehl übergeben werden sollen. Dies sind "net use"-Optionen in Windows und "Mount"-Optionen in Linux.

string (password)

Das Kennwort, das für die Authentifizierung im CIFS-Dateisystem verwendet werden soll.

string

Der relative Pfad auf dem Rechenknoten, an dem das Dateisystem eingebunden wird. Alle Dateisysteme werden relativ zum Batch-Bereitstellungsverzeichnis bereitgestellt, auf das über die Umgebungsvariable AZ_BATCH_NODE_MOUNTS_DIR zugegriffen werden kann.

string

Der URI des zu mountden Dateisystems.

string

Der Benutzer, der für die Authentifizierung gegen das CIFS-Dateisystem verwendet werden soll.

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.

CachingType

Der Typ der Zwischenspeicherung, die für die Datenträger aktiviert werden soll. Der Standardwert für die Zwischenspeicherung ist "readwrite". Informationen zu den Zwischenspeicherungsoptionen finden Sie unter: https://blogs.msdn.microsoft.com/windowsazurestorage/2012/06/27/exploring-windows-azure-drives-disks-and-images/.

integer (int32)

Die anfängliche Datenträgergröße in Gigabyte.

integer (int32)

Die wahrheitslogische Einheitsnummer. Die logicalUnitNumber wird verwendet, um jeden Datenträger eindeutig zu identifizieren. Wenn Sie mehrere Datenträger anfügen, sollte jeder eine eindeutige logischeUnitNumber aufweisen. Der Wert muss zwischen 0 und 63 (einschließlich) liegen.

ManagedDisk

Die Parameter des verwalteten Datenträgers.

StorageAccountType

Der Speicherkontotyp, der für den Datenträger verwendet werden soll. Wenn nicht angegeben, lautet der Standardwert "standard_lrs".

BatchPoolIdentityReference

Die Referenz einer der Poolidentitäten zum Verschlüsseln des Datenträgers. Diese Identität wird für den Zugriff auf den Schlüsseltresor verwendet.

string

Vollversionierte Schlüssel-URL, die auf einen Schlüssel in KeyVault verweist. Das Versionssegment der URL ist unabhängig vom RotationToLatestKeyVersionEnabled-Wert erforderlich.

boolean

Legen Sie dieses Flag auf true fest, um die automatische Aktualisierung von Disk Encryption auf die neueste Schlüsselversion zu aktivieren. Der Standardwert ist "false".

DiskCustomerManagedKey

Die Referenz zum kundenseitig verwalteten Schlüssel zum Verschlüsseln des Betriebssystemdatenträgers. Der vom Kunden verwaltete Schlüssel verschlüsselt den Betriebssystemdatenträger mit EncryptionAtRest, und standardmäßig wird auch der Datenträger verschlüsselt. Sie kann nur verwendet werden, wenn der Pool mit einer Identität konfiguriert ist und OsDisk als eines der Ziele von DiskEncryption festgelegt ist.

DiskEncryptionTarget[]

Die Liste der Datenträgerziele für den Batchdienst wird auf dem Computeknoten verschlüsselt. Die Liste der Datenträgerziele für den Batchdienst wird auf dem Computeknoten verschlüsselt.

string (arm-id)

Die ARM-Ressourcen-ID des Datenträgerverschlüsselungssatzes. Die Ressource muss sich im selben Abonnement wie das Batch-Konto befinden.

string

Der Name der Umgebungsvariable.

string

Der Wert der Umgebungsvariable.

string

Gibt den Verweis auf die InVMAccessControlProfileVersion-Ressourcen-ID im Format /subscriptions/{SubscriptionId}/resourceGroups/{ResourceGroupName}/providers/Microsoft.Compute/galleries/{galleryName}/inVMAccessControlProfiles/{profile}/versions/{version} an.

HostEndpointSettingsModeTypes

Gibt den Ausführungsmodus der Zugriffssteuerungsrichtlinie an.

string

Der IP-Tag-Typ. Beispiel: FirstPartyUsage.

string

Der Wert des IP-Tags, das der öffentlichen IP zugeordnet ist. Beispiel: SQL.

integer (int32)

Die Gruppen-ID für das Benutzerkonto. Die Uid- und gid-Eigenschaften müssen zusammen oder gar nicht angegeben werden. Wenn das zugrunde liegende Betriebssystem nicht angegeben ist, wird das Gid ausgewählt.

string (password)

Der private SSH-Schlüssel für das Benutzerkonto. Der private Schlüssel darf nicht kennwortgeschützter Schlüssel sein. Der private Schlüssel wird verwendet, um automatisch asymmetrisch-schlüsselbasierte Authentifizierung für SSH zwischen Compute-Knoten in einem Linux-Pool zu konfigurieren, wenn die enableInterNodeCommunication-Eigenschaft des Pools wahr ist (sie wird ignoriert, wenn enableInterNodeCommunication falsch ist). Dazu wird das Schlüsselpaar in das SSH-Verzeichnis des Benutzers eingefügt. Sofern nicht angegeben, wird passwortloses SSH zwischen den Compute Nodes nicht konfiguriert (es wird kein Bestand am .ssh-Verzeichnis des Benutzers vorgenommen).

integer (int32)

Die Benutzer-ID des Benutzerkontos. Die Uid- und gid-Eigenschaften müssen zusammen oder gar nicht angegeben werden. Wenn das zugrunde liegende Betriebssystem nicht angegeben ist, wird die UID ausgewählt.

DiskEncryptionSetParameters

Gibt die vom Kunden verwaltete Datenträgerverschlüsselungssatz-Ressourcen-ID für den verwalteten Datenträger an. Er kann nur im UserSubscription-Modus festgelegt werden.

BatchVmDiskSecurityProfile

Gibt die Sicherheitsprofileinstellungen für den verwalteten Datenträger an.

StorageAccountType

Der Speicherkontotyp für verwaltete Datenträger.

AzureBlobFileSystemConfiguration

Der Azure Storage-Container, der mithilfe von BLOB-FUSE auf jedem Knoten bereitgestellt werden soll. Diese Eigenschaft schließt sich gegenseitig mit allen anderen Eigenschaften aus.

AzureFileShareConfiguration

Die Azure-Dateifreigabe, die auf jedem Knoten bereitgestellt werden soll. Diese Eigenschaft schließt sich gegenseitig mit allen anderen Eigenschaften aus.

CifsMountConfiguration

Das CIFS/SMB-Dateisystem, das auf jedem Knoten bereitgestellt werden soll. Diese Eigenschaft schließt sich gegenseitig mit allen anderen Eigenschaften aus.

NfsMountConfiguration

Das NFS-Dateisystem, das auf jedem Knoten bereitgestellt werden soll. Diese Eigenschaft schließt sich gegenseitig mit allen anderen Eigenschaften aus.

DynamicVNetAssignmentScope

Der Umfang der dynamischen vnet-Zuordnung.

boolean

Gibt an, ob dieser Pool beschleunigte Netzwerke aktivieren soll. Das beschleunigte Netzwerk ermöglicht die einzelne E/A-Virtualisierung (SR-IOV) für einen virtuellen Computer, was zu einer verbesserten Netzwerkleistung führen kann. Weitere Informationen finden Sie unter: https://learn.microsoft.com/azure/virtual-network/accelerated-networking-overview.

BatchPoolEndpointConfiguration

Die Konfiguration für Endpunkte auf Compute Nodes im Batch Pool.

BatchPublicIpAddressConfiguration

Die Öffentliche IPAddress-Konfiguration für Computeknoten im Batchpool.

string

Die ARM-Ressourcenkennung des virtuellen Netzwerksubnetzes, dem die Rechenknoten des Pools beitreten. Dies ist das Format "/subscriptions/{subscription}/resourceGroups/{group}/providers/{provider}/virtualNetworks/{network}/subnets/{subnet}". Das virtuelle Netzwerk muss sich in derselben Region und im gleichen Abonnement wie das Azure-Batchkonto befinden. Das angegebene Subnetz sollte genügend freie IP-Adressen haben, um die Anzahl der Rechenknoten im Pool aufzunehmen. Wenn das Subnetz nicht genügend freie IP-Adressen hat, wird der Pool die Knoten teilweise zuweisen und ein Größenänderungsfehler tritt auf. Der Dienstprinzipal "MicrosoftAzureBatch" muss über die Rolle "Classic Virtual Machine Contributor" Role-Based Access Control (RBAC) für das angegebene VNet verfügen. Das angegebene Subnetz muss die Kommunikation vom Azure Batch-Service ermöglichen, um Aufgaben auf den Knoten planen zu können. Dies kann überprüft werden, indem überprüft wird, ob das angegebene VNet über alle zugehörigen Netzwerksicherheitsgruppen (Network Security Groups, NSG) verfügt. Wenn die Kommunikation mit den Knoten im angegebenen Subnetz von einer NSG verweigert wird, legt der Batchdienst den Status der Computeknoten auf unbrauchbar fest. Es werden nur ARM-virtuelle Netzwerke ('Microsoft.Network/virtualNetworks') unterstützt. Wenn das angegebene VNet zugehörige Network Security Groups (NSG) hat, müssen einige reservierte Systemports für eingehende Kommunikation aktiviert werden, darunter die Ports 29876 und 29877. Aktivieren Sie auch ausgehende Verbindungen mit Azure Storage auf Port 443. Weitere Informationen finden Sie unter: https://learn.microsoft.com/azure/batch/nodes-and-pools#virtual-network-vnet-and-firewall-configuration

NetworkSecurityGroupRuleAccess

Die Aktion, die für eine angegebene IP-Adresse, einen Subnetzbereich oder ein Bestimmtes Tag ausgeführt werden soll.

integer (int32)

Die Priorität für diese Regel. Prioritäten innerhalb eines Pools müssen einzigartig sein und in der Reihenfolge der Priorität bewertet werden. Je niedriger die Zahl ist, desto höher ist die Priorität. Regeln können beispielsweise mit den Bestellnummern 150, 250 und 350 angegeben werden. Die Regel mit der Bestellnummer 150 hat Vorrang vor der Regel mit einer Reihenfolge von 250. Zulässige Prioritäten sind 150 bis 4096. Wenn reservierte oder doppelte Werte bereitgestellt werden, schlägt die Anforderung mit dem HTTP-Statuscode 400 fehl.

string

Das Quelladressenpräfix oder -tag, das für die Regel übereinstimmen soll. Gültige Werte sind eine einzelne IP-Adresse (d. h. 10.10.10.10), IP-Subnetz (d. h. 192.168.1.0/24), Standardtag oder * (für alle Adressen). Wenn andere Werte bereitgestellt werden, schlägt die Anforderung mit dem HTTP-Statuscode 400 fehl.

string[]

Die Quellportbereiche, die für die Regel übereinstimmen sollen. Gültige Werte sind '' (für alle Ports 0 - 65535), ein bestimmter Port (d. h. 22) oder ein Portbereich (d. h. 100–200). Die Ports müssen im Bereich von 0 bis 65535 liegen. Jeder Eintrag in dieser Sammlung darf keinen anderen Eintrag überlappen (weder eine Reichweite noch ein einzelner Port). Wenn weitere Werte angegeben werden, schlägt die Anfrage mit HTTP-Statuscode 400 fehl. Der Standardwert ist ''.

string

Zusätzliche Befehlszeilenoptionen, die an den Bereitstellungsbefehl übergeben werden sollen. Dies sind "net use"-Optionen in Windows und "Mount"-Optionen in Linux.

string

Der relative Pfad auf dem Rechenknoten, an dem das Dateisystem eingebunden wird. Alle Dateisysteme werden relativ zum Batch-Bereitstellungsverzeichnis bereitgestellt, auf das über die Umgebungsvariable AZ_BATCH_NODE_MOUNTS_DIR zugegriffen werden kann.

string

Der URI des zu mountden Dateisystems.

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://learn.microsoft.com/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.

boolean

Gibt an, ob das Feature "Metadata Security Protocol" auf dem virtuellen Computer oder der VM-Skalierungsgruppe aktiviert werden soll. Der Standardwert ist "False".

HostEndpointSettings

Einstellungen für den IMDS-Endpunkt.

HostEndpointSettings

Einstellungen für den WireServer-Endpunkt.

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.

boolean

Zulassen, dass VMSS AZ-Grenzen beim Erstellen von Upgradebatches ignoriert. Berücksichtigen Sie die Updatedomäne und maxBatchInstancePercent, um die Batchgröße zu ermitteln. Dieses Feld kann nur bei Verwendung von NodePlacementConfiguration als Zonal auf "true" oder "false" festgelegt werden.

integer (int32)

Der maximale Prozentsatz der gesamten Instanzen des virtuellen Computers, die gleichzeitig durch das rollierende Upgrade in einem Batch aktualisiert werden. Da dies ein Maximum ist, können fehlerhafte Instanzen in früheren oder zukünftigen Batches dazu führen, dass der Prozentsatz der Instanzen in einem Batch verringert wird, um eine höhere Zuverlässigkeit sicherzustellen. Der Wert dieses Felds sollte zwischen 5 und 100 (einschließlich) liegen. Wenn "maxBatchInstancePercent" und "maxUnhealthyInstancePercent" mit dem Wert zugewiesen sind, sollte der Wert von "maxBatchInstancePercent" nicht größer als "maxUnhealthyInstancePercent" sein.

integer (int32)

Der maximale Prozentsatz der Instanzen des virtuellen Computers im Skalierungssatz, der gleichzeitig fehlerhaft sein kann, entweder aufgrund eines Upgrades oder durch die Integritätsprüfungen des virtuellen Computers in einem fehlerhaften Zustand gefunden wird, bevor das Rollupgrade abgebrochen wird. Diese Einschränkung wird vor dem Starten eines Batches überprüft. Der Wert dieses Felds sollte zwischen 5 und 100 (einschließlich) liegen. Wenn "maxBatchInstancePercent" und "maxUnhealthyInstancePercent" mit dem Wert zugewiesen sind, sollte der Wert von "maxBatchInstancePercent" nicht größer als "maxUnhealthyInstancePercent" sein.

integer (int32)

Der maximale Prozentsatz der aktualisierten Virtuellen Computerinstanzen, die sich in einem fehlerhaften Zustand befinden. Diese Überprüfung erfolgt, nachdem jeder Batch aktualisiert wurde. Wenn dieser Prozentsatz jemals überschritten wird, wird das rollierende Update abgebrochen. Der Wert dieses Felds sollte zwischen 0 und 100 (einschließlich) liegen.

string (duration)

Die Wartezeit zwischen Abschluss des Updates für alle virtuellen Computer in einem Batch und starten den nächsten Batch. Die Zeitdauer sollte im ISO 8601-Format angegeben werden.

boolean

Aktualisieren Sie alle fehlerhaften Instanzen in einem Skalierungssatz, bevor alle fehlerfreien Instanzen auftreten.

boolean

Fehler bei Rollbackinstanzen beim vorherigen Modell, wenn die Richtlinie für das Rollupgrade verletzt wird.

boolean

Diese Eigenschaft kann vom Benutzer in der Anforderung verwendet werden, um die Hostverschlüsselung für den virtuellen Computer oder die Skalierungsgruppe des virtuellen Computers zu aktivieren oder zu deaktivieren. Dadurch wird die Verschlüsselung für alle Datenträger einschließlich Ressourcen-/Temp-Datenträger auf dem Host selbst aktiviert. Weitere Informationen zur Verschlüsselung bei Hostanforderungen finden Sie unter https://learn.microsoft.com/azure/virtual-machines/disk-encryption#supported-vm-sizes.

ProxyAgentSettings

Gibt proxyAgent-Einstellungen beim Erstellen des virtuellen Computers an.

SecurityTypes

Gibt den SecurityType des virtuellen Computers an. Sie muss auf einen beliebigen angegebenen Wert festgelegt werden, um UefiSettings zu aktivieren.

BatchUefiSettings

Gibt die Sicherheitseinstellungen wie sicherer Start und vTPM an, die beim Erstellen des virtuellen Computers verwendet werden. Gibt die Sicherheitseinstellungen wie sicherer Start und vTPM an, die beim Erstellen des virtuellen Computers verwendet werden.

string

Die Service-Artefakt-Referenz-ID von ServiceArtifactReference. Die Dienstartefaktereferenz-ID in Form von /subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Compute/gallerys/{galleryName}/serviceArtifacts/{serviceArtifactName}/vmArtifactsProfiles/{vmArtifactsProfilesName}

AutomaticOsUpgradePolicy

Konfigurationsparameter, die zum Ausführen des automatischen Betriebssystemupgrades verwendet werden. Die Konfigurationsparameter, die zum Ausführen eines automatischen Betriebssystemupgrades verwendet werden.

UpgradeMode

Gibt den Modus eines Upgrades auf virtuelle Computer im Skalierungssatz an.

Mögliche Werte:

manuelle – Sie steuern die Anwendung von Updates auf virtuelle Computer im Skalierungssatz. Dazu verwenden Sie die ManualUpgrade-Aktion.

Automatische – Alle virtuellen Computer im Skalierungssatz werden automatisch gleichzeitig aktualisiert.

Roll- – Skalierungssatz führt Aktualisierungen in Batches mit einer optionalen Pausenzeit dazwischen durch.

RollingUpgradePolicy

Die Konfigurationsparameter, die beim Ausführen eines rollierenden Upgrades verwendet werden.

ElevationLevel

Die Erhebungsebene des Benutzerkontos. Der Standardwert ist "nonAdmin".

LinuxUserConfiguration

Die Linux-spezifische Benutzerkonfiguration für das Benutzerkonto. Diese Eigenschaft wird ignoriert, wenn sie in einem Windows-Pool angegeben ist. Wenn nicht angegeben, wird der Benutzer mit den Standardoptionen erstellt.

string

Der Name des Benutzerkontos. Namen können bis zu einer maximalen Länge von 20 Unicode-Zeichen enthalten.

string (password)

Das Passwort für das Benutzerkonto.

WindowsUserConfiguration

Die Windows-spezifische Benutzerkonfiguration für das Benutzerkonto. Diese Eigenschaft kann nur angegeben werden, wenn sich der Benutzer auf einem Windows-Pool befindet. Wenn nicht angegeben und auf einem Windows-Pool ist, wird der Benutzer mit den Standardoptionen erstellt.

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.

BatchContainerConfiguration

Die Containerkonfiguration für den Pool. Falls angegeben, wird die Einrichtung an jedem Compute-Knoten im Pool durchgeführt, damit Aufgaben in Containern ausgeführt werden können. Alle regulären Tasks und Jobmanager-Aufgaben, die auf diesem Pool ausgeführt werden, müssen die ContainerSettings-Eigenschaft angeben, und alle anderen Tasks können dies angeben.

DataDisk[]

Die Konfiguration für Datenfestplatten, die an die Rechenknoten im Pool angeschlossen sind. Diese Eigenschaft muss angegeben werden, wenn die Rechenknoten im Pool leere Datenfestplatten an sich angeschlossen haben müssen. Dies kann nicht aktualisiert werden. Jeder Compute-Knoten erhält seine eigene Festplatte (die Festplatte ist keine Dateifreigabe). Vorhandene Festplatten können nicht angeschlossen werden, jede angeschlossene Festplatte ist leer. Wenn der Compute-Node aus dem Pool entfernt wird, werden auch die Festplatte und alle damit verbundenen Daten gelöscht. Die Festplatte wird nach dem Anschluss nicht formatiert, sie muss vor der Nutzung formatiert werden – für weitere Informationen siehe https://learn.microsoft.com/azure/virtual-machines/linux/classic/attach-disk#initialize-a-new-data-disk-in-linux und https://learn.microsoft.com/azure/virtual-machines/windows/attach-disk-ps#add-an-empty-data-disk-to-a-virtual-machine.

DiskEncryptionConfiguration

Die Datenträgerverschlüsselungskonfiguration für den Pool. Wenn angegeben, wird die Verschlüsselung für jeden Knoten im Pool während der Knotenbereitstellung ausgeführt.

VMExtension[]

Die Erweiterung des virtuellen Computers für den Pool. Wenn angegeben, werden die in dieser Konfiguration genannten Erweiterungen auf jedem Knoten installiert.

BatchVmImageReference

Ein Verweis auf das Azure Virtual Machines Marketplace-Image oder das zu verwendende benutzerdefinierte Virtuelle Computerimage.

string

Dies gilt nur für Images, die das Windows-Betriebssystem enthalten, und sollten nur verwendet werden, wenn Sie gültige On-Premises-Lizenzen für die Compute-Nodes besitzen, die bereitgestellt werden. Ohne Angabe wird kein lokaler Lizenzierungsrabatt angewendet. Die Werte sind:

Windows_Server – Die lokale Lizenz gilt für Windows Server. Windows_Client – Die lokale Lizenz ist für Windows Client.

string

Die SKU des Batch-Computeknoten-Agents, der auf Computeknoten im Pool bereitgestellt werden soll. Der Batch Compute Node-Agent ist ein Programm, das auf jedem Computeknoten im Pool ausgeführt wird und die Befehls- und Steuerungsschnittstelle zwischen dem Computeknoten und dem Batchdienst bereitstellt. Es gibt unterschiedliche Implementierungen des Compute Node-Agents, die als SKUs bezeichnet werden, für verschiedene Betriebssysteme. Sie müssen eine Computeknoten-Agent-SKU angeben, die dem ausgewählten Imageverweis entspricht. Informationen zum Abrufen der Liste der unterstützten ComputeKnoten-Agent-SKUs sowie deren Liste der überprüften Imageverweise finden Sie unter "Liste unterstützter Computeknoten-Agent-SKUs".

BatchNodePlacementConfiguration

Die Knotenplatzierungskonfiguration für den Pool. Diese Konfiguration gibt Regeln für die physische Zuordnung von Knoten im Pool an.

BatchOsDisk

Einstellungen für den Betriebssystemdatenträger des virtuellen Computers.

SecurityProfile

Gibt die Sicherheitsprofileinstellungen für den virtuellen Computer oder die Skalierungsgruppe des virtuellen Computers an.

ServiceArtifactReference

Gibt die Dienstartefaktereferenz-ID an, die zum Festlegen derselben Imageversion für alle virtuellen Computer im Skalierungssatz bei Verwendung der neuesten Imageversion verwendet wird. Die Dienstartefaktereferenz-ID in Form von /subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Compute/gallerys/{galleryName}/serviceArtifacts/{serviceArtifactName}/vmArtifactsProfiles/{vmArtifactsProfilesName}

WindowsConfiguration

Windows-Betriebssystemeinstellungen auf dem virtuellen Computer. Diese Eigenschaft darf nicht angegeben werden, wenn die imageReference-Eigenschaft ein Linux-OS-Image angibt.

boolean

Gibt an, ob die Erweiterung eine neuere Nebenversion verwenden soll, wenn sie zur Bereitstellungszeit verfügbar ist. Nach der Bereitstellung aktualisiert die Erweiterung jedoch keine Nebenversionen, es sei denn, sie werden erneut bereitgestellt, auch wenn diese Eigenschaft auf "true" festgelegt ist.

boolean

Gibt an, ob die Erweiterung automatisch von der Plattform aktualisiert werden soll, wenn eine neuere Version der Erweiterung verfügbar ist.

string

Der Name der Erweiterung des virtuellen Computers.

object

Die Erweiterung kann entweder protectedSettings oder protectedSettingsFromKeyVault oder gar keine geschützten Einstellungen enthalten.

string[]

Die Sammlung von Erweiterungsnamen. Sammlung von Erweiterungsnamen, nach denen diese Erweiterung bereitgestellt werden muss.

string

Der Name des Herausgebers des Erweiterungshandlers.

object

JSON-formatierte öffentliche Einstellungen für die Erweiterung.

string

Die Art der Verlängerung.

string

Die Version des Skripthandlers.

boolean

Gibt an, ob automatische Updates auf dem virtuellen Computer aktiviert sind. Wenn dieser Wert nicht angegeben wird, ist der Standardwert "true".

LoginMode

Der Login-Modus für den Nutzer. Standardmäßig ist 'Batch'.