Freigeben über

Versionsverwaltung für Batch-Dienst-REST-API

  • Artikel

Vorgänge, die von der Batch-Dienst-REST-API bereitgestellt werden, haben zur Abwärtskompatibilität möglicherweise mehrere Versionen, da die API nach und nach weiterentwickelt wird. Sie müssen angeben, welche Version eines Vorgangs Sie bei dessen Aufruf verwenden möchten. Dazu geben Sie die Version mit dem REST-Aufruf an. Wenn Ihre Anwendung eine frühere Version eines Vorgangs aufruft, können Sie das Aufrufen der früheren Version fortsetzen, oder Sie ändern den Code für den Aufruf einer neueren Version. Wenn die Version nicht angegeben oder eine falsche Version angegeben wird, wird ein Fehler zurückgegeben.

Um anzugeben, welche Version eines Vorgangs verwendet werden soll, legen Sie den Api-version-Abfrageparameter fest. Die Version hat das Format Gruppe.Hauptversion.Nebenversion, wobei Gruppe im Format 'JJJJ-MM-TTT' vorliegt und Hauptversion sowie Nebenversion ganze Zahlen sind.

Neueste Version: 2023-05-01.17.0

  • [Breaking] Batchauftrag/Pool-Lebensdauerstatistik-API entfernt: lifetimejobstats und lifetimepoolstats.
  • Boolesche Eigenschaft enableAcceleratedNetworking hinzugefügt.NetworkConfiguration
    • Diese Eigenschaft bestimmt, ob dieser Pool beschleunigte Netzwerke mit dem Standardwert False aktivieren soll.
    • Ob dieses Feature aktiviert werden kann, hängt auch davon ab, ob ein Betriebssystem/vm-instance unterstützt wird. Dies sollte mit der AcceleratedNetworking-Richtlinie übereinstimmen.
  • Boolesche Eigenschaft enableAutomaticUpgrade hinzugefügt.VMExtension
    • Diese Eigenschaft bestimmt, ob die Erweiterung automatisch von der Plattform aktualisiert werden soll, wenn eine neuere Version der Erweiterung verfügbar ist.
  • Die -Eigenschaft type von ContainerConfiguration, die jetzt zwei Werte unterstützt: DockerCompatible und CriCompatible.

Frühere Versionen

Frühere Versionen umfassen:

Version: 2022-10-01.16.0

  • Neue NodeCommunicationMode Eigenschaft hinzugefügt, die bestimmt, wie ein Pool mit dem Batch-Dienst kommuniziert
  • Dem Modell wurde eine neue currentNodeCommunicationMode Eigenschaft des NodeCommunicationMode Typs CloudPool hinzugefügt, um auf den aktuellen Zustand des Poolkommunikationsmodus zu verweisen.
  • Den folgenden Modellen wurde eine neue targetNodeCommunicationMode Eigenschaft des NodeCommunicationMode Typs hinzugefügt, um auf den gewünschten Knotenkommunikationsmodus für den Pool zu verweisen:

Version: 2022-01-01.15.0

Version: 2021-06-01.14.0

  • Hinzufügen der Möglichkeit zum Zuweisen benutzerseitig zugewiesener verwalteter Identitäten zu CloudPool. Diese Identitäten werden auf jedem Knoten im Pool verfügbar gemacht und können für den Zugriff auf verschiedene Ressourcen verwendet werden.
  • Eigenschaft zu den folgenden Modellen hinzugefügt identityReference , um den Zugriff auf Ressourcen über eine verwaltete Identität zu unterstützen:
  • Neue extensions Eigenschaft zu VirtualMachineConfiguration hinzugefügt, CloudPool um VM-Erweiterungen für Knoten anzugeben
  • Die Möglichkeit zum Angeben von Verfügbarkeitszonen mithilfe einer neuen Eigenschaft nodePlacementConfiguration in VirtualMachineConfiguration wurde hinzugefügt.
  • VirtualMachineConfiguration wurde eine neue osDisk Eigenschaft hinzugefügt, die Einstellungen für den Betriebssystemdatenträger des virtuellen Computers enthält.
    • Die placement Eigenschaft on DiffDiskSettings gibt die kurzlebige Datenträgerplatzierung für Betriebssystemdatenträger für alle VMs im Pool an. Wenn Sie ihn auf "CacheDisk" festlegen, wird der kurzlebige Betriebssystemdatenträger im VM-Cache gespeichert.
  • Eigenschaft für CloudJob hinzugefügtmaxParallelTasks, um die maximale Anzahl von Aufgaben zu steuern, die gleichzeitig pro Auftrag ausgeführt werden können (Standardwert ist "-1", was "unbegrenzt" bedeutet). Diese Eigenschaft befindet sich derzeit in der privaten Vorschau.
  • Eigenschaft hinzugefügt virtualMachineInfo , die ComputeNode Informationen zum aktuellen Zustand des virtuellen Computers enthält, einschließlich der genauen Version des Marketplace-Images, das der virtuelle Computer verwendet.
  • Eigenschaft hinzugefügt recurrenceInterval , um Schedule das Intervall zwischen den Startzeiten von zwei aufeinanderfolgenden Aufträgen unter einem Auftragszeitplan zu steuern.

