Task - Add Collection

Dienst:

Batch Service

API-Version:

2024-07-01.20.0

Fügt dem angegebenen Auftrag eine Auflistung von Tasks hinzu.
Beachten Sie, dass jede Aufgabe über eine eindeutige ID verfügen muss. Der Batchdienst gibt möglicherweise nicht die Ergebnisse für jeden Vorgang in derselben Reihenfolge zurück, in der die Aufgaben in dieser Anforderung übermittelt wurden. Wenn das Zeitüberschreitungen des Servers oder die Verbindung während der Anforderung geschlossen wird, wurde die Anforderung möglicherweise teilweise oder vollständig verarbeitet oder gar nicht. In solchen Fällen sollte der Benutzer die Anforderung erneut ausstellen. Beachten Sie, dass der Benutzer fehler beim erneuten Ausgeben einer Anforderung ordnungsgemäß behandeln kann. Sie sollten z. B. die gleichen Vorgangs-IDs während eines Wiederholungsvorgangs verwenden, sodass beim erfolgreichen Vorherigen Vorgang keine zusätzlichen Aufgaben unerwartet erstellt werden. Wenn die Antwort Aufgaben enthält, die nicht hinzugefügt werden konnten, kann ein Client die Anforderung wiederholen. In einem Wiederholungsversuch ist es am effizientesten, nur Aufgaben erneut zu übermitteln, die nicht hinzugefügt wurden, und Aufgaben auszulassen, die erfolgreich beim ersten Versuch hinzugefügt wurden. Die maximale Lebensdauer eines Vorgangs von der Ergänzung zum Abschluss beträgt 180 Tage. Wenn eine Aufgabe nicht innerhalb von 180 Tagen nach dem Hinzufügen abgeschlossen wurde, wird sie vom Batchdienst beendet und in dem Zustand verbleiben, in dem es sich zu diesem Zeitpunkt befand.

POST {batchUrl}/jobs/{jobId}/addtaskcollection?api-version=2024-07-01.20.0

Mit optionalen Parametern:

POST {batchUrl}/jobs/{jobId}/addtaskcollection?timeout={timeout}&api-version=2024-07-01.20.0

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
batchUrl	path	True	string	Die Basis-URL für alle Azure Batch-Dienstanforderungen.
jobId	path	True	string	Die ID des Auftrags, dem die Aufgabenauflistung hinzugefügt werden soll.
api-version	query	True	string	Client-API-Version.
timeout	query		integer int32	Die maximale Zeit, die der Server für die Verarbeitung der Anforderung in Sekunden ausgeben kann. Der Standardwert ist 2 Minuten. Wenn der Wert größer als 120 ist, wird stattdessen der Standardwert verwendet.

Anforderungsheader

Media Types: "application/json; odata=minimalmetadata"

Name	Erforderlich	Typ	Beschreibung
client-request-id		string uuid	Die vom Aufrufer generierte Anforderungsidentität in Form einer GUID ohne Dekoration wie geschweifte Klammern, z. B. 9C4D50EE-2D56-4CD3-8152-34347DC9F2B0.
return-client-request-id		boolean	Gibt an, ob der Server die Clientanforderungs-ID in der Antwort zurückgeben soll.
ocp-date		string date-time-rfc1123	Der Zeitpunkt, zu dem die Anforderung ausgestellt wurde. Clientbibliotheken legen dies in der Regel auf die aktuelle Systemuhrzeit fest. legen Sie sie explizit fest, wenn Sie die REST-API direkt aufrufen.

Anforderungstext

Media Types: "application/json; odata=minimalmetadata"

Name	Erforderlich	Typ	Beschreibung
value	True	TaskAddParameter[]	Die Hinzuzufügende Sammlung von Tasks. Die maximale Anzahl von Vorgängen beträgt 100. Die serialisierte Gesamtgröße dieser Auflistung muss kleiner als 1 MB sein. Wenn sie größer als 1 MB ist (z. B. wenn jeder Vorgang über 100 Ressourcendateien oder Umgebungsvariablen verfügt), schlägt die Anforderung mit dem Code 'RequestBodyTooLarge' fehl und sollte erneut mit weniger Vorgängen wiederholt werden.

Antworten

Name	Typ	Beschreibung
200 OK	TaskAddCollectionResult	Eine Antwort, die die Ergebnisse des Vorgangs zum Hinzufügen von Aufgabenauflistung enthält. Header client-request-id: string request-id: string
Other Status Codes	BatchError	Unerwarteter Fehler

Sicherheit

azure_auth

Microsoft Entra OAuth 2.0-Authentifizierungscodefluss

Typ: oauth2
Ablauf: implicit
Autorisierungs-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiche

Name	Beschreibung
user_impersonation	Identitätswechsel ihres Benutzerkontos

Authorization

Typ: apiKey
In: header

Beispiele

Add a basic collection of tasks

Add a complex collection of tasks

Add a basic collection of tasks

Beispielanforderung

HTTP

POST account.region.batch.azure.com/jobs/jobId/addtaskcollection?api-version=2024-07-01.20.0



{
  "value": [
    {
      "id": "simple1",
      "commandLine": "cmd /c dir /s"
    },
    {
      "id": "simple2",
      "commandLine": "cmd /c dir /s"
    }
  ]
}

Beispiel für eine Antwort

Statuscode:

200

{
  "value": [
    {
      "status": "success",
      "taskId": "simple1",
      "eTag": "0x8D3D623CD661246",
      "lastModified": "2016-09-06T07:02:44.7589958Z",
      "location": "https://account.region.batch.azure.com/jobs/jobId/tasks/simple1"
    },
    {
      "status": "success",
      "taskId": "simple2",
      "eTag": "0x8D3D623CD7072CC",
      "lastModified": "2016-09-06T07:02:44.8270028Z",
      "location": "https://account.region.batch.azure.com/jobs/jobId/tasks/simple2"
    }
  ]
}

Add a complex collection of tasks

Beispielanforderung

HTTP

POST account.region.batch.azure.com/jobs/jobId/addtaskcollection?api-version=2024-07-01.20.0



