Udostępnij za pośrednictwem

Wersjonowanie REST API wsadowej

Operacje świadczone przez REST API usługi wsadowej mogą mieć wiele wersji dla kompatybilności wstecznej w miarę rozwoju API. Musisz określić, której wersji operacji chcesz użyć w momencie wywołania, podając wersję z wywołaniem REST. Jeśli Twoja aplikacja wywołuje starszą wersję operacji, możesz zdecydować się kontynuować wywoływanie starszej wersji lub zmodyfikować kod, aby wywołać nowszą wersję. Jeśli wersja nie jest określona lub podana jest nieprawidłowa, zwracany jest błąd.

Aby określić, której wersji operacji użyć, ustaw parametr zapytania o wersję API . Wersja jest w formacie Group.Major.Minor, gdzie w formacie YYYY-MM-DD jest Group, a Major to liczba całkowita, a Minor to liczba całkowita.

Najnowsza wersja: 2025-06-01

Poprzednie wersje

Poprzednie wersje obejmują:

Wersja: 2024-07-01.20.0

  • Dodano delokację węzłów obliczeniowych i operacje uruchamiania:
    • Dodano nową ComputeNode_Deallocate operację (POST /pools/{poolId}/nodes/{nodeId}/deallocate) do deallokacji bezczynnego lub działającego węzła obliczeniowego.
    • Dodano nową ComputeNode_Start operację (POST /pools/{poolId}/nodes/{nodeId}/start) do ponownego uruchomienia wcześniej zdelokowanego węzła obliczeniowego.
    • Dodano nowy NodeDeallocateParameter model z właściwością nodeDeallocateOption określającą, co robić z wykonywanymi zadaniami podczas deallocation.
  • [Łamanie] Usunięta operacja ComputeNode_GetRemoteDesktop (GET /pools/{poolId}/nodes/{nodeId}/rdp). Operacja ta dotyczyła wyłącznie pul konfiguracyjnych usług chmurowych.
  • [Łamanie] Usunięto wsparcie dla puli konfiguracji usług chmurowych:
    • Usunięty CloudServiceConfiguration model.
    • Usunięta cloudServiceConfiguration własność z CloudPool, PoolAddParameter, oraz PoolSpecification.
  • [Łamanie] Usunięta applicationLicenses własność z CloudPool, PoolAddParameter, oraz PoolSpecification.
  • Dodano wsparcie dla uchwytów związanych z kontenerami dla zadań:
    • Dodano nowy ContainerHostBatchBindMountEntry model z source właściwościami isReadOnly .
    • Dodano nowe ContainerHostDataPath enum o wartościach Shared, Startup, VfsMounts, Task, JobPrep, oraz Applications.
    • Dodano nową containerHostBatchBindMounts właściwość do TaskContainerSettingselementu .
  • Dodano wsparcie dla poufnych maszyn wirtualnych:
    • Dodano nowy VMDiskSecurityProfile model z securityEncryptionType własnością.
    • Dodano nową securityProfile właściwość do ManagedDiskelementu .
    • Dodano confidentialVM jako nową wartość dla SecurityProfile.securityType.
  • Dodano deallocated i deallocating jako nowe wartości dla ComputeNodeState.
  • Dodano nowe wymagane deallocated i deallocating właściwości do NodeCounts.
  • Dodano wsparcie dla Galerii Współdzielonej i Galerii Społecznościowej dla obrazów:
    • Dodaj sharedGalleryImageId i własności communityGalleryImageId do ImageReference.
  • Dodano skipWithdrawFromVNet właściwość do kontrolującej JobNetworkConfiguration , czy węzły pozostają połączone z VNet po zakończeniu zadania.
  • Dodana networkConfiguration własność do JobPatchParameter.
  • Rozszerzone możliwości patchowania puli: Dodano displayName, vmSize, taskSlotsPerNode, taskSchedulingPolicyuserAccountsenableInterNodeCommunicationnetworkConfigurationvirtualMachineConfiguration, , mountConfiguration, , upgradePolicy, , i resourceTags właściwości do .PoolPatchParameter Właściwości wpływające na topologię puli można aktualizować tylko wtedy, gdy pula jest pusta.
  • Dodano force parametr zapytania boole'a do Job_Delete, Job_Terminate, JobSchedule_Delete, oraz operacje JobSchedule_Terminate wymuszające operację.

Wersja: 2024-02-01.19.0

  • Dodano wsparcie dla polityki aktualizacji systemu operacyjnego dla pul maszyn wirtualnych:
    • Dodano nowy UpgradePolicy model o właściwościach mode, automaticOSUpgradePolicy, oraz rollingUpgradePolicy. Własność mode (UpgradeMode) przyjmuje wartości automatic, manual, oraz rolling.
    • Dodano nowy AutomaticOSUpgradePolicy model o właściwościach disableAutomaticRollback, enableAutomaticOSUpgrade, useRollingUpgradePolicy, oraz osRollingUpgradeDeferral.
    • Dodano nowy RollingUpgradePolicy model o właściwościach enableCrossZoneUpgrade, maxBatchInstancePercent, maxUnhealthyInstancePercent, maxUnhealthyUpgradedInstancePercent, pauseTimeBetweenBatches, prioritizeUnhealthyInstances, oraz .rollbackFailedInstancesOnPolicyBreach
    • Dodano nową upgradePolicy własność do CloudPool, PoolAddParameter, oraz PoolSpecification.
  • Dodano upgradingos jako nową wartość dla ComputeNodeState.
  • Dodano nową wymaganą upgradingOS właściwość do NodeCounts raportowania liczby węzłów w stanie upgradingos .