Version: 2020-09-01.12.0

  • [Breaking] Eigenschaft maxTasksPerNode durch taskSlotsPerNode für den Pool ersetzt. Die Verwendung dieser Eigenschaftenaufgaben in einem Auftrag kann eine dynamische Anzahl von Slots beanspruchen, die eine präzisere Kontrolle des Ressourcenverbrauchs ermöglichen.
  • [Breaking] Der Antworttyp von GetTaskCounts wurde geändert, um zurückzugeben TaskCountsResult, wobei es sich um ein komplexes Objekt handelt, das das vorherige TaskCounts Objekt und ein neues TaskSlotCounts Objekt enthält, das ähnliche Informationen im Kontext der verwendeten Slots bereitstellt.
  • Der Aufgabe wurde eine Eigenschaft requiredSlots hinzugefügt, die es dem Benutzer ermöglicht, anzugeben, wie viele Slots auf einem Knoten er einnehmen soll.

Version: 2020-03-01.11.0

Version: 2019-08-01.10.0

  • Die Möglichkeit zum Angeben einer Sammlung öffentlicher IP-Adressen für NetworkConfiguration über die neue publicIPs Eigenschaft im Pool wurde hinzugefügt. Dadurch wird sichergestellt, dass Knoten im Pool über eine IP-Adresse aus den vom Listenbenutzer bereitgestellten IP-Adressen verfügen.
  • Die Möglichkeit zum Einbinden von Remotedateisystemen auf jedem Knoten eines Pools über die MountConfiguration -Eigenschaft wurde hinzugefügt.
  • Shared Image Gallery Images können nun für die virtualMachineImageId -Eigenschaft von angegeben werden, ImageReference indem sie über die Azure-Resource Manager-ID auf das Image verweisen.
  • [Breaking] Wenn nicht angegeben, ist true der Standardwert für waitForSuccess on StartTask (zuvor war falseer ).
  • [Breaking] Wenn er nicht angegeben ist, ist der Standardwert für scope on jetzt immer Pool (zuvor war Task er auf Windows-Knoten und Pool auf AutoUserSpecification Linux-Knoten).
  • Verschiedene verwirrende oder unvollständige Dokumente wurden verbessert.

Version: 2019-06-01.9.0

  • [Breaking] Ersetzt ListNodeAgentSKUs durch ListSupportedImages. ListSupportedImages enthält alle informationen, die ursprünglich in ListNodeAgentSKUs , aber in einem klareren Format verfügbar waren. Neue, nicht überprüfte Bilder werden jetzt auch zurückgegeben. Zusätzliche Informationen zu Capabilities und BatchSupportEndOfLife sind über ImageInformationzugänglich.

  • Unterstützt jetzt Netzwerksicherheitsregeln, die den Netzwerkzugriff auf eine CloudPool basierend auf dem Quellport des Datenverkehrs blockieren. Dies erfolgt über die SourcePortRanges-Eigenschaft unter NetworkSecurityGroupRule.

  • Bei der Ausführung eines Containers unterstützt Batch jetzt die Ausführung der Aufgabe im Arbeitsverzeichnis des Containers bzw. im Arbeitsverzeichnis der Batch-Aufgabe. Dies wird mit der WorkingDirectory-Eigenschaft unter TaskContainerSettings gesteuert.

  • Verschiedene verwirrende oder unvollständige Dokumente wurden verbessert.