{
  "value": [
    {
      "id": "complex1",
      "commandLine": "cmd /c dir /s",
      "resourceFiles": [
        {
          "autoStorageContainerName": "containerName",
          "filePath": "data"
        }
      ],
      "environmentSettings": [
        {
          "name": "env1",
          "value": "value1"
        },
        {
          "name": "env2",
          "value": "value2"
        }
      ],
      "affinityInfo": {
        "affinityId": "affinityId"
      },
      "constraints": {
        "maxWallClockTime": "P1D",
        "retentionTime": "P2D",
        "maxTaskRetryCount": 5
      },
      "requiredSlots": 2,
      "multiInstanceSettings": {
        "numberOfInstances": 3,
        "coordinationCommandLine": "cmd /c echo coordinating",
        "commonResourceFiles": [
          {
            "httpUrl": "https://common.blob.core.windows.net/",
            "filePath": "common.exe"
          }
        ]
      }
    },
    {
      "id": "simple3",
      "commandLine": "cmd /c dir /s"
    }
  ]
}

Beispiel für eine Antwort

Statuscode:

200

{
  "value": [
    {
      "taskId": "simple3",
      "status": "success",
      "eTag": "0x8D3D623CE295629",
      "lastModified": "2016-09-06T07:02:46.0386857Z",
      "location": "https://account.region.batch.azure.com/jobs/jobId/tasks/simple3"
    },
    {
      "taskId": "complex1",
      "status": "success",
      "eTag": "0x8D3D623CE29A412",
      "lastModified": "2016-09-06T07:02:46.0406802Z",
      "location": "https://account.region.batch.azure.com/jobs/jobId/tasks/complex1"
    }
  ]
}

Definitionen

Name	Beschreibung
AccessScope	Die Batchressourcen, auf die das Token Zugriff gewährt.
AffinityInformation	Ein Gebietsschemahinweis, der vom Batchdienst verwendet werden kann, um einen Computeknoten auszuwählen, auf dem eine Aufgabe gestartet werden soll.
ApplicationPackageReference	Ein Verweis auf ein Paket, das auf Computeknoten bereitgestellt werden soll.
AuthenticationTokenSettings	Die Einstellungen für ein Authentifizierungstoken, das von der Aufgabe zum Ausführen von Batchdienstvorgängen verwendet werden kann.
AutoUserScope	Der Bereich für den automatischen Benutzer
AutoUserSpecification	Gibt die Parameter für den automatischen Benutzer an, der eine Aufgabe im Batchdienst ausführt.
BatchError	Eine Vom Azure Batch-Dienst empfangene Fehlerantwort.
BatchErrorDetail	Ein Element mit zusätzlichen Informationen, die in einer Azure Batch-Fehlerantwort enthalten sind.
ComputeNodeIdentityReference	Der Verweis auf eine vom Benutzer zugewiesene Identität, die dem Batchpool zugeordnet ist, den ein Computeknoten verwendet.
ContainerHostBatchBindMountEntry	Der Eintrag des Pfad- und Bereitstellungsmodus, den Sie in Aufgabencontainer bereitstellen möchten.
ContainerHostDataPath	Die Pfade, die im Container der Containeraufgabe bereitgestellt werden.
ContainerRegistry	Eine private Containerregistrierung.
ContainerWorkingDirectory	Der Speicherort des Arbeitsverzeichnisses für containeraufgaben.
DependencyAction	Eine Aktion, die der Batchdienst für Aufgaben ausführt, die von dieser Aufgabe abhängig sind.
ElevationLevel	Die Höhe des Benutzers.
EnvironmentSetting	Eine Umgebungsvariable, die für einen Vorgangsprozess festgelegt werden soll.
ErrorMessage	Eine Fehlermeldung, die in einer Azure Batch-Fehlerantwort empfangen wurde.
ExitCodeMapping	Wie der Batchdienst reagieren soll, wenn eine Aufgabe mit einem bestimmten Beendigungscode beendet wird.
ExitCodeRangeMapping	Eine Reihe von Beendigungscodes und wie der Batchdienst auf Beendigungscodes innerhalb dieses Bereichs reagieren soll.
ExitConditions	Gibt an, wie der Batchdienst reagieren soll, wenn die Aufgabe abgeschlossen ist.
ExitOptions	Gibt an, wie der Batchdienst auf eine bestimmte Beendigungsbedingung reagiert.
HttpHeader	Ein HTTP-Headernamen-Wert-Paar
JobAction	Eine Aktion, die für den Auftrag ausgeführt werden soll, der die Aufgabe enthält, wenn die Aufgabe mit der angegebenen Beendigungsbedingung abgeschlossen wird und die OnTaskFailed-Eigenschaft "performExitOptionsJobAction" lautet.
MultiInstanceSettings	Einstellungen, die angeben, wie eine Aufgabe mit mehreren Instanzen ausgeführt werden soll.
OutputFile	Eine Spezifikation zum Hochladen von Dateien von einem Azure Batch Compute Node an einen anderen Speicherort, nachdem der Batchdienst die Ausführung des Aufgabenvorgangs abgeschlossen hat.
OutputFileBlobContainerDestination	Gibt ein Dateiuploadziel in einem Azure Blob Storage-Container an.
OutputFileDestination	Das Ziel, in das eine Datei hochgeladen werden soll.
OutputFileUploadCondition	Die Bedingungen, unter denen eine Aufgabenausgabedatei oder eine Gruppe von Dateien hochgeladen werden soll.
OutputFileUploadOptions	Details zu einem Uploadvorgang einer Ausgabedatei, einschließlich der Bedingungen, unter denen der Upload ausgeführt werden soll.
ResourceFile	Eine einzelne Datei oder mehrere Dateien, die in einen Computeknoten heruntergeladen werden sollen.
TaskAddCollectionParameter	Eine Sammlung von hinzuzufügenden Azure-Batchaufgaben.
TaskAddCollectionResult	Das Ergebnis des Hinzufügens einer Sammlung von Aufgaben zu einem Auftrag.
TaskAddParameter	Eine hinzuzufügende Azure-Batchaufgabe.
TaskAddResult	Ergebnis für einen einzelnen Vorgang, der als Teil eines Vorgangs zum Hinzufügen einer Aufgabenauflistung hinzugefügt wurde.
TaskAddStatus	Der Status der Aufgabenanforderung hinzufügen.
TaskConstraints	Ausführungseinschränkungen, die auf einen Vorgang angewendet werden sollen.
TaskContainerSettings	Die Containereinstellungen für eine Aufgabe.
TaskDependencies	Gibt alle Abhängigkeiten eines Vorgangs an. Alle Vorgänge, die explizit oder innerhalb eines Abhängigkeitsbereichs angegeben sind, müssen abgeschlossen werden, bevor der abhängige Vorgang geplant wird.
TaskIdRange	Ein Bereich von Vorgangs-IDs, von denen ein Vorgang abhängig sein kann. Alle Vorgänge mit IDs im Bereich müssen erfolgreich abgeschlossen werden, bevor der abhängige Vorgang geplant werden kann.
UserIdentity	Die Definition der Benutzeridentität, unter der die Aufgabe ausgeführt wird.

