Freigeben über

Batch Service REST API-Versionsmanagement

Die vom Batch-Service REST API bereitgestellten Operationen können mehrere Versionen für Abwärtskompatibilität haben, während sich die API im Laufe der Zeit weiterentwickelt. Sie müssen angeben, welche Version einer Operation Sie verwenden möchten, wenn sie aufgerufen wird, indem Sie die Version mit Ihrem REST-Aufruf bereitstellen. Wenn Ihre Anwendung eine ältere Version einer Operation aufruft, können Sie wählen, ob Sie die ältere Version weiterhin aufrufen oder Ihren Code ändern, um eine neuere Version aufzurufen. Wenn die Version nicht angegeben ist oder eine falsche Version angegeben wird, wird ein Fehler zurückgegeben.

Um anzugeben, welche Version einer Operation verwendet werden soll, setzen Sie den API-Version-Abfrageparameter . Die Version verwendet das Format Group.Major.Minor, wobei Group im Format YYYY-MM-DD ist und Dur eine ganze Zahl und Minor eine ganze Zahl ist.

Neueste Version: 01.06.2025

Frühere Versionen

Frühere Versionen umfassen:

Version: 2024-07-01.20.0

  • Hinzufügende Deallokation und Startoperationen für Rechenknoten:
    • Neue ComputeNode_Deallocate Operation (POST /pools/{poolId}/nodes/{nodeId}/deallocate) hinzugefügt, um einen leeren oder laufenden Rechenknoten freizustellen.
    • Neue ComputeNode_Start Operation (POST /pools/{poolId}/nodes/{nodeId}/start) hinzugefügt, um einen zuvor zugeteilten Rechenknoten neu zu starten.
    • Neues NodeDeallocateParameter Modell mit einer nodeDeallocateOption Eigenschaft eingeführt, die angibt, was mit den Aufgaben während der Deallokation zu tun ist.
  • [Zerbrechen] Operation ComputeNode_GetRemoteDesktop entfernt (GET /pools/{poolId}/nodes/{nodeId}/rdp). Diese Operation war nur auf Cloud-Service-Konfigurationspools anwendbar.
  • [Zerbrechen] Entfernte Unterstützung für Cloud Service Configuration Pool:
    • Modell entfernt CloudServiceConfiguration .
    • Entfernte cloudServiceConfiguration Eigenschaft aus CloudPool, PoolAddParameter, und PoolSpecification.
  • [Zerbrechen] Entfernte applicationLicenses Eigenschaft aus CloudPool, PoolAddParameter, und PoolSpecification.
  • Container-Bind-Mount-Unterstützung für Aufgaben hinzugefügt:
    • Neues ContainerHostBatchBindMountEntry Modell mit source und isReadOnly Eigenschaften hinzugefügt.
    • Neue ContainerHostDataPath Enum mit den Werten Shared, , StartupVfsMounts, Task, JobPrep, und Applicationshinzugefügt.
    • Neue containerHostBatchBindMounts Eigenschaft hinzugefügt zu TaskContainerSettings.
  • Vertrauliche VM-Unterstützung hinzugefügt:
    • Neues VMDiskSecurityProfile Modell mit einer Eigenschaft securityEncryptionType hinzugefügt.
    • Neue securityProfile Eigenschaft hinzugefügt zu ManagedDisk.
    • Hinzugefügt confidentialVM als neuer Wert für SecurityProfile.securityType.
  • Hinzugefügt deallocated und deallocating als neue Werte für ComputeNodeState.
  • Neue, erforderliche deallocated und deallocating neue Eigenschaften hinzugefügt.NodeCounts
  • Hinzugefügte Unterstützung für Shared Gallery und Community Gallery Bildreferenzen:
    • Hinzugefügte sharedGalleryImageId und communityGalleryImageId Eigenschaften zu ImageReference.
  • Hinzugefügte Eigenschaft skipWithdrawFromVNet , um JobNetworkConfiguration zu steuern, ob Knoten nach Ende eines Jobs mit dem VNet verbunden bleiben.
  • Eigenschaft zu hinzugefügtnetworkConfiguration.JobPatchParameter
  • Erweiterte Pool-Patching-Funktionen: , , taskSlotsPerNode, taskSchedulingPolicy, enableInterNodeCommunication, mountConfigurationnetworkConfigurationvirtualMachineConfigurationupgradePolicyuserAccountsund resourceTags Eigenschaften hinzugefügt.PoolPatchParameterdisplayNamevmSize Eigenschaften, die die Pooltopologie beeinflussen, können nur aktualisiert werden, wenn der Pool leer ist.
  • Boolesche Abfrageparameter wurden zu Job_Delete, , , JobSchedule_Deleteund Operationen JobSchedule_Terminate hinzugefügtforce, um die Operation zu Job_Terminateerzwingen.

Version: 2024-02-01.19.0

  • Hinzugefügte Unterstützung für Betriebssystem-Upgrade-Richtlinien für VM-Pools:
    • Neues UpgradePolicy Modell mit den Eigenschaften mode, automaticOSUpgradePolicy, und rollingUpgradePolicyhinzugefügt. Die Eigenschaft mode (UpgradeMode) akzeptiert die Werte automatic, manual, und rolling.
    • Neues AutomaticOSUpgradePolicy Modell mit den Eigenschaften disableAutomaticRollback, enableAutomaticOSUpgrade, useRollingUpgradePolicy, und osRollingUpgradeDeferralhinzugefügt.
    • Neues RollingUpgradePolicy Modell mit den Eigenschaften enableCrossZoneUpgrade, maxBatchInstancePercent, , maxUnhealthyInstancePercentmaxUnhealthyUpgradedInstancePercent, pauseTimeBetweenBatches, prioritizeUnhealthyInstances, und rollbackFailedInstancesOnPolicyBreachhinzugefügt.
    • Neue upgradePolicy Eigenschaften zu CloudPool, PoolAddParameter, und PoolSpecificationhinzugefügt.
  • Hinzugefügt upgradingos als neuer Wert für ComputeNodeState.
  • Neue erforderliche upgradingOS Eigenschaften wurden hinzugefügt, um NodeCounts die Anzahl der Knoten im upgradingos Bundesstaat zu melden.