Version: 2018-12-01.8.0

  • [Breaking] Unterstützung für für upgradeos Pools cloudServiceConfiguration wurde entfernt.

    • upgradeos wurde entfernt.
    • Umbenannt targetOSVersion in osVersion und entfernt currentOSVersion in CloudPool.
    • upgrading aus PoolState entfernt.

  • [Breaking] Entfernt dataEgressGiB und dataIngressGiB aus poolusagemetrics. Diese Eigenschaften werden nicht mehr unterstützt.

  • [Breaking]ResourceFile Verbesserungen

    • Die Möglichkeit zum Angeben eines gesamten Azure Storage-Containers in ResourceFile wurde hinzugefügt. Für ResourceFile werden jetzt drei Modi unterstützt:
      • httpUrl erstellt eine ResourceFile , die auf eine einzelne HTTP-URL verweist.
      • storageContainerUrlerstellt einenResourceFile, der auf einen Azure Blob Storage Container zeigt.
      • autoStorageContainerNameerstellt einen ResourceFile , der auf einen Azure Blob Storage Container im von Batch registrierten AutoStorage-Konto zeigt.
    • UrLs, ResourceFile die für über die httpUrl -Methode bereitgestellt werden, können jetzt eine beliebige HTTP-URL sein. Zuvor musste es sich um eine Azure Blob Storage-URL handeln.
    • blobPrefix kann verwendet werden, um Downloads aus einem Speichercontainer nur auf diejenigen zu filtern, die dem Präfix entsprechen.

  • [Breaking] Eigenschaft aus VirtualMachineConfigurationentferntosDisk. Diese Eigenschaft wird nicht mehr unterstützt.

  • Pools, die auf dynamicVNetAssignmentScopeNetworkConfigurationjob "on" festlegen, können jetzt jedem Knoten dynamisch eine Virtual Network zuweisen, auf denen die Aufgaben des Auftrags ausgeführt werden. Die spezifische Virtual Network, mit der die Knoten verknüpft werden sollen, wird in der neuen JobNetworkConfiguration Eigenschaft für CloudJob und JobSpecificationangegeben.

    Hinweis

    Dieses Feature befindet sich in der Phase der öffentlichen Vorschau. Er ist für alle Batch-Konten deaktiviert, mit Ausnahme von Konten, die uns kontaktiert und angefordert haben, am Pilotprojekt teilzu sein.

  • Die maximale Lebensdauer eines Vorgangs beträgt jetzt 180 Tage (zuvor waren es 7).

  • Unterstützung für Windows-Pools zum Erstellen von Benutzern mit einem bestimmten Anmeldemodus (entweder batch oder interactive) über LoginModehinzugefügt.

  • Die Standardaufbewahrungszeit für Aufgaben beträgt jetzt 7 Tage, zuvor war sie unendlich.

Version 2018-08-01.7.0

Zu den neuen Features in Version 2018-08-01.7.0 gehören:

  • Zeigen Sie die Version des Azure Batch Node-Agents über die neue NodeAgentInfo-Eigenschaft auf ComputeNode an.
  • Die Möglichkeit zum Angeben eines für Filter einen Result Vorgang wurde hinzugefügt. Ausführlichere Informationen finden Sie hier.
    • Dies ermöglicht das häufig angeforderte Szenario der Ausführung einer serverseitigen Abfrage, um alle Aufgaben zu finden, die fehlgeschlagen sind.
  • [Breaking] Die -Eigenschaft wurde aus TaskCounts entferntValidationStatus.
  • [Breaking] Der Standardcachetyp für DataDisk und OSDisk ist jetzt ReadWrite anstelle von None.
  • [Breaking] Der einzige Wert von ContainerType von wurde in dockerdockerCompatibleumbenannt.

Version 2018-03-01.6.1

Zu den neuen Features in Version 2018-03-01.6.1 gehören:

  • Poolknotenanzahl nach Zustand: Diese Version fügt die Möglichkeit hinzu, die Anzahl der Poolknoten nach Zustand über den neuen ListPoolNodeCounts-Vorgang abzufragen . Dieser Vorgang bietet Ihnen die Möglichkeit, alle Pools in einem Batch-Konto nach Knotenzuständen abzufragen, einschließlich Erstellen, Leerlauf, Offline, vorzeitiger Entfernung, Neustarten, Reimaging, Starten und anderen.
  • Knoten-Agent-Protokolle: Diese Version bietet die Möglichkeit, Azure Batch Knoten-Agent-Protokolle von einem bestimmten Knoten über den UploadBatchServiceLogs-Vorgang hochzuladen. Dies ist für die Verwendung beim Debuggen durch Microsoft-Support vorgesehen, wenn Probleme auf einem Knoten auftreten.