AccessScope

Die Batchressourcen, auf die das Token Zugriff gewährt.

Name	Typ	Beschreibung
job	string	Gewährt Zugriff auf alle Vorgänge für den Auftrag, der die Aufgabe enthält.

AffinityInformation

Ein Gebietsschemahinweis, der vom Batchdienst verwendet werden kann, um einen Computeknoten auszuwählen, auf dem eine Aufgabe gestartet werden soll.

Name	Typ	Beschreibung
affinityId	string	Eine undurchsichtige Zeichenfolge, die die Position eines Computeknotens oder einer Zuvor ausgeführten Aufgabe darstellt. Sie können die Affinitäts-ID eines Knotens übergeben, um anzugeben, dass diese Aufgabe auf diesem Computeknoten ausgeführt werden muss. Beachten Sie, dass dies nur eine weiche Affinität ist. Wenn der Ziel-Computeknoten zum Zeitpunkt der Planung des Vorgangs ausgelastet oder nicht verfügbar ist, wird der Vorgang an anderer Stelle geplant.

ApplicationPackageReference

Ein Verweis auf ein Paket, das auf Computeknoten bereitgestellt werden soll.

Name	Typ	Beschreibung
applicationId	string	Die ID der bereitzustellenden Anwendung. Beim Erstellen eines Pools muss die Anwendungs-ID des Pakets vollqualifizierte sein (/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Batch/batchAccounts/{accountName}/applications/{applicationName}).
version	string	Die Version der bereitzustellenden Anwendung. Wenn sie weggelassen wird, wird die Standardversion bereitgestellt. Wenn dies für einen Pool nicht angegeben wird und für diese Anwendung keine Standardversion angegeben wird, schlägt die Anforderung mit dem Fehlercode InvalidApplicationPackageReferences und DEM HTTP-Statuscode 409 fehl. Wenn dies für eine Aufgabe nicht angegeben wird und für diese Anwendung keine Standardversion angegeben wird, schlägt die Aufgabe mit einem Vorverarbeitungsfehler fehl.

AuthenticationTokenSettings

Die Einstellungen für ein Authentifizierungstoken, das von der Aufgabe zum Ausführen von Batchdienstvorgängen verwendet werden kann.

Name	Typ	Beschreibung
access	AccessScope[]	Die Batchressourcen, auf die das Token Zugriff gewährt. Das Authentifizierungstoken gewährt Zugriff auf einen begrenzten Satz von Batchdienstvorgängen. Derzeit ist der einzige unterstützte Wert für die Access-Eigenschaft "auftrag", der Zugriff auf alle Vorgänge im Zusammenhang mit dem Auftrag gewährt, der die Aufgabe enthält.

AutoUserScope

Der Bereich für den automatischen Benutzer

Name	Typ	Beschreibung
pool	string	Gibt an, dass die Aufgabe als allgemeines automatisches Benutzerkonto ausgeführt wird, das auf jedem Computeknoten in einem Pool erstellt wird.
task	string	Gibt an, dass der Dienst einen neuen Benutzer für die Aufgabe erstellen soll.

AutoUserSpecification

Gibt die Parameter für den automatischen Benutzer an, der eine Aufgabe im Batchdienst ausführt.

Name	Typ	Beschreibung
elevationLevel	ElevationLevel	Die Höhenstufe des automatischen Benutzers. Der Standardwert ist "nonAdmin".
scope	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. Wenn die Aufgabe beispielsweise die Registrierung auf eine Weise stummschaltet, die sich auf andere Aufgaben auswirken könnte, oder wenn Zertifikate auf dem Pool angegeben wurden, auf die nicht durch normale Aufgaben zugegriffen werden sollte, aber von StartTasks zugänglich sein sollte.

BatchError

Eine Vom Azure Batch-Dienst empfangene Fehlerantwort.

Name	Typ	Beschreibung
code	string	Ein Bezeichner für den Fehler. Codes sind unveränderlich und sollen programmgesteuert genutzt werden.
message	ErrorMessage	Eine Meldung, die den Fehler beschreibt, der für die Anzeige in einer Benutzeroberfläche geeignet ist.
values	BatchErrorDetail[]	Eine Sammlung von Schlüssel-Wert-Paaren, die zusätzliche Details zum Fehler enthalten.

BatchErrorDetail

Ein Element mit zusätzlichen Informationen, die in einer Azure Batch-Fehlerantwort enthalten sind.

Name	Typ	Beschreibung
key	string	Ein Bezeichner, der die Bedeutung der Value-Eigenschaft angibt.
value	string	Die zusätzlichen Informationen, die in der Fehlerantwort enthalten sind.

ComputeNodeIdentityReference

Der Verweis auf eine vom Benutzer zugewiesene Identität, die dem Batchpool zugeordnet ist, den ein Computeknoten verwendet.

Name	Typ	Beschreibung
resourceId	string	Die ARM-Ressourcen-ID der vom Benutzer zugewiesenen Identität.

ContainerHostBatchBindMountEntry

Der Eintrag des Pfad- und Bereitstellungsmodus, den Sie in Aufgabencontainer bereitstellen möchten.

Name	Typ	Beschreibung
isReadOnly	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.
source	ContainerHostDataPath	Der Pfad, der für containerkunden bereitgestellt werden kann.

ContainerHostDataPath