Wersja: 2023-11-01.18.0

  • Dodano wsparcie dla zaufanego uruchamiania / profili bezpieczeństwa dla pul VM:
    • Dodano nowy SecurityProfile model o właściwościach encryptionAtHost, securityType, oraz uefiSettings.
    • Dodano nowy UefiSettings model z własnościami secureBootEnabled i vTpmEnabled.
    • Dodano nową securityProfile właściwość do VirtualMachineConfigurationelementu .
  • Dodano wsparcie dla odniesień artefaktów serwisowych dla zestawów skalowych:
    • Dodano nowy ServiceArtifactReference model z wymaganą id właściwością (ID zasobu ARM).
    • Dodano nową serviceArtifactReference właściwość do VirtualMachineConfiguration ustawienia tej samej wersji obrazu dla wszystkich maszyn wirtualnych w skali przy użyciu wersji obrazu latest .
  • Ulepszona konfiguracja dysku systemu:
    • Dodano nowy ManagedDisk model z storageAccountType własnością.
    • Dodano nowe właściwości do : , , , managedDiskoraz writeAcceleratorEnabled. diskSizeGBcachingOSDisk
  • Dodano StandardSSDLRS (standardssd_lrs) jako nową wartość dla StorageAccountType.
  • Dodano nową właściwość resourceTags do CloudPool, PoolAddParameter oraz PoolSpecification, aby umożliwić propagację znaczników zdefiniowanych przez użytkownika na zasoby wspierające Azure. Ma zastosowanie tylko wtedy, gdy poolAllocationMode jest UserSubscription.
  • Dodano nową scaleSetVmResourceId właściwość, aby VirtualMachineInfo ujawnić ID zasobów aktualnej maszyny wirtualnej VM VM Virtual Machine Scale Set węzła obliczeniowego. Zdefiniowane tylko wtedy, gdy konto wsadowe poolAllocationMode jest .UserSubscription

Wersja: 2023-05-01.17.0

  • [Łamanie] Usunięto API lifetimejobstats statystyk wsadowych zadań/puli na czas życia: oraz lifetimepoolstats.
  • Dodano własność enableAcceleratedNetworking boolowską do NetworkConfiguration.
    • Ta właściwość decyduje, czy ta pula powinna umożliwiać przyspieszone sieciowanie, z domyślną wartością False.
    • Czy ta funkcja może być włączona, zależy także od tego, czy system operacyjny/instancja maszyny wirtualnej jest obsługiwana, co powinno być zgodne z polityką AcceleratedNetworking.
  • Dodano własność enableAutomaticUpgrade boolowską do VMExtension.
    • Ta właściwość decyduje, czy rozszerzenie powinno być automatycznie zaktualizowane, jeśli dostępna jest nowsza wersja rozszerzenia.
  • Własność typeContainerConfiguration, która obecnie wspiera dwie wartości: DockerCompatible oraz CriCompatible.

Wersja: 2022-10-01.16.0

  • Dodano nową NodeCommunicationMode właściwość określającą sposób, w jaki pula komunikuje się z usługą Batch
  • Dodano nową currentNodeCommunicationMode właściwość NodeCommunicationMode tego typu do modelu CloudPool , aby odnosić się do aktualnego stanu trybu komunikacji puli.
  • Dodano nową targetNodeCommunicationMode właściwość NodeCommunicationMode tego typu do następujących modeli, aby odnosić się do pożądanego trybu komunikacji węzła dla puli:
    • PoolSpecification
    • CloudPool
    • PoolAddParameter
    • PoolPatchParameter
    • PoolUpdatePropertiesParameter

Wersja: 2022-01-01.15.0

  • Dodano nową uploadHeaders właściwość do modelu OutputFileBlobContainerDestination , pozwalającą użytkownikom ustawiać niestandardowe nagłówki HTTP przy przesyłaniu plików zasobów.
  • Dodano nowe allowTaskPreemption właściwości do następujących modeli, aby wspierać preemption zadań dla zadań o wyższym priorytecie (wymaga Comms-Enabled lub Single Tenant Pool):
    • JobSpecification
    • CloudJob
    • JobAddParameter
    • JobPatchParameter
    • JobUpdateParameter

