Dávkové služby REST API Versioning

Operace poskytované dávkovým servisním REST API mohou mít více verzí pro zpětnou kompatibilitu, jak se API v průběhu času vyvíjí. Musíte určit, kterou verzi operace chcete použít, když je volána, tím, že verzi poskytnete s vaším REST voláním. Pokud vaše aplikace volá starší verzi operace, můžete zvolit pokračování ve volání starší verze, nebo upravit kód tak, aby volal novější verzi. Pokud verze není specifikována nebo je uvedena nesprávná verze, vrátí se chyba.

Pro určení, kterou verzi operace použít, nastavte parametr dotazu na verzi API . Verze je ve formátu Group.Major.Minor, kde Group je ve formátu YYYY-MM-DD , Major je celé číslo a Minor je celé číslo.

Nejnovější verze: 2025-06-01

Předchozí verze

Předchozí verze zahrnují:

Verze: 2024-07-01.20.0

  • Přidáno delokace výpočetního uzlu a spuštění operací:
    • Přidán nový ComputeNode_Deallocate provoz (POST /pools/{poolId}/nodes/{nodeId}/deallocate) pro deallokaci nečinného nebo běžícího výpočetního uzlu.
    • Přidán nový ComputeNode_Start provoz (POST /pools/{poolId}/nodes/{nodeId}/start) pro restart dříve vyčleněného výpočetního uzlu.
    • Přidán nový NodeDeallocateParameter model s vlastností nodeDeallocateOption specifikující, co dělat s běžícími úkoly během deallocation.
  • [Lámání] Odstraněna ComputeNode_GetRemoteDesktop operace (GET /pools/{poolId}/nodes/{nodeId}/rdp). Tato operace byla použitelná pouze pro konfigurační pooly Cloud Service.
  • [Lámání] Podpora Cloud Service Configuration poolu odstraněna:
    • Odstraněný CloudServiceConfiguration model.
    • Odebrána cloudServiceConfiguration vlastnost z CloudPool, PoolAddParameter, a .PoolSpecification
  • [Lámání] Odebrána applicationLicenses vlastnost z CloudPool, PoolAddParameter, a .PoolSpecification
  • Přidáno připojení k kontejnerovým vazbám pro úkoly:
    • Přidán nový ContainerHostBatchBindMountEntry model s source vlastnostmi isReadOnly .
    • Přidáno nové ContainerHostDataPath enum s hodnotami Shared, Startup, VfsMounts, Task, JobPrep, a .Applications
    • Byla přidána nová containerHostBatchBindMounts vlastnost do TaskContainerSettingssouboru .
  • Přidána podpora důvěrných VM:
    • Přidán nový VMDiskSecurityProfile model s nemovitostí securityEncryptionType .
    • Byla přidána nová securityProfile vlastnost do ManagedDisksouboru .
    • Přidáno confidentialVM jako nová hodnota pro SecurityProfile.securityType.
  • Přidány deallocated a jako deallocating nové hodnoty pro ComputeNodeState.
  • Přidány nové požadované deallocated a vlastnosti do NodeCountsdeallocating .
  • Přidáno sdílené galerie a podpora referenčních obrázků komunitní galerie:
    • Přidáno sharedGalleryImageId a vlastnosti communityGalleryImageId k ImageReference.
  • Přidány skipWithdrawFromVNet vlastnosti k pro JobNetworkConfiguration kontrolu, zda uzly zůstanou připojeny k VNetu i po skončení práce.
  • Přidáno networkConfiguration vlastnost k JobPatchParameter.
  • Rozšířené možnosti záplatování poolu: Přidány displayName, vmSize, taskSlotsPerNode, taskSchedulingPolicy, networkConfigurationmountConfigurationenableInterNodeCommunicationuserAccountsupgradePolicyvirtualMachineConfigurationa resourceTags vlastnosti do .PoolPatchParameter Vlastnosti ovlivňující topologii poolu lze aktualizovat pouze tehdy, když je pool prázdný.
  • Přidán force booleovský dotazovací parametr do Job_Delete, Job_Terminate, JobSchedule_Delete, a JobSchedule_Terminate operace pro vynucení operace.

Verze: 2024-02-01.19.0

  • Přidána podpora politiky upgradu OS pro VM pooly:
    • Přidán nový UpgradePolicy model s vlastnostmi mode, automaticOSUpgradePolicy, a rollingUpgradePolicy. Vlastnost mode (UpgradeMode) přijímá hodnoty automatic, manual, a rolling.
    • Přidán nový AutomaticOSUpgradePolicy model s vlastnostmi disableAutomaticRollback, enableAutomaticOSUpgrade, useRollingUpgradePolicy, a .osRollingUpgradeDeferral
    • Přidán nový RollingUpgradePolicy model s vlastnostmi enableCrossZoneUpgrade, maxBatchInstancePercent, maxUnhealthyInstancePercent, pauseTimeBetweenBatchesmaxUnhealthyUpgradedInstancePercent, , prioritizeUnhealthyInstancesa .rollbackFailedInstancesOnPolicyBreach
    • Přidány nové upgradePolicy vlastnosti do CloudPool, PoolAddParameter, a PoolSpecification.
  • Přidáno upgradingos jako nová hodnota pro ComputeNodeState.
  • Přidány nové požadované upgradingOS vlastnosti pro NodeCounts hlášení počtu uzlů ve státě upgradingos .