Die Pfade, die im Container der Containeraufgabe bereitgestellt werden.

Name	Typ	Beschreibung
Applications	string	Der Anwendungspfad.
JobPrep	string	Der Auftragsvorstellungsvorgangspfad.
Shared	string	Der Pfad für die Aufgabe mit mehreren Instanzen, um ihre Dateien freigegeben zu haben.
Startup	string	Der Pfad für die Startaufgabe.
Task	string	Der Vorgangspfad.
VfsMounts	string	Der Pfad enthält alle virtuellen Dateisysteme, die auf diesem Knoten bereitgestellt werden.

ContainerRegistry

Eine private Containerregistrierung.

Name	Typ	Beschreibung
identityReference	ComputeNodeIdentityReference	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. Der Verweis auf eine vom Benutzer zugewiesene Identität, die dem Batchpool zugeordnet ist, den ein Computeknoten verwendet.
password	string	Das Kennwort für die Anmeldung beim Registrierungsserver.
registryServer	string	Die Registrierungs-URL. Wenn nicht angegeben, lautet der Standardwert "docker.io".
username	string	Der Benutzername, der sich beim Registrierungsserver anmeldet.

ContainerWorkingDirectory

Der Speicherort des Arbeitsverzeichnisses für containeraufgaben.

Name	Typ	Beschreibung
containerImageDefault	string	Verwenden Sie das im Containerimage definierte Arbeitsverzeichnis. Achten Sie darauf, dass dieses Verzeichnis die von Batch heruntergeladenen Ressourcendateien nicht enthält.
taskWorkingDirectory	string	Verwenden Sie das standardmäßige Arbeitsverzeichnis "Batchdienstaufgaben", das die Vorgangsressourcendateien enthält, die von Batch aufgefüllt werden.

DependencyAction

Eine Aktion, die der Batchdienst für Aufgaben ausführt, die von dieser Aufgabe abhängig sind.

Name	Typ	Beschreibung
block	string	Blockiert Vorgänge, die auf diesen Vorgang warten, und verhindert, dass sie geplant werden.
satisfy	string	Erfüllen von Aufgaben, die auf diesen Vorgang warten; sobald alle Abhängigkeiten erfüllt sind, wird die Ausführung der Aufgabe geplant.

ElevationLevel

Die Höhe des Benutzers.

Name	Typ	Beschreibung
admin	string	Der Benutzer ist ein Benutzer mit erhöhtem Zugriff und arbeitet mit vollständigen Administratorberechtigungen.
nonadmin	string	Der Benutzer ist ein Standardbenutzer ohne erhöhten Zugriff.

EnvironmentSetting

Eine Umgebungsvariable, die für einen Vorgangsprozess festgelegt werden soll.

Name	Typ	Beschreibung
name	string	Der Name der Umgebungsvariable.
value	string	Der Wert der Umgebungsvariable.

ErrorMessage

Eine Fehlermeldung, die in einer Azure Batch-Fehlerantwort empfangen wurde.

Name	Typ	Beschreibung
lang	string	Der Sprachcode der Fehlermeldung
value	string	Der Text der Nachricht.

ExitCodeMapping

Wie der Batchdienst reagieren soll, wenn eine Aufgabe mit einem bestimmten Beendigungscode beendet wird.

Name	Typ	Beschreibung
code	integer	Ein Prozessausgangscode.
exitOptions	ExitOptions	Wie der Batchdienst reagieren soll, wenn der Vorgang mit diesem Beendigungscode beendet wird.

ExitCodeRangeMapping

Eine Reihe von Beendigungscodes und wie der Batchdienst auf Beendigungscodes innerhalb dieses Bereichs reagieren soll.

Name	Typ	Beschreibung
end	integer	Der letzte Ausgangscode im Bereich.
exitOptions	ExitOptions	Wie der Batchdienst reagieren soll, wenn der Vorgang mit einem Ausgangscode im Bereich endet (einschließlich).
start	integer	Der erste Ausgangscode im Bereich.

ExitConditions

Gibt an, wie der Batchdienst reagieren soll, wenn die Aufgabe abgeschlossen ist.

Name	Typ	Beschreibung
default	ExitOptions	Wie der Batchdienst reagieren soll, wenn der Vorgang mit einer Beendigungsbedingung fehlschlägt, die von keiner der anderen Eigenschaften abgedeckt wird. Dieser Wert wird verwendet, wenn der Task mit einem nichtzero-Beendigungscode beendet wird, der nicht in der exitCodes- oder exitCodeRanges-Auflistung aufgeführt ist, mit einem Vorverarbeitungsfehler, wenn die PreProcessingError-Eigenschaft nicht vorhanden ist, oder mit einem Dateiuploadfehler, wenn die FileUploadError-Eigenschaft nicht vorhanden ist. Wenn Sie ein nicht standardmäßiges Verhalten beim Beenden von Code 0 wünschen, müssen Sie es explizit mithilfe der exitCodes- oder exitCodeRanges-Auflistung auflisten.
exitCodeRanges	ExitCodeRangeMapping[]	Eine Liste der Aufgabenausgangscodebereiche und wie der Batchdienst darauf reagieren soll.
exitCodes	ExitCodeMapping[]	Eine Liste der einzelnen Aufgabenendecodes und derEn Reaktion des Batchdiensts.
fileUploadError	ExitOptions	Wie der Batchdienst reagieren soll, wenn ein Dateiuploadfehler auftritt. Wenn die Aufgabe mit einem Exitcode beendet wurde, der über exitCodes oder exitCodeRanges angegeben wurde und dann einen Dateiuploadfehler aufgetreten ist, hat die durch den Beendigungscode angegebene Aktion Vorrang.
preProcessingError	ExitOptions	Wie der Batchdienst reagieren soll, wenn die Aufgabe aufgrund eines Fehlers nicht gestartet werden kann.

ExitOptions

Gibt an, wie der Batchdienst auf eine bestimmte Beendigungsbedingung reagiert.