Version 2017-09-01.6.0

  • Azure-Hybridnutzungsvorteil: Sie können jetzt Batch-Windows-VM-Pools erstellen, die angeben, dass die Azure Hybrid Use Benefit-Lizenzierung verwendet wird. Wenn diese Lizenzierung verwendet wird, wird ein Rabatt auf den VM-Preis angewendet. Verwenden Sie die neue LicenseType-Eigenschaft für VirtualMachineConfiguration.

  • Pool-VM-Datenträger: Sie können einen oder mehrere leere Datenträger an VM-Pools anfügen, indem Sie die neue Datenträgerkonfiguration verwenden, die Teil der Konfiguration des virtuellen Computers ist. Verwenden Sie die DataDisks-Eigenschaft für VirtualMachineConfiguration.

  • (Breaking Change) Benutzerdefinierte Images werden jetzt mithilfe von Azure Resource Manager-Imageressourcen anstelle von Blob-VHD-Dateien erstellt und bereitgestellt. Batch verwendet nun verwaltete Datenträger zum Erstellen der Pool-VMs und daher eine Imageressource . Es gibt jetzt keine Beschränkung für die Anzahl von VMs in einem Pool, der mit einem benutzerdefinierten Image erstellt wurde. Außerdem sind mehrere Kopien des VHD-Blobs für große Pools nicht mehr erforderlich. Benutzerdefinierte Imagepools sind daher viel einfacher zu erstellen und zu skalieren. Weitere Informationen finden Sie unter Verwenden eines benutzerdefinierten Images zum Erstellen eines VM-Pools.

  • (Breaking Change) Aufgaben mit mehreren instance (erstellt mit MultiInstanceSettings) müssen jetzt CoordinationCommandLine angeben, und NumberOfInstances ist jetzt optional und standardmäßig 1.

  • Unterstützung für Aufgaben, die mithilfe von Docker-Containern ausgeführt werden, wurde hinzugefügt. Um eine Aufgabe mit einem Docker-Container auszuführen, müssen Sie eine ContainerConfiguration für die VirtualMachineConfiguration für einen Pool angeben und dann TaskContainerSettings zum Task hinzufügen.

Version 2017-06-01.5.1

Die hier beschriebene Version der Batch-API ist 2017-06-01.5.1. Es wird empfohlen, nach Möglichkeit die neueste Version zu verwenden.

Zu den neuen Features in Version 2017-06-01.5.1 gehören:

  • Unterstützung für effiziente Aufgabenzählungen über den neuen Vorgang "Vorgangsanzahl abrufen ". Durch Aufrufen des Vorgangs Get Task Count (Vorgang abrufen) können Sie die Anzahl der aktiven, ausgeführten und abgeschlossenen Aufgaben sowie der erfolgreichen oder fehlgeschlagenen Aufgaben abrufen. Weitere Informationen finden Sie unter Count tasks by state to monitor a job's progress (Preview) (Zählen von Aufgaben nach Zustand zur Überwachung des Auftragsstatus (Vorschau)).
  • Unterstützung für die Angabe eingehender Endpunkte auf Poolcomputeknoten über die neue poolEndpointConfiguration-Eigenschaft . Durch Festlegen dieser Eigenschaft können Sie bestimmte Ports auf dem Knoten extern adressiert.

Version 2017-05-01.5.0

In den folgenden Abschnitten werden neue und geänderte Features in Version 2017-05-01.5.0 beschrieben.

Wichtig

Version 2017-05-01.5.0 enthält mehrere Breaking Changes. Überprüfen Sie die unten aufgeführten Breaking Changes, und aktualisieren Sie Ihren Code, um Version 2017-05-01.5.0 aufzurufen.

Computeknoten mit niedriger Priorität

Azure Batch bietet jetzt Computeknoten mit niedriger Priorität, um die Kosten für Batch-Workloads zu senken. Durch VMs mit niedriger Priorität werden neue Typen von Batch-Workloads möglich, indem eine große Menge an Computeleistung bereitgestellt wird, die gleichzeitig wirtschaftlich ist.