Wersja: 2021-06-01.14.0

  • Dodaj możliwość przypisywania zarządzanych tożsamości przypisanych przez użytkownika do CloudPool. Tożsamości te są dostępne na każdym węźle w puli i mogą być wykorzystywane do dostępu do różnych zasobów.
  • Dodano identityReference właściwości do następujących modeli, aby umożliwić dostęp do zasobów za pośrednictwem zarządzanej tożsamości:
    • AzureBlobFileSystemConfiguration
    • OutputFileBlobContainerDestination
    • ContainerRegistry
    • ResourceFile
    • UploadBatchServiceLogs
  • Dodano nową extensions właściwość do VirtualMachineConfiguration on, CloudPool aby określić rozszerzenia maszyny wirtualnej dla węzłów
  • Dodano możliwość określania stref dostępności za pomocą nowej właściwości nodePlacementConfiguration w VirtualMachineConfiguration
  • Dodano nową osDisk właściwość do VirtualMachineConfiguration, która zawiera ustawienia dla dysku systemu operacyjnego maszyny wirtualnej.
    • Właściwość placement on DiffDiskSettings określa efemeryczne rozmieszczenie dysków dla dysków systemu operacyjnego dla wszystkich maszyn wirtualnych w puli. Ustawiam ją na "CacheDisk", aby przechowywać efemeryczny dysk systemu operacyjnego na pamięci podręcznej VM.
  • Dodano maxParallelTasks właściwość on, CloudJob aby kontrolować maksymalną liczbę zadań, które mogą działać jednocześnie na jedno zadanie (domyślnie -1 oznacza nieograniczone). Ta nieruchomość jest obecnie w prywatnym przeglądzie.
  • Dodana virtualMachineInfo właściwość na ComputeNode ten zawiera informacje o aktualnym stanie maszyny wirtualnej, w tym dokładną wersję obrazu marketplace, którego używa maszyna wirtualna.
  • Dodano recurrenceInterval właściwość do Schedule do kontrolowania odstępu między czasami rozpoczęcia dwóch kolejnych zadań w ramach harmonogramu zadań.

Wersja: 2020-09-01.12.0

  • [Łamanie] Zastąpiłem nieruchomość maxTasksPerNode na basen.taskSlotsPerNode Użycie tej właściwości zadania w zadaniu może zużywać dynamiczną liczbę slotów, co pozwala na bardziej precyzyjną kontrolę nad zużyciem zasobów.
  • [Łamanie] Zmieniono typ odpowiedzi na GetTaskCounts return TaskCountsResult, czyli złożony obiekt zawierający poprzedni TaskCounts obiekt oraz nowy TaskSlotCounts obiekt dostarczający podobne informacje w kontekście używanych slotów.
  • Dodano właściwość requiredSlots do zadania pozwalającą użytkownikowi określić, ile slotów na węźle powinno zajmować.

Wersja: 2020-03-01.11.0

  • Dodano możliwość szyfrowania dysków ComputeNode z wykorzystaniem nowej DiskEncryptionConfiguration właściwości VirtualMachineConfiguration.
  • [Łamanie] Własność virtualMachineImageIdImageReference może teraz odnosić się tylko do obrazu Shared Image Gallery.
  • [Łamanie] Właściwość password korpusu Add Certificate żądań jest opcjonalna dla certyfikatów w formacie PFX.
  • [Łamanie] Pule mogą być teraz provisionowane bez publicznego IP, korzystając z nowej PublicIPAddressConfiguration właściwości NetworkConfiguration.
  • [Łamanie] Nieruchomość publicIPs została NetworkConfiguration przemianowana ipAddressIds i wprowadzona do tej dziedziny PublicIPAddressConfiguration . Ta własność może być określona tylko wtedy, gdy provision własność jest .usermanaged

Wersja: 2019-08-01.10.0

  • Dodano możliwość określenia zbioru publicznych adresów IP za NetworkConfiguration pomocą nowej publicIPs właściwości w puli. Gwarantuje to, że węzły w puli mają adres IP z listy IP podanych przez użytkownika.
  • Dodano możliwość montowania zdalnych systemów plików na każdym węźle puli za pośrednictwem tej MountConfiguration właściwości.
  • Shared Image Gallery obrazy można teraz określić na podstawie właściwości virtualMachineImageIdImageReference, odwołując się do obrazu za pomocą jego identyfikatora Azure Resource Manager.
  • [Łamanie] Gdy nie jest to określone, domyślna wartość dla waitForSuccess on to (truewcześniej była falseStartTask ).
  • [Łamanie] Gdy nie jest to określone, domyślna wartość scope na AutoUserSpecification to teraz zawsze Pool (wcześniej była to Task na węzłach Windows i Pool na węzłach Linuksa).
  • Poprawiłem różne mylące lub niekompletne dokumenty.

Wersja: 2019-06-01.09.0

  • [Łamanie] Zastąpiony ListNodeAgentSKUs przez ListSupportedImages. ListSupportedImages zawiera wszystkie te same informacje, które pierwotnie były dostępne ListNodeAgentSKUs , ale w bardziej przejrzystym formacie. Nowe, niezweryfikowane zdjęcia również są teraz zwracane. Dodatkowe informacje o Capabilities i BatchSupportEndOfLife są dostępne przez .ImageInformation

  • Teraz wspieraj zasady bezpieczeństwa sieciowego blokujące dostęp do CloudPool sieci na podstawie portu źródłowego ruchu. Reguła ta jest realizowana za pomocą własności SourcePortRanges na NetworkSecurityGroupRule.

  • Podczas uruchamiania kontenera usługa Batch obsługuje teraz wykonywanie zadania w katalogu roboczym kontenera lub w katalogu roboczym zadania usługi Batch. Jest to kontrolowane przez WorkingDirectory właściwość na .TaskContainerSettings

  • Poprawiłem różne mylące lub niekompletne dokumenty.