Verze: 2023-11-01.18.0

  • Přidáno podpora Trusted Launch / bezpečnostních profilů pro VM pooly:
    • Přidán nový SecurityProfile model s vlastnostmi encryptionAtHost, securityType, a uefiSettings.
    • Přidán nový UefiSettings model s vlastnostmi secureBootEnabled a .vTpmEnabled
    • Byla přidána nová securityProfile vlastnost do VirtualMachineConfigurationsouboru .
  • Přidána podpora referenčních artefaktů služeb pro škálovací sady:
    • Přidán nový ServiceArtifactReference model s požadovanou id vlastností (ARM resource ID).
    • Přidáno nové serviceArtifactReference vlastnosti pro VirtualMachineConfiguration nastavení stejné verze obrazu pro všechny VM v škálovací sadě při použití verze latest obrazu.
  • Vylepšená konfigurace disku OS:
    • Přidán nový ManagedDisk model s nemovitostí storageAccountType .
    • Přidány nové vlastnosti k OSDisk: caching, diskSizeGB, , managedDiska writeAcceleratorEnabled.
  • Přidáno StandardSSDLRS (standardssd_lrs) jako novou hodnotu pro StorageAccountType.
  • Přidány nové vlastnosti resourceTags do CloudPool, PoolAddParameter a PoolSpecification, aby bylo možné propagovat uživatelsky definované tagy na zálohu Azure zdrojů. Platí pouze v případě, že poolAllocationMode je UserSubscription.
  • Přidán nový scaleSetVmResourceId vlastnost, která VirtualMachineInfo umožňuje zobrazit ID zdroje aktuálního VM Virtual Machine Scale Set výpočetního uzlu. Definováno pouze tehdy, když je dávkový poolAllocationMode účet .UserSubscription

Verze: 2023-05-01.17.0

  • [Lámání] Odstraněno API pro statistiky životnosti batch jobů/poolů: lifetimejobstats a lifetimepoolstats.
  • Přidán booleovský vlastnost enableAcceleratedNetworking do NetworkConfiguration.
    • Tato vlastnost určuje, zda by měl tento pool povolit zrychlené síťování, přičemž výchozí hodnota je False.
    • Zda lze tuto funkci povolit, závisí také na tom, zda je podporována instance operačního systému nebo VM, což by mělo být v souladu s politikou AcceleratedNetworking Policy.
  • Přidán booleovský vlastnost enableAutomaticUpgrade do VMExtension.
    • Tato vlastnost určuje, zda by mělo být rozšíření automaticky aktualizováno, pokud je k dispozici novější verze rozšíření.
  • Vlastnost typeContainerConfiguration, která nyní podporuje dvě hodnoty: DockerCompatible a CriCompatible.

Verze: 2022-10-01.16.0

  • Přidány nové NodeCommunicationMode vlastnosti, které určují, jak pool komunikuje se službou Batch
  • Přidány nové currentNodeCommunicationMode vlastnosti NodeCommunicationMode tohoto typu do modelu CloudPool , které odkazují na aktuální stav režimu komunikace poolu.
  • Přidány nové targetNodeCommunicationMode vlastnosti NodeCommunicationMode tohoto typu do následujících modelů, které odkazují na požadovaný komunikační režim uzlu pro pool:
    • PoolSpecification
    • CloudPool
    • PoolAddParameter
    • PoolPatchParameter
    • PoolUpdatePropertiesParameter

Verze: 2022-01-01.15.0

  • Přidány nové uploadHeaders vlastnosti modelu OutputFileBlobContainerDestination , které umožňují uživatelům nastavit vlastní HTTP hlavičky při nahrávání resource souborů.
  • Přidány nové allowTaskPreemption vlastnosti do následujících modelů pro podporu předem úkolů u úkolů s vyšší prioritou (vyžaduje Comms-Enabled nebo Single Tenant Pool):
    • JobSpecification
    • CloudJob
    • JobAddParameter
    • JobPatchParameter
    • JobUpdateParameter