Name	Typ	Beschreibung
dependencyAction	DependencyAction	Eine Aktion, die der Batchdienst für Aufgaben ausführt, die von dieser Aufgabe abhängig sind. Mögliche Werte sind "erfüllen" (sodass abhängige Vorgänge ausgeführt werden können) und "Blockieren" (abhängige Vorgänge warten weiterhin). Batch unterstützt den Abbruch abhängiger Vorgänge noch nicht.
jobAction	JobAction	Eine Aktion, die für den Auftrag ausgeführt werden soll, der die Aufgabe enthält, wenn die Aufgabe mit der angegebenen Beendigungsbedingung abgeschlossen wird und die OnTaskFailed-Eigenschaft "performExitOptionsJobAction" lautet. Der Standardwert ist keine für Exitcode 0 und wird für alle anderen Beendigungsbedingungen beendet. Wenn die "onTaskFailed"-Eigenschaft des Auftrags keine Aktion ist, gibt die Angabe dieser Eigenschaft einen Fehler zurück, und die Add-Task-Anforderung schlägt mit einem ungültigen Eigenschaftswertfehler fehl. wenn Sie die REST-API direkt aufrufen, lautet der HTTP-Statuscode 400 (Ungültige Anforderung).

HttpHeader

Ein HTTP-Headernamen-Wert-Paar

Name	Typ	Beschreibung
name	string	Der Name der Kopfzeile, die beim Hochladen von Ausgabedateien verwendet werden soll, wobei die Groß-/Kleinschreibung nicht beachtet wird.
value	string	Der Wert des Headers, der beim Hochladen von Ausgabedateien verwendet werden soll

JobAction

Eine Aktion, die für den Auftrag ausgeführt werden soll, der die Aufgabe enthält, wenn die Aufgabe mit der angegebenen Beendigungsbedingung abgeschlossen wird und die OnTaskFailed-Eigenschaft "performExitOptionsJobAction" lautet.

Name	Typ	Beschreibung
disable	string	Deaktivieren Sie den Auftrag. Dies entspricht dem Aufrufen der Deaktivierungsauftrags-API mit einem disableTasks-Wert von "requeue".
none	string	Ergreifen Sie keine Aktion.
terminate	string	Beenden Sie den Auftrag. Der terminateReason in der Ausführungsinfo des Auftrags wird auf "TaskFailed" festgelegt.

MultiInstanceSettings

Einstellungen, die angeben, wie eine Aufgabe mit mehreren Instanzen ausgeführt werden soll.

Name	Typ	Beschreibung
commonResourceFiles	ResourceFile[]	Eine Liste der Dateien, die der Batchdienst herunterladen wird, bevor die Koordinationsbefehlszeile ausgeführt wird. Der Unterschied zwischen allgemeinen Ressourcendateien und Vorgangsressourcendateien besteht darin, dass allgemeine Ressourcendateien für alle Teilvorgänge einschließlich der primären Vorgänge heruntergeladen werden, während Vorgangsressourcendateien nur für die primäre Datei heruntergeladen werden. Beachten Sie außerdem, dass diese Ressourcendateien nicht in das Arbeitsverzeichnis "Vorgang" heruntergeladen werden, sondern stattdessen in das Stammverzeichnis "Task" (ein Verzeichnis über dem Arbeitsverzeichnis) heruntergeladen werden. 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.
coordinationCommandLine	string	Die Befehlszeile, die auf allen Computeknoten ausgeführt werden soll, damit sie koordiniert werden können, wenn die primäre Aufgabe ausgeführt wird. Eine typische Koordinations-Befehlszeile startet einen Hintergrunddienst und überprüft, ob der Dienst bereit ist, Knotenübergreifende Nachrichten zu verarbeiten.
numberOfInstances	integer	Die Anzahl der Computeknoten, die für den Vorgang erforderlich sind. Wenn nicht angegeben, ist der Standardwert 1.

OutputFile

Eine Spezifikation zum Hochladen von Dateien von einem Azure Batch Compute Node an einen anderen Speicherort, nachdem der Batchdienst die Ausführung des Aufgabenvorgangs abgeschlossen hat.

Name	Typ	Beschreibung
destination	OutputFileDestination	Das Ziel für die Ausgabedatei(n).
filePattern	string	Ein Muster, das angibt, welche Datei(en) hochgeladen werden soll. Sowohl relative als auch absolute Pfade werden unterstützt. Relative Pfade sind relativ zum Arbeitsverzeichnis "Aufgabe". Die folgenden Wildcards werden unterstützt: * entspricht 0 oder mehr Zeichen (z. B. Muster abc* würde abc oder abcdef entsprechen), ** entspricht einem verzeichnis, ? entspricht einem einzelnen Zeichen, [abc] entspricht einem Zeichen in den Klammern, und [a-c] entspricht einem Zeichen im Bereich. Klammern können eine Negation enthalten, um einem zeichen nicht angegebenen Zeichen zu entsprechen (z. B. [!abc] entspricht einem beliebigen Zeichen, aber a, b oder c). Wenn ein Dateiname mit "." beginnt, wird er standardmäßig ignoriert, kann aber durch explizite Angabe übereinstimmen (z. B. .gif stimmt nicht mit .a.gifüberein, sondern ..gif). Ein einfaches Beispiel: ***.txt entspricht jeder Datei, die nicht in "." beginnt und mit .txt im Arbeitsverzeichnis "Aufgabe" oder einem beliebigen Unterverzeichnis endet. Wenn der Dateiname ein Wildcardzeichen enthält, kann es mithilfe von Klammern escapet werden (z. B. abc[] entspricht einer Datei namens abc). Beachten Sie, dass sowohl \ als auch / werden als Verzeichnistrennzeichen unter Windows behandelt, aber nur / ist unter Linux. Umgebungsvariablen (%var% unter Windows oder $var unter Linux) werden vor der Anwendung des Musters erweitert.
uploadOptions	OutputFileUploadOptions	Zusätzliche Optionen für den Uploadvorgang, einschließlich der Bedingungen, unter denen der Upload ausgeführt werden soll.

OutputFileBlobContainerDestination

Gibt ein Dateiuploadziel in einem Azure Blob Storage-Container an.