Wersja: 2018-12-01.8.0

  • [Łamanie] Usunięto wsparcie dla upgradeoscloudServiceConfiguration on pools.

    • Usunięto upgradeos element.
    • Przemianowano targetOSVersion na osVersion i usunięto currentOSVersion w .CloudPool
    • Usunięto upgrading element z PoolState.

  • [Łamanie] Usunięte dataEgressGiB i dataIngressGiB z poolusagemetrics. Te nieruchomości nie są już wspierane.

  • [Łamanie]ResourceFile Ulepszenia

    • Dodano możliwość określenia całego kontenera Azure Storage w ResourceFile. Obecnie obsługiwane są trzy tryby dla ResourceFile:
      • httpUrl tworzy wskazanie ResourceFile do pojedynczego adresu URL HTTP.
      • storageContainerUrl tworzy ResourceFile wskazujący na kontener Azure Blob Storage.
      • autoStorageContainerName tworzy ResourceFile wskazujący na kontener Azure Blob Storage w zarejestrowanym kontzie Batch autostorage.
    • Adresy URL udostępniane przez ResourceFile tę metodę httpUrl mogą teraz być dowolnym adresem HTTP. Wcześniej te adresy musiały być adresem Azure Blob Storage.
    • blobPrefix może być używany do filtrowania pobrań z pojemnika pamięci tylko do tych odpowiadających prefiksu.

  • [Łamanie] Usunięta osDisk własność z VirtualMachineConfiguration. Ta nieruchomość nie jest już wspierana.

  • Pule, które ustawiają dynamicVNetAssignmentScope na NetworkConfiguration na job mogą teraz dynamicznie przypisywać Virtual Network każdemu węzłowi zadanias tasks run on. The specific Virtual Network to join the nodes to is specified in the new JobNetworkConfigurationproperty onCloudJobandJobSpecification'.

    Uwaga / Notatka

    Ta funkcja jest dostępna w publicznej wersji zapoznawczej. Jest wyłączony dla wszystkich kont Batch z wyjątkiem tych, które się z nami skontaktowały i poprosiły o udział w pilotażu.

  • Maksymalny czas trwania zadania wynosi obecnie 180 dni (wcześniej było to 7).

  • Dodano wsparcie dla Windows poolów do tworzenia użytkowników w określonym trybie logowania (batch lub interactive) przez LoginMode.

  • Domyślny czas utrzymania wszystkich zadań wynosi teraz siedem dni, wcześniej był nieskończony.

Wersja 2018-08-01.7.0

Nowe funkcje w wersji 2018-08-01.7.0 obejmują:

  • Zobacz wersję Azure Batch Node Agent, korzystając z nowej właściwości NodeAgentInfo na ComputeNode.
  • Dodano możliwość określenia a Filter na zadaniu Result . Aby uzyskać więcej informacji, zobacz tutaj.
    • Pozwala to często żądać wykonania zapytania po stronie serwera i znaleźć wszystkie zadania, które zawiodły.
  • [Łamanie] Usunięto ValidationStatus tę własność z TaskCounts.
  • [Łamanie] Domyślnym typem buforowania dla DataDisk i OSDisk jest teraz ReadWrite zamiast .None
  • [Łamanie] Przemianowano jedyną wartość ContainerType z docker do .dockerCompatible

Wersja 2018-03-01.6.1

Nowe funkcje w wersji 2018-03-01.6.1 obejmują:

  • Liczba węzłów puli według stanu: Ta wersja dodaje możliwość zapytania liczby węzłów puli według stanu, za pomocą nowej operacji ListPoolNodeCounts. Ta operacja daje możliwość zapytania wszystkich pul w kontu wsadowym o stany węzłów.
  • Logi agentów węzłów: Ta wersja dodaje możliwość przesyłania logów agenta Azure Batch z konkretnego węzła, za pomocą operacji UploadBatchServiceLogs. Ten dziennik jest przeznaczony do debugowania przez Microsoft Support w przypadku wystąpienia problemów na danym węźle.

Wersja 2017-09-01.6.0

  • Azure Hybrid Use Benefit: Możesz teraz tworzyć pule VM Batch Windows, określając, że należy korzystać z licencjonowania Azure Hybrid Use Benefit. Gdy ta licencja jest używana, nakłada się rabat na cenę maszyny wirtualnej. Użyj nowej właściwości LicenseType w VirtualMachineConfiguration.

  • Dyski danych VM do puli: Możesz dołączyć jeden lub więcej pustych dysków do pul VM, korzystając z nowej konfiguracji dysku danych, która jest częścią konfiguracji maszyny wirtualnej. Użyj właściwości DataDisks w VirtualMachineConfiguration.

  • (Breaking change) Niestandardowe obrazy są teraz tworzone i wdrażane przy użyciu zasobów obrazowych Azure Resource Manager zamiast plików VHD blob. Batch teraz używa zarządzanych dysków do tworzenia maszyn wirtualnych puli, a tym samym korzysta z zasobu Image . Obecnie nie ma już ograniczenia liczby maszyn wirtualnych w puli utworzonej za pomocą niestandardowego obrazu; ponadto nie jest już potrzebne wiele kopii VHD blob dla dużych pul. Niestandardowe pule obrazów są więc znacznie łatwiejsze do tworzenia i skalowania. Więcej informacji można znaleźć w artykule Użyj niestandardowego obrazu do stworzenia puli maszyn wirtualnych.

    • Nowa właściwość VirtualMachineImageId w ImageReference zawiera odniesienie do Image, a OSDisk.ImageUris już nie istnieje.

    • W wyniku tej zmiany ImageReference jest teraz wymaganą właściwością VirtualMachineConfiguration.

  • (Drobne wyłamki) Zadania wieloinstancyjne (tworzone za pomocą MultiInstanceSettings) muszą teraz określać Linię Poleceń Koordynacji, a LiczbaInstancji jest opcjonalna i domyślnie ustawiona na 1.

  • Dodano wsparcie dla zadań wykonywanych przy użyciu kontenerów Docker. Aby wykonać zadanie z użyciem kontenera Docker, musisz określić ContainerConfiguration w VirtualMachineConfiguration dla puli, a następnie dodać TaskContainerSettings do zadania.