Verze: 2021-06-01.14.0

  • Přidejte možnost přiřazovat uživatelem přiřazené spravované identity k CloudPool. Tyto identity jsou dostupné na každém uzlu v poolu a lze je použít k přístupu k různým zdrojům.
  • Přidány identityReference vlastnosti k následujícím modelům pro podporu přístupu ke zdrojům prostřednictvím spravované identity:
    • AzureBlobFileSystemConfiguration
    • OutputFileBlobContainerDestination
    • ContainerRegistry
    • ResourceFile
    • UploadBatchServiceLogs
  • Přidáno nové extensions vlastnosti do VirtualMachineConfiguration pro CloudPool specifikaci rozšíření virtuálních strojů pro uzly
  • Přidána možnost specifikovat dostupné zóny pomocí nové vlastnosti nodePlacementConfiguration ve VirtualMachineConfiguration
  • Přidány nové osDisk vlastnosti do VirtualMachineConfiguration, která obsahuje nastavení pro disk operačního systému virtuálního stroje.
    • Vlastnost placement on DiffDiskSettings specifikuje dočasné umístění disků operačního systému pro všechny VM v poolu. Nastavím ho na "CacheDisk" pro uložení efemérního OS disku do VM cache.
  • Přidáno maxParallelTasks vlastnost on pro CloudJob řízení maximálního počtu úkolů, které mohou běžet současně na jednu úlohu (výchozí -1 znamená neomezené). Tato nemovitost je momentálně v soukromé přehlídce.
  • Přidaná virtualMachineInfo vlastnost obsahuje ComputeNode informace o aktuálním stavu virtuálního stroje, včetně přesné verze image marketplace, kterou VM používá.
  • Přidáno recurrenceInterval vlastnost k Schedule pro řízení intervalu mezi začátky dvou po sobě jdoucích úloh v rámci harmonogramu úloh.

Verze: 2020-09-01.12.0

  • [Lámání] Nahradil jsem nemovitost maxTasksPerNode na bazénu taskSlotsPerNode . Použití této vlastnosti může úkoly v práci spotřebovávat dynamický počet slotů, což umožňuje jemnější kontrolu nad spotřebou zdrojů.
  • [Lámání] Typ odpovědi na GetTaskCounts return TaskCountsResult, což je komplexní objekt obsahující předchozí TaskCounts objekt a nový TaskSlotCounts objekt poskytující podobné informace v kontextu používaných slotů.
  • Přidáno vlastnost requiredSlots úkolu, která umožňuje uživateli určit, kolik slotů na uzlu by měla zabírat.

Verze: 2020-03-01.11.0

  • Přidána možnost šifrování diskových jednotek ComputeNode pomocí nové DiskEncryptionConfiguration vlastnosti .VirtualMachineConfiguration
  • [Lámání] Vlastnost virtualMachineImageIdImageReference nyní může odkazovat pouze na Shared Image Gallery obraz.
  • [Lámání] Vlastnost password těla Add Certificate provozu požadavků je volitelná pro certifikáty formátované PFX.
  • [Lámání] Pooly lze nyní provisionovat bez veřejné IP pomocí nové PublicIPAddressConfiguration vlastnosti NetworkConfiguration.
  • [Lámání] Nemovitost publicIPsNetworkConfiguration byla přejmenována ipAddressIds a také se přestěhovala PublicIPAddressConfiguration . Tuto vlastnost lze specifikovat pouze tehdy, pokud provision je vlastnost .usermanaged

Verze: 2019-08-01.10.0

  • Přidána možnost specifikovat kolekci veřejných IP adres přes NetworkConfiguration novou publicIPs vlastnost v poolu. To zaručuje, že uzly v poolu mají IP adresu ze seznamu IP adres poskytnutých uživatelem.
  • Přidána možnost připojit vzdálené souborové systémy na každý uzel poolu prostřednictvím MountConfiguration vlastnosti.
  • Shared Image Gallery obrázky lze nyní specifikovat podle vlastnosti virtualMachineImageIdImageReference odkazováním na obrázek přes jeho Azure Resource Manager ID.
  • [Lámání] Pokud není specifikováno, výchozí hodnota pro waitForSuccess on StartTask je true (dříve to bylo false).
  • [Lámání] Pokud není specifikováno, výchozí hodnota scope na AutoUserSpecification je nyní vždy Pool (dříve to bylo Task na Windows uzlech a Pool na linuxových uzlech).
  • Zlepšil různé matoucí nebo neúplné dokumenty.

Verze: 2019-06-01.9.0

  • [Lámání] Nahrazeno ListNodeAgentSKUs .ListSupportedImages ListSupportedImages obsahuje všechny stejné informace, které byly původně dostupné ListNodeAgentSKUs , ale v jasnější podobě. Nové, neověřené obrázky jsou nyní také vraceny. Další informace o Capabilities a BatchSupportEndOfLife jsou dostupné prostřednictvím ImageInformation.

  • Nyní podporujte síťová bezpečnostní pravidla blokující síťový přístup na CloudPool základě zdrojového portu provozu. Toto pravidlo se provádí pomocí SourcePortRanges vlastnosti na NetworkSecurityGroupRule.

  • Při spuštění kontejneru teď Služba Batch podporuje provádění úlohy v pracovním adresáři kontejneru nebo v pracovním adresáři úkolu batch. Toto je řízeno WorkingDirectory vlastností na TaskContainerSettings.

  • Zlepšil různé matoucí nebo neúplné dokumenty.