Name	Typ	Beschreibung
containerUrl	string	Die URL des Containers in Azure Blob Storage, in den die Datei(en) hochgeladen werden soll. Wenn keine verwaltete Identität verwendet wird, muss die URL eine SAS (Shared Access Signature) enthalten, die Schreibberechtigungen für den Container gewährt.
identityReference	ComputeNodeIdentityReference	Der Verweis auf die vom Benutzer zugewiesene Identität für den Zugriff auf Azure Blob Storage, der durch containerUrl angegeben wird Die Identität muss Schreibzugriff auf den Azure Blob Storage-Container haben.
path	string	Das Ziel-BLOB oder virtuelle Verzeichnis im Azure Storage-Container. Wenn filePattern auf eine bestimmte Datei verweist (d. h. keine Wildcards enthält), ist der Pfad der Name des Blobs, in das diese Datei hochgeladen werden soll. Wenn FilePattern einen oder mehrere Wildcards enthält (und daher mit mehreren Dateien übereinstimmen kann), ist der Pfad der Name des virtuellen Blob-Verzeichnisses (das jedem Blobnamen vorangestellt ist), in den die Datei(n) hochgeladen werden soll. Wenn sie weggelassen werden, werden Die Dateien in das Stammverzeichnis des Containers hochgeladen, wobei ein BLOB-Name mit ihrem Dateinamen übereinstimmen soll.
uploadHeaders	HttpHeader[]	Eine Liste von Namen-Wert-Paaren für Kopfzeilen, die beim Hochladen von Ausgabedateien verwendet werden sollen Diese Header werden beim Hochladen von Dateien in Azure Storage angegeben. Offizielles Dokument für zulässige Kopfzeilen beim Hochladen von Blobs: https://learn.microsoft.com/rest/api/storageservices/put-blob#request-headers-all-blob-types

OutputFileDestination

Das Ziel, in das eine Datei hochgeladen werden soll.

Name	Typ	Beschreibung
container	OutputFileBlobContainerDestination	Ein Speicherort im Azure Blob Storage, in den Dateien hochgeladen werden.

OutputFileUploadCondition

Die Bedingungen, unter denen eine Aufgabenausgabedatei oder eine Gruppe von Dateien hochgeladen werden soll.

Name	Typ	Beschreibung
taskcompletion	string	Laden Sie die Dateien nach dem Beenden des Aufgabenvorgangs hoch, unabhängig davon, was der Ausgangscode war.
taskfailure	string	Laden Sie die Datei(n) erst hoch, nachdem der Vorgangsvorgang mit einem Nichtzero-Ausgangscode beendet wurde.
tasksuccess	string	Laden Sie die Datei(n) erst hoch, nachdem der Vorgangsvorgang mit einem Exitcode von 0 beendet wurde.

OutputFileUploadOptions

Details zu einem Uploadvorgang einer Ausgabedatei, einschließlich der Bedingungen, unter denen der Upload ausgeführt werden soll.

Name	Typ	Beschreibung
uploadCondition	OutputFileUploadCondition	Die Bedingungen, unter denen die Task-Ausgabedatei oder -gruppe von Dateien hochgeladen werden soll. Der Standardwert ist "taskcompletion".

ResourceFile

Eine einzelne Datei oder mehrere Dateien, die in einen Computeknoten heruntergeladen werden sollen.

Name	Typ	Beschreibung
autoStorageContainerName	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.
blobPrefix	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.
fileMode	string	Das Attribut für den Dateiberechtigungsmodus im oktalen Format. Diese Eigenschaft gilt nur für Dateien, die auf Linux-Computeknoten heruntergeladen werden. Sie wird ignoriert, wenn sie für eine resourceFile angegeben wird, die in einen Windows Compute Node heruntergeladen wird. Wenn diese Eigenschaft für einen Linux-Computeknoten nicht angegeben ist, wird auf die Datei ein Standardwert von 0770 angewendet.
filePath	string	Der Speicherort auf dem Computeknoten, in den die Datei(n) heruntergeladen werden soll, relativ zum Arbeitsverzeichnis der Aufgabe. 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 des Vorgangs (z. B. mithilfe von '.') herausbrechen.
httpUrl	string	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.
identityReference	ComputeNodeIdentityReference	Der Verweis auf die vom Benutzer zugewiesene Identität für den Zugriff auf Azure Blob Storage, der durch "storageContainerUrl" oder "httpUrl" angegeben wird Der Verweis auf eine vom Benutzer zugewiesene Identität, die dem Batchpool zugeordnet ist, den ein Computeknoten verwendet.
storageContainerUrl	string	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.

TaskAddCollectionParameter

Eine Sammlung von hinzuzufügenden Azure-Batchaufgaben.

Name	Typ	Beschreibung
value	TaskAddParameter[]	Die Hinzuzufügende Sammlung von Tasks. Die maximale Anzahl von Vorgängen beträgt 100. Die serialisierte Gesamtgröße dieser Auflistung muss kleiner als 1 MB sein. Wenn sie größer als 1 MB ist (z. B. wenn jeder Vorgang über 100 Ressourcendateien oder Umgebungsvariablen verfügt), schlägt die Anforderung mit dem Code 'RequestBodyTooLarge' fehl und sollte erneut mit weniger Vorgängen wiederholt werden.

TaskAddCollectionResult

Das Ergebnis des Hinzufügens einer Sammlung von Aufgaben zu einem Auftrag.

Name	Typ	Beschreibung
value	TaskAddResult[]	Die Ergebnisse des Vorgangs zum Hinzufügen der Aufgabenauflistung.

TaskAddParameter

Eine hinzuzufügende Azure-Batchaufgabe.