Wersja 2017-06-01.5.1

Wersja API Batch opisana tutaj to 2017-06-01.5.1. Zaleca się używanie najnowszej wersji, jeśli to możliwe.

Nowe funkcje w wersji 2017-06-01.5.1 obejmują:

  • Wsparcie dla efektywnego liczenia zadań dzięki nowej operacji Get Task Counts. Wywołując operację Pobierz liczbę zadań, możesz uzyskać liczbę aktywnych, działających i ukończonych zadań oraz zadań, które zakończyły się sukcesem lub niepowodzeniem. Więcej informacji można znaleźć w artykule Licz zadania dla zadania według stanu (Podgląd).
  • Wsparcie dla określania punktów końcowych przychodzących na węzłach obliczeniowej puli, za pomocą nowej właściwości poolEndpointConfiguration . Ustawiając tę właściwość, możesz zewnętrznie adresować konkretne porty na węźle.

Wersja 2017-05-01.5.0

Poniższe sekcje przedstawiają nowe i zmienione funkcje w wersji 2017-05-01.5.0.

Ważna

Wersja 2017-05-01.5.0 zawiera kilka zmian łamiących. Przejrzyj najnowsze zmiany i zaktualizuj swój kod, aby wywołać wersję 2017-05-01.5.0.

Węzły obliczeniowe o niskim priorytecie

Azure Batch oferuje teraz węzły obliczeniowe o niskim priorytecie, aby obniżyć koszty obciążeń wsadowych. Maszyny wirtualne o niskim priorytecie umożliwiają tworzenie nowych typów obciążeń wsadowych, zapewniając dużą moc obliczeniową, która jest jednocześnie ekonomiczna.

Wprowadzono kilka zmian w API REST dla węzłów o niskim priorytecie:

  • (Drobne wyłamki) Właściwości targetDedicated i currentDedicated puli lub specyfikacji puli zostały przemianowane na targetDedicatedNodes oraz currentComputeNodes.
  • (Drobne wyłamki) Właściwość resizeError puli to teraz kolekcja o nazwie resizeErrors.
  • Węzły obliczeniowe mają nową właściwość isDediced . Ta właściwość jest prawdziwa dla dedykowanych węzłów, a fałszywa dla węzłów o niskim priorytecie.
  • Zadanie Menedżera Zadań ma nową właściwość allowLowPriorityNode . Jeśli ta właściwość jest prawdziwa, zadanie Menedżera zadań może działać na węźle o niskim priorytecie. Jeśli jest fałszywe , to zadanie Menedżera zadań działa na dedykowanym węźle obliczeniowym.

Użytkownicy nazwani na Linuksie

Azure Batch oferuje teraz dodatkowe wsparcie dla tworzenia nazwanych użytkowników na węzłach Linuksa.

  • Nowa właściwość linuxUserConfiguration obsługuje określanie uid (identyfikator użytkownika) oraz gid (identyfikator grupy) podczas tworzenia użytkownika Linuksa.
  • (Drobne wyłamki) Właściwość sshPrivateKey została przeniesiona z właściwości userAccount do nowej właściwości linuxUserConfiguration . Właściwość linuxUserConfiguration jest sama w sobie właściwością użytkownika Konta .

Aby uzyskać więcej informacji o nazwanych kontach użytkowników, zobacz Wykonaj zadania pod kontami użytkowników w Batch (Batch Task under user accounts).

Pliki wyjściowe danych zadań

Możesz teraz określić pliki wyjściowe, które przesyłają dane zadania po jego zakończeniu.

  • Nowa własność outputFiles umożliwia określenie plików zadań do przesłania na Azure Storage.
  • Nowa własność fileUploadError w właściwości exitConditions umożliwia określanie działań do wykonania na podstawie statusu przesłania pliku wyjściowego.

Raportowanie błędów zadań