Verze: 2018-12-01.8.0

  • [Lámání] Odstraněna podpora pro upgradeos on-pools cloudServiceConfiguration .

    • Bylo odebráno upgradeos.
    • Přejmenováno targetOSVersion na osVersion a odstraněno currentOSVersion na CloudPool.
    • Odebrané upgrading z objektu PoolState.

  • [Lámání] Odstraněno dataEgressGiB a dataIngressGiB z poolusagemetrics. Tyto nemovitosti již nejsou podporovány.

  • [Lámání]ResourceFile Vylepšení

    • Přidáno možnost specifikovat celý Azure Storage kontejner v ResourceFile. Nyní jsou pro ResourceFile podporovány tři režimy:
      • httpUrl vytváří ResourceFile odkaz na jednu HTTP URL.
      • storageContainerUrl vytvoří ResourceFile ukazující na Azure Blob Storage kontejner.
      • autoStorageContainerName vytvoří ResourceFile ukazující na Azure Blob Storage kontejner v účtu registrovaném v Batch autostorage.
    • URL adresy poskytované touto ResourceFile metodou httpUrl mohou nyní být jakékoliv HTTP URL. Dříve musely tyto URL být Azure Blob Storage URL.
    • blobPrefix lze použít k filtrování stažených souborů z úložného kontejneru pouze na ty, které odpovídají předponě.

  • [Lámání] Odebrána osDisk vlastnost z VirtualMachineConfiguration. Tato nemovitost již není podporována.

  • Pooly, které nastaví dynamicVNetAssignmentScope na NetworkConfiguration na job, nyní mohou dynamicky přiřadit Virtual Network každému uzlu jobs tasks run on. The specific Virtual Network to join the nodes to is specified in the new JobNetworkConfigurationproperty onCloudJobandJobSpecification'.

    Poznámka:

    Tato funkce je ve verzi Public Preview. Je deaktivován pro všechny Batch účty kromě těch, které nás kontaktovaly a požádaly o účast v pilotním projektu.

  • Maximální životnost úkolu je nyní 180 dní (dříve to bylo 7).

  • Přidána podpora Windows poolů pro vytváření uživatelů se specifickým přihlašovacím režimem (buď batch nebo interactive) přes LoginMode.

  • Výchozí doba udržení úkolů pro všechny úkoly je nyní sedm dní, dříve byla nekonečná.

Verze 2018-08-01.7.0

Nové funkce ve verzi 2018-08-01.7.0 zahrnují:

  • Prohlédněte si verzi Azure Batch Node Agenta prostřednictvím nové vlastnosti NodeAgentInfo na ComputeNode.
  • Přidáno možnost zadat na Filter úkol.Result Další podrobnosti najdete tady.
    • To umožňuje často žádanému scénáři provedení dotazu na straně serveru najít všechny úkoly, které selhaly.
  • [Lámání] Vlastnost jsem odstranil ValidationStatus z TaskCounts.
  • [Lámání] Výchozí typ cache pro DataDisk a OSDisk je nyní ReadWrite místo .None
  • [Lámání] Přejmenována jediná hodnota ContainerType z docker na dockerCompatible.

Verze 2018-03-01.6.1

Nové funkce ve verzi 2018-03-01.6.1 zahrnují:

  • Počty uzlů poolu podle stavu: Tato verze přidává možnost dotazovat se na počty uzlů poolu podle stavu prostřednictvím nové operace ListPoolNodeCounts. Tato operace vám umožňuje dotazovat všechny pooly v Batch účtu na stavy uzlů.
  • Logy node agentů: Tato verze přidává možnost nahrávat logy agenta Azure Batch node z konkrétního uzlu prostřednictvím operace UploadBatchServiceLogs. Tento log je určen k ladění Microsoft Support v případě problémů na uzlu.