Version: 2023-11-01.18.0

  • Hinzugefügte Unterstützung für Trusted Launch / Sicherheitsprofile für VM-Pools:
    • Neues SecurityProfile Modell mit den Eigenschaften encryptionAtHost, securityType, und uefiSettingshinzugefügt.
    • Neues UefiSettings Modell mit Eigenschaften secureBootEnabled und vTpmEnabledhinzugefügt.
    • Neue securityProfile Eigenschaft hinzugefügt zu VirtualMachineConfiguration.
  • Zusätzliche Unterstützung für Serviceartefakte-Referenzen für Skalierungssätze:
    • Neues ServiceArtifactReference Modell mit einer erforderlichen id Eigenschaft (ARM-Ressourcen-ID) hinzugefügt.
    • Neue serviceArtifactReference Eigenschaft VirtualMachineConfiguration hinzugefügt, um für alle VMs in einem Skalierungsset dieselbe Image-Version festzulegen, wenn die Image-Version verwendet wird latest .
  • Erweiterte OS-Festplattenkonfiguration:
    • Neues ManagedDisk Modell mit einer Eigenschaft storageAccountType hinzugefügt.
    • Neue Eigenschaften wurden hinzugefügt zu OSDisk: caching, , diskSizeGB, managedDiskund writeAcceleratorEnabled.
  • Hinzugefügt StandardSSDLRS (standardssd_lrs) als neuen Wert für StorageAccountType.
  • Neue resourceTags-Eigenschaft zu CloudPool, PoolAddParameter und PoolSpecification hinzugefügt, um benutzerdefinierte Tags auf die Sicherung Azure Ressourcen weiterzugeben. Gilt nur, wenn poolAllocationModeUserSubscriptionist.
  • Neue scaleSetVmResourceId Eigenschaft VirtualMachineInfo hinzugefügt, um die Ressourcen-ID der aktuellen Virtual Machine Scale Set VM des Rechenknotens freizulegen. Nur dann definiert, wenn das Batch-Konto poolAllocationMode .UserSubscription

Version: 2023-05-01.17.0

  • [Zerbrechen] Batch-Job/Pool-Lebensdauerstatistik-API entfernt: lifetimejobstats und lifetimepoolstats.
  • Boolesche Eigenschaft enableAcceleratedNetworking wurde hinzugefügt.NetworkConfiguration
    • Diese Eigenschaft bestimmt, ob dieser Pool beschleunigtes Netzwerken ermöglichen sollte, wobei der Standardwert False ist.
    • Ob diese Funktion aktiviert werden kann, hängt auch davon ab, ob eine Betriebssystem-/VM-Instanz unterstützt wird, was mit der AcceleratedNetworking Policy übereinstimmen sollte.
  • Boolesche Eigenschaft enableAutomaticUpgrade wurde hinzugefügt.VMExtension
    • Diese Eigenschaft bestimmt, ob die Erweiterung automatisch aktualisiert werden sollte, falls eine neuere Version der Erweiterung verfügbar ist.
  • Die Eigenschaft type von ContainerConfiguration, die nun zwei Werte unterstützt: DockerCompatible und CriCompatible.

Version: 2022-10-01.16.0

  • Neue NodeCommunicationMode Eigenschaft hinzugefügt, die bestimmt, wie ein Pool mit dem Batch-Service kommuniziert
  • Neue currentNodeCommunicationMode Eigenschaft des Typs NodeCommunicationMode wurde dem CloudPool Modell hinzugefügt, um auf den aktuellen Zustand des Pool-Kommunikationsmodus zu verweisen.
  • Neue targetNodeCommunicationMode Eigenschaften des Typs NodeCommunicationMode wurden den folgenden Modellen hinzugefügt, um auf den gewünschten Knotenkommunikationsmodus für den Pool zu verweisen:
    • PoolSpecification
    • CloudPool
    • PoolAddParameter
    • PoolPatchParameter
    • PoolUpdatePropertiesParameter

Version: 01.01.01.2022

  • Neue uploadHeaders Eigenschaften wurden dem OutputFileBlobContainerDestination Modell hinzugefügt, um es den Nutzern zu ermöglichen, benutzerdefinierte HTTP-Header bei Ressourcendatei-Uploads einzustellen.
  • Neue allowTaskPreemption Eigenschaften wurden den folgenden Modellen hinzugefügt, um Task-Präemption für Aufgaben mit höherer Priorität zu unterstützen (erfordert Comms-Enabled oder Single Tenant Pool):
    • JobSpecification
    • CloudJob
    • JobAddParameter
    • JobPatchParameter
    • JobUpdateParameter