Wprowadzono kilka zmian, aby poprawić raportowanie błędów w zadaniach.

  • Nowa właściwość wyniku , właściwości executionInfo , wskazuje, czy zadanie zakończyło się sukcesem czy niepowodzeniem.
  • (Drobne wyłamki) Właściwość schedulingError własności executionInfo została przemianowana na failureInfo. Właściwość failureInfo jest zwracana za każdym razem, gdy zadanie się nie powióduje. Obejmuje to wszystkie wcześniejsze błędy w harmonogramie, wszystkie przypadki, gdy zwracany jest niezerowy kod końcowy zadania, oraz wszelkie niepowodzenia przesyłania plików.
  • (Drobne wyłamki) Właściwość schedulingError właściwości exitConditions została przemianowana na preProcessingError, aby wyjaśnić, kiedy błąd wystąpił w cyklu życia zadania.
  • (Drobne wyłamki) Właściwość scheduleErrorCateogry została przemianowana na errorCategory.

Licencje aplikacyjne

Możesz teraz poprosić o przydzielenie licencji aplikacji do swojej puli za pomocą nowej właściwości applicationLicenses na puli lub specyfikacji puli.

Wersja 2017-01-01.4.0

Ta wersja rozszerza całe wsparcie dla poprzedniej wersji, 2016-07-01.3.1. Dodatkowo obsługuje następujące funkcje:

  • Uruchom zadanie pod określoną tożsamością użytkownika.

    Teraz możesz uruchomić zadanie lub kolekcję zadań pod jedną z następujących tożsamości użytkownika, określoną za pomocą nowej właściwości userIdentity w zasobach zadania:

    • Konto użytkownika z nazwą, którą sam definiujesz.

    • Konto użytkownika tworzone automatycznie (autouser). Użytkownik automatyczny może działać jako użytkownik administracyjny lub nieadministracyjny. Domyślnie użytkownik automatyczny działa jako użytkownik nieadministracyjny.

      Ważna

      Własność userIdentity wraz z własnością elevationLevel zastępuje właściwość runElevated w żądaniach dodających zadanie lub kolekcję zadań oraz w odpowiedziach, które otrzymują informacje o zadaniu lub wypisują zadania.

      Jeśli wykonasz żądanie zawierające właściwość runElevated do wersji 2017-01-01.4.0 usługi Wsadowej, żądanie nie przestaje się udawane.

      Aby uruchomić jako użytkownik administracyjny, zaktualizuj aplikację tak, aby używała właściwości userIdentity , ustawiając właściwość ElevationLevel na administrator.

      Aby uruchomić użytkownika nieadministracyjnego, zaktualizuj aplikację tak, aby używała właściwości userIdentity , ustawiając właściwość poziomElevationLevel na nonAdmin. Ponieważ to ustawienie jest domyślne, możesz je też pominąć.

  • Zdefiniuj konta użytkowników we wszystkich węzłach w puli.

    Możesz teraz uruchomić zadania lub kolekcję zadań na koncie użytkownika, które zdefiniujesz na zasobach puli. Zdefiniuj konto użytkownika za pomocą nowej właściwości userAccounts, w żądaniach Add Pool. Definiując konto, możesz określić nazwę konta, hasło, poziom wysokości (administrator lub nieadministrator) oraz klucz prywatny SSH (dla pul Linuksa).

    Po zdefiniowaniu konta użytkownika, możesz określić to konto użytkownika dla właściwości userIdentity w żądaniach dodających zadanie lub kolekcję zadań.

  • Zapewnij zadaniu token do uwierzytelniania się do usługi Batch podczas uruchamiania zadania.

    Usługa Batch może teraz udostępnić token uwierzytelniania zadaniu podczas jego uruchomienia. Token uwierzytelniania umożliwia zadaniu wysyłanie żądań związanych z zadaniem do usługi wsadowej, bez konieczności posiadania kluczy konta wsadowego. Token jest dostarczany za pośrednictwem zmiennej środowiskowej AZ_BATCH_AUTHENTICATION_TOKEN.

    Obecnie tokeny uwierzytelniania są obsługiwane wyłącznie do wywoływania operacji na zasobu zadania. Token uwierzytelniania daje dostęp do wszystkich operacji na zadaniu, które zawiera to zadanie.

    Aby usługa Batch dostarczyła token uwierzytelniania, określ nową właściwość authenticationTokenSettings wraz z jej właściwością access w żądaniach Add Task lub Add Task Collection.

  • Określ akcję, która ma wykonać zależności zadania, jeśli zadanie się nie powiedzie.

    Możesz teraz określić, że zadania zależne są kontynuowane nawet jeśli zadanie, od którego zależą, nie powiód się. Ustaw nową właściwość dependencyAction zasobu zadania tak, aby spełniała zadania działające w zależności nawet jeśli zadanie nadrzędne się nie powiedzie. Alternatywnie, ustaw dependencyAction na blok, aby zapobiec uruchamianiu zadań zależnych w przypadku niepowodzenia zadania nadrzędnego.

    Określ właściwość dependencyAction w żądaniach dodania zadania lub dodawania kolekcji zadań.

    Więcej informacji o wykorzystaniu akcji zależności, zobacz Akcje zależności.

  • Używaj niestandardowych obrazów dysków OS podczas tworzenia puli.

    Teraz możesz używać niestandardowych obrazów dysków systemu operacyjnego do tworzenia puli.

    Aby to zrobić, musisz określić przy tworzeniu konta Batch, że pule mają być przydzielane w subskrypcji użytkownika, a nie w subskrypcji zarządzanej przez usługę Wsadową. W wywołaniu Create Account ustaw właściwość poolAllocationMode na UserSubscription. Następnie użyj właściwości osDisk , aby określić odniesienie do obrazu dysku w żądaniu dodania puli.

    Ważna

    Gdy tworzysz swoje konto Batch, jeśli określisz, że pule mają być przydzielane w subskrypcji użytkownika, musisz użyć uwierzytelniania opartego na Azure Active Directory dla wszystkich żądań przesyłanych przez to konto.

  • Używaj uwierzytelniania opartego na Azure Active Directory do żądań do usługi wsadowej.

    Azure Active Directory (Azure AD) jest teraz obsługiwany do uwierzytelniania wywołań do usługi wsadowej.

    Jeśli Twoje konto Batch jest skonfigurowane do provisionowania pul w subskrypcji użytkownika, wymagane jest uwierzytelnianie Azure AD.