Es gibt mehrere Änderungen an der REST-API für Knoten mit niedriger Priorität:

  • (Breaking Change) Die Eigenschaften targetDedicated und currentDedicated einer Pool- oder Poolspezifikation wurden in targetDedicatedNodes und currentComputeNodes umbenannt.
  • (Breaking Change) Die resizeError-Eigenschaft eines Pools ist jetzt eine Auflistung namens resizeErrors.
  • Computeknoten verfügen über eine neue isDedicated-Eigenschaft . Diese Eigenschaft gilt für dedizierte Knoten undfalse für Knoten mit niedriger Priorität.
  • Eine Auftrags-Manager-Aufgabe verfügt über eine neue allowLowPriorityNode-Eigenschaft . Wenn diese Eigenschaft true ist, kann die Auftrags-Manager-Aufgabe auf einem Knoten mit niedriger Priorität ausgeführt werden. Wenn der Wert false ist, wird der Auftrags-Manager-Task auf einem dedizierten Computeknoten ausgeführt.

Benannte Benutzer unter Linux

Azure Batch bietet jetzt zusätzliche Unterstützung für das Erstellen benannter Benutzer auf Linux-Knoten.

  • Die neue linuxUserConfiguration-Eigenschaft unterstützt die Angabe einer UID (Benutzer-ID) und gid (Gruppen-ID) beim Erstellen eines Linux-Benutzers.
  • (Breaking Change) Die sshPrivateKey-Eigenschaft wurde von der userAccount-Eigenschaft in die neue linuxUserConfiguration-Eigenschaft verschoben. Die linuxUserConfiguration-Eigenschaft ist selbst eine Eigenschaft der userAccount-Eigenschaft .

Weitere Informationen zu benannten Benutzerkonten finden Sie unter Ausführen von Aufgaben unter Benutzerkonten in Batch.

Ausgabedateien für Aufgabendaten

Sie können jetzt Ausgabedateien angeben, um Aufgabendaten nach Abschluss eines Vorgangs hochzuladen.

  • Die neue outputFiles-Eigenschaft unterstützt das Angeben von Aufgabendateien, die in Azure Storage hochgeladen werden sollen.
  • Die neue fileUploadError-Eigenschaft der exitConditions-Eigenschaft unterstützt die Angabe von Aktionen, die basierend auf dem upload-status einer Ausgabedatei ausgeführt werden sollen.

Berichterstellung bei Aufgabenfehlern

Es wurden mehrere Änderungen vorgenommen, um die Berichterstellung für Aufgabenfehler zu verbessern.

  • Die neue result-Eigenschaft der executionInfo-Eigenschaft gibt an, ob eine Aufgabe erfolgreich war oder fehlgeschlagen ist.
  • (Breaking Change) Die schedulingError-Eigenschaft der executionInfo-Eigenschaft wurde in failureInfo umbenannt. Die failureInfo-Eigenschaft wird jedes Mal zurückgegeben, wenn ein Taskfehler auftritt. Dies umfasst alle vorherigen Planungsfehlerfälle, alle Fälle, in denen ein Exitcode des Vorgangs ungleich null zurückgegeben wird, und alle Fehler beim Hochladen von Dateien.
  • (Breaking Change) Die schedulingError-Eigenschaft der exitConditions-Eigenschaft wurde in preProcessingError umbenannt, um zu klären, wann der Fehler im Aufgabenlebenszyklus aufgetreten ist.
  • (Breaking Change) Die SchedulingErrorCateogry-Eigenschaft wurde in errorCategory umbenannt.

Anwendungslizenzen

Sie können jetzt anfordern, dass Anwendungslizenzen in Ihrem Pool über die neue applicationLicenses-Eigenschaft für eine Pool- oder Poolspezifikation bereitgestellt werden.

Version 2017-01-01.4.0

