Przechowywanie wersji interfejsu API REST usługi Batch
Operacje udostępniane przez interfejs API REST usługi Batch mogą mieć wiele wersji w celu zapewnienia zgodności z poprzednimi wersjami, ponieważ interfejs API ewoluuje wraz z upływem czasu. Musisz określić wersję operacji, której chcesz użyć, gdy jest wywoływana, podając wersję wywołania REST. Jeśli aplikacja wywołuje starszą wersję operacji, możesz kontynuować wywoływanie starszej wersji lub zmodyfikować kod w celu wywołania nowszej wersji. Jeśli wersja nie jest określona lub określono nieprawidłową wersję, zwracany jest błąd.
Aby określić wersję operacji do użycia, ustaw parametr zapytania api-version . Wersja jest w formacie Group.Major.Minor, gdzie group ma format "RRRR-MM-DD", a główna jest liczbą całkowitą, a pomocnicza jest liczbą całkowitą.
Najnowsza wersja: 2023-05-01.17.0
- [Niezgodność] Usunięto interfejs API statystyk okresu istnienia zadania/puli usługi Batch:
lifetimejobstats
ilifetimepoolstats
. - Dodano właściwość
enableAcceleratedNetworking
logiczną do elementuNetworkConfiguration
.- Ta właściwość określa, czy ta pula powinna włączyć przyspieszoną sieć z wartością domyślną False.
- To, czy tę funkcję można włączyć, jest również związane z tym, czy jest obsługiwany system operacyjny/wystąpienie maszyny wirtualnej, co powinno być zgodne z zasadami przyspieszonej sieci.
- Dodano właściwość
enableAutomaticUpgrade
logiczną do elementuVMExtension
.- Ta właściwość określa, czy rozszerzenie powinno zostać automatycznie uaktualnione przez platformę, jeśli jest dostępna nowsza wersja rozszerzenia.
- Właściwość
type
ContainerConfiguration
, która obsługuje teraz dwie wartości:DockerCompatible
iCriCompatible
.
Poprzednie wersje
Poprzednie wersje obejmują:
- 2022-10-01.16.0
- 2022-01-01.15.0
- 2021-06-01.14.0
- 2020-09-01.12.0
- 2020-03-01.11.0
- 2019-08-01.10.0
- 2019-06-01.9.0
- 2018-12-01.8.0
- 2018-08-01.7.0
- 2018-03-01.6.1
- 2017-09-01.6.0
- 2017-06-01.5.1
- 2017-05-01.5.0
- 2017-01-01.4.0
- 2016-07-01.3.1
- 2016-02-01.3.0
- 2015-12-01.2.2
- 2015-11-01.2.1
- 2015-06-01.2.0
- 2015-03-01.1.1
- 2014-10-01.1.0
Wersja: 2022-10-01.16.0
- Dodano nową
NodeCommunicationMode
właściwość określającą sposób komunikacji puli z usługą Batch - Dodano nową
currentNodeCommunicationMode
właściwośćNodeCommunicationMode
typu doCloudPool
modelu, aby odwoływać się do bieżącego stanu trybu komunikacji puli. - Dodano nową
targetNodeCommunicationMode
właściwośćNodeCommunicationMode
typu do następujących modeli, aby odwołać się do żądanego trybu komunikacji węzła dla puli:
Wersja: 2022-01-01.15.0
- Dodano nową
uploadHeaders
właściwość do modelu,OutputFileBlobContainerDestination
aby umożliwić użytkownikom ustawianie niestandardowych nagłówków HTTP podczas przekazywania plików zasobów. - Dodano nową
allowTaskPreemption
właściwość do następujących modeli w celu obsługi wywłaszczania zadań podrzędnych o wyższym priorytcie (wymaga Comms-Enabled lub pojedynczej puli dzierżaw):
Wersja: 2021-06-01.14.0
- Dodaj możliwość przypisywania tożsamości zarządzanych przypisanych przez użytkownika do programu
CloudPool
. Te tożsamości będą udostępniane w każdym węźle w puli i mogą być używane do uzyskiwania dostępu do różnych zasobów. - Dodano
identityReference
właściwość do następujących modeli w celu obsługi uzyskiwania dostępu do zasobów za pośrednictwem tożsamości zarządzanej: - Dodano nową
extensions
właściwość do polecenia VirtualMachineConfiguration w systemieCloudPool
, aby określić rozszerzenia maszyny wirtualnej dla węzłów - Dodano możliwość określania stref dostępności przy użyciu nowej właściwości
nodePlacementConfiguration
w usłudze VirtualMachineConfiguration - Dodano nową
osDisk
właściwość do klasy VirtualMachineConfiguration, która zawiera ustawienia dysku systemu operacyjnego maszyny wirtualnej.- Właściwość
placement
onDiffDiskSettings
określa efemeryczne umieszczanie dysków systemu operacyjnego dla wszystkich maszyn wirtualnych w puli. Ustawienie go na wartość "CacheDisk" spowoduje zapisanie efemerycznego dysku systemu operacyjnego w pamięci podręcznej maszyny wirtualnej.
- Właściwość
- Dodano
maxParallelTasks
właściwość wCloudJob
poleceniu w celu kontrolowania maksymalnej liczby zadań, które mogą być uruchamiane w tym samym czasie na zadanie (wartość domyślna to -1, co oznacza nieograniczoną). Ta właściwość jest obecnie dostępna w prywatnej wersji zapoznawczej. - Dodano
virtualMachineInfo
właściwośćComputeNode
zawierającą informacje o bieżącym stanie maszyny wirtualnej, w tym dokładną wersję obrazu witryny Marketplace używanego przez maszynę wirtualną. - Dodano
recurrenceInterval
właściwość w celuSchedule
kontrolowania interwału między godzinami rozpoczęcia dwóch kolejnych zadań w ramach harmonogramu zadań.
Wersja: 2020-09-01.12.0
- [Niezgodność] Zastąpiono właściwość właściwością
maxTasksPerNode
taskSlotsPerNode
w puli. Użycie tych zadań właściwości w zadaniu może zużywać dynamiczną liczbę miejsc, co zapewnia bardziej szczegółową kontrolę nad zużyciem zasobów. - [Niezgodność] Zmieniono typ odpowiedzi ,
GetTaskCounts
aby zwrócićTaskCountsResult
obiekt , który jest obiektem złożonym zawierającym poprzedniTaskCounts
obiekt i nowyTaskSlotCounts
obiekt dostarczający podobne informacje w kontekście używanych miejsc. - Dodano właściwość
requiredSlots
do zadania, dzięki czemu użytkownik może określić, ile miejsc w węźle ma być zajętych.
Wersja: 2020-03-01.11.0
- Dodano możliwość szyfrowania dysków ComputeNode przy użyciu nowej
DiskEncryptionConfiguration
właściwości .VirtualMachineConfiguration
- [Niezgodność] Właściwość
virtualMachineImageId
ImageReference
elementu może teraz odwoływać się tylko do obrazu Shared Image Gallery. - [Niezgodność] Właściwość
password
treściAdd Certificate
żądania operacji jest opcjonalna dla certyfikatów sformatowanych w formacie PFX. - [Niezgodność] Pule można teraz aprowizować bez publicznego adresu IP przy użyciu nowej
PublicIPAddressConfiguration
właściwości .NetworkConfiguration
- [Niezgodność] Nazwa
publicIPs
właściwościNetworkConfiguration
została zmieniona naipAddressIds
i została również przeniesiona doPublicIPAddressConfiguration
. Tę właściwość można określić tylko wtedy, gdyprovision
właściwość ma wartośćusermanaged
.
Wersja: 2019-08-01.10.0
- Dodano możliwość określania kolekcji publicznych adresów IP
NetworkConfiguration
za pośrednictwem nowejpublicIPs
właściwości w puli. Gwarantuje to, że węzły w puli będą miały adres IP z listy podanych adresów IP. - Dodano możliwość instalowania zdalnych systemów plików w każdym węźle puli za pośrednictwem
MountConfiguration
właściwości . - Shared Image Gallery obrazy można teraz określić we
virtualMachineImageId
właściwościImageReference
, odwołując się do obrazu za pośrednictwem identyfikatora usługi Azure Resource Manager. - [Niezgodność] Jeśli nie zostanie określony, wartość domyślna dla zmiennej
waitForSuccess
onStartTask
totrue
(wcześniej byłafalse
to ). - [Niezgodność] Jeśli nie zostanie określony, wartość domyślna polecenia
scope
on jest teraz zawszePool
(wcześniej byłaTask
w węzłach systemu Windows iPool
w węzłach systemuAutoUserSpecification
Linux). - Ulepszono różne mylące lub niekompletne dokumenty.
Wersja: 2019-06-01.9.0
[Niezgodność] Zamieniono
ListNodeAgentSKUs
element naListSupportedImages
.ListSupportedImages
zawiera wszystkie te same informacje, które pierwotnie są dostępne w formacieListNodeAgentSKUs
, ale w jaśniejszym formacie. Teraz są również zwracane nowe, niezweryfikowane obrazy. Dodatkowe informacje o usłudzeCapabilities
iBatchSupportEndOfLife
są dostępne za pośrednictwem poleceniaImageInformation
.Teraz obsługują reguły zabezpieczeń sieci blokujące dostęp sieciowy do
CloudPool
obiektu na podstawie portu źródłowego ruchu. Jest to realizowane za pomocą właściwościSourcePortRanges
w klasieNetworkSecurityGroupRule
.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 właściwość
WorkingDirectory
w klasieTaskContainerSettings
.Ulepszono różne mylące lub niekompletne dokumenty.
Wersja: 2018-12-01.8.0
[Niezgodność] Usunięto obsługę w
upgradeos
pulachcloudServiceConfiguration
.[Niezgodność] Usunięto
dataEgressGiB
elementów idataIngressGiB
zpoolusagemetrics
elementu . Te właściwości nie są już obsługiwane.[Niezgodność]
ResourceFile
Ulepszenia- Dodano możliwość określenia całego kontenera usługi Azure Storage w pliku ResourceFile. Istnieją teraz trzy obsługiwane tryby dla elementu ResourceFile:
-
httpUrl
Tworzy punktResourceFile
pojedynczego adresu URL HTTP. -
storageContainerUrl
Tworzy punktResourceFile
dla kontenera Azure Blob Storage. -
autoStorageContainerName
tworzy punktResourceFile
do kontenera Azure Blob Storage na zarejestrowanym koncie automatycznego tworzenia usługi Batch.
-
- Adresy URL udostępniane
ResourceFile
za pośrednictwemhttpUrl
metody mogą teraz być dowolnym adresem URL PROTOKOŁU HTTP. Wcześniej musiały one być adresem URL Azure Blob Storage. -
blobPrefix
można używać do filtrowania pobierania z kontenera magazynu tylko do tych pasujących do prefiksu.
- Dodano możliwość określenia całego kontenera usługi Azure Storage w pliku ResourceFile. Istnieją teraz trzy obsługiwane tryby dla elementu ResourceFile:
[Niezgodność] Usunięto
osDisk
właściwość zVirtualMachineConfiguration
elementu . Ta właściwość nie jest już obsługiwana.Pule, które ustawiają
dynamicVNetAssignmentScope
wartość włączonąNetworkConfiguration
job
, mogą teraz dynamicznie przypisywać Virtual Network do każdego węzła, w ramach którego zadania są uruchamiane. Określona Virtual Network do przyłączenia węzłów do programu jest określona w nowejJobNetworkConfiguration
właściwości w systemieCloudJob
iJobSpecification
.Uwaga
Ta funkcja jest dostępna w publicznej wersji zapoznawczej. Jest ona wyłączona dla wszystkich kont usługi Batch z wyjątkiem tych, które skontaktowały się z nami i zażądały, aby były w pilotażu.
Maksymalny okres istnienia zadania wynosi teraz 180 dni (wcześniej było to 7).
Dodano obsługę pul systemu Windows na potrzeby tworzenia użytkowników z określonym trybem logowania (lub
batch
interactive
) za pośrednictwem poleceniaLoginMode
.Domyślny czas przechowywania zadań dla wszystkich zadań wynosi teraz 7 dni, wcześniej był nieskończony.
Wersja 2018-08-01.7.0
Nowe funkcje w wersji 2018-08-01.7.0 obejmują:
- Wyświetl wersję agenta Azure Batch Node za pośrednictwem nowej właściwości NodeAgentInfo w programie ComputeNode.
- Dodano możliwość określenia
Filter
wartości zadaniaResult
. Więcej informacji można znaleźć tutaj.- Umożliwia to często żądany scenariusz wykonywania zapytania po stronie serwera w celu znalezienia wszystkich zadań, które zakończyły się niepowodzeniem.
-
[Niezgodność] Usunięto
ValidationStatus
właściwość z taskCounts. -
[Niezgodność] Domyślny typ buforowania dla dysków DataDisk i OSDisk jest teraz
ReadWrite
zamiastNone
. -
[Niezgodność] Zmieniono nazwę jedynej wartości ContainerType z
docker
nadockerCompatible
.
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ść wykonywania zapytań dotyczących liczby węzłów puli według stanu za pośrednictwem nowej operacji ListPoolNodeCounts . Ta operacja umożliwia wykonywanie zapytań dotyczących wszystkich pul na koncie usługi Batch dla stanów węzłów, w tym tworzenia, bezczynności, trybu offline, wywłaszczania, ponownego uruchamiania, ponownego tworzenia, uruchamiania i innych.
- Dzienniki agenta węzła: ta wersja dodaje możliwość przekazywania dzienników agenta węzła Azure Batch z określonego węzła za pośrednictwem operacji UploadBatchServiceLogs. Jest to przeznaczone do użycia w debugowaniu przez pomoc techniczna firmy Microsoft w przypadku wystąpienia problemów w węźle.
Wersja 2017-09-01.6.0
Korzyść użycia hybrydowego platformy Azure: możesz teraz utworzyć pule maszyn wirtualnych z systemem Windows w usłudze Batch określające, że ma być używane licencjonowanie korzyści użycia hybrydowego platformy Azure. Gdy to licencjonowanie jest używane, rabat jest stosowany do ceny maszyny wirtualnej. Użyj nowej właściwości LicenseType w usłudze VirtualMachineConfiguration.
Dyski danych maszyny wirtualnej puli: można dołączyć jeden lub więcej pustych dysków danych do pul maszyn wirtualnych przy użyciu nowej konfiguracji dysku danych, która jest częścią konfiguracji maszyny wirtualnej. Użyj właściwości DataDisks w usłudze VirtualMachineConfiguration.
(Zmiana powodująca niezgodność) Obrazy niestandardowe są teraz tworzone i wdrażane przy użyciu zasobów obrazu usługi Azure Resource Manager zamiast plików VHD obiektów blob. Usługa Batch używa teraz dysków zarządzanych do tworzenia maszyn wirtualnych puli i w związku z tym używa zasobu Obraz . Obecnie nie ma limitu liczby maszyn wirtualnych w puli utworzonej przy użyciu obrazu niestandardowego; Ponadto wiele kopii obiektu blob VHD dla dużych pul nie jest już wymagane. W związku z tym pule obrazów niestandardowych są znacznie łatwiejsze do tworzenia i skalowania. Aby uzyskać więcej informacji, zobacz Tworzenie puli maszyn wirtualnych przy użyciu obrazu niestandardowego.
Nowa właściwość VirtualMachineImageId na właściwości ImageReference zawiera odwołanie do właściwości Image, a identyfikator OSDisk.ImageUris już nie istnieje.
Z powodu tej zmiany funkcja ImageReference jest teraz wymaganą właściwością VirtualMachineConfiguration.
(Zmiana powodująca niezgodność) Zadania obejmujące wiele wystąpień (utworzone przy użyciu funkcji MultiInstanceSettings) muszą teraz określać wartość CoordinationCommandLine, a parametr NumberOfInstances jest teraz opcjonalny, a wartości domyślne to 1.
Dodano obsługę zadań uruchamianych przy użyciu kontenerów platformy Docker. Aby uruchomić zadanie przy użyciu kontenera platformy Docker, należy określić element ContainerConfiguration w obiekcie VirtualMachineConfiguration dla puli, a następnie dodać element TaskContainerSettingsw zadaniu.
Wersja 2017-06-01.5.1
Wersja interfejsu API usługi Batch opisana tutaj to 2017-06-01.5.1. Użycie najnowszej wersji jest zalecane, jeśli jest to możliwe.
Nowe funkcje w wersji 2017-06-01.5.1 obejmują:
- Obsługa wydajnych liczników zadań za pomocą nowej operacji Pobieranie liczby zadań . Wywołując operację Pobieranie liczby zadań, można uzyskać liczbę aktywnych, uruchomionych i zakończonych zadań oraz zadań, które zakończyły się powodzeniem lub niepowodzeniem. Aby uzyskać więcej informacji, zobacz Liczba zadań dla zadania według stanu (wersja zapoznawcza).
- Obsługa określania przychodzących punktów końcowych w węzłach obliczeniowych puli za pośrednictwem nowej właściwości poolEndpointConfiguration . Ustawiając tę właściwość, można adresować określone porty w węźle zewnętrznie.
Wersja 2017-05-01.5.0
W poniższych sekcjach opisano nowe i zmienione funkcje w wersji 2017-05-01.5.0.
Ważne
Wersja 2017-05-01.5.0 zawiera kilka zmian powodujących niezgodność. Przejrzyj zmiany powodujące niezgodność wymienione poniżej i zaktualizuj kod, aby wywołać wersję 2017-05-01.5.0.
Węzły obliczeniowe o niskim priorytcie
Azure Batch teraz oferuje węzły obliczeniowe o niskim priorytcie, aby zmniejszyć koszty obciążeń usługi Batch. Maszyny wirtualne o niskim priorytcie sprawiają, że nowe typy obciążeń usługi Batch są możliwe, zapewniając dużą ilość mocy obliczeniowej, która jest również ekonomiczna.
Istnieje kilka zmian interfejsu API REST dla węzłów o niskim priorytcie:
- (Zmiana powodująca niezgodność) Nazwa targetDedicated i currentDedicated właściwości specyfikacji puli lub puli została zmieniona na targetDedicatedNodes i currentComputeNodes.
- (Zmiana powodująca niezgodność) Właściwość resizeError puli jest teraz kolekcją o nazwie resizeErrors.
- Węzły obliczeniowe mają nową właściwość isDedicated . Ta właściwość ma wartość true dla dedykowanych węzłów i wartość false dla węzłów o niskim priorytetu.
- Zadanie Menedżera zadań ma nową właściwość allowLowPriorityNode . Jeśli ta właściwość ma wartość true, zadanie Menedżera zadań może być uruchamiane w węźle o niskim priorytcie. Jeśli jest to fałsz, zadanie Menedżera zadań zostanie uruchomione w dedykowanym węźle obliczeniowym.
Nazwani użytkownicy w systemie Linux
Azure Batch teraz oferuje dodatkową obsługę tworzenia nazwanych użytkowników w węzłach systemu Linux.
- Nowa właściwość linuxUserConfiguration obsługuje określanie identyfikatora uid (identyfikatora użytkownika) i gid (identyfikator grupy) podczas tworzenia użytkownika systemu Linux.
- (Zmiana powodująca niezgodność) 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 samą właściwością właściwości userAccount .
Aby uzyskać więcej informacji na temat nazwanych kont użytkowników, zobacz Uruchamianie zadań w obszarze konta użytkowników w usłudze Batch.
Pliki wyjściowe dla danych zadań
Teraz można określić pliki wyjściowe, aby przekazać dane zadania po zakończeniu zadania.
- Nowa właściwość outputFiles obsługuje określanie plików zadań do przekazania do usługi Azure Storage.
- Nowa właściwość fileUploadError właściwości exitConditions obsługuje określanie akcji do wykonania na podstawie stanu przekazywania pliku wyjściowego.
Raportowanie błędów zadań
Wprowadzono kilka zmian w celu poprawy raportowania błędów zadań.
- Nowa właściwość result właściwości executionInfo wskazuje, czy zadanie zakończyło się powodzeniem, czy niepowodzeniem.
- (Zmiana powodująca niezgodność) Nazwa właściwości schedulingError właściwości executionInfo została zmieniona na failureInfo. Właściwość failureInfo jest zwracana za każdym razem, gdy wystąpi błąd zadania. Obejmuje to wszystkie poprzednie przypadki błędów planowania, wszystkie przypadki, w których zwracany jest kod zakończenia zadania niezerowego i wszelkie błędy przekazywania plików.
- (Zmiana powodująca niezgodność) Nazwa właściwości schedulingError właściwości exitConditions została zmieniona na preProcessingError , aby wyjaśnić, kiedy wystąpił błąd w cyklu życia zadania.
- (Zmiana powodująca niezgodność) Nazwa właściwości schedulingErrorCateogry została zmieniona na errorCategory.
Licencje aplikacji
Teraz możesz zażądać aprowizacji licencji aplikacji w puli za pośrednictwem nowej właściwości applicationLicenses w specyfikacji puli lub puli.
Wersja 2017-01-01.4.0
Ta wersja rozszerza całą obsługę z poprzedniej wersji 2016-07-01.3.1. Ponadto obsługuje ona następujące możliwości:
Uruchom zadanie w ramach określonej tożsamości użytkownika.
Teraz można uruchomić kolekcję zadań lub zadań w ramach jednej z następujących tożsamości użytkownika określonych za pośrednictwem nowej właściwości userIdentity w zasobie zadania:
Konto użytkownika o zdefiniowanej nazwie.
Konto użytkownika, które jest tworzone automatycznie (automatycznie użytkownik). Użytkownik automatyczny może działać jako użytkownik administracyjny lub jako użytkownik niebędący administratorem. Domyślnie użytkownik automatyczny jest uruchamiany jako użytkownik niebędący administratorem.
Ważne
Właściwość userIdentity z jej właściwością elevationLevel zastępuje właściwość runElevated w żądaniach, które dodają zadanie lub kolekcję zadań, oraz w odpowiedziach, które pobierają informacje o zadaniu lub zadaniach listy.
Jeśli wyślesz żądanie zawierające właściwość runElevated do wersji 2017-01-01.4.0 usługi Batch, żądanie zakończy się niepowodzeniem.
Aby uruchomić użytkownika administracyjnego, zaktualizuj aplikację, aby korzystała z właściwości userIdentity , ustawiając właściwość elevationLevel na administratora.
Aby uruchomić jako użytkownik niebędący administratorem, zaktualizuj aplikację, aby korzystała z właściwości userIdentity , ustawiając właściwość elevationLevel na wartość nonAdmin. Ponieważ jest to ustawienie domyślne, można również pominąć to ustawienie.
Zdefiniuj konta użytkowników we wszystkich węzłach w puli.
Teraz możesz uruchomić kolekcję zadań lub zadań w ramach konta użytkownika zdefiniowanego w zasobie puli. Zdefiniuj konto użytkownika za pomocą nowej właściwości userAccounts w żądaniach dodania puli. Podczas definiowania konta można określić nazwę konta, hasło, poziom podniesienia uprawnień (administrator lub inny niż administrator) oraz klucz prywatny SSH (w przypadku pul systemu Linux).
Po zdefiniowaniu konta użytkownika można określić to konto użytkownika dla właściwości userIdentity w żądaniach dodania zadania lub kolekcji zadań.
Podaj zadanie z tokenem w celu uwierzytelnienia w usłudze Batch po uruchomieniu zadania.
Usługa Batch może teraz podać token uwierzytelniania do zadania po jego uruchomieniu. Token uwierzytelniania umożliwia zadanie wystawiania żądań związanych z zadaniem do usługi Batch bez kluczy konta usługi Batch. Token jest dostarczany za pośrednictwem zmiennej środowiskowej AZ_BATCH_AUTHENTICATION_TOKEN.
Obecnie tokeny uwierzytelniania są obsługiwane tylko w przypadku wywoływania operacji na zasobie zadania. Token uwierzytelniania udziela dostępu do wszystkich operacji w zadaniu, które zawiera zadanie.
Aby usługa Batch dostarczyła token uwierzytelniania, określ nową właściwość authenticationTokenSettings wraz z jej właściwością dostępu , w żądaniach dodania zadania lub dodania kolekcji zadań.
Określ akcję, która ma być wykonywana na zależnościach zadania, jeśli zadanie zakończy się niepowodzeniem.
Teraz można określić, że zadania zależne będą kontynuowane nawet wtedy, gdy zadanie, od którego zależą, zakończy się niepowodzeniem. Ustaw nową właściwość dependencyAction zasobu zadania, aby spełnić je pod kątem uruchamiania zadań zależnych, nawet jeśli zadanie nadrzędne zakończy się niepowodzeniem. Alternatywnie ustaw właściwość dependencyAction , aby zablokować , aby zapobiec uruchamianiu zadań zależnych, jeśli zadanie nadrzędne zakończy się niepowodzeniem.
Określ właściwość dependencyAction w żądaniach , aby dodać zadanie lub dodać kolekcję zadań.
Aby uzyskać więcej informacji na temat korzystania z akcji zależności, zobacz Akcje zależności.
Podczas tworzenia puli użyj niestandardowych obrazów dysków systemu operacyjnego.
Teraz możesz użyć niestandardowych obrazów dysków systemu operacyjnego do utworzenia puli.
W tym celu należy określić, kiedy tworzysz konto usługi Batch, które pule mają być aprowidowane w subskrypcji użytkownika, a nie w subskrypcji zarządzanej przez usługę Batch. W wywołaniu metody Create Account ustaw właściwość poolAllocationMode na UserSubscription. Następnie użyj właściwości osDisk , aby określić odwołanie do obrazu dysku w żądaniu dodania puli.
Ważne
Jeśli podczas tworzenia konta usługi Batch określisz, że pule mają być aprowidowane w subskrypcji użytkownika, musisz użyć uwierzytelniania opartego na usłudze Azure Active Directory dla wszystkich żądań wysyłanych za pośrednictwem tego konta.
Użyj uwierzytelniania opartego na usłudze Azure Active Directory w przypadku żądań do usługi Batch.
Usługa Azure Active Directory (Azure AD) jest teraz obsługiwana do uwierzytelniania wywołań do usługi Batch.
Jeśli konto usługi Batch jest skonfigurowane do aprowizowania pul w subskrypcji użytkownika, wymagane jest użycie uwierzytelniania Azure AD.
Wersja 2016-07-01.3.1
Ta wersja rozszerza wszystkie wsparcie z poprzedniej wersji, 2016-02-01.3.0. Ponadto obsługuje następujące możliwości:
Możliwość tworzenia puli i puli automatycznej z konfiguracją sieci
- Nowa właściwość networkConfiguration została dodana zarówno do puli, jak i zasobów puli automatycznej. Tej właściwości można użyć do określenia konfiguracji sieci puli, takiej jak podsieć, w której są tworzone węzły obliczeniowe puli.
Automatyczne kończenie zadania po zakończeniu wszystkich zadań.
- Nowa właściwość onAllTasksComplete została dodana do zasobu zadania. Można to określić podczas tworzenia lub aktualizowania zadania.
Automatyczne kończenie lub wyłączanie zadania w przypadku niepowodzenia zadania.
- Nowa właściwość onTaskFailure została dodana do zasobu zadania, a nowa właściwość exitConditions została dodana do zasobu zadania. Ustawienie onTaskFailure zadania wskazuje, czy niepowodzenie zadania może mieć wpływ na poziom zadania, a właściwość exitConditions zadania umożliwia zadaniaom dostosowanie wpływu na poziom zadania do charakteru błędu.
Kojarzenie pakietów aplikacji z zadaniami, a także pulami.
- Nowa aplikacja właściwościPackageReferences została dodana do zasobu zadania i do ustawień jobManagerTask. Dzięki temu pakiety aplikacji mogą być wdrażane na żądanie, ponieważ zadania wymagają ich, zamiast wymagać ich określenia w czasie tworzenia puli. Jest to szczególnie przydatne w przypadku długotrwałych pul, które mogą być wywoływane w celu uruchamiania różnych rodzajów zadań lub różnych wersji aplikacji w okresie ich istnienia lub jeśli masz duży pakiet aplikacji, który nie jest wymagany przez wszystkie zadania.
Możliwość ponownego aktywowania zadania, które zakończyło się niepowodzeniem.
- Dodano nową operację Ponowne aktywowanie zadania w celu zresetowania stanu zadania, które zakończyło się niepowodzeniem. Pozwala to na ponowne ponowienia próby, na przykład jeśli błąd był przejściowy lub czy można było naprawić przyczynę błędu, bez ponownego utworzenia zadania.
Wersja 2016-02-01.3.0
Ta wersja rozszerza wszystkie wsparcie z poprzedniej wersji, 2015-12-01.2.2. Ponadto obsługuje następujące możliwości:
Możliwość tworzenia puli i puli automatycznej przy użyciu konfiguracji maszyny wirtualnej IaaS
Istniejące właściwości "osFamily", "targetOSVersion" i "currentOSVersion" są przenoszone z właściwości najwyższego poziomu zasobów puli i puli automatycznej i są przenoszone wewnątrz nowej właściwości o nazwie "cloudServiceConfiguration".
Nowa właściwość "virtualMachineConfiguration" jest dodawana zarówno do zasobów puli, jak i puli automatycznej. Tę właściwość można określić, aby skonfigurować pulę/pulę automatyczną za pomocą maszyn wirtualnych IaaS.
Dodano nowy interfejs API w celu uzyskania informacji o wszystkich jednostkach SKU agenta węzła obsługiwanych przez usługę Batch. Zobacz Wyświetlanie listy obsługiwanych jednostek SKU agenta węzła.
Dodano nowy interfejs API w celu uzyskania ustawień logowania zdalnego, których można użyć do zdalnego logowania do węzła obliczeniowego utworzonego przy użyciu konfiguracji maszyny wirtualnej IaaS. Zobacz Pobieranie ustawień zdalnego logowania dla węzła.
Dodano nowy interfejs API w celu dodania kolekcji zadań do zadania. Zobacz Dodawanie kolekcji zadań do zadania.
Nowa opcjonalna właściwość "sshPublicKey" jest dodawana do zasobu Użytkownik, który może służyć do dodawania/aktualizowania użytkowników w węźle obliczeniowym systemu Linux.
Do zasobu Node są dodawane dwie nowe właściwości "totalTasksSucceeded" i "runningTasksCount". Te właściwości można uzyskać za pomocą pozycji Pobierz informacje o węźle lub Wyświetl listę węzłów obliczeniowych w puli.
Nowa właściwość "fileMode" jest dodawana do typu złożonego "ResourceFile". Ta właściwość jest stosowana tylko w węzłach obliczeniowych systemu Linux i ignorowana dla węzłów obliczeniowych systemu Windows.
Nowa właściwość "fileMode" jest dodawana do typu złożonego "FileProperties". Ta właściwość jest zwracana przez usługę Batch dla węzłów obliczeniowych systemu Linux w ramach interfejsów API GetFileProperties lub ListFileProperties. Ponadto istniejąca właściwość "creationTime" w ramach typu złożonego "FileProperties" jest zmieniana na właściwość opcjonalną, ponieważ ta właściwość nie zostanie zwrócona dla węzłów obliczeniowych systemu Linux.
Typ danych istniejącej właściwości "widoczność" wewnątrz typu złożonego "CertificateReference" jest modyfikowany z ciągu z wartościami rozdzielanymi przecinkami do kolekcji ciągów. Nazwa jednej z istniejących wartości widoczności została zmieniona z "rdp" na "remoteuser".
Adresy URL następujących interfejsów API są zmieniane w celu zastąpienia ciągu "?" dla nazwy akcji na "/":
Uaktualnianie systemu operacyjnego węzłów obliczeniowych w puli
Wersja 2015-12-01.2.2
Ta wersja rozszerza wszystkie wsparcie z poprzedniej wersji, 2015-11-01.2.1. Ponadto obsługuje następujące możliwości:
Aplikacje można teraz wdrażać w węzłach obliczeniowych przy użyciu pakietów aplikacji zamiast plików zasobów.
Nowe interfejsy API są udostępniane klientom w celu przeglądania listy dostępnych aplikacji i wersji, na przykład w celu wyświetlenia selektora w interfejsie użytkownika.
Interfejsy API związane z pulą są zmieniane, aby umożliwić puli określanie pakietów aplikacji do pobrania do wszystkich węzłów w tej puli.
Zadania mogą być teraz zależne od innych zadań. Zadanie zależne nie zostanie uruchomione do momentu pomyślnego ukończenia wszystkich zadań, od których zależy.
Ta wersja zawiera następujące inne zmiany:
- Domyślny limit czasu zmiany rozmiaru puli został zmieniony na 15 minut.
Wersja 2015-11-01.2.1
Ta wersja rozszerza wszystkie wsparcie z poprzedniej wersji 2015-06-01.2.0. Ponadto obsługuje następujące możliwości:
Możliwość dodawania i uruchamiania zadania z wieloma wystąpieniami (na przykład MPI)
Nowa opcjonalna właściwość "multiInstanceSettings" jest dodawana do zasobu Zadania, który można opcjonalnie uwzględnić w interfejsach API Dodaj zadanie, Pobierz zadanie, Lista zadań.
Dodano nową listę podzadań zadania interfejsu API w celu uzyskania informacji o podzadaniach.
Nowa opcjonalna właściwość "subtaskId" jest dodawana do elementu "recentTasks" dla węzła obliczeniowego. Ta właściwość jest zwracana w ramach pobierania węzła obliczeniowego i wyświetlania listy węzłów obliczeniowych
Możliwość wyłączania lub włączania planowania zadań w węźle obliczeniowym
Dwa nowe interfejsy API Wyłącz planowanie zadań w węźle i Włącz planowanie zadań w węźle są dodawane w zasobie węzła obliczeniowego.
Dodano nowy stan węzła obliczeniowego "offline". W przypadku starszych wersji interfejsu API ten stan jest mapowany na "bezużyteczne".
Nowa właściwość "schedulingState" jest dodawana do zasobu węzła obliczeniowego. Możliwe wartości dla wartości "enabled" i "disabled".
Możliwość określania interwału oceny autoskalowania w puli/puli automatycznej
Nowa właściwość "autoScaleEvaluationInterval" jest dodawana do zasobu puli. Tę właściwość można uwzględnić w interfejsach API Dodaj pulę, Pobierz pulę, Włącz autoskalowanie i Pule list.
Podobnie w przypadku pul automatycznych nowa właściwość "autoScaleEvaluationInterval" jest dodawana do właściwości "autoPoolSpecification". Tę właściwość można uwzględnić w obszarze Dodaj zadanie, Pobierz zadanie, Lista zadań, Dodaj harmonogram zadań, Pobierz harmonogram zadań, Harmonogram aktualizacji zadań, Harmonogram zadań listy i Zadania listy w interfejsach API harmonogramu zadań.
Ulepszenie interfejsów API zadań w celu zwrócenia katalogu głównego zadania w węźle obliczeniowym.
Do zasobu zadania dodawane są dwie nowe właściwości "taskRootDirectoryUrl" i "taskRootDirectoryUrl", które można uzyskać w ramach sekcji Pobieranie informacji o zadaniu, interfejsach API list tasks
Nowa właściwość "taskRootDirectory" jest dodawana do elementów "jobPreparationTaskExecutionInfo" i "jobReleaseTaskExecutionInfo", które można uzyskać za pomocą pozycji Lista stanu zadań przygotowania i wydania zadania dla interfejsu API zadania.