Wersja 2016-07-01.3.1

Ta wersja rozszerza całe wsparcie z poprzedniej wersji, 2016-02-01.3.0. Dodatkowo obsługuje następujące funkcje:

  • Możliwość tworzenia puli oraz autopuli z konfiguracją sieciową

    • Do zasobów puli i autopuli dodano nową sieć własności. Ta właściwość może być użyta do określenia utworzonych węzłów obliczeniowych pulis network configuration, such as the subnet in which the pool.

  • Automatycznie zakończ zadanie po zakończeniu wszystkich zadań.

    • Do zasobu zadania dodano nową właściwość AllTasksComplete. Możesz określić tę właściwość podczas tworzenia lub aktualizacji zadania.

  • Automatycznie zakończ lub wyłącz zadanie, gdy zadanie się nie powiedzie.

    • Do zasobu zadania dodano nową właściwość onTaskFailure, a do zasobu zadania dodano nową właściwość exitConditions. Ustawienie job onTaskFailure wskazuje, czy niepowodzenie zadania może mieć wpływ na poziom zadania, a właściwość exit conditions pozwala zadaniom dostosować wpływ na poziomie zadania do charakteru niepowodzenia.

  • Skojarz pakiety aplikacji z zadaniami i pulami.

    • Nowa właściwość applicationPackageReferences dodana do zasobu zadania oraz do ustawień jobManagerTask. Ta właściwość pozwala na wdrażanie pakietów aplikacji na żądanie, gdy zadania ich wymagają, zamiast wymagać ich określenia przy tworzeniu puli. Ta własność jest szczególnie cenna dla pul o długim życiu, które mogą być wymagane do uruchamiania różnych typów zadań lub wersji aplikacji w trakcie ich okresu życia.

  • Możliwość reaktywacji nieudanego zadania.

    • Dodano nową operację Reaktywuj zadanie, aby przywrócić stan nieudanego zadania do aktywnego. Pozwala to na ponowne próbowanie błędów, na przykład jeśli awaria była przejściowa lub jeśli udało się naprawić przyczynę awarii bez odtwarzania zadania.

Wersja 2016-02-01.3.0

Ta wersja rozszerza całe wsparcie z poprzedniej wersji, 2015-12-01.2.2. Dodatkowo obsługuje następujące funkcje:

  • Możliwość tworzenia puli oraz autopoola z konfiguracją VM IaaS

    • Istniejące właściwości osFamily, targetOSVersion oraz currentOSVersion są przenoszone z najwyższych właściwości zasobów Pool i Autopool i są przenoszone wewnątrz nowej właściwości o nazwie cloudServiceConfiguration.

    • Do zasobów Poola i Autopoolu dodana jest nowa własność virtualMachineConfiguration . Ta właściwość może być określona, aby skonfigurować pulę/pulę automatyczną z maszynami wirtualnymi IaaS.

    • Dodano nowe API do pozyskiwania informacji o wszystkich SKU agentów węzłów obsługiwanych przez usługę Wsad. Zobacz Lista obsługiwanych SKU agentów węzłów.

    • Dodano nowe API do uzyskania zdalnych ustawień logowania, które można wykorzystać do zdalnego logowania do węzła obliczeniowego utworzonego w konfiguracji VM IaaS. Zobacz Ustawienia zdalnego logowania dla węzła.

    • Dodane jest nowe API, aby dodać kolekcję zadań do zadania. Zobacz Dodaj zbiór zadań do zadania.

    • Do zasobu użytkownika dodana jest nowa opcjonalna właściwość sshPublicKey , którą można wykorzystać do dodawania/aktualizacji użytkowników na węźle obliczeniowym Linuksa.

    • Do zasobu Node dodano dwie nowe właściwości totalTasksSucceeded i runningTasksCount . Właściwości te można uzyskać poprzez Pobierz informacje o węźle lub Wymienił węzły obliczeniowe w puli.

    • Do typu kompleksowego ResourceFile dodaje się nową własnośćfileMode. Ta właściwość jest stosowana tylko w węzłach obliczeniowych Linuksa i ignorowana dla węzłów obliczeniowych Windows.

    • Do typu kompleksowego FileProperties dodaje się nową własnośćfileMode. Ta właściwość jest zwracana przez usługę Batch dla węzłów obliczeniowych Linux jako część API GetFileProperties lub ListFileProperties. Ponadto istniejąca własność creationTime w typie FileProperties złożonym jest zmieniana na opcjonalną, ponieważ ta właściwość nie zostanie zwrócona dla węzłów obliczeniowych Linuksa.

    • Typ danych istniejącej właściwości visibility wewnątrz CertificateReference typu zespolonego jest modyfikowany z ciągu z wartościami rozdzielonymi przecinkami na zbiór ciągów znaków. Również jedna z istniejących wartości widoczności została przemianowana z "rdp" na "remoteuser".

  • Adresy URL następujących API zostały zmienione, zastępując nazwę akcji "?" na "/":

    • Zastąpienie właściwości puli

    • Wyłącz automatyczne skalowanie na puli

    • Włącz automatyczne skalowanie na puli

    • Obliczaj automatyczną formułę skalowania

    • Zmień rozmiar basenu

    • Przestań zmieniać rozmiar basenu

    • Aktualizacja systemu operacyjnego węzłów obliczeniowych w puli

    • Usuń węzły obliczeniowe z puli

    • Restartuj węzeł

    • Ponowne naobrazowanie węzła

    • Wyłącz harmonogramowanie zadań na węźle

    • Włącz harmonogramowanie zadań na węźle

    • Wyłącz harmonogram zadań

    • Włącz harmonogram zadań

    • Zakończ harmonogram zadań

    • Wyłącz zadanie

    • Aktywuj zadanie

    • Zakończenie pracy

    • Zakończ zadanie

    • Anuluj usunięcie certyfikatu