Verze 2017-09-01.6.0

  • Azure Hybrid Use Benefit: Nyní můžete vytvářet hromadné Windows VM pooly s tím, že je nutné používat Azure Hybrid Use Benefit licencování. Při použití této licence se na cenu VM uplatňuje sleva. Použijte novou vlastnost LicenseType ve VirtualMachineConfiguration.

  • Datové disky VM poolu: Můžete připojit jeden nebo více prázdných datových disků k VM poolům pomocí nové konfigurace datového disku, která je součástí konfigurace virtuálního stroje. Použijte vlastnost DataDisks ve VirtualMachineConfiguration.

  • (Lámání drobných) Vlastní obrázky se nyní vytvářejí a nasazují pomocí zdrojů obrazů Azure Resource Manager místo VHD souborů blob. Batch nyní používá spravované disky k vytváření VM poolu a proto využívá zdroj obrazu . Nyní neexistuje žádné omezení počtu VM v poolu vytvořeném pomocí vlastního image; také už není potřeba více kopií VHD blobu pro velké pooly. Vlastní obrazové pooly jsou proto mnohem jednodušší na tvorbu a škálování. Pro více informací viz Použít vlastní obraz k vytvoření poolu virtuálních strojů.

    • Nová vlastnost VirtualMachineImageId v ImageReference obsahuje odkaz na Image a OSDisk.ImageUris již neexistuje.

    • Díky této změně je ImageReference nyní povinnou vlastností VirtualMachineConfiguration.

  • (Roztrhání drobných) Víceinstatencové úlohy (vytvořené pomocí MultiInstanceSettings) nyní musí specifikovat CoordinationCommandLine, a NumberOfInstances je nyní volitelný a výchozí 1.

  • Přidána podpora pro úlohy spouštěné pomocí Docker kontejnerů. Pro spuštění úlohy pomocí Docker kontejneru musíte zadat ContainerConfiguration ve VirtualMachineConfiguration pro pool a poté přidat TaskContainerSettings do Task.

Verze 2017-06-01.5.1

Verze Batch API popsaná zde je 2017-06-01.5.1. Doporučuje se používat nejnovější verzi, pokud je to možné.

Nové funkce ve verzi 2017-06-01.5.1 zahrnují:

  • Podpora efektivního počítání úkolů prostřednictvím nové operace Získat počty úkolů. Zavoláním operace Get Task Counts můžete získat počet aktivních, běžících a dokončených úkolů, stejně jako úkolů, které uspěly nebo ne. Pro více informací viz Počet úloh pro práci podle státu (Náhled).
  • Podpora specifikace příchozích koncových bodů na výpočetních uzlech poolu prostřednictvím nové vlastnosti poolEndpointConfiguration . Nastavením této vlastnosti můžete externě adresovat konkrétní porty na uzlu.

Verze 2017-05-01.5.0

Následující sekce popisují nové a změněné funkce ve verzi 2017-05-01.5.0.

Důležité

Verze 2017-05-01.5.0 obsahuje několik zásadních změn. Prohlédněte si aktuální změny a aktualizujte svůj kód na verzi 2017-05-01.5.0.

Výpočetní uzly s nízkou prioritou

Azure Batch nyní nabízí nízkoprioritní výpočetní uzly pro snížení nákladů na dávkové zátěže. VM s nízkou prioritou umožňují nové typy dávkových pracovních zátěží tím, že poskytují velké množství výpočetního výkonu, který je zároveň ekonomický.

Existuje několik změn v REST API pro uzly s nízkou prioritou:

  • (Roztrhání drobných) Vlastnosti targetDedicated a currentDedicated poolu nebo specifikace poolu byly přejmenovány na targetDedicatedNodes a currentComputeNodes.
  • (Roztrhání drobných) Vlastnost resizeError v poolu je nyní kolekce nazvaná resizeErrors.
  • Výpočetní uzly mají novou vlastnost isDediced . Tato vlastnost platí pro dedikované uzly a nepravdivá pro uzly s nízkou prioritou.
  • Úloha Správce úloh má novou vlastnost allowLowPriorityNode . Pokud je tato vlastnost pravdivá, může úkol Správce úloh běžet na uzlu s nízkou prioritou. Pokud je nepravdivá, pak úloha Správce úloh běží na vyhrazeném výpočetním uzlu.

Jmenovaní uživatelé na Linuxu

Azure Batch nyní nabízí dodatečnou podporu pro vytváření pojmenovaných uživatelů na Linuxových uzlech.

  • Nová vlastnost linuxUserConfiguration podporuje zadání uid (uživatelského ID) a gid (skupinové ID) při vytváření linuxového uživatele.
  • (Roztrhání drobných) Vlastnost sshPrivateKey byla přesunuta z vlastnosti userAccount do nové vlastnosti linuxUserConfiguration . Vlastnost linuxUserConfiguration je sama vlastností vlastnosti userAccount .

Pro více informací o pojmenovaných uživatelských účtech viz Spouštět úkoly pod uživatelskými účty v Batch.

Výstupní soubory pro data o úkolech

Nyní můžete specifikovat výstupní soubory, které nahrají data o úkolu po dokončení úkolu.

  • Nová vlastnost outputFiles podporuje specifikaci úkolových souborů pro nahrání na Azure Storage.
  • Nová vlastnost fileUploadError vlastnosti exitConditions podporuje specifikování akcí na základě stavu nahrávání výstupního souboru.

Hlášení chyb v úkolech