Version: 06.06.01.2021

  • Fügen Sie die Möglichkeit hinzu, benutzerdefinierte verwaltete Identitäten an CloudPoolzuzuweisen. Diese Identitäten werden auf jedem Knoten im Pool verfügbar gemacht und können verwendet werden, um auf verschiedene Ressourcen zuzugreifen.
  • Hinzufügen von Eigenschaften zu den folgenden Modellen identityReference , um den Zugriff auf Ressourcen über verwaltete Identität zu unterstützen:
    • AzureBlobFileSystemConfiguration
    • OutputFileBlobContainerDestination
    • ContainerRegistry
    • ResourceFile
    • UploadBatchServiceLogs
  • Neue extensions Eigenschaft zu VirtualMachineConfiguration hinzugefügt CloudPool , um virtuelle Maschinenerweiterungen für Knoten festzulegen
  • Die Möglichkeit hinzugefügt, Verfügbarkeitszonen mit einer neuen Eigenschaft nodePlacementConfiguration in VirtualMachineConfiguration anzugeben
  • Eine neue osDisk Eigenschaft wurde zu VirtualMachineConfiguration hinzugefügt, die Einstellungen für die Betriebssystem-Festplatte der virtuellen Maschine enthält.
    • Die Eigenschaft placement auf DiffDiskSettings spezifiziert die Platzierung der ephemeren Festplatten für Betriebssystemfestplatten aller VMs im Pool. Ich stelle es auf "CacheDisk" ein, um die vergängliche OS-Festplatte im VM-Cache zu speichern.
  • Hinzugefügte maxParallelTasks Eigenschaft ein, CloudJob um die maximale Anzahl der Aufgaben zu steuern, die gleichzeitig pro Job ausgeführt werden können (standardmäßig -1 bedeutet unbegrenzt). Diese Immobilie befindet sich derzeit in privater Vorschau.
  • Die hinzugefügte virtualMachineInfo Eigenschaft ComputeNode enthält Informationen über den aktuellen Zustand der virtuellen Maschine, einschließlich der exakten Version des Marktplatz-Images, das die VM verwendet.
  • Hinzugefügte recurrenceInterval Eigenschaft, um Schedule das Intervall zwischen den Startzeiten zweier aufeinanderfolgender Jobs unter einem Jobplan zu kontrollieren.

Version: 2020-09-01.12.0

  • [Zerbrechen] Grundstück wurde durch den Pool maxTasksPerNodetaskSlotsPerNode ersetzt. Mit dieser Eigenschaft können Aufgaben in einem Job eine dynamische Anzahl von Slots beanspruchen, was eine feinere Kontrolle über den Ressourcenverbrauch ermöglicht.
  • [Zerbrechen] Der Antworttyp von GetTaskCounts wurde geändert, um zurückzugeben TaskCountsResult, was ein komplexes Objekt ist, das das vorherige TaskCounts Objekt enthält, und ein neues TaskSlotCounts Objekt, das ähnliche Informationen im Kontext der verwendeten Slots liefert.
  • Hinzugefügte Eigenschaft requiredSlots zur Aufgabe, die es dem Benutzer erlaubt, anzugeben, wie viele Slots auf einem Knoten er einnehmen soll.

Version: 03.03.01.2020

  • Zusätzliche Möglichkeit zur Verschlüsselung von ComputeNode-Festplattenlaufwerken mit der neuen DiskEncryptionConfiguration Eigenschaft .VirtualMachineConfiguration
  • [Zerbrechen] Die Eigenschaft virtualMachineImageId von ImageReference kann sich nun nur noch auf ein Shared Image Gallery Bild beziehen.
  • [Zerbrechen] Die Eigenschaft password des Anfragekörpers ist Add Certificate optional für PFX-formatierte Zertifikate.
  • [Zerbrechen] Pools können nun ohne öffentliche IP mit der neuen PublicIPAddressConfiguration Eigenschaft von NetworkConfigurationbereitgestellt werden.
  • [Zerbrechen] Die Immobilie publicIPsNetworkConfiguration wurde umbenannt ipAddressIds und ebenfalls eingezogen PublicIPAddressConfiguration . Diese Eigenschaft kann nur angegeben werden, wenn provision die Eigenschaft ist usermanaged.

Version: 2019-08-01.10.0

  • Zusätzliche Möglichkeit, eine Sammlung öffentlicher IPs NetworkConfiguration über die neue publicIPs Eigenschaft im Pool anzugeben. Dies garantiert, dass Knoten im Pool eine IP aus der Liste der vom Nutzer bereitgestellten IPs haben.
  • Zusätzliche Möglichkeit, entfernte Dateisysteme auf jedem Knoten eines Pools über die Eigenschaft MountConfiguration zu mounten.
  • Shared Image Gallery Bilder können nun auf der Eigenschaft virtualMachineImageIdImageReference angegeben werden, indem das Bild über seine Azure Resource Manager-ID referenziert wird.
  • [Zerbrechen] Wenn nicht angegeben, ist der Standardwert für waitForSuccess auf StartTask ( true zuvor war falseer ).
  • [Zerbrechen] Wenn nicht angegeben, ist der Standardwert für scope auf AutoUserSpecification nun immer Pool (zuvor war er Task auf Windows Knoten und Pool auf Linux-Knoten).
  • Verbesserte verschiedene verwirrende oder unvollständige Dokumente.

Version: 2019-06-01.9.0

  • [Zerbrechen] Ersetzt ListNodeAgentSKUs durch ListSupportedImages. ListSupportedImages enthält alle ursprünglich verfügbaren Informationen in ListNodeAgentSKUs klarerem Format. Neue, nicht verifizierte Bilder werden nun ebenfalls zurückgegeben. Zusätzliche Informationen über Capabilities und BatchSupportEndOfLife sind zugänglich über ImageInformation.

  • Unterstützen Sie nun Netzwerksicherheitsregeln, die den Netzwerkzugriff auf ein CloudPool basierend auf dem Quellport des Verkehrs blockieren. Diese Regel erfolgt über die Eigenschaft SourcePortRanges auf NetworkSecurityGroupRule.

  • Beim Ausführen eines Containers unterstützt Batch jetzt das Ausführen der Aufgabe im Containerarbeitsverzeichnis oder im Arbeitsverzeichnis für Batchaufgaben. Dies wird von der WorkingDirectory Eigenschaft für TaskContainerSettings.

  • Verbesserte verschiedene verwirrende oder unvollständige Dokumente.