Dieses Versionsrelease erweitert alle Unterstützungen der vorherigen Version, 2016-07-01.3.1. Darüber hinaus werden die folgenden Funktionen unterstützt:

  • Führen Sie eine Aufgabe unter einer angegebenen Benutzeridentität aus.

    Sie können jetzt eine Aufgaben- oder Aufgabensammlung unter einer der folgenden Benutzeridentitäten ausführen, die über die neue userIdentity-Eigenschaft für die Taskressource angegeben sind:

    • Ein Benutzerkonto mit einem Namen, den Sie definieren.

    • Ein Benutzerkonto, das automatisch erstellt wird (ein automatischer Benutzer). Ein automatischer Benutzer kann als Administratorbenutzer oder als nicht administrativer Benutzer ausgeführt werden. Standardmäßig wird ein automatischer Benutzer als nicht administrativer Benutzer ausgeführt.

      Wichtig

      Die userIdentity-Eigenschaft mit ihrer elevationLevel-Eigenschaft ersetzt die runElevated-Eigenschaft in Anforderungen, die eine Aufgabe oder eine Aufgabensammlung hinzufügen, und in Antworten, die Informationen zu einer Aufgabe oder einer Liste von Aufgaben erhalten.

      Wenn Sie eine Anforderung stellen, die die runElevated-Eigenschaft auf Version 2017-01.01.4.0 des Batch-Diensts enthält, schlägt die Anforderung fehl.

      Wenn Sie als Administrator ausgeführt werden möchten, aktualisieren Sie Ihre Anwendung so, dass sie die userIdentity-Eigenschaft verwendet, und legen Sie die elevationLevel-Eigenschaft auf administrator fest.

      Um als nicht administrativer Benutzer auszuführen, aktualisieren Sie Ihre Anwendung so, dass sie die userIdentity-Eigenschaft verwendet, und legen Sie die elevationLevel-Eigenschaft auf nonAdmin fest. Da dies die Standardeinstellung ist, können Sie die Einstellung auch weglassen.

  • Definieren Sie Benutzerkonten für alle Knoten in einem Pool.

    Sie können jetzt eine Aufgabe- oder Aufgabensammlung unter einem Benutzerkonto ausführen, das Sie für die Poolressource definieren. Definieren Sie ein Benutzerkonto über die neue userAccounts-Eigenschaft in Anforderungen zum Hinzufügen von Pool. Wenn Sie das Konto definieren, können Sie den Kontonamen, das Kennwort, die Erhöhungsebene (Administrator oder Nicht-Administrator) und den privaten SSH-Schlüssel (für Linux-Pools) angeben.

    Nachdem Sie das Benutzerkonto definiert haben, können Sie dieses Benutzerkonto für die userIdentity-Eigenschaft in Anforderungen angeben, die eine Aufgabe oder eine Aufgabensammlung hinzufügen.

  • Stellen Sie eine Aufgabe mit einem Token bereit, um sich beim Batch-Dienst zu authentifizieren, wenn der Task ausgeführt wird.

    Der Batch-Dienst kann jetzt ein Authentifizierungstoken für eine Aufgabe bereitstellen, wenn er ausgeführt wird. Das Authentifizierungstoken ermöglicht es einer Aufgabe, Anforderungen im Zusammenhang mit dem Auftrag an den Batch-Dienst ohne die Batch-Kontoschlüssel auszustellen. Das Token wird über die AZ_BATCH_AUTHENTICATION_TOKEN Umgebungsvariable bereitgestellt.

    Derzeit werden Authentifizierungstoken nur für Aufrufvorgänge für die Auftragsressource unterstützt. Das Authentifizierungstoken gewährt Zugriff auf alle Vorgänge für den Auftrag, der die Aufgabe enthält.

    Damit der Batch-Dienst das Authentifizierungstoken bereitstellt, geben Sie die neue authenticationTokenSettings-Eigenschaft zusammen mit ihrer Zugriffseigenschaft in Anforderungen zum Hinzufügen von Aufgabe oder Aufgabensammlung hinzufügen an.

  • Geben Sie eine Aktion an, die für die Abhängigkeiten einer Aufgabe ausgeführt werden soll, wenn die Aufgabe fehlschlägt.

    Sie können nun angeben, dass abhängige Aufgaben auch dann fortgesetzt werden, wenn die Aufgabe, von der sie abhängig sind, fehlschlägt. Legen Sie die neue dependencyAction-Eigenschaft einer Taskressource fest, die erfüllt werden soll, um abhängige Aufgaben auszuführen, auch wenn der übergeordnete Task fehlschlägt. Legen Sie alternativ "dependencyAction" auf Block fest, um die Ausführung abhängiger Aufgaben zu verhindern, wenn der übergeordnete Task fehlschlägt.

    Geben Sie die dependencyAction-Eigenschaft in Anforderungen zum Hinzufügen von Aufgabe oder Aufgabensammlung hinzufügen an.

    Weitere Informationen zur Verwendung von Abhängigkeitsaktionen finden Sie unter Abhängigkeitsaktionen.

  • Verwenden Sie benutzerdefinierte Betriebssystemdatenträgerimages beim Erstellen eines Pools.

    Sie können jetzt benutzerdefinierte Betriebssystemdatenträgerimages verwenden, um einen Pool zu erstellen.

    Dazu müssen Sie beim Erstellen Ihres Batch-Kontos angeben, dass Pools im Benutzerabonnement und nicht in einem abonnement bereitgestellt werden sollen, das vom Batch-Dienst verwaltet wird. Legen Sie in einem Aufruf von Create Account die poolAllocationMode-Eigenschaft auf UserSubscription fest. Verwenden Sie dann die osDisk-Eigenschaft , um einen Verweis auf ein Datenträgerimage in einer Anforderung an Pool hinzufügen anzugeben.

    Wichtig

    Wenn Sie beim Erstellen Ihres Batch-Kontos angeben, dass Pools im Benutzerabonnement bereitgestellt werden sollen, müssen Sie die Azure Active Directory-basierte Authentifizierung für alle Anforderungen verwenden, die über dieses Konto erfolgen.

  • Verwenden Sie die Azure Active Directory-basierte Authentifizierung für Anforderungen an den Batch-Dienst.

    Azure Active Directory (Azure AD) wird jetzt für die Authentifizierung von Aufrufen des Batch-Diensts unterstützt.

    Wenn Ihr Batch-Konto für die Bereitstellung von Pools im Benutzerabonnement eingerichtet ist, ist die Verwendung der Azure AD-Authentifizierung erforderlich.