Bylo provedeno několik změn ke zlepšení reportování chyb v úkolech.

  • Nová vlastnost výsledku vlastnosti executionInfo ukazuje, zda úkol uspěl nebo neuspěl.
  • (Roztrhání drobných) Vlastnost scheduleulingError vlastnosti executionInfo byla přejmenována na failureInfo. Vlastnost failureInfo se vrací pokaždé, když dojde k selhání úkolu. To zahrnuje všechny předchozí případy chyb při plánování, případy, kdy je vrácen nenulový výstupní kód úkolu, a případné selhání nahrávání souborů.
  • (Roztrhání drobných) Vlastnost schedulingError vlastnosti exitConditions byla přejmenována na preProcessingError , aby bylo jasné, kdy k chybě došlo v životním cyklu úkolu.
  • (Roztrhání drobných) Vlastnost plánováníChybaKategorie byla přejmenována na kategorii chybKategorie.

Aplikační licence

Nyní můžete požádat o přidělení aplikačních licencí do vašeho poolu prostřednictvím nové vlastnosti applicationLicenses na poolu nebo specifikaci poolu.

Verze 2017-01-01.4.0

Tato verze rozšiřuje veškerou podporu oproti předchozí verzi, 2016-07-01.3.1. Navíc podporuje následující schopnosti:

  • Spusť úlohu pod specifikovanou uživatelskou identitou.

    Nyní můžete spustit úlohu nebo kolekci úloh pod jednou z následujících identit uživatelů, specifikovanou pomocí nové vlastnosti userIdentity v resource tasku:

    • Uživatelský účet s jménem, které definujete sami.

    • Uživatelský účet, který se automaticky vytváří (autouser). Automatický uživatel může běžet jako administrátorský uživatel nebo jako neadministrátor. Ve výchozím nastavení běží automatický uživatel jako neadministrátor.

      Důležité

      Vlastnost userIdentity s vlastností elevationLevel nahrazuje vlastnost runElevated v požadavcích, které přidávají úkol nebo kolekci úloh, a v odpovědích, které získávají informace o úkolu nebo které vyjmenovávají úkoly.

      Pokud provedete požadavek, který obsahuje vlastnost runElevated do verze 2017-01-01.4.0 služby Batch, požadavek selže.

      Pro spuštění jako administrátor aktualizujte aplikaci tak, aby používala vlastnost userIdentity a nastavte vlastnost elevationLevel na admin.

      Pro spuštění jako neadministrátorský uživatel aktualizujte svou aplikaci tak, aby používala vlastnost userIdentity , nastavte vlastnost elevationLevel na nonAdmin. Protože toto nastavení je výchozí, můžete ho také vynechat.

  • Definujte uživatelské účty napříč všemi uzly v poolu.

    Nyní můžete spustit úkol nebo kolekci úkolů pod uživatelským účtem, který definujete na zdroji poolu. Definujte uživatelský účet pomocí vlastnosti new userAccountsAccounts v požadavcích na přidání poolu. Když definujete účet, můžete zadat název účtu, heslo, úroveň nadmořské úrovně (admin nebo neadmin) a SSH soukromý klíč (pro Linuxové pooly).

    Jakmile definujete uživatelský účet, můžete tento uživatelský účet specifikovat pro vlastnost userIdentity v požadavcích, které přidávají úkol nebo kolekci úloh.

  • Poskytnout úkolu token, který se při spuštění úkolu autentizuje u služby Batch.

    Batch služba nyní může při spuštění úkolu poskytnout autentizační token. Autentizační token umožňuje úkolu odesílat požadavky související s úkolem na službu Batch, bez klíčů Batch účtu. Token se poskytuje prostřednictvím proměnné prostředí AZ_BATCH_AUTHENTICATION_TOKEN.

    V současnosti jsou autentizační tokeny podporovány pouze pro volání operací na zdroji práce. Autentizační token umožňuje přístup ke všem operacím na úkolu, který úkol obsahuje.

    Aby služba Batch poskytla autentizační token, zadejte novou vlastnost authenticationTokenSettings spolu s její přístupovou vlastností v požadavcích na Přidání úkolu nebo Přidání kolekce úloh.

  • Specifikujte akci, která převezme závislosti úkolu, pokud úkol selže.

    Nyní můžete specifikovat, že závislé úkoly pokračují i v případě, že úkol, na kterém závisí, selže. Nastavte novou vlastnost dependencyAction pro zdroj úkolu tak, aby splňovala spouštění závislých úloh i v případě, že nadřazený úkol selže. Alternativně nastavte dependencyAction na blokování , aby se zabránilo spouštění závislých úloh, pokud rodičovský úkol selže.

    Specifikujte vlastnost dependencyAction v požadavcích na přidání úkolu nebo přidání kolekce úkolů.

    Pro více informací o použití dependencních akcí viz Dependency actions.

  • Při vytváření poolu používejte vlastní obrazy disků OS.

    Nyní můžete použít vlastní obrazy disků OS k vytvoření poolu.

    K tomu musíte při vytváření Batch účtu specifikovat, že pooly budou provisionovány v uživatelském předplatném, nikoli v předplatném spravovaném službou Batch. Při volání k vytvoření účtu nastavte vlastnost poolAllocationMode na UserSubscription. Poté použijte vlastnost osDisk k určení odkazu na obraz disku v požadavku na přidání poolu.

    Důležité

    Když vytvoříte svůj Batch účet, pokud specifikujete, že pooly mají být nastaveny v uživatelském předplatném, musíte použít autentizaci založenou na Azure Active Directory pro všechny požadavky přes tento účet.

  • Použijte autentizaci založenou na Azure Active Directory pro požadavky na službu Batch .

    Azure Active Directory (Azure AD) je nyní podporován pro autentizaci volání do služby Batch.

    Pokud je váš batch účet nastaven tak, aby v uživatelském předplatném zřizoval pooly, je potřeba použít autentizaci přes Azure AD.