Version: 2018-12-01.8.0

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

    • upgradeos wurde entfernt.
    • Umbenannt targetOSVersion in osVersion und entfernt currentOSVersion auf CloudPool.
    • Aus upgradingPoolState.

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

  • [Zerbrechen]ResourceFile Verbesserungen

    • Die Möglichkeit wurde hinzugefügt, einen kompletten Azure Storage-Container in ResourceFile anzugeben. Es gibt jetzt drei unterstützte Modi für ResourceFile:
      • httpUrl erzeugt eine ResourceFile Referenz auf eine einzelne HTTP-URL.
      • storageContainerUrl erzeugt ein ResourceFile, das auf einen Azure Blob Storage Container zeigt.
      • autoStorageContainerName erstellt ein ResourceFile, das auf einen Azure Blob Storage Container im Batch-registrierten Autostorage-Konto zeigt.
    • URLs, die über die Methode httpUrl bereitgestellt ResourceFile werden, können nun jede HTTP-URL sein. Früher mussten diese URLs eine Azure Blob Storage-URL sein.
    • blobPrefix kann verwendet werden, um Downloads aus einem Speichercontainer auf nur solche zu filtern, die dem Präfix entsprechen.

  • [Zerbrechen] Eigentum VirtualMachineConfigurationaus entferntosDisk. Diese Eigenschaft wird nicht mehr unterstützt.

  • Pools, die das dynamicVNetAssignmentScope auf NetworkConfiguration auf job setzen, können nun dynamisch jedem Knoten des Jobs ein Virtual Network zuweisen s tasks run on. The specific Virtual Network to join the nodes to is specified in the new JobNetworkConfigurationproperty onCloudJobandJobSpecification'.

    Hinweis

    Dieses Feature befindet sich in der öffentlichen Vorschau. Es ist für alle Batch-Konten deaktiviert, außer für diejenigen, die uns kontaktiert und darum gebeten haben, im Pilotprojekt dabei zu sein.

  • Die maximale Lebensdauer einer Aufgabe beträgt jetzt 180 Tage (früher waren es 7 Tage).

  • Unterstützung für Windows Pools hinzugefügt, um Benutzer mit einem bestimmten Anmeldemodus (entweder batch oder interactive) über LoginMode) zu erstellen.

  • Die Standard-Aufgabenaufbewahrungszeit für alle Aufgaben beträgt jetzt sieben Tage, zuvor war sie unendlich.

Version 2018-08-01.7.0

Neue Funktionen in Version 2018-08-01.7.0 umfassen:

  • Sehen Sie die Version des Azure Batch Node Agent über die neue Eigenschaft NodeAgentInfo auf ComputeNode.
  • Es wurde die Möglichkeit hinzugefügt, ein Filter A auf der Seite Result einer Aufgabe anzugeben. Weitere Informationen finden Sie hier.
    • Dies ermöglicht das oft geforderte Szenario, eine serverseitige Abfrage durchzuführen, um alle fehlgeschlagenen Aufgaben zu finden.
  • [Zerbrechen] Die Immobilie wurde von TaskCounts entfernt ValidationStatus .
  • [Zerbrechen] Der Standard-Caching-Typ für DataDisk und OSDisk ist jetzt ReadWrite anstelle von None.
  • [Zerbrechen] Umbenannte den einzigen Wert von ContainerType von docker .dockerCompatible

Version 2018-03-01.6.1

Neue Funktionen in Version 2018-03-01.6.1 umfassen:

  • Pool-Knotenzählungen nach Zustand: Diese Version fügt die Möglichkeit hinzu, Pool-Knotenzählungen nach Zustand abzufragen, über die neue Operation ListPoolNodeCounts. Diese Operation gibt Ihnen die Möglichkeit, alle Pools in einem Batch-Konto nach Knotenzuständen abzufragen.
  • Node Agent Logs: Diese Version fügt die Möglichkeit hinzu, Azure Batch Node Agent Logs von einem bestimmten Knoten über die Operation UploadBatchServiceLogs hochzuladen. Dieses Protokoll ist für die Verwendung beim Debugging durch Microsoft Support gedacht, falls Probleme an einem Knoten auftreten.