Version 2016-07-01.3.1

Dieses Versionsrelease erweitert die gesamte Unterstützung der vorherigen Version 2016-02-01.3.0. Darüber hinaus werden die folgenden Funktionen unterstützt:

  • Möglichkeit zum Erstellen eines Pools und eines automatischen Pools mit Netzwerkkonfiguration

    • Sowohl dem Pool als auch den Autopoolressourcen wurde eine neue Eigenschaft networkConfiguration hinzugefügt. Diese Eigenschaft kann verwendet werden, um die Netzwerkkonfiguration des Pools anzugeben, z. B. das Subnetz, in dem die Computeknoten des Pools erstellt werden.

  • Beenden Sie einen Auftrag automatisch, wenn alle Aufgaben abgeschlossen sind.

    • Der Auftragsressource wurde eine neue Eigenschaft onAllTasksComplete hinzugefügt. Sie können dies angeben, wenn Sie einen Auftrag erstellen oder aktualisieren.

  • Automatisch beenden oder deaktivieren Sie einen Auftrag, wenn eine Aufgabe fehlschlägt.

    • Der Auftragsressource wurde eine neue Eigenschaft onTaskFailure hinzugefügt, und der Aufgabenressource wurde eine neue Eigenschaft exitConditions hinzugefügt. Die Einstellung "auftrag onTaskFailure" gibt an, ob ein Vorgangsfehler auswirkungen auf Auftragsebene haben kann, und die task exitConditions-Eigenschaft ermöglicht Es Tasks, die Auswirkungen auf Auftragsebene an die Art des Fehlers anzupassen.

  • Ordnen Sie Anwendungspakete Aufgaben und Pools zu.

    • Der Taskressource und den JobManagerTask-Einstellungen wurde eine neue Eigenschaft applicationPackageReferences hinzugefügt. Dadurch können Anwendungspakete bei Bedarf bereitgestellt werden, da Aufgaben sie erfordern, anstatt sie zum Zeitpunkt der Poolerstellung anzugeben. Dies ist besonders nützlich für langlebige Pools, die möglicherweise aufgerufen werden, um verschiedene Arten von Aufträgen oder unterschiedliche Anwendungsversionen über ihre Lebensdauer auszuführen, oder wenn Sie über ein großes Anwendungspaket verfügen, das nicht für alle Aufgaben erforderlich ist.

  • Funktion zum Reaktivieren eines fehlgeschlagenen Vorgangs.

    • Ein neuer Vorgang Reactivate a task wurde hinzugefügt, um den Status einer fehlerhaften Aufgabe auf aktiv zurückzusetzen. Dadurch können Fehler wiederholt werden, z. B. wenn der Fehler vorübergehend war oder wenn Sie die Ursache des Fehlers beheben konnten, ohne die Aufgabe erneut zu erstellen.

Version 2016-02-01.3.0

Dieses Versionsrelease erweitert die gesamte Unterstützung der vorherigen Version 2015-12-01.2.2. Darüber hinaus werden die folgenden Funktionen unterstützt:

Version 2015-12-01.2.2