Verze 2016-07-01.3.1

Tato verze rozšiřuje veškerou podporu oproti předchozí verzi, 2016-02-01.3.0. Navíc podporuje následující schopnosti:

  • Schopnost vytvářet pool a autopool s konfigurací sítě

    • Do zdrojů poolu i autopoolu byla přidána nová vlastnostní síťová konfigurace. Tato vlastnost může být použita ke specifikaci výpočetních uzlů poolus network configuration, such as the subnet in which the pool, které jsou vytvořeny.

  • Automaticky ukončit úkol, když jsou všechny úkoly dokončeny.

    • Do zdroje práce byla přidána nová vlastnost na AllTasksComplete. Tuto vlastnost můžete specifikovat při vytváření nebo aktualizaci práce.

  • Automaticky ukončit nebo deaktivovat úlohu, když úkol selže.

    • Do zdroje úkolu byla přidána nová vlastnost onTaskFailure a do zdroje úkolu byla přidána nová vlastnost exitConditions. Nastavení job onTaskFailure ukazuje, zda může selhání úkolu mít dopad na úroveň práce, a vlastnost výstupní podmínky úkolu umožňuje úkolům přizpůsobit dopad na úroveň úkolu povaze selhání.

  • Spojte aplikační balíčky s úkoly a pooly.

    • Nová vlastnost applicationPackageReferences přidány do resource task a do nastavení jobManagerTask. Tato vlastnost umožňuje nasazování aplikačních balíčků na vyžádání podle požadavků úkolů, místo aby byly specifikovány při vytváření poolu. Tato vlastnost je zvláště cenná pro dlouhodobé pooly, které mohou být během své životnosti potřebovány k provozování různých typů úloh nebo verzí aplikací.

  • Schopnost znovu aktivovat neúspěšný úkol.

    • Byla přidána nová operace Reaktivovat úkol, která resetuje stav neúspěšného úkolu na aktivní. To umožňuje opakované pokusy o selhání, například pokud selhání bylo přechodné nebo pokud jste dokázali opravit příčinu selhání bez nutnosti znovu vytvořit úkol.

Verze 2016-02-01.3.0

Tato verze rozšiřuje veškerou podporu z předchozí verze, 2015-12-01.2.2. Navíc podporuje následující schopnosti:

  • Možnost vytvořit pool a autopool s konfigurací IaaS VM

    • Stávající vlastnosti osFamily, a jsou currentOSVersion přesunuty z vrchních vlastností zdrojů Pool a Autopool a jsou přesunuty uvnitř nové vlastnosti nazvané cloudServiceConfigurationtargetOSVersion .

    • Do zdrojů Pool i Autopool je přidána nová vlastnost virtualMachineConfiguration . Tuto vlastnost lze specifikovat pro konfiguraci pool/auto poolu s IaaS VM.

    • Je přidáno nové API pro získání informací o všech SKU agentů uzlů podporovaných službou Batch. Viz Seznam podporovaných SKU agentů uzlů.

    • Přidáno je nové API pro získání vzdálených přihlašovacích nastavení, která lze použít k vzdálenému přihlášení k výpočetnímu uzlu vytvořenému s konfigurací IaaS VM. Viz Nastavení vzdáleného přihlášení pro uzel.

    • Je přidáno nové API, které přidává kolekci úkolů do úlohy. Viz Přidat sbírku úkolů k práci.

    • Do uživatelského zdroje je přidána nová volitelná vlastnost sshPublicKey , kterou lze použít k přidávání a aktualizaci uživatelů na výpočetním uzlu Linuxu.

    • Dvě nové vlastnosti totalTasksSucceeded a runningTasksCount jsou přidány do zdroje Node. Tyto vlastnosti lze získat pomocí Získat informace o uzlu nebo Seznam výpočetních uzlů ve skupině.

    • Do komplexního ResourceFile typu je přidána nová nemovitostfileMode. Tato vlastnost se uplatňuje pouze na výpočetních uzlech Linuxu a ignoruje se u výpočetních uzlů Windows.

    • Do komplexního FileProperties typu je přidána nová nemovitostfileMode. Tato vlastnost je vrácena službou Batch pro výpočetní uzly Linuxu jako součást API GetFileProperties nebo ListFileProperties. Také stávající vlastnost creationTime pod komplexním typem FileProperties je změněna na volitelnou, protože tato vlastnost se nevrátí pro výpočetní uzly Linuxu.

    • Datový typ existující vlastnosti visibility uvnitř komplexního CertificateReference typu je upraven z řetězce s hodnotami oddělenými čárkami na kolekci řetězců. Jedna z existujících hodnot viditelnosti byla také přejmenována z "rdp" na "remoteuser".

  • URL adresy následujících API jsou změněny tak, aby místo názvu akce bylo "?" na "/":

    • Nahraďte vlastnosti bazénu

    • Vypněte automatické škálování na poolu

    • Povolit automatické škálování na poolu

    • Vyhodnoťte automatický škálovací vzorec

    • Změnit velikost bazénu

    • Přestaňte měnit velikost bazénu

    • Aktualizace operačního systému výpočetních uzlů v poolu

    • Odstraňte výpočetní uzly z poolu

    • Restartujte uzel

    • Reimage uzlu

    • Vypněte plánování úloh na uzlu

    • Povolit plánování úloh na uzlu

    • Vypněte rozvrh úloh

    • Povolte rozvrh úloh

    • Ukončit pracovní rozvrh

    • Vypnout práci

    • Povolit práci

    • Ukončit práci

    • Ukončit úkol

    • Zrušit smazání certifikátu