Version 2017-09-01.6.0

  • Azure Hybrid Use Benefit: Sie können jetzt Batch-Windows-VM-Pools erstellen, in denen festgelegt wird, dass Azure Hybrid Use Benefit-Lizenzen verwendet werden. Wenn diese Lizenz genutzt wird, wird ein Rabatt auf den VM-Preis angewendet. Verwenden Sie die neue LicenseType-Eigenschaft auf VirtualMachineConfiguration.

  • Pool-VM-Datendisks: Sie können eine oder mehrere leere Datendisks an VM-Pools anschließen, indem Sie die neue Datendisk-Konfiguration verwenden, die Teil der virtuellen Maschinenkonfiguration ist. Verwenden Sie die DataDisks-Eigenschaft in VirtualMachineConfiguration.

  • (Veränderung brechen) Benutzerdefinierte Images werden nun mit Azure Resource Manager-Image-Ressourcen erstellt und bereitgestellt, anstatt mit Blob-VHD-Dateien. Batch verwendet nun verwaltete Festplatten, um die Pool-VMs zu erstellen, und nutzt daher eine Image-Ressource . Es gibt nun keine Begrenzung für die Anzahl der VMs in einem Pool, der mit einem benutzerdefinierten Image erstellt wird; außerdem sind mehrere Kopien des VHD-Blobs für große Pools nicht mehr erforderlich. Benutzerdefinierte Bildpools sind daher viel einfacher zu erstellen und zu skalieren. Weitere Informationen finden Sie unter Verwenden Sie ein benutzerdefiniertes Image zur Erstellung eines Pools von virtuellen Maschinen.

    • Die neue VirtualMachineImageId-Eigenschaft auf ImageReference enthält die Referenz auf das Image, und OSDisk.ImageUris existiert nicht mehr.

    • Aufgrund dieser Änderung ist ImageReference nun eine erforderliche Eigenschaft von VirtualMachineConfiguration.

  • (Wechsel brechen) Multi-Instanz-Aufgaben (erstellt mit MultiInstanceSettings) müssen nun CoordinationCommandLine angeben, und NumberOfInstances ist jetzt optional und standardmäßig auf 1 eingestellt.

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

Version 2017-06-01.5.1

Die hier beschriebene Version der Batch-API lautet 2017-06-01.5.1. Wenn möglich, wird empfohlen, die neueste Version zu verwenden.

Neue Funktionen in Version 2017-06-01.5.1 umfassen:

  • Unterstützung für effiziente Aufgabenzählungen über die neue Operation Get Task Counts. Indem Sie die Operation 'Aufgaben abrufen' aufrufen, können Sie eine Zählung der aktiven, laufenden und abgeschlossenen Aufgaben sowie der erfolgreichen oder fehlgeschlagenen Aufgaben erhalten. Weitere Informationen finden Sie unter Aufgaben zählen für einen Auftrag nach Bundesstaat (Vorschau).
  • Unterstützung für die Spezifikation eingehender Endpunkte auf Pool-Compute-Knoten über die neue poolEndpointConfiguration-Eigenschaft . Indem du diese Eigenschaft setzt, kannst du bestimmte Ports am Knoten extern adressieren.

Version 2017-05-01.5.0

Die folgenden Abschnitte beschreiben neue und geänderte Funktionen in Version 2017-05-01.5.0.

Von Bedeutung

Version 2017-05-01.5.0 enthält mehrere fehlerhafte Änderungen. Überprüfen Sie die aktuellen Änderungen und aktualisieren Sie Ihren Code, um die Version 2017-05-01.5.0 anzurufen.

Rechenknoten mit niedriger Priorität

Azure Batch bietet nun Low-Priority-Compute-Nodes an, um die Kosten von Batch-Workloads zu senken. Low-Priority-VMs ermöglichen neue Arten von Batch-Workloads, indem sie eine große Rechenleistung bieten, die zugleich wirtschaftlich ist.

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

  • (Wechsel brechen) Die targetDedicated - und currentDedive-Eigenschaften eines Pool- oder Pool-Spezifikations wurden in targetDedicatedNodes und currentComputeNodes umbenannt.
  • (Wechsel brechen) Die resizeError-Eigenschaft eines Pools ist nun eine Sammlung namens resizeErrors.
  • Compute-Knoten haben eine neue isDedive-Eigenschaft . Diese Eigenschaft gilt für dedizierte Knoten und falsch für niedrigprioritäre Knoten.
  • Eine Job Manager-Aufgabe hat eine neue allowLowPriorityNode-Eigenschaft . Wenn diese Eigenschaft zutrifft, kann die Aufgabe Job Manager auf einem Knoten mit niedriger Priorität ausgeführt werden. Wenn sie falsch ist, läuft die Job Manager-Aufgabe auf einem dedizierten Rechenknoten.

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 einer gid (Gruppen-ID) beim Erstellen eines Linux-Benutzers.
  • (Wechsel brechen) Die sshPrivateKey-Eigenschaft wurde von der userAccount-Eigenschaft auf 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

Du kannst jetzt Ausgabedateien festlegen, um Aufgabendaten nach Abschluss einer Aufgabe hochzuladen.

  • Die neue Eigenschaft outputFiles unterstützt die Spezifikation von Task-Dateien, die auf Azure Storage hochgeladen werden sollen.
  • Die neue Eigenschaft fileUploadError der exitConditions-Eigenschaft unterstützt die Spezifizierung von Aktionen, die basierend auf dem Upload-Status einer Ausgabedatei ausgeführt werden sollen.

Aufgabenfehlermeldung

Es wurden mehrere Änderungen vorgenommen, um die Berichterstattung bei Aufgabenfehlern zu verbessern.

  • Die neue Ergebnis-Eigenschaft der executionInfo-Eigenschaft gibt an, ob eine Aufgabe erfolgreich oder fehlgeschlagen ist.
  • (Wechsel brechen) Die Eigenschaft schedulingError der executionInfo-Eigenschaft wurde in failureInfo umbenannt. Die Eigenschaft failureInfos wird jedes Mal zurückgegeben, wenn ein Aufgabenfehler auftritt. Dazu gehören alle vorherigen Planungsfehler, alle Fälle, in denen ein von null nicht null Task-Exit-Code zurückgegeben wird, sowie etwaige Datei-Upload-Fehlfunktionen.
  • (Wechsel brechen) Die Eigenschaft schedulingError der exitConditions-Eigenschaft wurde in preProcessingError umbenannt, um zu klären, wann der Fehler im Aufgabenlebenszyklus auftrat.
  • (Wechsel brechen) Die Eigenschaft schedulingErrorCateogry wurde in errorCategory umbenannt.