Name	Typ	Beschreibung
affinityInfo	AffinityInformation	Ein Gebietsschemahinweis, der vom Batchdienst verwendet werden kann, um einen Computeknoten auszuwählen, auf dem die neue Aufgabe gestartet werden soll.
applicationPackageReferences	ApplicationPackageReference[]	Eine Liste der Pakete, die der Batchdienst vor dem Ausführen der Befehlszeile auf dem Computeknoten bereitstellen wird. Anwendungspakete werden heruntergeladen und in ein freigegebenes Verzeichnis bereitgestellt, nicht das Arbeitsverzeichnis "Aufgabe". Wenn sich daher ein referenziertes Paket bereits im Knoten befindet und auf dem neuesten Stand ist, wird es nicht erneut heruntergeladen. die vorhandene Kopie auf dem Computeknoten verwendet wird. Wenn ein referenziertes Paket nicht installiert werden kann, z. B. weil das Paket gelöscht wurde oder weil der Download fehlgeschlagen ist, schlägt die Aufgabe fehl.
authenticationTokenSettings	AuthenticationTokenSettings	Die Einstellungen für ein Authentifizierungstoken, das von der Aufgabe zum Ausführen von Batchdienstvorgängen verwendet werden kann. Wenn diese Eigenschaft festgelegt ist, stellt der Batchdienst die Aufgabe mit einem Authentifizierungstoken bereit, das zum Authentifizieren von Batchdienstvorgängen verwendet werden kann, ohne dass ein Kontozugriffsschlüssel erforderlich ist. Das Token wird über die AZ_BATCH_AUTHENTICATION_TOKEN Umgebungsvariable bereitgestellt. Die Vorgänge, die die Aufgabe mit dem Token ausführen kann, sind von den Einstellungen abhängig. Beispielsweise kann eine Aufgabe Auftragsberechtigungen anfordern, um dem Auftrag weitere Aufgaben hinzuzufügen, oder den Status des Auftrags oder anderer Aufgaben unter dem Auftrag zu überprüfen.
commandLine	string	Die Befehlszeile der Aufgabe. Bei Aufgaben mit mehreren Instanzen wird die Befehlszeile als primäre Aufgabe ausgeführt, nachdem die primäre Aufgabe und alle Teilvorgänge die Ausführung der Koordinations-Befehlszeile abgeschlossen 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://learn.microsoft.com/azure/batch/batch-compute-node-environment-variables) verwenden.
constraints	TaskConstraints	Die Ausführungseinschränkungen, die für diesen Vorgang gelten. Wenn Sie keine Einschränkungen angeben, ist maxTaskRetryCount das für den Auftrag angegebene maxTaskRetryCount, die maxWallClockTime ist unendlich, und die Aufbewahrungszeit beträgt 7 Tage.
containerSettings	TaskContainerSettings	Die Einstellungen für den Container, unter dem die Aufgabe ausgeführt wird. Wenn der Pool, der diese Aufgabe ausführt, containerConfiguration festgelegt ist, muss dies ebenfalls festgelegt werden. Wenn der Pool, der diese Aufgabe ausführt, keinen containerConfiguration-Satz aufweist, darf dies nicht festgelegt werden. Wenn dies angegeben wird, werden alle Verzeichnisse rekursiv unterhalb der AZ_BATCH_NODE_ROOT_DIR (der Stamm von Azure Batchverzeichnissen auf dem Knoten) dem Container zugeordnet, alle Taskumgebungsvariablen werden dem Container zugeordnet, und die Task-Befehlszeile wird im Container ausgeführt. Dateien, die im Container außerhalb von AZ_BATCH_NODE_ROOT_DIR erstellt wurden, werden möglicherweise nicht auf den Hostdatenträger wiedergegeben, was bedeutet, dass Batchdatei-APIs nicht auf diese Dateien zugreifen können.
dependsOn	TaskDependencies	Die Vorgänge, von denen dieser Vorgang abhängt. Dieser Vorgang wird erst geplant, wenn alle Vorgänge, von denen er abhängt, erfolgreich abgeschlossen wurden. Wenn eine dieser Vorgänge fehlschlägt und die Wiederholungsanzahl ausschöpfen kann, wird dieser Vorgang nie geplant. Wenn der Auftrag "TaskDependencies" nicht auf "true" festgelegt hat und dieses Element vorhanden ist, schlägt die Anforderung mit dem Fehlercode TaskDependenciesNotSpecifiedOnJob fehl.
displayName	string	Ein Anzeigename für den Vorgang. Der Anzeigename muss nicht eindeutig sein und kann alle Unicode-Zeichen bis zu einer maximalen Länge von 1024 enthalten.
environmentSettings	EnvironmentSetting[]	Eine Liste der Umgebungsvariableneinstellungen für die Aufgabe.
exitConditions	ExitConditions	Gibt an, wie der Batchdienst reagieren soll, wenn die Aufgabe abgeschlossen ist. Wie der Batchdienst reagieren soll, wenn die Aufgabe abgeschlossen ist.
id	string	Eine Zeichenfolge, 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. Bei der ID wird die Groß-/Kleinschreibung beibehalten und die Groß-/Kleinschreibung nicht beachtet (d. h., Sie haben möglicherweise keine zwei IDs innerhalb eines Auftrags, die sich nur nach Groß-/Kleinschreibung unterscheiden).
multiInstanceSettings	MultiInstanceSettings	Ein Objekt, das angibt, dass die Aufgabe eine aufgabe mit mehreren Instanzen ist, und enthält Informationen zum Ausführen der Aufgabe mit mehreren Instanzen. Aufgaben mit mehreren Instanzen werden häufig zur Unterstützung von MPI-Aufgaben verwendet. Wenn eines der Teilvorgänge fehlschlägt (z. B. aufgrund des Beendens mit einem Nicht-Null-Ausgangscode), schlägt im MPI-Fall der gesamte Vorgang mit mehreren Instanzen fehl. Der Vorgang mit mehreren Instanzen wird dann bis zum Wiederholungsgrenzwert beendet und erneut versucht.
outputFiles	OutputFile[]	Eine Liste der Dateien, die der Batchdienst nach dem Ausführen der Befehlszeile vom Computeknoten hochladen wird. Bei Aufgaben mit mehreren Instanzen werden die Dateien nur aus dem Computeknoten hochgeladen, auf dem die primäre Aufgabe ausgeführt wird.
requiredSlots	integer	Die Anzahl der Zeitplanungsplätze, die der auszuführende Vorgang benötigt. Der Standardwert ist 1. Eine Aufgabe kann nur für die Ausführung auf einem Computeknoten geplant werden, wenn der Knoten über genügend freie Planungsplätze verfügt. Bei Aufgaben mit mehreren Instanzen muss dies 1 sein.
resourceFiles	ResourceFile[]	Eine Liste der Dateien, die der Batchdienst vor dem Ausführen der Befehlszeile auf den Computeknoten herunterladen wird. Bei Vorgängen mit mehreren Instanzen werden die Ressourcendateien nur auf den Computeknoten heruntergeladen, auf dem der primäre Vorgang 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.
userIdentity	UserIdentity	Die Benutzeridentität, unter der die Aufgabe ausgeführt wird. Wenn dies nicht angegeben wird, wird die Aufgabe als nicht administrativer Benutzer ausgeführt, der für die Aufgabe eindeutig ist.