Verze 2015-12-01.2.2

Tato verze rozšiřuje veškerou podporu oproti předchozí verzi, 2015-11-01.2.1. Navíc podporuje následující schopnosti:

  • Aplikace nyní mohou být nasazovány pro výpočetní uzly pomocí aplikačních balíčků místo jako resource souborů.

    • Pro klienty jsou poskytována nová API pro procházení seznamu dostupných aplikací a verzí, například pro zobrazení selektoru v uživatelském rozhraní.

    • API související s poolem jsou změněna tak, aby poolu umožnila specifikovat aplikační balíčky, které mají být staženy na všechny uzly v daném poolu.

  • Úkoly nyní mohou být závislé na jiných úkolech. Závislý úkol nezačne, dokud nejsou všechny úkoly, na kterých závisí, úspěšně dokončeny.

Tato verze obsahuje následující další změny:

  • Výchozí časový limit pro změnu velikosti poolu se změnil na 15 minut.

Verze 2015-11-01.2.1

Tato verze rozšiřuje veškerou podporu z předchozí verze 2015-06-01.2.0. Navíc podporuje následující schopnosti:

  • Schopnost přidávat a spouštět víceintenční úkoly (například MPI)

    • Do zdroje Úkol je přidána nová volitelná vlastnost multiInstanceSettings , kterou lze volitelně zahrnout do API Přidat úkol, Získat úkol, Seznam úkolů.

    • Nový API Seznam podúkolů úkolu je přidán pro získání informací o podúkolech.

    • Pro Compute Node je přidána recentTasks nová volitelná vlastnostsubtaskId. Tato vlastnost se vrací jako součást uzlů Get Compute Node a List Compute Nodes

  • Schopnost zakázat nebo povolit plánování úloh na výpočetním uzlu

    • Na zdroj výpočetního uzlu jsou přidány dvě nová API: Disable task scheduling na jednom uzlu a Enable task scheduling on node.

    • Je přidán nový stav offline výpočetního uzlu. Pro starší verze API je tento stav mapován na unusable.

    • Do zdroje výpočetního uzlu je přidána nová vlastnost schedulingState . Možné hodnoty pro enabled a disabled.

  • Možnost specifikovat interval automatického -scale hodnocení v poolu/autopoolu

    • Do pool resource je přidána nová nemovitost autoScaleEvaluationInterval . Tuto vlastnost lze zahrnout do API Add Pool, Get Pool, Enable Auto-Scale a List Pools.

    • Podobně u automatických poolů se do vlastnosti přidá autoPoolSpecification nová vlastnostautoScaleEvaluationInterval. Tato vlastnost může být zahrnuta v API Přidat práci, Získat práci, Seznam pracovních míst, Přidat plán úkolů, Nastavit harmonogram úkolů, Aktualizovat harmonogram úloh, Seznam pracovních pozic a Seznam úkolů v API pro rozvrh úloh.

  • Vylepšení API úloh tak, aby vracela kořenový adresář úlohy na výpočetním uzlu.

    • Dvě nové vlastnosti taskRootDirectory a taskRootDirectoryUrl jsou přidány do zdroje Task, který lze získat jako součást API Získat informace o úlohě, List Tasks API

    • Přidá jobPreparationTaskExecutionInfo se nová vlastnosttaskRootDirectory, kterou jobReleaseTaskExecutionInfo lze získat pomocí Seznam stav úloh pro přípravu a uvolnění úloh pro API pro práci.

  • Last updated on