Anwendungslizenzen

Sie können jetzt anfordern, dass Anwendungslizenzen Ihrem Pool über die neue applicationLicenses-Eigenschaft in einem Pool oder einer Poolspezifikation zugewiesen werden.

Version 2017-01-01.01.0

Diese Version erweitert die gesamte Unterstützung der vorherigen Version, 2016-07-01.3.1. Zusätzlich unterstützt es folgende Funktionen:

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

    Sie können nun eine Aufgabe oder Aufgabensammlung unter einer der folgenden Benutzeridentitäten ausführen, die über die neue userIdentity-Eigenschaft auf der Task-Ressource angegeben sind:

    • Ein Benutzerkonto mit einem Namen, den du selbst definierst.

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

      Von Bedeutung

      Die userIdentity-Eigenschaft ersetzt mit ihrer ElevationLevel-Eigenschaft die runElevated-Eigenschaft in Anfragen, die eine Aufgabe oder Aufgabensammlung hinzufügen, sowie in Antworten, die Informationen über eine Aufgabe erhalten oder Aufgaben auflisten.

      Wenn Sie eine Anfrage stellen, die die runElevated-Eigenschaft auf Version 2017-01-01.4.0 des Batch-Dienstes enthält, schlägt die Anfrage fehl.

      Um als administrativer Benutzer auszuführen, aktualisieren Sie Ihre Anwendung so, dass sie die userIdentity-Eigenschaft verwendet und die ElevationLevel-Eigenschaft auf Admin setzen.

      Um als nicht-administrativer Benutzer auszuführen, aktualisieren Sie Ihre Anwendung so, dass sie die userIdentity-Eigenschaft verwendet und die ElevationLevel-Eigenschaft auf nonAdmin setzen. Da diese Einstellung die Standardeinstellung ist, kannst du sie auch weglassen.

  • Definieren Sie Benutzerkonten über alle Knoten in einem Pool.

    Du kannst jetzt eine Aufgabe oder Aufgabensammlung unter einem Benutzerkonto ausführen, das du auf der Pool-Ressource definierst. Definieren Sie ein Benutzerkonto über die neue userAccounts-Eigenschaft bei Anfragen zum Add Pool. Wenn Sie das Konto definieren, können Sie den Kontonamen, das Passwort, die Erhöhungsstufe (Admin oder Nicht-Admin) und den SSH-Privatschlüssel (für Linux-Pools) angeben.

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

  • Stellen Sie einer Aufgabe ein Token zur Authentifizierung beim Batch-Service bereit, wenn die Aufgabe ausgeführt wird.

    Der Batch-Dienst kann nun ein Authentifizierungstoken für eine Aufgabe bereitstellen, wenn sie ausgeführt wird. Das Authentifizierungstoken ermöglicht es einer Aufgabe, Anfragen im Zusammenhang mit dem Job an den Batch-Service zu senden, ohne die Batch-Kontoschlüssel. Das Token wird über die AZ_BATCH_AUTHENTICATION_TOKEN Umgebungsvariable bereitgestellt.

    Derzeit werden Authentifizierungstoken nur für Aufrufoperationen auf der Jobressource unterstützt. Das Authentifizierungstoken gewährt Zugriff auf alle Operationen auf dem Job, der die Aufgabe enthält.

    Damit der Batch-Dienst das Authentifizierungstoken bereitstellt, geben Sie bei Anfragen zur Add Task oder Add Task Collection die neue Eigenschaft authenticationTokenSettings zusammen mit ihrer Zugriffseigenschaft an.

  • Gib eine Aktion an, die auf die Abhängigkeiten einer Aufgabe ausgeführt werden soll, falls die Aufgabe fehlschlägt.

    Man kann jetzt angeben, dass abhängige Aufgaben fortgesetzt werden, auch wenn die Aufgabe, von der sie abhängen, fehlschlägt. Stellen Sie die neue DependencyAction-Eigenschaft einer Taskressource so ein, dass sie Dependent Tasks ausführt, auch wenn die übergeordnete Aufgabe fehlschlägt. Alternativ setzen Sie dependencyAction auf blockieren , um das Ausführen abhängiger Aufgaben zu verhindern, falls die übergeordnete Aufgabe fehlschlägt.

    Spezifizieren Sie die dependencyAction-Eigenschaft in Anfragen zur Aufgabe hinzufügen oder Aufgabensammlung hinzufügen.

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

  • Verwenden Sie benutzerdefinierte OS-Festplattenabbilder beim Erstellen eines Pools.

    Du kannst jetzt benutzerdefinierte OS-Disk-Images verwenden, um einen Pool zu erstellen.

    Dazu müssen Sie bei der Erstellung Ihres Batch-Kontos angeben, dass Pools im Benutzerabonnement bereitgestellt werden sollen und nicht in einem Abonnement, das vom Batch-Service verwaltet wird. Setzen Sie in einem Aufruf auf Create Account die poolAllocationMode-Eigenschaft auf UserSubscription. Dann verwenden Sie die osDisk-Eigenschaft , um eine Referenz auf ein Festplattenabbild in einer Anfrage zum Add Pool zu spezifizieren.

    Von Bedeutung

    Wenn Sie Ihr Batch-Konto erstellen und festlegen, dass Pools im Benutzerabonnement bereitgestellt werden sollen, müssen Sie für alle Anfragen, die über dieses Konto gestellt werden, eine Azure Active Directory-basierte Authentifizierung verwenden.

  • Verwenden Sie Azure Active Directory-basierte Authentifizierung für Anfragen an den Batch-Service.

    Azure Active Directory (Azure AD) wird jetzt zur Authentifizierung von Aufrufen des Batch-Dienstes unterstützt.

    Wenn Ihr Batch-Konto so eingerichtet ist, dass im Benutzerabonnement Pools bereitgestellt werden, ist die Verwendung von Azure AD Authentifizierung erforderlich.