Wersja 2015-12-01.2.2

Ta wersja rozszerza całe wsparcie z poprzedniej wersji, 2015-11-01.2.1. Dodatkowo obsługuje następujące funkcje:

  • Aplikacje mogą być teraz wdrażane do obliczeń węzłów za pomocą pakietów aplikacji zamiast jako plików zasobów.

    • Nowe API są udostępniane dla klientów do przeglądania listy dostępnych aplikacji i wersji, na przykład do wyświetlania selektora w interfejsie użytkownika.

    • API związane z pulą zostały zmienione, aby umożliwić puli określenie pakietów aplikacji do pobrania do wszystkich węzłów w tej puli.

  • Zadania mogą teraz być zależne od innych zadań. Zadanie zależne nie rozpocznie się, dopóki wszystkie zadania, od których zależy, nie zostaną pomyślnie ukończone.

Ta wersja zawiera następujące inne zmiany:

  • Domyślny limit czasu na zmianę rozmiaru puli zmienił się na 15 minut.

Wersja 2015-11-01.2.1

Ta wersja rozszerza całe wsparcie z poprzedniej wersji 2015-06-01.2.0. Dodatkowo obsługuje następujące funkcje:

  • Możliwość dodawania i uruchamiania zadań wieloinstancjowych (na przykład MPI)

    • Do zasobu Zadania dodana jest nowa opcjonalna właściwość multiInstanceSettings , którą można opcjonalnie uwzględnić w API Dodaj zadanie, Pobierz zadanie, Lista zadań.

    • Nowe API Lista podzadań zadania jest dodawana, aby uzyskać informacje o podzadaniach.

    • Dodana recentTasks jest nowa opcjonalna właściwość subtaskId dla węzła obliczeniowego. Ta właściwość jest zwracana jako część węzłów Get Compute Node i List Compute Nodes

  • Możliwość wyłączania lub włączania harmonogramowania zadań na węźle obliczeniowym

    • Dwa nowe API: Disable task scheduling na węźle oraz Enable task scheduling na węźle, dodano na zasobach węzła obliczeniowego.

    • Dodany jest nowy stan offline węzła obliczeniowego. W starszych wersjach API ten stan jest mapowany na unusable.

    • Do zasobu węzła obliczeniowego dodana jest nowa właściwość schedulingState . Możliwe wartości dla enabled i disabled.

  • Możliwość określenia interwału oceny automatycznego -scale na puli/autopuli

    • Do zasobów puli dodaje się nową własność autoScaleEvaluationInterval . Ta właściwość może być uwzględniona w API Add Pool, Get Pool, Enable Auto Scale oraz List Pools.

    • Podobnie, w przypadku automatycznych pul do własności dodaje autoPoolSpecification się nową własnośćautoScaleEvaluationInterval. Ta własność może być zawarta w API Dodaj zadania, Pobierz zadania, Lista zadań, Dodaj harmonogram zadań, Pobierz harmonogram zadań, Aktualizuj harmonogram zadań, Lista harmonogramów zadań oraz Lista zadań w API harmonogramu zadań.

  • Ulepszenie API zadań, aby zwracały katalog główny zadania na węźle obliczeniowym.

    • Dwie nowe właściwości taskRootDirectory zostały taskRootDirectoryUrl dodane do zasobu Task, które można uzyskać w ramach API Pobierz informacje o zadaniu, List Tasks API

    • Dodana jobPreparationTaskExecutionInfo jest nowa właściwośćtaskRootDirectory, którą jobReleaseTaskExecutionInfo można uzyskać poprzez List status zadań do przygotowania i wypuszczenia zadania dla API zadania.

  • Last updated on