TaskAddResult

Ergebnis für einen einzelnen Vorgang, der als Teil eines Vorgangs zum Hinzufügen einer Aufgabenauflistung hinzugefügt wurde.

Name	Typ	Beschreibung
eTag	string	Das ETag des Vorgangs, wenn die Aufgabe erfolgreich hinzugefügt wurde. Sie können dies verwenden, um zu erkennen, ob sich die Aufgabe zwischen Anforderungen geändert hat. Insbesondere können Sie das ETag mit einer Aktualisierungsaufgabe-Anforderung übergeben, um anzugeben, dass Ihre Änderungen nur wirksam werden sollen, wenn niemand sonst den Auftrag in der Zwischenzeit geändert hat.
error	BatchError	Fehler beim Hinzufügen der Aufgabe.
lastModified	string	Der Zeitpunkt der letzten Änderung des Vorgangs.
location	string	Die URL der Aufgabe, wenn die Aufgabe erfolgreich hinzugefügt wurde.
status	TaskAddStatus	Der Status der Aufgabenanforderung hinzufügen.
taskId	string	Die ID des Vorgangs, für den dies das Ergebnis ist.

TaskAddStatus

Der Status der Aufgabenanforderung hinzufügen.

Name	Typ	Beschreibung
clienterror	string	Die Aufgabe konnte aufgrund eines Clientfehlers nicht hinzugefügt werden und sollte nicht erneut versucht werden, ohne die Anforderung entsprechend zu ändern.
servererror	string	Die Aufgabe konnte aufgrund eines Serverfehlers nicht hinzugefügt werden und kann ohne Änderung wiederholt werden.
success	string	Die Aufgabe wurde erfolgreich hinzugefügt.

TaskConstraints

Ausführungseinschränkungen, die auf einen Vorgang angewendet werden sollen.

Name	Typ	Beschreibung
maxTaskRetryCount	integer	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 die Anzahl der Wiederholungen für die ausführbare Aufgabe aufgrund eines Nichtzero-Beendigungscodes 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, versucht der Batchdienst den Vorgang 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).
maxWallClockTime	string	Die maximale verstrichene Zeit, die der Vorgang ausführen kann, gemessen von dem Zeitpunkt, zu dem der Vorgang gestartet wird. Wenn der Vorgang nicht innerhalb des Zeitlimits abgeschlossen wird, beendet der Batchdienst ihn. Wenn dies nicht angegeben ist, gibt es kein Zeitlimit für die Dauer der Ausführung des Vorgangs.
retentionTime	string	Die minimale Zeit, um das Aufgabenverzeichnis auf dem Computeknoten beizubehalten, in dem er ausgeführt wurde, ab dem Zeitpunkt, zu dem die Ausführung abgeschlossen ist. Nach diesem Zeitpunkt kann der Batchdienst das Aufgabenverzeichnis und alle zugehörigen Inhalte löschen. Der Standardwert ist 7 Tage, d. h. das Aufgabenverzeichnis wird 7 Tage lang aufbewahrt, es sei denn, der Computeknoten wird entfernt oder der Auftrag gelöscht.

TaskContainerSettings

Die Containereinstellungen für eine Aufgabe.

Name	Typ	Beschreibung
containerHostBatchBindMounts	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.
containerRunOptions	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.
imageName	string	Das Image, das zum Erstellen des Containers verwendet werden soll, in dem die Aufgabe ausgeführt wird. Dies ist der vollständige Imageverweis, wie für "Docker Pull" angegeben. Wenn kein Tag als Teil des Bildnamens angegeben wird, wird das Tag ":latest" als Standard verwendet.
registry	ContainerRegistry	Die private Registrierung, die das Containerimage enthält. Diese Einstellung kann weggelassen werden, wenn sie bereits bei der Poolerstellung bereitgestellt wurde.
workingDirectory	ContainerWorkingDirectory	Der Speicherort des Arbeitsverzeichnisses für containeraufgaben. Der Standardwert ist "taskWorkingDirectory".

TaskDependencies

Gibt alle Abhängigkeiten eines Vorgangs an. Alle Vorgänge, die explizit oder innerhalb eines Abhängigkeitsbereichs angegeben sind, müssen abgeschlossen werden, bevor der abhängige Vorgang geplant wird.

Name	Typ	Beschreibung
taskIdRanges	TaskIdRange[]	Die Liste der Aufgaben-ID-Bereiche, von denen dieser Vorgang abhängt. Alle Vorgänge in allen Bereichen müssen erfolgreich abgeschlossen werden, bevor der abhängige Vorgang geplant werden kann.
taskIds	string[]	Die Liste der Aufgaben-IDs, von denen diese Aufgabe abhängt. Alle Vorgänge in dieser Liste müssen erfolgreich abgeschlossen werden, bevor der abhängige Vorgang geplant werden kann. Die TaskIds-Auflistung ist auf 64000 Zeichen beschränkt (d. h. die kombinierte Länge aller Vorgangs-IDs). Wenn die taskIds-Auflistung die maximale Länge überschreitet, schlägt die Add-Task-Anforderung mit dem Fehlercode TaskDependencyListTooLong fehl. In diesem Fall sollten Sie stattdessen Aufgaben-ID-Bereiche verwenden.

TaskIdRange

Ein Bereich von Vorgangs-IDs, von denen ein Vorgang abhängig sein kann. Alle Vorgänge mit IDs im Bereich müssen erfolgreich abgeschlossen werden, bevor der abhängige Vorgang geplant werden kann.

Name	Typ	Beschreibung
end	integer	Die letzte Vorgangs-ID im Bereich.
start	integer	Die erste Vorgangs-ID im Bereich.

UserIdentity

Die Definition der Benutzeridentität, unter der die Aufgabe ausgeführt wird.

Name	Typ	Beschreibung
autoUser	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.
username	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.