Version 2016-07-01.3.1

Diese Version erweitert alle Unterstützung der vorherigen Version, 2016-02-01.3.0. Zusätzlich unterstützt es folgende Funktionen:

  • Möglichkeit, einen Pool und einen Autopool mit Netzwerkkonfiguration zu erstellen

    • Eine neue Property networkConfiguration wurde sowohl dem Pool als auch den Autopool-Ressourcen hinzugefügt. Diese Eigenschaft kann verwendet werden, um die Rechenknoten des Poolss network configuration, such as the subnet in which the poolzu spezifizieren.

  • Beenden Sie automatisch einen Job, wenn alle Aufgaben erledigt sind.

    • Eine neue Eigenschaft auf AllTasksComplete wurde der Job-Ressource hinzugefügt. Du kannst diese Eigenschaft angeben, wenn du einen Job erstellst oder aktualisierst.

  • Einen Job automatisch beenden oder deaktivieren, wenn eine Aufgabe fehlschlägt.

    • Eine neue Eigenschaft onTaskFailure wurde der Jobressource hinzugefügt, und eine neue Eigenschaft exitConditions wurde der Aufgabenressource hinzugefügt. Die Einstellung Job onTaskFailure gibt an, ob ein Task Failure einen Job-Level-Einfluss haben kann, und die Task exitConditions-Eigenschaft erlaubt es Tasks, die Job-Level-Auswirkung an die Art des Fehlers anzupassen.

  • Verknüpfe Anwendungspakete mit Aufgaben und Pools.

    • Eine neue Eigenschaft applicationPackageReferences wurde zur Aufgabenressource und zu den JobJobManagerTask-Einstellungen hinzugefügt. Diese Eigenschaft erlaubt es, Anwendungspakete auf Abruf bereitzustellen, da Aufgaben sie erfordern, anstatt dass sie bei der Poolerstellung spezifiziert werden müssen. Diese Eigenschaft ist besonders wertvoll für langlebige Pools, die im Laufe ihrer Lebensdauer verschiedene Arten von Aufträgen oder Anwendungsversionen ausführen können.

  • Fähigkeit, eine fehlgeschlagene Aufgabe wieder zu aktivieren.

    • Eine neue Operation Reactivate a Task wurde hinzugefügt, um den Status einer fehlgeschlagenen Aufgabe auf aktiv zurückzusetzen. Dies ermöglicht es, Fehler erneut zu versuchen, zum Beispiel wenn der Fehler vorübergehend war oder wenn man die Ursache beheben konnte, ohne die Aufgabe neu zu erstellen.

Version 2016-02-01.3.0

Diese Version erweitert alle Unterstützung der vorherigen Version, 2015-12-01.2.2. Zusätzlich unterstützt es folgende Funktionen:

  • Möglichkeit, einen Pool und einen Autopool mit IaaS-VM-Konfiguration zu erstellen

    • Bestehende Immobilien osFamily, targetOSVersion und currentOSVersion werden von Top-Level-Objekten von Pool- und Autopool-Ressourcen in eine neue Immobilie namens cloudServiceConfigurationverlegt.

    • Eine neue Immobilie virtualMachineConfiguration wird sowohl den Pool- als auch den Autopool-Ressourcen hinzugefügt. Diese Eigenschaft kann zur Konfiguration eines Pools/Autopools mit IaaS-VMs festgelegt werden.

    • Eine neue API wird hinzugefügt, um Informationen über alle vom Batch-Service unterstützten Node-Agent-SKUs zu erhalten. Siehe Liste unterstützter Node-Agent-SKUs.

    • Eine neue API wurde hinzugefügt, um Remote-Login-Einstellungen zu erhalten, mit denen man sich remote an einem mit der IaaS-VM-Konfiguration erstellten Rechenknoten anmelden kann. Sieh unter Remote-Login-Einstellungen für einen Knoten.

    • Eine neue API wird hinzugefügt, um eine Sammlung von Aufgaben zu einem Job hinzuzufügen. Siehe Add a Collection of Tasks to a Job.

    • Eine neue optionale Eigenschaft sshPublicKey wird der Benutzerressource hinzugefügt, die zum Hinzufügen/Aktualisieren von Benutzern auf einem Linux-Rechenknoten verwendet werden kann.

    • Zwei neue Eigenschaften totalTasksSucceeded und runningTasksCount werden der Node-Ressource hinzugefügt. Diese Eigenschaften können über Get Information about a Node oder List the Compute Nodes in a Pool erhalten werden.

    • Eine neue Eigenschaft fileMode wird dem ResourceFile komplexen Typ hinzugefügt. Diese Eigenschaft wird nur auf Linux-Rechenknoten angewendet und bei Windows-Rechenknoten ignoriert.

    • Eine neue Eigenschaft fileMode wird dem FileProperties komplexen Typ hinzugefügt. Diese Eigenschaft wird vom Batch-Service für Linux-Rechenknoten als Teil der APIs GetFileProperties oder ListFileProperties zurückgegeben. Außerdem wird die bestehende Eigenschaft creationTime unter dem FileProperties komplexen Typ in eine optionale Eigenschaft geändert, da diese Eigenschaft für Linux-Rechenknoten nicht zurückgegeben wird.

    • Der Datentyp der vorhandenen Eigenschaft visibility innerhalb des komplexen CertificateReference Typs wird von einer Zeichenkette mit kommagetrennten Werten zu einer Sammlung von Zeichenketten modifiziert. Außerdem wurde einer der bestehenden Werte für die Sichtbarkeit von "rdp" in "remoteuser" umbenannt.

  • Die URLs der folgenden APIs werden so geändert, dass "?" für den Aktionsnamen durch "/" ersetzt wird:

    • Ersetzen Sie die Eigenschaften eines Pools

    • Automatische Skalierung in einem Pool deaktivieren

    • Automatische Skalierung in einem Pool aktivieren

    • Bewerten Sie eine automatische Skalierungsformel

    • Verändere die Größe eines Pools

    • Hör auf, die Größe eines Pools zu ändern

    • Upgrade des Betriebssystems der Rechenknoten in einem Pool

    • Entferne Rechenknoten aus einem Pool

    • Neustarten eines Knotens

    • Einen Knoten neu abbilden

    • Deaktivieren Sie die Task-Scheduling auf einem Knoten

    • Aktivieren Sie die Aufgabenplanung auf einem Knoten

    • Deaktivieren Sie einen Arbeitsplan

    • Aktivieren Sie einen Arbeitsplan

    • Einen Arbeitsplan beenden

    • Deaktiviere einen Job

    • Aktivieren Sie einen Job

    • Einen Job beenden

    • Eine Aufgabe beenden

    • Die Löschung eines Zertifikats aufheben