Dieses Versionsrelease erweitert die gesamte Unterstützung der vorherigen Version 2015-11-01.2.1. Darüber hinaus werden die folgenden Funktionen unterstützt:

  • Anwendungen können jetzt mithilfe von Anwendungspaketen statt als Ressourcendateien auf Computeknoten bereitgestellt werden.

    • Neue APIs werden für Clients bereitgestellt, um die Liste der verfügbaren Anwendungen und Versionen zu durchsuchen, z. B. um einen Selektor in einer Benutzeroberfläche anzuzeigen.

    • Poolbezogene APIs werden so geändert, dass ein Pool Anwendungspakete angeben kann, die auf alle Knoten in diesem Pool heruntergeladen werden sollen.

  • Aufgaben können nun von anderen Aufgaben abhängig gemacht werden. Ein abhängiger Vorgang wird erst gestartet, wenn alle Aufgaben, von denen er abhängig ist, erfolgreich abgeschlossen wurden.

Dieses Versionsrelease enthält die folgenden weiteren Änderungen:

  • Das Standardtimeout für die Größe des Pools wurde auf 15 Minuten geändert.

Version 2015-11-01.2.1

Dieses Versionsrelease erweitert die gesamte Unterstützung der vorherigen Version 2015-06-01.2.0. Darüber hinaus werden die folgenden Funktionen unterstützt:

  • Möglichkeit zum Hinzufügen und Ausführen von Aufgaben mit mehreren instance (z. B. MPI)

    • Der Taskressource wird eine neue optionale Eigenschaft "multiInstanceSettings" hinzugefügt, die optional in die APIs "Aufgabe hinzufügen", "Aufgabe abrufen" und "Listenaufgaben" eingeschlossen werden kann.

    • Eine neue API-Liste der Untertasks einer Aufgabe wird hinzugefügt, um Informationen zu Teilvorgängen abzurufen.

    • Eine neue optionale Eigenschaft "subtaskId" wird "recentTasks" für einen Computeknoten hinzugefügt. Diese Eigenschaft wird im Rahmen von Get Compute Node und List Compute Nodes zurückgegeben.

  • Funktion zum Deaktivieren oder Aktivieren der Aufgabenplanung auf einem Computeknoten

    • Zwei neue APIs Deaktivieren der Aufgabenplanung auf einem Knoten und Aktivieren der Aufgabenplanung auf einem Knoten werden zur Computeknotenressource hinzugefügt.

    • Ein neuer Computeknotenstatus "offline" wird hinzugefügt. Bei älteren API-Versionen wird dieser Zustand "nicht verwendbar" zugeordnet.

    • Der Computeknotenressource wird eine neue Eigenschaft "schedulingState" hinzugefügt. Mögliche Werte für "aktiviert" und "deaktiviert".

  • Möglichkeit zum Angeben des Automatischskalierungsintervalls für einen Pool/Autopool

    • Eine neue Eigenschaft "autoScaleEvaluationInterval" wird der Poolressource hinzugefügt. Diese Eigenschaft kann in den APIs "Pool hinzufügen", "Pool abrufen", "AutoScale aktivieren" und "Listenpools" enthalten sein.

    • In ähnlicher Weise wird für automatische Pools eine neue Eigenschaft "autoScaleEvaluationInterval" zur "autoPoolSpecification"-Eigenschaft hinzugefügt. Diese Eigenschaft kann in den APIs "Auftrag hinzufügen", "Auftrag abrufen", "Auftrag auflisten", "Auftragszeitplan hinzufügen", "Auftragszeitplan aktualisieren", "Auftragszeitpläne auflisten" und "Aufträge in Auftragszeitplan auflisten" enthalten sein.

  • Erweiterung der Aufgaben-APIs, um das Stammverzeichnis der Aufgabe auf dem Computeknoten zurückzugeben.

    • Zwei neue Eigenschaften "taskRootDirectory" und "taskRootDirectoryUrl" werden der Taskressource hinzugefügt, die als Teil von Abrufen von Informationen zu einer Aufgabe, Listenaufgaben-APIs abgerufen werden können.

    • Eine neue Eigenschaft "taskRootDirectory" wird "jobPreparationTaskExecutionInfo" und "jobReleaseTaskExecutionInfo" hinzugefügt, die über List the status der Auftragsvorbereitungs- und Auftragsfreigabeaufgaben für eine Auftrags-API abgerufen werden kann.