Version 2015-12-01.2.2

Diese Version erweitert alle Unterstützung der vorherigen Version, 2015-11-01.2.1. Zusätzlich unterstützt es folgende Funktionen:

  • Anwendungen können nun über Anwendungspakete statt als Ressourcendateien auf Rechenknoten bereitgestellt werden.

    • Neue APIs werden bereitgestellt, damit Clients die Liste verfügbarer Anwendungen und Versionen durchsuchen können, zum Beispiel um einen Selektor in einer Benutzeroberfläche anzuzeigen.

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

  • Aufgaben können nun von anderen Aufgaben abhängig gemacht werden. Eine abhängige Aufgabe startet erst, wenn alle Aufgaben, auf die sie angewiesen ist, erfolgreich abgeschlossen sind.

Diese Version enthält die folgenden weiteren Änderungen:

  • Die Standard-Pool-Resize-Timeout hat sich auf 15 Minuten geändert.

Version 2015-11-01.2.1

Diese Version erweitert alle Unterstützung aus der vorherigen Version 2015-06-01.2.0. Zusätzlich unterstützt es folgende Funktionen:

  • Möglichkeit, Multi-Instanz-Aufgaben hinzuzufügen und auszuführen (zum Beispiel MPI)

    • Eine neue optionale Eigenschaft multiInstanceSettings wird der Task-Ressource hinzugefügt, die optional in den APIs "Aufgabe hinzufügen, Aufgabe abrufen, Aufgabenliste auflisten" enthalten sein kann.

    • Eine neue API-Liste der Unteraufgaben einer Aufgabe wird hinzugefügt, um Informationen über Unteraufgaben zu erhalten.

    • Eine neue optionale Eigenschaft subtaskId wird für einen Compute-Node hinzugefügt recentTasks . Diese Eigenschaft wird als Teil von Get Compute Node und List Compute Nodes zurückgegeben

  • Möglichkeit, die Aufgabenplanung auf einem Rechenknoten zu deaktivieren oder zu aktivieren

    • Zwei neue APIs: Aufgabenplanung auf einem Knoten deaktivieren und Aufgabenplanung auf einem Knoten aktivieren, werden auf der Compute-Node-Ressource hinzugefügt.

    • Ein neuer Rechenknotenzustand offline wird hinzugefügt. Für ältere API-Versionen wird dieser Zustand auf unusableabgebildet.

    • Eine neue Eigenschaft schedulingState wird der Compute-Node-Ressource hinzugefügt. Mögliche Werte für enabled und disabled.

  • Fähigkeit, Auto--scale-Evaluationsintervall auf einem Pool/Autopool anzugeben

    • Ein neues Grundstück autoScaleEvaluationInterval wird der Poolressource hinzugefügt. Diese Eigenschaft kann in den APIs Add Pool, Get Pool, Enable Auto -Scale und List Pools enthalten sein.

    • Ähnlich wird bei Autopools eine neue Immobilie autoScaleEvaluationInterval hinzugefügt autoPoolSpecification . Diese Eigenschaft kann in Job hinzufügen, Auftrag abrufen, Aufträge listen, Jobpläne hinzufügen, Jobplan hinzufügen, Jobplan abrufen, Jobplan aktualisieren, Jobpläne listen und Jobs auflisten in Jobplan-APIs enthalten sein.

  • Verbesserung der Aufgaben-APIs, um das Wurzelverzeichnis der Aufgabe auf dem Rechenknoten zurückzugeben.

    • Zwei neue Eigenschaften taskRootDirectory werden taskRootDirectoryUrl zur Aufgabenressource hinzugefügt, die als Teil von Get Information on a Task, List Tasks APIs, erhalten werden können

    • Eine neue Eigenschaft taskRootDirectory wird hinzugefügt jobPreparationTaskExecutionInfo , die jobReleaseTaskExecutionInfo über List the Status of the job preparation und job release tasks für eine Job-API erhalten werden kann.

  • Last updated on