Jobs - Create Job
Tworzy zadanie na określone konto.
Usługa Batch obsługuje dwa sposoby kontrolowania pracy wykonywanej w ramach zadania.
W pierwszym podejściu użytkownik określa zadanie Menedżera Zadań. Usługa Batch uruchamia to zadanie, gdy jest gotowe do rozpoczęcia zadania. Zadanie Menedżera Zadań kontroluje wszystkie pozostałe zadania działające pod tym zadaniem, korzystając z API zadań. W drugim podejściu użytkownik bezpośrednio kontroluje wykonywanie zadań w ramach aktywnego zadania, korzystając z API zadań. Warto też zauważyć: przy nadawaniu nazw Jobs, unikaj podawania wrażliwych informacji, takich jak nazwy użytkowników czy tajne nazwy projektów.
Te informacje mogą być wyświetlane w dziennikach telemetrii dostępnych dla inżynierów pomocy technicznej firmy Microsoft.
POST {endpoint}/jobs?api-version=2025-06-01
POST {endpoint}/jobs?api-version=2025-06-01&timeOut={timeOut}
Parametry identyfikatora URI
| Nazwa | W | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
endpoint
|
path | True |
string (uri) |
Punkt końcowy konta usługi Batch (na przykład: https://batchaccount.eastus2.batch.azure.com). |
|
api-version
|
query | True |
string minLength: 1 |
Wersja interfejsu API do użycia dla tej operacji. |
|
time
|
query |
integer (int32) |
Maksymalny czas przetwarzania żądania przez serwer w sekundach. Wartość domyślna to 30 sekund. Jeśli wartość jest większa niż 30, zostanie użyta domyślna wersja domyślna.". |
Nagłówek żądania
Media Types: "application/json; odata=minimalmetadata"
| Nazwa | Wymagane | Typ | Opis |
|---|---|---|---|
| client-request-id |
string |
Tożsamość żądania wygenerowanego przez obiekt wywołujący w postaci identyfikatora GUID bez dekoracji, takiej jak nawiasy klamrowe, np. 9C4D50EE-2D56-4CD3-8152-34347DC9F2B0. |
|
| return-client-request-id |
boolean |
Czy serwer powinien zwrócić identyfikator żądania klienta w odpowiedzi. |
|
| ocp-date |
string (date-time-rfc7231) |
Czas wystawienia żądania. Biblioteki klienckie zazwyczaj ustawiają tę wartość na bieżący czas zegara systemowego; ustaw go jawnie, jeśli bezpośrednio wywołujesz interfejs API REST. |
Treść żądania
Media Types: "application/json; odata=minimalmetadata"
| Nazwa | Wymagane | Typ | Opis |
|---|---|---|---|
| id | True |
string |
Ciąg, który jednoznacznie identyfikuje zadanie w ramach konta. Identyfikator może zawierać dowolną kombinację znaków alfanumerycznych, w tym łączników i podkreśleń, i nie może zawierać więcej niż 64 znaków. Identyfikator jest zachowywany przy użyciu wielkości liter i bez uwzględniania wielkości liter (oznacza to, że w ramach konta mogą nie istnieć dwa identyfikatory, które różnią się tylko wielkością liter). |
| poolInfo | True |
Pula, w której usługa Batch uruchamia zadania podrzędne zadania. |
|
| allowTaskPreemption |
boolean |
Czy zadania podrzędne w tym zadaniu mogą zostać wywłaszczone przez inne zadania o wysokim priorytcie. (Ta właściwość nie jest domyślnie dostępna. Skontaktuj się z pomocą techniczną, aby uzyskać więcej informacji) Jeśli wartość jest ustawiona na True, inne zadania o wysokim priorytecie przesłane do systemu będą miały pierwszeństwo i będą mogły ponownie kolejkować zadania z tego zadania. Możesz zaktualizować parametr allowTaskPreemption zadania po jego utworzeniu przy użyciu interfejsu API zadania aktualizacji. |
|
| commonEnvironmentSettings |
Lista typowych ustawień zmiennych środowiskowych. Te zmienne środowiskowe są ustawiane dla wszystkich zadań w zadaniu (w tym menedżera zadań, przygotowania zadania i zadania zwolnienia zadania). Poszczególne zadania mogą zastąpić ustawienie środowiska określone w tym miejscu, określając tę samą nazwę ustawienia o innej wartości. |
||
| constraints |
Ograniczenia wykonywania zadania. |
||
| displayName |
string |
Nazwa wyświetlana zadania. Nazwa wyświetlana nie musi być unikatowa i może zawierać znaki Unicode o maksymalnej długości 1024. |
|
| jobManagerTask |
Szczegóły zadania Menedżera zadań, które mają zostać uruchomione po uruchomieniu zadania. Jeśli zadanie nie określi zadania Menedżera zadań, użytkownik musi jawnie dodać zadania do zadania. Jeśli zadanie określi zadanie Menedżera zadań, usługa Batch tworzy zadanie Menedżera zadań podczas tworzenia zadania i spróbuje zaplanować zadanie Menedżera zadań przed zaplanowaniem innych zadań w zadaniu. Typowym celem zadania Menedżera zadań jest kontrolowanie i/lub monitorowanie wykonywania zadania, na przykład poprzez podjęcie decyzji o tym, jakie dodatkowe zadania do uruchomienia, określenie, kiedy praca jest ukończona itp. (Jednak zadanie Menedżera zadań nie jest ograniczone do tych działań — jest to w pełni funkcjonalne zadanie w systemie i wykonywanie jakichkolwiek akcji wymaganych dla zadania). Na przykład zadanie Menedżera zadań może pobrać plik określony jako parametr, przeanalizować zawartość tego pliku i przesłać dodatkowe zadania na podstawie tej zawartości. |
||
| jobPreparationTask |
Zadanie przygotowania zadania. Jeśli zadanie ma zadanie przygotowania zadania, usługa Batch uruchomi zadanie przygotowania zadania w węźle przed uruchomieniem dowolnego zadania tego zadania w tym węźle obliczeniowym. |
||
| jobReleaseTask |
Zadanie zwolnienia zadania. Nie można określić zadania zwolnienia zadania bez określania zadania przygotowania zadania. Usługa Batch uruchamia zadanie zwolnienia zadania w węzłach, w których uruchomiono zadanie przygotowania zadania. Głównym celem zadania zwolnienia zadania jest cofnięcie zmian w węzłach obliczeniowych wprowadzonych przez zadanie przygotowania zadania. Przykładowe działania obejmują usuwanie plików lokalnych lub zamykanie usług, które zostały uruchomione w ramach przygotowania zadania. |
||
| maxParallelTasks |
integer (int32) |
Maksymalna liczba zadań, które mogą być wykonywane równolegle dla zadania. (Ta właściwość nie jest domyślnie dostępna. Skontaktuj się z pomocą techniczną, aby uzyskać więcej informacji) Wartość maxParallelTasks musi być -1 lub większa niż 0, jeśli zostanie określona. Jeśli nie zostanie określona, wartość domyślna to -1, co oznacza, że nie ma limitu liczby zadań, które można uruchamiać jednocześnie. Wartość maxParallelTasks zadania można zaktualizować po jego utworzeniu przy użyciu interfejsu API zadania aktualizacji. |
|
| metadata |
Lista par name-value skojarzonych z zadaniem jako metadanymi. Usługa Batch nie przypisuje żadnego znaczenia metadanym; służy wyłącznie do używania kodu użytkownika. |
||
| networkConfiguration |
(Ta właściwość nie jest domyślnie dostępna. Skontaktuj się z pomocą techniczną, aby uzyskać więcej informacji) Konfiguracja sieci dla zadania. |
||
| onAllTasksComplete |
Akcja, jaką usługa Batch powinna wykonać, gdy wszystkie zadania w zadaniu są w stanie ukończonym. Należy pamiętać, że jeśli zadanie nie zawiera zadań, wszystkie zadania są uznawane za ukończone. W związku z tym ta opcja jest najczęściej używana z zadaniem Menedżera zadań; Jeśli chcesz używać automatycznego kończenia zadań bez Menedżera zadań, należy początkowo ustawić wartość onAllTasksComplete na wartość noaction i zaktualizować właściwości zadania, aby ustawić właściwość onAllTasksComplete na zakończenie zadania po zakończeniu dodawania zadań. Wartość domyślna to noaction. |
||
| onTaskFailure |
Akcja, jaką usługa Batch powinna wykonać, gdy dowolne zadanie w zadaniu zakończy się niepowodzeniem. Zadanie jest uznawane za nieudane, jeśli występuje błądInfo. Właściwość failureInfo jest ustawiana, jeśli zadanie kończy się kodem zakończenia innym niż zero po wyczerpaniu liczby ponownych prób lub jeśli wystąpił błąd podczas uruchamiania zadania, na przykład z powodu błędu pobierania pliku zasobu. Wartość domyślna to noaction. |
||
| priority |
integer (int32) |
Priorytet zadania. Wartości priorytetu mogą mieścić się w zakresie od -1000 do 1000, a -1000 jest najniższym priorytetem, a 1000 jest najwyższym priorytetem. Wartość domyślna to 0. |
|
| usesTaskDependencies |
boolean |
Czy zadania w zadaniu mogą definiować zależności od siebie. Wartość domyślna to false. |
Odpowiedzi
| Nazwa | Typ | Opis |
|---|---|---|
| 201 Created |
Żądanie zakończyło się pomyślnie i w rezultacie został utworzony nowy zasób. Nagłówki
|
|
| Other Status Codes |
Nieoczekiwana odpowiedź na błąd. |
Zabezpieczenia
OAuth2Auth
Typ:
oauth2
Flow:
implicit
Adres URL autoryzacji:
https://login.microsoftonline.com/common/oauth2/v2.0/authorize
Zakresy
| Nazwa | Opis |
|---|---|
| https://batch.core.windows.net//.default |
Przykłady
| Creates a basic job |
| Creates a complex job |
Creates a basic job
Przykładowe żądanie
POST {endpoint}/jobs?api-version=2025-06-01
{
"id": "jobId",
"priority": 0,
"poolInfo": {
"poolId": "poolId"
}
}
Przykładowa odpowiedź
Creates a complex job
Przykładowe żądanie
POST {endpoint}/jobs?api-version=2025-06-01
{
"id": "jobId",
"priority": 100,
"constraints": {
"maxWallClockTime": "PT1H",
"maxTaskRetryCount": -1
},
"jobManagerTask": {
"id": "taskId",
"commandLine": "myprogram.exe",
"resourceFiles": [
{
"httpUrl": "http://mystorage1.blob.core.windows.net/scripts/myprogram.exe?sas",
"filePath": "myprogram.exe"
},
{
"storageContainerUrl": "http://mystorage1.blob.core.windows.net/data?sas",
"filePath": "datafolder"
}
],
"environmentSettings": [
{
"name": "myvariable",
"value": "myvalue"
}
],
"constraints": {
"maxWallClockTime": "PT1H",
"maxTaskRetryCount": 0,
"retentionTime": "PT1H"
},
"requiredSlots": 2,
"killJobOnCompletion": false,
"userIdentity": {
"autoUser": {
"scope": "task",
"elevationLevel": "admin"
}
},
"runExclusive": true
},
"poolInfo": {
"autoPoolSpecification": {
"autoPoolIdPrefix": "mypool",
"poolLifetimeOption": "job",
"pool": {
"vmSize": "Standard_D2ds_v5",
"virtualMachineConfiguration": {
"imageReference": {
"publisher": "MicrosoftWindowsServer",
"offer": "WindowsServer",
"sku": "2025-datacenter-smalldisk",
"version": "latest"
},
"nodeAgentSKUId": "batch.node.windows amd64",
"windowsConfiguration": {
"enableAutomaticUpdates": false
},
"nodePlacementConfiguration": {
"policy": "zonal"
}
},
"resizeTimeout": "PT15M",
"targetDedicatedNodes": 3,
"targetLowPriorityNodes": 0,
"taskSlotsPerNode": 2,
"taskSchedulingPolicy": {
"nodeFillType": "spread"
},
"enableAutoScale": false,
"enableInterNodeCommunication": true,
"startTask": {
"commandLine": "myprogram2.exe",
"resourceFiles": [
{
"httpUrl": "http://mystorage1.blob.core.windows.net/scripts/myprogram2.exe?sas",
"filePath": "myprogram2.exe"
}
],
"environmentSettings": [
{
"name": "myvariable",
"value": "myvalue"
}
],
"userIdentity": {
"autoUser": {
"scope": "task",
"elevationLevel": "admin"
}
},
"maxTaskRetryCount": 2,
"waitForSuccess": true
},
"metadata": [
{
"name": "myproperty",
"value": "myvalue"
}
]
}
}
},
"metadata": [
{
"name": "myproperty",
"value": "myvalue"
}
]
}
Przykładowa odpowiedź
Definicje
| Nazwa | Opis |
|---|---|
|
Authentication |
Ustawienia tokenu uwierzytelniania, którego zadanie może używać do wykonywania operacji usługi Batch. |
|
Automatic |
Parametry konfiguracji używane do przeprowadzania automatycznego uaktualniania systemu operacyjnego. |
|
Auto |
Enumy AutoUserScope |
|
Auto |
Określa opcje dla użytkownika automatycznego, który uruchamia zadanie usługi Azure Batch. |
|
Azure |
Informacje używane do nawiązywania połączenia z kontenerem usługi Azure Storage przy użyciu systemu Blobfuse. |
|
Azure |
Informacje używane do nawiązywania połączenia z udziałem plików platformy Azure. |
|
Batch |
Enumy BatchAccessScope |
|
Batch |
Akcja, jaką usługa Batch powinna wykonać, gdy wszystkie zadania w zadaniu są w stanie ukończonym. |
|
Batch |
Odwołanie do pakietu do wdrożenia w węzłach obliczeniowych. |
|
Batch |
Określa charakterystykę tymczasowej "automatycznej puli". Usługa Batch utworzy tę automatyczną pulę po przesłaniu zadania. |
|
Batch |
Konfiguracja pul z obsługą kontenerów. |
|
Batch |
Określa efemeryczne ustawienia dysku dla dysku systemu operacyjnego używanego przez węzeł obliczeniowy (VM). |
|
Batch |
Odebrano odpowiedź o błędzie z usługi Azure Batch. |
|
Batch |
Element dodatkowych informacji zawartych w odpowiedzi na błąd usługi Azure Batch. |
|
Batch |
Komunikat o błędzie odebrany w odpowiedzi na błąd usługi Azure Batch. |
|
Batch |
Pula nat dla ruchu przychodzącego, która może służyć do adresowania określonych portów w węzłach obliczeniowych w puli usługi Batch zewnętrznie. |
|
Batch |
Ograniczenia wykonywania zadania. |
|
Batch |
Parametry tworzenia zadania usługi Azure Batch. |
|
Batch |
Enums BatchJobDefaultOrder |
|
Batch |
Określa szczegóły zadania Menedżera zadań. Zadanie Menedżera zadań jest uruchamiane automatycznie po utworzeniu zadania. Usługa Batch próbuje zaplanować zadanie Menedżera zadań przed innymi zadaniami w zadaniu. Podczas zmniejszania puli usługa Batch próbuje zachować węzły, w których zadania menedżera zadań są uruchamiane tak długo, jak to możliwe (czyli węzły obliczeniowe z uruchomionymi zadaniami normalnymi są usuwane przed węzłami obliczeniowymi z uruchomionymi zadaniami Menedżera zadań). Gdy zadanie Menedżera zadań kończy się niepowodzeniem i musi zostać uruchomione ponownie, system próbuje zaplanować go o najwyższym priorytetzie. Jeśli nie ma dostępnych bezczynnych węzłów obliczeniowych, system może zakończyć jedną z uruchomionych zadań w puli i zwrócić ją do kolejki, aby umożliwić ponowne uruchomienie zadania Menedżera zadań. Należy pamiętać, że zadanie Menedżera zadań w jednym zadaniu nie ma priorytetu nad zadaniami w innych zadaniach. W przypadku zadań obserwowane są tylko priorytety na poziomie zadania. Jeśli na przykład menedżer zadań w zadaniu o priorytecie 0 musi zostać uruchomiony ponownie, nie spowoduje to przesiedleń zadań o priorytecie 1. Usługa Batch ponowi próbę wykonania zadań po wyzwoleniu operacji odzyskiwania w węźle. Przykłady operacji odzyskiwania obejmują (ale nie tylko) ponowne uruchomienie węzła w złej kondycji lub zniknięcie węzła obliczeniowego z powodu awarii hosta. Ponowne próby z powodu operacji odzyskiwania są niezależne i nie są liczone względem parametru maxTaskRetryCount. Nawet jeśli parametr maxTaskRetryCount wynosi 0, może wystąpić wewnętrzna ponowna próba spowodowana operacją odzyskiwania. W związku z tym wszystkie zadania powinny być idempotentne. Oznacza to, że zadania muszą tolerować przerywanie i ponowne uruchamianie bez powodowania uszkodzenia lub duplikowania danych. Najlepszym rozwiązaniem dla długotrwałych zadań jest użycie jakiejś formy tworzenia punktów kontrolnych. |
|
Batch |
(Ta właściwość nie jest domyślnie dostępna. Skontaktuj się z pomocą techniczną, aby uzyskać więcej informacji) Konfiguracja sieci dla zadania. |
|
Batch |
Zadanie przygotowania zadania do uruchomienia przed wszystkimi zadaniami zadania w dowolnym węźle obliczeniowym. Przygotowanie zadania umożliwia przygotowanie węzła do uruchamiania zadań podrzędnych dla zadania. Działania często wykonywane w ramach przygotowania zadania obejmują: pobieranie typowych plików zasobów używanych przez wszystkie zadania w zadaniu. Zadanie przygotowania zadania może pobrać te wspólne pliki zasobów do lokalizacji udostępnionej w węźle. (AZ_BATCH_NODE_ROOT_DIR\shared) lub uruchomienie usługi lokalnej w węźle, aby wszystkie zadania tego zadania mogły się z nim komunikować. Jeśli zadanie przygotowania zadania zakończy się niepowodzeniem (oznacza to, że wyczerpuje liczbę ponownych prób przed zakończeniem z kodem zakończenia 0), usługa Batch nie uruchomi zadań tego zadania w węźle. Węzeł obliczeniowy pozostaje niekwalifikowany do uruchamiania zadań tego zadania do momentu jego odtworzenia. Węzeł obliczeniowy pozostaje aktywny i może być używany dla innych zadań. Zadanie przygotowania zadania może być uruchamiane wiele razy w tym samym węźle. W związku z tym należy napisać zadanie przygotowania zadania w celu obsługi ponownego wykonania. Jeśli węzeł zostanie uruchomiony ponownie, zadanie przygotowania zadania zostanie uruchomione ponownie w węźle obliczeniowym przed zaplanowanym innym zadaniem zadania, jeśli ponownie uruchomOnNodeRebootAfterSuccess ma wartość true lub jeśli zadanie przygotowania zadania nie zostało wcześniej ukończone. Jeśli węzeł jest odtwarzany ponownie, zadanie przygotowania zadania jest uruchamiane ponownie przed zaplanowanie dowolnego zadania zadania. Usługa Batch ponowi próbę wykonania zadań po wyzwoleniu operacji odzyskiwania w węźle. Przykłady operacji odzyskiwania obejmują (ale nie tylko) ponowne uruchomienie węzła w złej kondycji lub zniknięcie węzła obliczeniowego z powodu awarii hosta. Ponowne próby z powodu operacji odzyskiwania są niezależne i nie są liczone względem parametru maxTaskRetryCount. Nawet jeśli parametr maxTaskRetryCount wynosi 0, może wystąpić wewnętrzna ponowna próba spowodowana operacją odzyskiwania. W związku z tym wszystkie zadania powinny być idempotentne. Oznacza to, że zadania muszą tolerować przerywanie i ponowne uruchamianie bez powodowania uszkodzenia lub duplikowania danych. Najlepszym rozwiązaniem dla długotrwałych zadań jest użycie jakiejś formy tworzenia punktów kontrolnych. |
|
Batch |
Zadanie zwolnienia zadania do uruchomienia po zakończeniu zadania w dowolnym węźle obliczeniowym, w którym zostało uruchomione zadanie. Zadanie zwolnienia zadania jest uruchamiane po zakończeniu zadania z powodu jednego z następujących elementów: Użytkownik wywołuje interfejs API zakończenia zadania lub interfejs API usuwania zadania, gdy zadanie jest nadal aktywne, jest osiągane maksymalne ograniczenie czasu zegara ściany zadania, a zadanie jest nadal aktywne lub zadanie podrzędne zostało ukończone, a zadanie jest skonfigurowane do zakończenia po zakończeniu pracy Menedżera zadań. Zadanie zwolnienia zadania jest uruchamiane w każdym węźle, w którym zadania zostały uruchomione, a zadanie przygotowania zadania zostało uruchomione i ukończone. Jeśli odtwarzasz obraz węzła po uruchomieniu zadania przygotowania zadania, a zadanie kończy się bez dalszych zadań zadania uruchomionego w tym węźle (a tym samym zadanie przygotowania zadania nie zostanie uruchomione ponownie), zadanie zwolnienia zadania nie zostanie uruchomione w tym węźle obliczeniowym. Jeśli węzeł zostanie uruchomiony ponownie, gdy zadanie zwolnienia zadania jest nadal uruchomione, zadanie zwolnienia zadania zostanie uruchomione ponownie po uruchomieniu węzła obliczeniowego. Zadanie nie jest oznaczone jako ukończone, dopóki wszystkie zadania wydania zadania nie zostaną ukończone. Zadanie zwolnienia zadania jest uruchamiane w tle. Nie zajmuje miejsca planowania; oznacza to, że nie jest liczone do limitu taskSlotsPerNode określonego w puli. |
|
Batch |
Usługa Batch nie przypisuje żadnego znaczenia do tych metadanych; służy wyłącznie do używania kodu użytkownika. |
|
Batch |
Enums BatchNodeFillType |
|
Batch |
Odwołanie do tożsamości przypisanej przez użytkownika skojarzonej z pulą usługi Batch, która będzie używana przez węzeł obliczeniowy. |
|
Batch |
W przypadku umieszczania regionalnego węzły w puli zostaną przydzielone w tym samym regionie. W przypadku umieszczania strefowego węzły w puli będą rozmieszczone w różnych strefach z najlepszym równoważeniem nakładu pracy. |
|
Batch |
Enums BatchNodePlacementPolicyType |
|
Batch |
Ustawienia dysku systemu operacyjnego węzła obliczeniowego (VM). |
|
Batch |
Konfiguracja punktu końcowego dla puli. |
|
Batch |
Odwołanie do jednej z tożsamości puli w celu zaszyfrowania dysku. Ta tożsamość będzie używana do uzyskiwania dostępu do magazynu kluczy. |
|
Batch |
Określa sposób przypisania zadania do puli. |
|
Batch |
Enumy BatchPoolLifetimeOption |
|
Batch |
Specyfikacja tworzenia nowej puli. |
|
Batch |
Konfiguracja publicznego adresu IP konfiguracji sieci puli. |
|
Batch |
Usługa Batch ponowi próbę wykonania zadań po wyzwoleniu operacji odzyskiwania w węźle. Przykłady operacji odzyskiwania obejmują (ale nie tylko) ponowne uruchomienie węzła w złej kondycji lub zniknięcie węzła obliczeniowego z powodu awarii hosta. Ponowne próby z powodu operacji odzyskiwania są niezależne i nie są liczone względem parametru maxTaskRetryCount. Nawet jeśli parametr maxTaskRetryCount wynosi 0, może wystąpić wewnętrzna ponowna próba spowodowana operacją odzyskiwania. W związku z tym wszystkie zadania powinny być idempotentne. Oznacza to, że zadania muszą tolerować przerywanie i ponowne uruchamianie bez powodowania uszkodzenia lub duplikowania danych. Najlepszym rozwiązaniem dla długotrwałych zadań jest użycie jakiejś formy tworzenia punktów kontrolnych. W niektórych przypadkach funkcja StartTask może zostać ponownie uruchomiona, mimo że węzeł obliczeniowy nie został ponownie uruchomiony. Należy zachować szczególną ostrożność, aby uniknąć zadań StartTasks, które tworzą proces przerwania lub instalują/uruchamiają usługi z katalogu roboczego StartTask, ponieważ uniemożliwi to usłudze Batch ponowne uruchomienie zadania StartTask. |
|
Batch |
Ograniczenia wykonywania, które mają zastosowanie do zadania. |
|
Batch |
Ustawienia kontenera dla zadania. |
|
Batch |
Enumy TaskFailure |
|
Batch |
Określa sposób dystrybucji zadań w węzłach obliczeniowych. |
|
Batch |
Określa ustawienia zabezpieczeń, takie jak bezpieczny rozruch i maszyna wirtualna vTPM używane podczas tworzenia maszyny wirtualnej. |
|
Batch |
Określa ustawienia profilu zabezpieczeń dla dysku zarządzanego. Uwaga: Można ją ustawić tylko dla poufnych maszyn wirtualnych i jest to wymagane w przypadku korzystania z poufnych maszyn wirtualnych. |
|
Batch |
Odwołanie do obrazu witryny Marketplace usługi Azure Virtual Machines lub obrazu galerii obliczeniowej platformy Azure. Aby uzyskać listę wszystkich odwołań do obrazów witryny Azure Marketplace zweryfikowanych przez usługę Azure Batch, zobacz operację "Lista obsługiwanych obrazów". |
|
Caching |
Enumy CachingType |
|
Cifs |
Informacje używane do nawiązywania połączenia z systemem plików CIFS. |
|
Container |
Wpis ścieżki i trybu instalacji, który chcesz zainstalować w kontenerze zadań. |
|
Container |
Ścieżki, które zostaną zainstalowane w kontenerze zadania kontenera. |
|
Container |
Prywatny rejestr kontenerów. |
|
Container |
Enums ContainerType |
|
Container |
Enums ContainerWorkingDirectory |
|
Data |
Ustawienia, które będą używane przez dyski danych skojarzone z węzłami obliczeniowymi w puli. W przypadku korzystania z dołączonych dysków danych należy zainstalować i sformatować dyski z maszyny wirtualnej, aby ich używać. |
|
Diff |
Określa efemeryczne rozmieszczenie dysku systemu operacyjnego dla wszystkich węzłów obliczeniowych (VM) w puli. Ta właściwość może być używana przez użytkownika w żądaniu, aby wybrać lokalizację, w której powinien znajdować się system operacyjny. np. miejsce na dysku pamięci podręcznej na potrzeby aprowizacji efemerycznego dysku systemu operacyjnego. Aby uzyskać więcej informacji na temat wymagań dotyczących rozmiaru dysku Ephemeral OS, prosimy zapoznać się z wymaganiami dotyczącymi rozmiaru dysku Ephemeral OS dla maszyn wirtualnych z Windows at i https://learn.microsoft.com/azure/virtual-machines/windows/ephemeral-os-disks#size-requirements Linuksa pod https://learn.microsoft.com/azure/virtual-machines/linux/ephemeral-os-disks#size-requirements |
|
Disk |
Odwołanie do klucza zarządzanego przez klienta w celu zaszyfrowania dysku. |
|
Disk |
Konfiguracja szyfrowania dysków zastosowana w węzłach obliczeniowych w puli. Konfiguracja szyfrowania dysków nie jest obsługiwana w puli systemu Linux utworzonej za pomocą obrazu galerii obliczeń platformy Azure. |
|
Disk |
Identyfikator zasobu usługi ARM zestawu szyfrowania dysku. |
|
Disk |
Enumy DiskEncryptionTarget |
|
Dynamic |
Enums DynamicVNetAssignmentScope |
|
Elevation |
Enumy ElevationLevel |
|
Environment |
Zmienna środowiskowa, która ma być ustawiana w procesie zadania. |
|
Host |
Określa określone ustawienia punktu końcowego hosta. |
|
Host |
Enums HostEndpointSettingsModeTypes |
|
Inbound |
Enums InboundEndpointProtocol |
|
Ip |
IPAddressProvisioningType enums |
| IPFamily |
Rodziny adresów IP używane do określania wersji adresów IP dostępnych w puli. |
| IPTag |
Zawiera tag IP skojarzony z publicznym adresem IP. |
|
Linux |
Właściwości używane do tworzenia konta użytkownika w węźle obliczeniowym systemu Linux. |
|
Login |
Enumy LoginMode |
|
Managed |
Parametry dysku zarządzanego. |
|
Mount |
System plików do zainstalowania w każdym węźle. |
|
Network |
Konfiguracja sieci dla puli. |
|
Network |
Reguła sieciowej grupy zabezpieczeń, która ma być stosowana do przychodzącego punktu końcowego. |
|
Network |
Enumy NetworkSecurityGroupRuleAccess |
|
Nfs |
Informacje używane do nawiązywania połączenia z systemem plików NFS. |
|
Output |
Podczas każdego przekazywania plików usługa Batch zapisuje dwa pliki dziennika w węźle obliczeniowym "fileuploadout.txt" i "fileuploaderr.txt". Te pliki dziennika służą do uzyskania dodatkowych informacji na temat konkretnego błędu. |
|
Output |
Określa miejsce docelowe przekazywania plików w kontenerze usługi Azure Blob Storage. |
|
Output |
Miejsce docelowe, do którego ma zostać przekazany plik. |
|
Output |
OutputFileUploadCondition enums |
|
Output |
Opcje operacji przekazywania pliku wyjściowego, w tym w jakich warunkach należy wykonać przekazywanie. |
|
Output |
Para nazwa-wartość nagłówka HTTP |
|
Proxy |
Określa ustawienia proxyAgent podczas tworzenia maszyny wirtualnej. |
|
Resource |
Jeden plik lub wiele plików do pobrania do węzła obliczeniowego. |
|
Rolling |
Parametry konfiguracji używane podczas uaktualniania stopniowego. |
|
Security |
Enumy SecurityEncryptionTypes |
|
Security |
Określa ustawienia profilu zabezpieczeń dla maszyny wirtualnej lub zestawu skalowania maszyn wirtualnych. |
|
Security |
Określa typ zabezpieczeń maszyny wirtualnej. Musi być ustawiona na dowolną określoną wartość, aby włączyć interfejs UefiSettings. |
|
Service |
Określa identyfikator odwołania artefaktu usługi używany do ustawiania tej samej wersji obrazu dla wszystkich maszyn wirtualnych w zestawie skalowania w przypadku używania "najnowszej" wersji obrazu. |
|
Storage |
Wyliczenia StorageAccountType |
|
Upgrade |
Enumy UpgradeMode |
|
Upgrade |
Opisuje zasady uaktualniania — automatyczne, ręczne lub stopniowe. |
|
User |
Właściwości używane do tworzenia użytkownika używanego do wykonywania zadań w węźle obliczeniowym usługi Azure Batch. |
|
User |
Definicja tożsamości użytkownika, w ramach której jest uruchamiane zadanie. Określ właściwość userName lub autoUser, ale nie obie. |
|
Virtual |
Konfiguracja węzłów obliczeniowych w puli oparta na infrastrukturze usługi Azure Virtual Machines. |
| VMExtension |
Konfiguracja rozszerzeń maszyn wirtualnych. |
|
Windows |
Ustawienia systemu operacyjnego Windows, które mają być stosowane do maszyny wirtualnej. |
|
Windows |
Właściwości używane do tworzenia konta użytkownika w węźle obliczeniowym systemu Windows. |
AuthenticationTokenSettings
Ustawienia tokenu uwierzytelniania, którego zadanie może używać do wykonywania operacji usługi Batch.
| Nazwa | Typ | Opis |
|---|---|---|
| access |
Zasoby wsadowe, do których token daje dostęp. Token uwierzytelniania przyznaje dostęp do ograniczonego zestawu operacji usług wsadowych. Obecnie jedyną obsługiwaną wartością właściwości dostępu jest "job", która daje dostęp do wszystkich operacji związanych z Jobem zawierającym Zadanie. |
AutomaticOsUpgradePolicy
Parametry konfiguracji używane do przeprowadzania automatycznego uaktualniania systemu operacyjnego.
| Nazwa | Typ | Opis |
|---|---|---|
| disableAutomaticRollback |
boolean |
Czy funkcja wycofywania obrazów systemu operacyjnego powinna być wyłączona. |
| enableAutomaticOSUpgrade |
boolean |
Wskazuje, czy uaktualnienia systemu operacyjnego powinny być automatycznie stosowane do wystąpień zestawu skalowania w sposób kroczący, gdy nowsza wersja obrazu systemu operacyjnego stanie się dostępna. |
| osRollingUpgradeDeferral |
boolean |
Odroczenie uaktualnień systemu operacyjnego na maszynach TVM, jeśli są uruchomione zadania. |
| useRollingUpgradePolicy |
boolean |
Wskazuje, czy zasady uaktualniania stopniowego powinny być używane podczas automatycznego uaktualniania systemu operacyjnego. Automatyczne uaktualnianie systemu operacyjnego spowoduje powrót do domyślnych zasad, jeśli żadne zasady nie są zdefiniowane w zestawie skalowania maszyn wirtualnych. |
AutoUserScope
Enumy AutoUserScope
| Wartość | Opis |
|---|---|
| task |
Określa, że usługa powinna utworzyć nowego użytkownika do zadania. |
| pool |
Określa, że zadanie jest wykonywane jako wspólne automatyczne konto użytkownika, które jest tworzone na każdym węźle obliczeniowym w puli. |
AutoUserSpecification
Określa opcje dla użytkownika automatycznego, który uruchamia zadanie usługi Azure Batch.
| Nazwa | Typ | Opis |
|---|---|---|
| elevationLevel |
Poziom podniesienia uprawnień użytkownika automatycznego. Wartość domyślna to nonAdmin. |
|
| scope |
Zakres użytkownika automatycznego. Wartość domyślna to pula. Jeśli pula jest uruchomiona w systemie Windows, należy określić wartość Zadanie, jeśli wymagana jest ściślejsza izolacja między zadaniami. Na przykład, jeśli zadanie mutuje rejestr w sposób, który może mieć wpływ na inne zadania. |
AzureBlobFileSystemConfiguration
Informacje używane do nawiązywania połączenia z kontenerem usługi Azure Storage przy użyciu systemu Blobfuse.
| Nazwa | Typ | Opis |
|---|---|---|
| accountKey |
string (password) |
Klucz konta usługi Azure Storage. Ta właściwość wzajemnie się wyklucza zarówno z kluczem sasKey, jak i tożsamością; należy określić dokładnie jeden. |
| accountName |
string |
Nazwa konta usługi Azure Storage. |
| blobfuseOptions |
string |
Dodatkowe opcje wiersza polecenia umożliwiające przekazanie polecenia instalacji. Są to opcje "net use" w systemach Windows i "instalowanie" w systemie Linux. |
| containerName |
string |
Nazwa kontenera usługi Azure Blob Storage. |
| identityReference |
Odniesienie do przypisanej przez użytkownika tożsamości do użycia do uzyskania containerName. Ta właściwość wzajemnie wyklucza się zarówno z kluczem accountKey, jak i sasKey; należy określić dokładnie jeden. |
|
| relativeMountPath |
string |
Ścieżka względna na węźle obliczeniowym, na którym system plików będzie montowany. Wszystkie systemy plików są instalowane względem katalogu instalacji usługi Batch, dostępnego za pośrednictwem zmiennej środowiskowej AZ_BATCH_NODE_MOUNTS_DIR. |
| sasKey |
string (password) |
Token SAS usługi Azure Storage. Ta właściwość wzajemnie wyklucza się zarówno z kluczem konta, jak i tożsamością; należy określić dokładnie jeden. |
AzureFileShareConfiguration
Informacje używane do nawiązywania połączenia z udziałem plików platformy Azure.
| Nazwa | Typ | Opis |
|---|---|---|
| accountKey |
string (password) |
Klucz konta usługi Azure Storage. |
| accountName |
string |
Nazwa konta usługi Azure Storage. |
| azureFileUrl |
string (uri) |
Adres URL usługi Azure Files. Jest to formularz "https://{account}.file.core.windows.net/". |
| mountOptions |
string |
Dodatkowe opcje wiersza polecenia umożliwiające przekazanie polecenia instalacji. Są to opcje "net use" w systemach Windows i "instalowanie" w systemie Linux. |
| relativeMountPath |
string |
Ścieżka względna na węźle obliczeniowym, na którym system plików będzie montowany. Wszystkie systemy plików są instalowane względem katalogu instalacji usługi Batch, dostępnego za pośrednictwem zmiennej środowiskowej AZ_BATCH_NODE_MOUNTS_DIR. |
BatchAccessScope
Enumy BatchAccessScope
| Wartość | Opis |
|---|---|
| job |
Daje dostęp do wykonywania wszystkich operacji nad zadaniem zawierającym zadanie. |
BatchAllTasksCompleteMode
Akcja, jaką usługa Batch powinna wykonać, gdy wszystkie zadania w zadaniu są w stanie ukończonym.
| Wartość | Opis |
|---|---|
| noaction |
Nie należy nic robić. Stanowisko pozostaje aktywne, chyba że zostanie zwolnione lub unieruchomione w inny sposób. |
| terminatejob |
Zakończ pracę. ZakończenieReason zadania jest ustawiony na 'AllTasksComplete'. |
BatchApplicationPackageReference
Odwołanie do pakietu do wdrożenia w węzłach obliczeniowych.
| Nazwa | Typ | Opis |
|---|---|---|
| applicationId |
string |
ID aplikacji do wdrożenia. Podczas tworzenia puli identyfikator aplikacji pakietu musi być w pełni kwalifikowany (/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Batch/batchAccounts/{accountName}/applications/{applicationName}). |
| version |
string |
Wersja aplikacji do wdrożenia. W przypadku pominięcia zostanie wdrożona domyślna wersja. Jeśli ten wniosek zostanie pominięty w Pool, a domyślna wersja nie zostanie określona dla tej aplikacji, żądanie kończy się niepowodzeniem z kodem błędu InvalidApplicationPackageReferences i kodem statusowym HTTP 409. Jeśli to zostanie pominięte w zadaniu i nie podano domyślnej wersji dla tej aplikacji, zadanie zostaje nieudane z błędem wstępnego przetwarzania. |
BatchAutoPoolSpecification
Określa charakterystykę tymczasowej "automatycznej puli". Usługa Batch utworzy tę automatyczną pulę po przesłaniu zadania.
| Nazwa | Typ | Opis |
|---|---|---|
| autoPoolIdPrefix |
string |
Prefiks dodany do unikalnego identyfikatora przy automatycznym tworzeniu Pool. Usługa Batch przypisuje każdej automatycznej puli unikalny identyfikator przy utworzeniu. Aby rozróżnić pule utworzone do różnych celów, możesz określić ten element, aby dodać prefiks do przypisanego identyfikatora. Prefiks może mieć do 20 znaków. |
| keepAlive |
boolean |
Czy utrzymać auto pool przy życiu po zakończeniu jego okresu użytkowania. Jeśli to nieprawda, usługa Batch usuwa Pool po wygaśnięciu jej żywotności (określonej przez ustawienie poolLifetimeOption); czyli w momencie, gdy Zadanie lub Harmonogram Zadań się kończy. Jeśli to prawda, usługa Batch nie usuwa automatycznie Pool. To od użytkownika należy usunięcie automatycznych pul utworzonych za pomocą tej opcji. |
| pool |
Specyfikacja Pool dla automatycznej Pool. |
|
| poolLifetimeOption |
Minimalny czas życia tworzonych automatycznych Pool oraz sposób, w jaki wiele Zadań w harmonogramie jest przypisywanych do Poolów. |
BatchContainerConfiguration
Konfiguracja pul z obsługą kontenerów.
| Nazwa | Typ | Opis |
|---|---|---|
| containerImageNames |
string[] |
Kolekcja nazw obrazów kontenerów. To jest pełne odniesienie do Image, jak byłoby określone jako "docker pull". Obraz będzie pozyskiwany z domyślnego rejestru Dockera, chyba że jest w pełni kwalifikowany z alternatywnym rejestrem. |
| containerRegistries |
Dodatkowe rejestry prywatne, z których można ściągać kontenery. Jeśli jakiekolwiek obrazy muszą zostać pobrane z prywatnego rejestru, który wymaga poświadczeń, należy je tutaj podać. |
|
| type |
Technologia kontenera do użycia. |
BatchDiffDiskSettings
Określa efemeryczne ustawienia dysku dla dysku systemu operacyjnego używanego przez węzeł obliczeniowy (VM).
| Nazwa | Typ | Opis |
|---|---|---|
| placement |
Określa efemeryczne umieszczanie dysku dla dysku systemu operacyjnego dla wszystkich maszyn wirtualnych w puli. Ta właściwość może być używana przez użytkownika w żądaniu, aby wybrać lokalizację, np. miejsce na dysku pamięci podręcznej na potrzeby aprowizacji dysku efemerycznego systemu operacyjnego. Aby uzyskać więcej informacji na temat wymagań dotyczących rozmiaru dysku systemu operacyjnego efemerycznego, zapoznaj się z wymaganiami dotyczącymi rozmiaru dysku efemerycznego systemu operacyjnego dla maszyn wirtualnych z systemem Windows na https://learn.microsoft.com/azure/virtual-machines/windows/ephemeral-os-disks#size-requirements i maszynach wirtualnych z systemem Linux w https://learn.microsoft.com/azure/virtual-machines/linux/ephemeral-os-disks#size-requirements. |
BatchError
Odebrano odpowiedź o błędzie z usługi Azure Batch.
| Nazwa | Typ | Opis |
|---|---|---|
| code |
string |
Identyfikator błędu. Kody są niezmienne i mają być używane programowo. |
| message |
Komunikat opisujący błąd, który ma być odpowiedni do wyświetlania w interfejsie użytkownika. |
|
| values |
Kolekcja par klucz-wartość zawierająca dodatkowe szczegóły dotyczące błędu. |
BatchErrorDetail
Element dodatkowych informacji zawartych w odpowiedzi na błąd usługi Azure Batch.
| Nazwa | Typ | Opis |
|---|---|---|
| key |
string |
Identyfikator określający znaczenie właściwości Value. |
| value |
string |
Dodatkowe informacje zawarte w odpowiedzi na błąd. |
BatchErrorMessage
Komunikat o błędzie odebrany w odpowiedzi na błąd usługi Azure Batch.
| Nazwa | Typ | Opis |
|---|---|---|
| lang |
string |
Kod językowy komunikatu o błędzie. |
| value |
string |
Tekst wiadomości. |
BatchInboundNatPool
Pula nat dla ruchu przychodzącego, która może służyć do adresowania określonych portów w węzłach obliczeniowych w puli usługi Batch zewnętrznie.
| Nazwa | Typ | Opis |
|---|---|---|
| backendPort |
integer (int32) |
Numer portu w węźle Compute. To musi być unikalne w ramach Batch Pool. Dopuszczalne wartości to od 1 do 65535 z wyjątkiem 29876 i 29877, ponieważ są one zarezerwowane. Jeśli podano jakiekolwiek wartości zarezerwowane, żądanie zakończy się niepowodzeniem z kodem stanu HTTP 400. |
| frontendPortRangeEnd |
integer (int32) |
Ostatni numer portu w zakresie zewnętrznych portów, które będą wykorzystywane do zapewnienia dostępu do backendPortu na poszczególnych węzłach obliczeniowych. Dopuszczalny zakres wartości z zakresu od 1 do 65534 z wyjątkiem portów od 50000 do 55000, które są zarezerwowane przez usługę Batch. Wszystkie zakresy w Puli muszą być odrębne i nie mogą się nakładać. Każda gama musi zawierać co najmniej 40 portów. Jeśli jakiekolwiek wartości zarezerwowane lub nakładające się zostaną dostarczone, żądanie zakończy się niepowodzeniem z kodem stanu HTTP 400. |
| frontendPortRangeStart |
integer (int32) |
Pierwszy numer portu w zakresie zewnętrznych portów, które będą wykorzystywane do zapewnienia dostępu do backendPortu na poszczególnych węzłach obliczeniowych. Dopuszczalny zakres wartości z zakresu od 1 do 65534 z wyjątkiem portów od 50000 do 55000, które są zarezerwowane. Wszystkie zakresy w Puli muszą być odrębne i nie mogą się nakładać. Każda gama musi zawierać co najmniej 40 portów. Jeśli jakiekolwiek wartości zarezerwowane lub nakładające się zostaną dostarczone, żądanie zakończy się niepowodzeniem z kodem stanu HTTP 400. |
| name |
string |
Nazwa punktu końcowego. Nazwa musi być unikalna w ramach Batch Pool, może zawierać litery, cyfry, podkreślenia, kropki i myślniki. Nazwy muszą zaczynać się literą lub cyfrą, muszą kończyć się literą, cyfrą lub podkreśleniami i nie mogą przekraczać 77 znaków. Jeśli podano nieprawidłowe wartości, żądanie zakończy się niepowodzeniem z kodem stanu HTTP 400. |
| networkSecurityGroupRules |
Lista reguł sieciowej grupy zabezpieczeń, które zostaną zastosowane do punktu końcowego. Maksymalna liczba reguł, które można określić na wszystkich końcach puli wsadowej, wynosi 25. Jeśli nie określono żadnych reguł sieciowej grupy zabezpieczeń, zostanie utworzona domyślna reguła zezwalania na dostęp przychodzący do określonego zapleczaPort. Jeśli maksymalna liczba reguł sieciowej grupy zabezpieczeń zostanie przekroczona, żądanie zakończy się niepowodzeniem z kodem stanu HTTP 400. |
|
| protocol |
Protokół punktu końcowego. |
BatchJobConstraints
Ograniczenia wykonywania zadania.
| Nazwa | Typ | Opis |
|---|---|---|
| maxTaskRetryCount |
integer (int32) |
Maksymalna liczba powtórzeń każdego zadania może być powtórzona. Usługa Batch ponawia próbę zadania, jeśli jego kod zakończenia jest inny niżzer. Należy pamiętać, że ta wartość steruje liczbą ponownych prób. Usługa Batch wykona każde zadanie raz, a następnie może powtórzyć do tego limitu. Na przykład, jeśli maksymalna liczba powtórek wynosi 3, Batch próbuje zadanie do 4 razy (raz początkowo i 3 razy). Jeśli maksymalna liczba powtórek wynosi 0, usługa wsadowa nie podejmuje powtórek zadań. Jeśli maksymalna liczba powtórek wynosi -1, usługa Batch wykonuje próby zadań bez ograniczeń. Wartość domyślna to 0 (bez ponownych prób). |
| maxWallClockTime |
string (duration) |
Maksymalny czas, jaki może wykonać Zadanie, mierzony od momentu jego utworzenia. Jeśli zadanie nie zostanie ukończone w wyznaczonym czasie, usługa wsadowa kończy je wraz z wykonywanymi zadaniami. W takim przypadku powodem zakończenia będzie MaxWallClockTimeExpiry. Jeśli ta właściwość nie jest określona, nie ma limitu czasowego na czas trwania zadania. |
BatchJobCreateOptions
Parametry tworzenia zadania usługi Azure Batch.
| Nazwa | Typ | Domyślna wartość | Opis |
|---|---|---|---|
| allowTaskPreemption |
boolean |
Czy zadania podrzędne w tym zadaniu mogą zostać wywłaszczone przez inne zadania o wysokim priorytcie. (Ta właściwość nie jest domyślnie dostępna. Skontaktuj się z pomocą techniczną, aby uzyskać więcej informacji) Jeśli wartość jest ustawiona na True, inne zadania o wysokim priorytecie przesłane do systemu będą miały pierwszeństwo i będą mogły ponownie kolejkować zadania z tego zadania. Możesz zaktualizować parametr allowTaskPreemption zadania po jego utworzeniu przy użyciu interfejsu API zadania aktualizacji. |
|
| commonEnvironmentSettings |
Lista typowych ustawień zmiennych środowiskowych. Te zmienne środowiskowe są ustawiane dla wszystkich zadań w zadaniu (w tym menedżera zadań, przygotowania zadania i zadania zwolnienia zadania). Poszczególne zadania mogą zastąpić ustawienie środowiska określone w tym miejscu, określając tę samą nazwę ustawienia o innej wartości. |
||
| constraints |
Ograniczenia wykonywania zadania. |
||
| displayName |
string |
Nazwa wyświetlana zadania. Nazwa wyświetlana nie musi być unikatowa i może zawierać znaki Unicode o maksymalnej długości 1024. |
|
| id |
string |
Ciąg, który jednoznacznie identyfikuje zadanie w ramach konta. Identyfikator może zawierać dowolną kombinację znaków alfanumerycznych, w tym łączników i podkreśleń, i nie może zawierać więcej niż 64 znaków. Identyfikator jest zachowywany przy użyciu wielkości liter i bez uwzględniania wielkości liter (oznacza to, że w ramach konta mogą nie istnieć dwa identyfikatory, które różnią się tylko wielkością liter). |
|
| jobManagerTask |
Szczegóły zadania Menedżera zadań, które mają zostać uruchomione po uruchomieniu zadania. Jeśli zadanie nie określi zadania Menedżera zadań, użytkownik musi jawnie dodać zadania do zadania. Jeśli zadanie określi zadanie Menedżera zadań, usługa Batch tworzy zadanie Menedżera zadań podczas tworzenia zadania i spróbuje zaplanować zadanie Menedżera zadań przed zaplanowaniem innych zadań w zadaniu. Typowym celem zadania Menedżera zadań jest kontrolowanie i/lub monitorowanie wykonywania zadania, na przykład poprzez podjęcie decyzji o tym, jakie dodatkowe zadania do uruchomienia, określenie, kiedy praca jest ukończona itp. (Jednak zadanie Menedżera zadań nie jest ograniczone do tych działań — jest to w pełni funkcjonalne zadanie w systemie i wykonywanie jakichkolwiek akcji wymaganych dla zadania). Na przykład zadanie Menedżera zadań może pobrać plik określony jako parametr, przeanalizować zawartość tego pliku i przesłać dodatkowe zadania na podstawie tej zawartości. |
||
| jobPreparationTask |
Zadanie przygotowania zadania. Jeśli zadanie ma zadanie przygotowania zadania, usługa Batch uruchomi zadanie przygotowania zadania w węźle przed uruchomieniem dowolnego zadania tego zadania w tym węźle obliczeniowym. |
||
| jobReleaseTask |
Zadanie zwolnienia zadania. Nie można określić zadania zwolnienia zadania bez określania zadania przygotowania zadania. Usługa Batch uruchamia zadanie zwolnienia zadania w węzłach, w których uruchomiono zadanie przygotowania zadania. Głównym celem zadania zwolnienia zadania jest cofnięcie zmian w węzłach obliczeniowych wprowadzonych przez zadanie przygotowania zadania. Przykładowe działania obejmują usuwanie plików lokalnych lub zamykanie usług, które zostały uruchomione w ramach przygotowania zadania. |
||
| maxParallelTasks |
integer (int32) |
-1 |
Maksymalna liczba zadań, które mogą być wykonywane równolegle dla zadania. (Ta właściwość nie jest domyślnie dostępna. Skontaktuj się z pomocą techniczną, aby uzyskać więcej informacji) Wartość maxParallelTasks musi być -1 lub większa niż 0, jeśli zostanie określona. Jeśli nie zostanie określona, wartość domyślna to -1, co oznacza, że nie ma limitu liczby zadań, które można uruchamiać jednocześnie. Wartość maxParallelTasks zadania można zaktualizować po jego utworzeniu przy użyciu interfejsu API zadania aktualizacji. |
| metadata |
Lista par name-value skojarzonych z zadaniem jako metadanymi. Usługa Batch nie przypisuje żadnego znaczenia metadanym; służy wyłącznie do używania kodu użytkownika. |
||
| networkConfiguration |
(Ta właściwość nie jest domyślnie dostępna. Skontaktuj się z pomocą techniczną, aby uzyskać więcej informacji) Konfiguracja sieci dla zadania. |
||
| onAllTasksComplete |
Akcja, jaką usługa Batch powinna wykonać, gdy wszystkie zadania w zadaniu są w stanie ukończonym. Należy pamiętać, że jeśli zadanie nie zawiera zadań, wszystkie zadania są uznawane za ukończone. W związku z tym ta opcja jest najczęściej używana z zadaniem Menedżera zadań; Jeśli chcesz używać automatycznego kończenia zadań bez Menedżera zadań, należy początkowo ustawić wartość onAllTasksComplete na wartość noaction i zaktualizować właściwości zadania, aby ustawić właściwość onAllTasksComplete na zakończenie zadania po zakończeniu dodawania zadań. Wartość domyślna to noaction. |
||
| onTaskFailure |
Akcja, jaką usługa Batch powinna wykonać, gdy dowolne zadanie w zadaniu zakończy się niepowodzeniem. Zadanie jest uznawane za nieudane, jeśli występuje błądInfo. Właściwość failureInfo jest ustawiana, jeśli zadanie kończy się kodem zakończenia innym niż zero po wyczerpaniu liczby ponownych prób lub jeśli wystąpił błąd podczas uruchamiania zadania, na przykład z powodu błędu pobierania pliku zasobu. Wartość domyślna to noaction. |
||
| poolInfo |
Pula, w której usługa Batch uruchamia zadania podrzędne zadania. |
||
| priority |
integer (int32) |
Priorytet zadania. Wartości priorytetu mogą mieścić się w zakresie od -1000 do 1000, a -1000 jest najniższym priorytetem, a 1000 jest najwyższym priorytetem. Wartość domyślna to 0. |
|
| usesTaskDependencies |
boolean |
Czy zadania w zadaniu mogą definiować zależności od siebie. Wartość domyślna to false. |
BatchJobDefaultOrder
Enums BatchJobDefaultOrder
| Wartość | Opis |
|---|---|
| none |
Zadania powinny być planowane równomiernie ze wszystkich zadań o równym priorytecie dla puli. |
| creationtime |
Jeśli zadania mają równy priorytet, zadania z wcześniej utworzonych zadań powinny być zaplanowane jako pierwsze. |
BatchJobManagerTask
Określa szczegóły zadania Menedżera zadań. Zadanie Menedżera zadań jest uruchamiane automatycznie po utworzeniu zadania. Usługa Batch próbuje zaplanować zadanie Menedżera zadań przed innymi zadaniami w zadaniu. Podczas zmniejszania puli usługa Batch próbuje zachować węzły, w których zadania menedżera zadań są uruchamiane tak długo, jak to możliwe (czyli węzły obliczeniowe z uruchomionymi zadaniami normalnymi są usuwane przed węzłami obliczeniowymi z uruchomionymi zadaniami Menedżera zadań). Gdy zadanie Menedżera zadań kończy się niepowodzeniem i musi zostać uruchomione ponownie, system próbuje zaplanować go o najwyższym priorytetzie. Jeśli nie ma dostępnych bezczynnych węzłów obliczeniowych, system może zakończyć jedną z uruchomionych zadań w puli i zwrócić ją do kolejki, aby umożliwić ponowne uruchomienie zadania Menedżera zadań. Należy pamiętać, że zadanie Menedżera zadań w jednym zadaniu nie ma priorytetu nad zadaniami w innych zadaniach. W przypadku zadań obserwowane są tylko priorytety na poziomie zadania. Jeśli na przykład menedżer zadań w zadaniu o priorytecie 0 musi zostać uruchomiony ponownie, nie spowoduje to przesiedleń zadań o priorytecie 1. Usługa Batch ponowi próbę wykonania zadań po wyzwoleniu operacji odzyskiwania w węźle. Przykłady operacji odzyskiwania obejmują (ale nie tylko) ponowne uruchomienie węzła w złej kondycji lub zniknięcie węzła obliczeniowego z powodu awarii hosta. Ponowne próby z powodu operacji odzyskiwania są niezależne i nie są liczone względem parametru maxTaskRetryCount. Nawet jeśli parametr maxTaskRetryCount wynosi 0, może wystąpić wewnętrzna ponowna próba spowodowana operacją odzyskiwania. W związku z tym wszystkie zadania powinny być idempotentne. Oznacza to, że zadania muszą tolerować przerywanie i ponowne uruchamianie bez powodowania uszkodzenia lub duplikowania danych. Najlepszym rozwiązaniem dla długotrwałych zadań jest użycie jakiejś formy tworzenia punktów kontrolnych.
| Nazwa | Typ | Opis |
|---|---|---|
| allowLowPriorityNode |
boolean |
Czy zadanie Job Manager może działać na węźle Spot/Low-Priority Compute. Wartość domyślna to true. |
| applicationPackageReferences |
Lista pakietów aplikacji, które usługa wsadowa wdroży do węzła obliczeniowego przed uruchomieniem linii poleceń. Pakiety aplikacji są pobierane i wdrażane w katalogu współdzielonym, a nie w katalogu roboczym Task. Dlatego jeśli odwołany pakiet aplikacji jest już na węźle Compute i jest aktualny, nie jest ponownie pobierany; używana jest istniejąca kopia na węźle obliczeniowym. Jeśli odwołany pakiet aplikacji nie może zostać zainstalowany, na przykład dlatego, że pakiet został usunięty lub pobranie się nie powiodło, zadanie nie może zostać załatwione. |
|
| authenticationTokenSettings |
Ustawienia tokenu uwierzytelniania, którego zadanie może używać do wykonywania operacji usługi Batch. Jeśli ta właściwość jest ustawiona, usługa wsadowa zapewnia zadaniu token uwierzytelniający, który może być używany do uwierzytelniania operacji usługi wsadowej bez konieczności posiadania klucza dostępu do konta. Token jest dostarczany za pośrednictwem zmiennej środowiskowej AZ_BATCH_AUTHENTICATION_TOKEN. Operacje, które zadanie może wykonać za pomocą tokena, zależą od ustawień. Na przykład zadanie może żądać uprawnień do zadania, aby dodać inne zadania do zadania lub sprawdzić status zadania lub innych zadań pod zadaniem. |
|
| commandLine |
string |
Linia poleceń zadania Menedżera Zadań. Wiersz polecenia nie jest uruchamiany w powłoce i dlatego nie może korzystać z funkcji powłoki, takich jak rozszerzenie zmiennej środowiskowej. Jeśli chcesz skorzystać z takich funkcji, należy wywołać powłokę w wierszu polecenia, na przykład za pomocą polecenia "cmd /c MyCommand" w systemie Windows lub "/bin/sh -c MyCommand" w systemie Linux. Jeśli wiersz polecenia odwołuje się do ścieżek plików, powinien użyć ścieżki względnej (względem katalogu roboczego zadania) lub użyć zmiennej środowiskowej udostępnionej w usłudze Batch (https://learn.microsoft.com/azure/batch/batch-compute-node-environment-variables). |
| constraints |
Ograniczenia dotyczące zadania Menedżera Zadań. |
|
| containerSettings |
Ustawienia kontenera, pod którym działa Task Manager Task Manager. Jeśli pula uruchamiająca to zadanie ma ustawioną containerConfiguration, to również musi być ustawiona. Jeśli pula, która wykona to zadanie, nie ma ustawionej containerConfiguration, nie może być ustawiona. Gdy to zostanie określone, wszystkie katalogi rekurencyjnie poniżej AZ_BATCH_NODE_ROOT_DIR (korzenia katalogów Azure Batch na węźle) są mapowane do kontenera, wszystkie zmienne środowiskowe Task są mapowane do kontenera, a wiersz poleceń Task jest wykonywany w kontenerze. Pliki wytworzone w kontenerze poza AZ_BATCH_NODE_ROOT_DIR mogą nie być odzwierciedlone na dysku hosta, co oznacza, że API plików wsadowych nie będą miały dostępu do tych plików. |
|
| displayName |
string |
Nazwa wyświetlana zadania Menedżera Zadań. Nie musi być unikalny i może zawierać dowolne znaki Unicode do maksymalnej długości 1024. |
| environmentSettings |
Lista ustawień zmiennych środowiskowych dla zadania Menedżera Zadań. |
|
| id |
string |
Ciąg znaków, który jednoznacznie identyfikuje zadanie Menedżera Zadań w ramach zadania. ID może zawierać dowolną kombinację znaków alfanumerycznych, w tym łączników i podkreśleń, i nie może zawierać więcej niż 64 znaki. |
| killJobOnCompletion |
boolean |
Czy ukończenie zadania Kierownika Zadań oznacza ukończenie całego Zadania. Jeśli to prawda, po zakończeniu zadania Menedżera Zadań usługa Batch oznacza zadanie jako ukończone. Jeśli w tym czasie nadal działają jakieś zadania (poza Job Release), są one zakończane. Jeśli nieprawda, zakończenie zadania Menedżera Zadań nie wpływa na status Zadania. W takim przypadku powinieneś użyć atrybutu onAllTasksComplete do zakończenia zadania lub poprosić klienta lub użytkownika, by zakończył zadanie wyraźnie. Przykładem jest sytuacja, gdy Menedżer Zadań tworzy zestaw Zadań, ale nie odgrywa dalszej roli w ich wykonaniu. Wartość domyślna to true. Jeśli używasz atrybutów onAllTasksComplete i onTaskFailure do kontrolowania czasu życia Zadania, a Menedżera Zadań używasz tylko do tworzenia Zadań dla zadania (nie do monitorowania postępów), to ważne jest, aby ustawić killJobOnCompletion na false. |
| outputFiles |
Lista plików, które usługa wsadowa zagra z węzła obliczeniowego po uruchomieniu linii poleceń. W przypadku zadań wieloinstancjowych pliki będą przesyłane wyłącznie z węzła obliczeniowego, na którym wykonywane jest główne zadanie. |
|
| requiredSlots |
integer (int32) |
Liczba slotów harmonogramowych wymaganych do wykonania zadania. Wartość domyślna to 1. Zadanie może być zaplanowane do uruchomienia na węźle obliczeniowym tylko wtedy, gdy węzeł ma wystarczająco dużo wolnych slotów do planowania. Dla zadań wieloinstancjowych ta właściwość nie jest obsługiwana i nie może być określana. |
| resourceFiles |
Lista plików, które usługa Batch pobierze do węzła obliczeniowego przed uruchomieniem wiersza polecenia. Pliki wymienione w ramach tego elementu znajdują się w katalogu roboczym zadania. Istnieje maksymalny rozmiar listy plików zasobów. Po przekroczeniu maksymalnego rozmiaru żądanie zakończy się niepowodzeniem, a kod błędu odpowiedzi to RequestEntityTooLarge. W takim przypadku należy zmniejszyć rozmiar kolekcji plików ResourceFiles. Można to osiągnąć przy użyciu plików .zip, pakietów aplikacji lub kontenerów platformy Docker. |
|
| runExclusive |
boolean |
Czy zadanie Job Manager wymaga wyłącznego użycia węzła obliczeniowego, w którym działa. Jeśli to prawda, żadne inne zadania nie będą działać na tym samym węźle tak długo, jak działa menedżer zadań. Jeśli to nieprawda, inne zadania mogą działać jednocześnie z Menedżerem zadań na węźle obliczeniowym. Zadanie Menedżera Zadań normalnie liczy się do limitu współbieżnych zadań węzła obliczeniowego, więc jest to istotne tylko wtedy, gdy węzeł obliczeniowy pozwala na wiele równoczesnych zadań. Wartość domyślna to true. |
| userIdentity |
Tożsamość użytkownika, pod którą działa zadanie Menedżera Zadań. Jeśli zostanie pominięte, Zadanie działa jako użytkownik nieadministracyjny, unikalny dla Zadania. |
BatchJobNetworkConfiguration
(Ta właściwość nie jest domyślnie dostępna. Skontaktuj się z pomocą techniczną, aby uzyskać więcej informacji) Konfiguracja sieci dla zadania.
| Nazwa | Typ | Opis |
|---|---|---|
| skipWithdrawFromVNet |
boolean |
Czy wycofać węzły obliczeniowe z sieci wirtualnej do DNC po zakończeniu lub usunięciu zadania. Jeśli wartość true, węzły pozostaną przyłączone do sieci wirtualnej do kontrolera DNC. Jeśli wartość false, węzły zostaną automatycznie wycofane po zakończeniu zadania. Wartość domyślna to fałsz. |
| subnetId |
string |
Identyfikator zasobu usługi ARM podsieci sieci wirtualnej, do której węzły obliczeniowe uruchomione z zadania zostaną dołączone do czasu trwania zadania. Sieć wirtualna musi znajdować się w tym samym regionie i subskrypcji co konto usługi Azure Batch. Określona podsieć powinna mieć wystarczająco dużo wolnych adresów IP, aby pomieścić liczbę węzłów obliczeniowych, które będą uruchamiać zadania z zadania. Może to być maksymalnie liczba węzłów obliczeniowych w puli. Jednostka usługi "MicrosoftAzureBatch" musi mieć rolę "Klasyczny współautor maszyny wirtualnej" Role-Based kontroli dostępu (RBAC) dla określonej sieci wirtualnej, aby usługa Azure Batch mogła zaplanować zadania w węzłach. Można to sprawdzić, sprawdzając, czy określona sieć wirtualna ma skojarzone sieciowe grupy zabezpieczeń. Jeśli komunikacja z węzłami w określonej podsieci zostanie odrzucona przez sieciową grupę zabezpieczeń, usługa Batch ustawi stan węzłów obliczeniowych na bezużyteczny. Jest to formularz /subscriptions/{subscription}/resourceGroups/{group}/providers/{provider}/virtualNetworks/{network}/subnets/{subnet}. Jeśli określona sieć wirtualna ma skojarzone sieciowe grupy zabezpieczeń, należy włączyć kilka zarezerwowanych portów systemowych dla komunikacji przychodzącej z usługi Azure Batch. W przypadku pul utworzonych przy użyciu konfiguracji maszyny wirtualnej włącz porty 29876 i 29877, a także port 22 dla systemu Linux i port 3389 dla systemu Windows. Port 443 jest również wymagany do otwarcia dla połączeń wychodzących na potrzeby komunikacji z usługą Azure Storage. Aby uzyskać więcej informacji, zobacz: https://learn.microsoft.com/azure/batch/batch-api-basics#virtual-network-vnet-and-firewall-configuration. |
BatchJobPreparationTask
Zadanie przygotowania zadania do uruchomienia przed wszystkimi zadaniami zadania w dowolnym węźle obliczeniowym. Przygotowanie zadania umożliwia przygotowanie węzła do uruchamiania zadań podrzędnych dla zadania. Działania często wykonywane w ramach przygotowania zadania obejmują: pobieranie typowych plików zasobów używanych przez wszystkie zadania w zadaniu. Zadanie przygotowania zadania może pobrać te wspólne pliki zasobów do lokalizacji udostępnionej w węźle. (AZ_BATCH_NODE_ROOT_DIR\shared) lub uruchomienie usługi lokalnej w węźle, aby wszystkie zadania tego zadania mogły się z nim komunikować. Jeśli zadanie przygotowania zadania zakończy się niepowodzeniem (oznacza to, że wyczerpuje liczbę ponownych prób przed zakończeniem z kodem zakończenia 0), usługa Batch nie uruchomi zadań tego zadania w węźle. Węzeł obliczeniowy pozostaje niekwalifikowany do uruchamiania zadań tego zadania do momentu jego odtworzenia. Węzeł obliczeniowy pozostaje aktywny i może być używany dla innych zadań. Zadanie przygotowania zadania może być uruchamiane wiele razy w tym samym węźle. W związku z tym należy napisać zadanie przygotowania zadania w celu obsługi ponownego wykonania. Jeśli węzeł zostanie uruchomiony ponownie, zadanie przygotowania zadania zostanie uruchomione ponownie w węźle obliczeniowym przed zaplanowanym innym zadaniem zadania, jeśli ponownie uruchomOnNodeRebootAfterSuccess ma wartość true lub jeśli zadanie przygotowania zadania nie zostało wcześniej ukończone. Jeśli węzeł jest odtwarzany ponownie, zadanie przygotowania zadania jest uruchamiane ponownie przed zaplanowanie dowolnego zadania zadania. Usługa Batch ponowi próbę wykonania zadań po wyzwoleniu operacji odzyskiwania w węźle. Przykłady operacji odzyskiwania obejmują (ale nie tylko) ponowne uruchomienie węzła w złej kondycji lub zniknięcie węzła obliczeniowego z powodu awarii hosta. Ponowne próby z powodu operacji odzyskiwania są niezależne i nie są liczone względem parametru maxTaskRetryCount. Nawet jeśli parametr maxTaskRetryCount wynosi 0, może wystąpić wewnętrzna ponowna próba spowodowana operacją odzyskiwania. W związku z tym wszystkie zadania powinny być idempotentne. Oznacza to, że zadania muszą tolerować przerywanie i ponowne uruchamianie bez powodowania uszkodzenia lub duplikowania danych. Najlepszym rozwiązaniem dla długotrwałych zadań jest użycie jakiejś formy tworzenia punktów kontrolnych.
| Nazwa | Typ | Opis |
|---|---|---|
| commandLine |
string |
Linia poleceń zadania Przygotowania do Pracy. Wiersz polecenia nie jest uruchamiany w powłoce i dlatego nie może korzystać z funkcji powłoki, takich jak rozszerzenie zmiennej środowiskowej. Jeśli chcesz skorzystać z takich funkcji, należy wywołać powłokę w wierszu polecenia, na przykład za pomocą polecenia "cmd /c MyCommand" w systemie Windows lub "/bin/sh -c MyCommand" w systemie Linux. Jeśli wiersz polecenia odwołuje się do ścieżek plików, powinien użyć ścieżki względnej (względem katalogu roboczego zadania) lub użyć zmiennej środowiskowej udostępnionej w usłudze Batch (https://learn.microsoft.com/azure/batch/batch-compute-node-environment-variables). |
| constraints |
Ograniczenia dotyczące zadania Przygotowania do Pracy. |
|
| containerSettings |
Ustawienia kontenera, pod którym uruchamia się zadanie Przygotowania Zadania. Gdy to zostanie określone, wszystkie katalogi rekurencyjnie poniżej AZ_BATCH_NODE_ROOT_DIR (korzenia katalogów Azure Batch na węźle) są mapowane do kontenera, wszystkie zmienne środowiskowe Task są mapowane do kontenera, a wiersz poleceń Task jest wykonywany w kontenerze. Pliki wytworzone w kontenerze poza AZ_BATCH_NODE_ROOT_DIR mogą nie być odzwierciedlone na dysku hosta, co oznacza, że API plików wsadowych nie będą miały dostępu do tych plików. |
|
| environmentSettings |
Lista ustawień zmiennych środowiskowych dla zadania Przygotowania do Pracy. |
|
| id |
string |
Ciąg znaków, który jednoznacznie identyfikuje Zadanie Przygotowania Zadania w obrębie Zadania. ID może zawierać dowolną kombinację znaków alfanumerycznych, w tym łączników i podkreśleń, i nie może zawierać więcej niż 64 znaki. Jeśli nie określisz tej właściwości, usługa Batch przypisuje domyślną wartość 'jobpreparation'. Żadne inne Zadanie w Zadaniu nie może mieć takiego samego identyfikatora jak Zadanie Przygotowania Zadania. Jeśli spróbujesz przesłać zadanie o tym samym identyfikatorze, usługa Batch odrzuca żądanie kodem błędu TaskIdSameAsJobPreparationTask; jeśli wywołujesz bezpośrednio REST API, kod statusu HTTP to 409 (Konflikt). |
| rerunOnNodeRebootAfterSuccess |
boolean |
Czy usługa Batch powinna ponownie uruchomić zadanie Przygotowania Zadania po ponownym uruchomieniu węzła obliczeniowego. Zadanie Przygotowania Zadania jest zawsze uruchamiane ponownie, jeśli węzeł obliczeniowy zostanie ponownie nainstalowany lub jeśli Zadanie Przygotowania Zadania nie zostało ukończone (np. gdy restart nastąpił podczas działania zadania). Dlatego zawsze powinieneś pisać zadanie przygotowania do pracy, aby było idempotentne i zachowywało się poprawnie, jeśli jest wykonywane wielokrotnie. Wartość domyślna to true. |
| resourceFiles |
Lista plików, które usługa Batch pobierze do węzła obliczeniowego przed uruchomieniem wiersza polecenia. Pliki wymienione w ramach tego elementu znajdują się w katalogu roboczym zadania. Istnieje maksymalny rozmiar listy plików zasobów. Po przekroczeniu maksymalnego rozmiaru żądanie zakończy się niepowodzeniem, a kod błędu odpowiedzi to RequestEntityTooLarge. W takim przypadku należy zmniejszyć rozmiar kolekcji plików ResourceFiles. Można to osiągnąć przy użyciu plików .zip, pakietów aplikacji lub kontenerów platformy Docker. |
|
| userIdentity |
Tożsamość użytkownika, pod którą uruchamiane jest zadanie Przygotowania Pracy. Jeśli zostanie pominięte, Zadanie działa jako użytkownik nieadministracyjny unikalny dla Zadania na węzłach obliczeniowych Windows lub jako użytkownik nieadministracyjny unikalny dla Puli na Linuxowych Węzłach Obliczeniowych. |
|
| waitForSuccess |
boolean |
Czy usługa wsadowa powinna czekać na pomyślne zakończenie zadania przygotowania zadania, zanim zaplanuje inne zadania zadania na węźle obliczeniowym. Zadanie Przygotowania do Zadania zostało pomyślnie zakończone, jeśli zakończyło się kodem wyjścia 0. Jeśli to prawda, a zadanie przygotowania zadania na węźle nie powiodło, usługa wsadowa powtarza zadanie do maksymalnej liczby powtórzeń (zgodnie z elementem ograniczeń). Jeśli zadanie nadal nie zostało pomyślnie ukończone po wszystkich próbach, usługa wsadowa nie zaplanuje zadań zadania tego zadania do węzła. Węzeł pozostaje aktywny i może uruchamiać zadania innych zadań. Jeśli to nieprawda, usługa Batch nie poczeka na zakończenie zadania Przygotowania Zadania. W takim przypadku inne Zadania Zadania mogą rozpocząć się na Węźle Obliczeniowym, podczas gdy Zadanie Przygotowania Zadania nadal trwa; a nawet jeśli zadanie Przygotowania Zadania się nie powiedzie, nowe Zadania będą nadal planowane na węźle obliczeniowym. Wartość domyślna to true. |
BatchJobReleaseTask
Zadanie zwolnienia zadania do uruchomienia po zakończeniu zadania w dowolnym węźle obliczeniowym, w którym zostało uruchomione zadanie. Zadanie zwolnienia zadania jest uruchamiane po zakończeniu zadania z powodu jednego z następujących elementów: Użytkownik wywołuje interfejs API zakończenia zadania lub interfejs API usuwania zadania, gdy zadanie jest nadal aktywne, jest osiągane maksymalne ograniczenie czasu zegara ściany zadania, a zadanie jest nadal aktywne lub zadanie podrzędne zostało ukończone, a zadanie jest skonfigurowane do zakończenia po zakończeniu pracy Menedżera zadań. Zadanie zwolnienia zadania jest uruchamiane w każdym węźle, w którym zadania zostały uruchomione, a zadanie przygotowania zadania zostało uruchomione i ukończone. Jeśli odtwarzasz obraz węzła po uruchomieniu zadania przygotowania zadania, a zadanie kończy się bez dalszych zadań zadania uruchomionego w tym węźle (a tym samym zadanie przygotowania zadania nie zostanie uruchomione ponownie), zadanie zwolnienia zadania nie zostanie uruchomione w tym węźle obliczeniowym. Jeśli węzeł zostanie uruchomiony ponownie, gdy zadanie zwolnienia zadania jest nadal uruchomione, zadanie zwolnienia zadania zostanie uruchomione ponownie po uruchomieniu węzła obliczeniowego. Zadanie nie jest oznaczone jako ukończone, dopóki wszystkie zadania wydania zadania nie zostaną ukończone. Zadanie zwolnienia zadania jest uruchamiane w tle. Nie zajmuje miejsca planowania; oznacza to, że nie jest liczone do limitu taskSlotsPerNode określonego w puli.
| Nazwa | Typ | Opis |
|---|---|---|
| commandLine |
string |
Linia poleceń zadania Job Release. Wiersz polecenia nie jest uruchamiany w powłoce i dlatego nie może korzystać z funkcji powłoki, takich jak rozszerzenie zmiennej środowiskowej. Jeśli chcesz skorzystać z takich funkcji, należy wywołać powłokę w wierszu polecenia, na przykład za pomocą polecenia "cmd /c MyCommand" w systemie Windows lub "/bin/sh -c MyCommand" w systemie Linux. Jeśli wiersz polecenia odwołuje się do ścieżek plików, powinien użyć ścieżki względnej (względem katalogu roboczego zadania) lub użyć zmiennej środowiskowej udostępnionej w usłudze Batch (https://learn.microsoft.com/azure/batch/batch-compute-node-environment-variables). |
| containerSettings |
Ustawienia kontenera, pod którym działa Job Release Task. Gdy to zostanie określone, wszystkie katalogi rekurencyjnie poniżej AZ_BATCH_NODE_ROOT_DIR (korzenia katalogów Azure Batch na węźle) są mapowane do kontenera, wszystkie zmienne środowiskowe Task są mapowane do kontenera, a wiersz poleceń Task jest wykonywany w kontenerze. Pliki wytworzone w kontenerze poza AZ_BATCH_NODE_ROOT_DIR mogą nie być odzwierciedlone na dysku hosta, co oznacza, że API plików wsadowych nie będą miały dostępu do tych plików. |
|
| environmentSettings |
Lista ustawień zmiennych środowiskowych dla zadania Job Release. |
|
| id |
string |
Ciąg znaków, który jednoznacznie identyfikuje Job Release Task w obrębie Jobu. ID może zawierać dowolną kombinację znaków alfanumerycznych, w tym łączników i podkreśleń, i nie może zawierać więcej niż 64 znaki. Jeśli nie określisz tej właściwości, usługa Batch przypisuje domyślną wartość 'jobrelease'. Żadne inne Zadanie w Zadaniu nie może mieć tego samego ID co Zadanie Zwolnienia Zadania. Jeśli spróbujesz przesłać zadanie o tym samym identyfikatorze, usługa Batch odrzuca je kodem błędu TaskIdSameAsJobReleaseTask; jeśli wywołujesz bezpośrednio REST API, kod statusu HTTP to 409 (Konflikt). |
| maxWallClockTime |
string (duration) |
Maksymalny czas, jaki zadanie Job Release może wykonać na danym węźle obliczeniowym, mierzony od momentu rozpoczęcia zadania. Jeśli zadanie nie zostanie ukończone w wyznaczonym czasie, usługa wsadowa je kończy. Wartość domyślna to 15 minut. Nie możesz określać przerwy dłuższej niż 15 minut. Jeśli to zrobisz, usługa Batch odrzuca go z błędem; jeśli wywołujesz bezpośrednio REST API, kod statusu HTTP to 400 (Bad Request). |
| resourceFiles |
Lista plików, które usługa Batch pobierze do węzła obliczeniowego przed uruchomieniem wiersza polecenia. Istnieje maksymalny rozmiar listy plików zasobów. Po przekroczeniu maksymalnego rozmiaru żądanie zakończy się niepowodzeniem, a kod błędu odpowiedzi to RequestEntityTooLarge. W takim przypadku należy zmniejszyć rozmiar kolekcji plików ResourceFiles. Można to osiągnąć przy użyciu plików .zip, pakietów aplikacji lub kontenerów platformy Docker. Pliki wymienione w ramach tego elementu znajdują się w katalogu roboczym zadania. |
|
| retentionTime |
string (duration) |
Minimalny czas na zachowanie katalogu zadań dla zadania Job Release Task na węźle obliczeniowym. Po upływie tego czasu usługa wsadowa może usunąć katalog zadań oraz całą jego zawartość. Domyślnie to 7 dni, czyli katalog zadań będzie przechowywany przez 7 dni, chyba że węzeł obliczeniowy zostanie usunięty lub zadanie usunięte. |
| userIdentity |
Tożsamość użytkownika, pod którą działa Zadanie Zwolnienia Zadania. Jeśli zostanie pominięte, Zadanie działa jako użytkownik nieadministracyjny, unikalny dla Zadania. |
BatchMetadataItem
Usługa Batch nie przypisuje żadnego znaczenia do tych metadanych; służy wyłącznie do używania kodu użytkownika.
| Nazwa | Typ | Opis |
|---|---|---|
| name |
string |
Nazwa elementu metadanych. |
| value |
string |
Wartość elementu metadanych. |
BatchNodeFillType
Enums BatchNodeFillType
| Wartość | Opis |
|---|---|
| spread |
Zadania powinny być przydzielane równomiernie pomiędzy wszystkie węzły obliczeniowe w puli. |
| pack |
Jak najwięcej Zadań (taskSlotsPerNode) powinno być przypisanych do każdego węzła obliczeniowego w puli, zanim jakiekolwiek zadania zostaną przypisane do następnego węzła obliczeniowego w puli. |
BatchNodeIdentityReference
Odwołanie do tożsamości przypisanej przez użytkownika skojarzonej z pulą usługi Batch, która będzie używana przez węzeł obliczeniowy.
| Nazwa | Typ | Opis |
|---|---|---|
| resourceId |
string (arm-id) |
Identyfikator zasobu usługi ARM tożsamości przypisanej przez użytkownika. |
BatchNodePlacementConfiguration
W przypadku umieszczania regionalnego węzły w puli zostaną przydzielone w tym samym regionie. W przypadku umieszczania strefowego węzły w puli będą rozmieszczone w różnych strefach z najlepszym równoważeniem nakładu pracy.
| Nazwa | Typ | Opis |
|---|---|---|
| policy |
Typ zasad umieszczania węzła w pulach usługi Batch. Zasady alokacji używane przez usługę Batch do aprowizowania węzłów. Jeśli nie zostanie określony, usługa Batch użyje zasad regionalnych. |
BatchNodePlacementPolicyType
Enums BatchNodePlacementPolicyType
| Wartość | Opis |
|---|---|
| regional |
Wszystkie węzły w puli zostaną przydzielone w tym samym regionie. |
| zonal |
Węzły w puli będą rozproszone po różnych strefach dostępności z najlepszym balansowaniem wysiłku. |
BatchOsDisk
Ustawienia dysku systemu operacyjnego węzła obliczeniowego (VM).
| Nazwa | Typ | Opis |
|---|---|---|
| caching |
Określa wymagania dotyczące buforowania. Możliwe wartości to: None, ReadOnly, ReadWrite. Wartości domyślne to: Brak w przypadku magazynu w warstwie Standardowa. Funkcja ReadOnly dla usługi Premium Storage. |
|
| diskSizeGB |
integer (int32) |
Początkowy rozmiar dysku w GB podczas tworzenia nowego dysku systemu operacyjnego. |
| ephemeralOSDiskSettings |
Określa efemeryczne ustawienia dysku dla dysku systemu operacyjnego używanego przez węzeł obliczeniowy (VM). |
|
| managedDisk |
Parametry dysku zarządzanego. |
|
| writeAcceleratorEnabled |
boolean |
Określa, czy na dysku należy włączyć lub wyłączyć funkcję writeAccelerator. |
BatchPoolEndpointConfiguration
Konfiguracja punktu końcowego dla puli.
| Nazwa | Typ | Opis |
|---|---|---|
| inboundNATPools |
Lista przychodzących pul NAT, które mogą być używane do adresowania konkretnych portów na pojedynczym węźle obliczeniowym zewnętrznie. Maksymalna liczba przychodzących pul NAT na pulę wsadową wynosi 5. Jeśli maksymalna liczba przychodzących pul NAT zostanie przekroczona, żądanie kończy się niepowodzeniem z kodem statusu HTTP 400. Nie można tego określić, jeśli parametr IPAddressProvisioningType ma wartość NoPublicIPAddresses. |
BatchPoolIdentityReference
Odwołanie do jednej z tożsamości puli w celu zaszyfrowania dysku. Ta tożsamość będzie używana do uzyskiwania dostępu do magazynu kluczy.
| Nazwa | Typ | Opis |
|---|---|---|
| resourceId |
string (arm-id) |
Identyfikator zasobu usługi ARM tożsamości przypisanej przez użytkownika. To odwołanie musi być uwzględnione w tożsamościach puli. |
BatchPoolInfo
Określa sposób przypisania zadania do puli.
| Nazwa | Typ | Opis |
|---|---|---|
| autoPoolSpecification |
Charakterystyka tymczasowej "puli samochodowej". Usługa Batch utworzy tę automatyczną pulę po przesłaniu zadania. Jeśli automatyczne tworzenie Puli nie zawie, usługa Batch przenosi Zadanie do stanu zakończenia, a błąd tworzenia Puli jest ustawiany w właściwości błędu harmonogramowania zadania. Usługa Batch zarządza czasem życia (zarówno tworzenie, jak i, o ile nie jest określone keepAlive, usunięciem) automatycznej puli. Wszelkie działania użytkownika, które wpływają na czas trwania automatycznej puli podczas aktywnego zadania, skutkują nieoczekiwanym zachowaniem. Musisz podać albo identyfikator puli, albo specyfikację automatycznej puli, ale nie oba. |
|
| poolId |
string |
Identyfikator istniejącej puli. Wszystkie zadania tego zadania będą działać na określonej puli. Musisz upewnić się, że Pool, do którego się odnosi ta własność, istnieje. Jeśli pula nie istnieje w momencie, gdy usługa wsadowa próbuje zaplanować zadanie, żadne zadania dla tego zadania nie będą działać, dopóki nie utworzysz puli z tym identyfikatorem. Należy zauważyć, że usługa Batch nie odrzuci żądania Job; po prostu nie wykona zadań, dopóki pula nie istnieje. Musisz podać albo identyfikator puli, albo specyfikację automatycznej puli, ale nie oba. |
BatchPoolLifetimeOption
Enumy BatchPoolLifetimeOption
| Wartość | Opis |
|---|---|
| jobschedule |
Pula istnieje przez cały okres trwania harmonogramu prac. Usługa wsadowa tworzy pulę, gdy tworzy pierwsze zadanie w harmonogramie. Możesz zastosować tę opcję tylko do grafików zadań, a nie do ofert. |
| job |
Pool istnieje przez cały czas trwania pracy, której jest poświęcony. Usługa Batch tworzy Pool, gdy tworzy zadanie. Jeśli opcja "zadanie" zostanie zastosowana do harmonogramu zadań, usługa wsadowa tworzy nową automatyczną pulę dla każdego zadania utworzonego w harmonogramie. |
BatchPoolSpecification
Specyfikacja tworzenia nowej puli.
| Nazwa | Typ | Opis |
|---|---|---|
| applicationPackageReferences |
Lista pakietów do zainstalowania w każdym węźle obliczeniowym w puli. Podczas tworzenia puli identyfikator aplikacji pakietu musi być w pełni kwalifikowany (/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Batch/batchAccounts/{accountName}/applications/{applicationName}). Zmiany odwołań do pakietu mają wpływ na wszystkie nowe węzły łączące pulę, ale nie mają wpływu na węzły obliczeniowe, które znajdują się już w puli, dopóki nie zostaną ponownie uruchomione lub zrewidowane. W danej puli istnieje maksymalnie 10 odwołań do pakietu. |
|
| autoScaleEvaluationInterval |
string (duration) |
Interwał czasu, w którym ma być automatycznie dostosowywany rozmiar puli zgodnie z formułą autoskalowania. Wartość domyślna to 15 minut. Minimalna i maksymalna wartość to odpowiednio 5 minut i 168 godzin. Jeśli określisz wartość mniejszą niż 5 minut lub większą niż 168 godzin, usługa Batch odrzuci żądanie z nieprawidłowym błędem wartości właściwości; Jeśli bezpośrednio wywołujesz interfejs API REST, kod stanu HTTP to 400 (Nieprawidłowe żądanie). |
| autoScaleFormula |
string |
Formuła żądanej liczby węzłów obliczeniowych w puli. Nie można określić tej właściwości, jeśli dla parametru enableAutoScale ustawiono wartość false. Jest to wymagane, jeśli wartość enableAutoScale jest ustawiona na wartość true. Formuła jest sprawdzana pod kątem ważności przed utworzeniem puli. Jeśli formuła jest nieprawidłowa, usługa Batch odrzuca żądanie ze szczegółowymi informacjami o błędzie. |
| displayName |
string |
Nazwa wyświetlana puli. Nazwa wyświetlana nie musi być unikatowa i może zawierać znaki Unicode o maksymalnej długości 1024. |
| enableAutoScale |
boolean |
Określa, czy rozmiar puli powinien być automatycznie dostosowywany w miarę upływu czasu. Jeśli wartość false, należy określić co najmniej jeden z elementów targetDedicatedNodes i targetLowPriorityNodes. Jeśli wartość true, wymagany jest element autoScaleFormula. Rozmiar puli jest automatycznie zmieniany zgodnie z formułą. Wartość domyślna to fałsz. |
| enableInterNodeCommunication |
boolean |
Określa, czy pula zezwala na bezpośrednią komunikację między węzłami obliczeniowymi. Włączenie komunikacji między węzłami ogranicza maksymalny rozmiar puli z powodu ograniczeń wdrażania w węzłach obliczeniowych puli. Może to spowodować, że pula nie osiągnie żądanego rozmiaru. Wartość domyślna to fałsz. |
| metadata |
Lista par name-value skojarzonych z pulą jako metadanych. Usługa Batch nie przypisuje żadnego znaczenia metadanym; służy wyłącznie do używania kodu użytkownika. |
|
| mountConfiguration |
Lista systemów plików do zainstalowania w każdym węźle w puli. Obsługuje to usługi Azure Files, NFS, CIFS/SMB i Blobfuse. |
|
| networkConfiguration |
Konfiguracja sieci dla puli. |
|
| resizeTimeout |
string (duration) |
Limit czasu alokacji węzłów obliczeniowych do puli. Ten limit czasu dotyczy tylko skalowania ręcznego; nie ma żadnego wpływu, gdy parametr enableAutoScale jest ustawiony na wartość true. Wartość domyślna to 15 minut. Minimalna wartość to 5 minut. Jeśli określisz wartość mniejszą niż 5 minut, usługa Batch odrzuci żądanie z błędem; Jeśli bezpośrednio wywołujesz interfejs API REST, kod stanu HTTP to 400 (Nieprawidłowe żądanie). |
| startTask |
Zadanie do uruchomienia w każdym węźle obliczeniowym podczas dołączania do puli. Zadanie jest uruchamiane po dodaniu węzła obliczeniowego do puli lub ponownym uruchomieniu węzła obliczeniowego. |
|
| targetDedicatedNodes |
integer (int32) |
Żądana liczba dedykowanych węzłów obliczeniowych w puli. Nie można określić tej właściwości, jeśli parametr enableAutoScale jest ustawiony na wartość true. Jeśli parametr enableAutoScale ma wartość false, należy ustawić element targetDedicatedNodes, targetLowPriorityNodes lub oba te elementy. |
| targetLowPriorityNodes |
integer (int32) |
Żądana liczba węzłów obliczeniowych typu spot/o niskim priorytcie w puli. Nie można określić tej właściwości, jeśli parametr enableAutoScale jest ustawiony na wartość true. Jeśli parametr enableAutoScale ma wartość false, należy ustawić element targetDedicatedNodes, targetLowPriorityNodes lub oba te elementy. |
| taskSchedulingPolicy |
Sposób dystrybucji zadań między węzłami obliczeniowymi w puli. Jeśli nie zostanie określony, wartość domyślna zostanie rozłożona. |
|
| taskSlotsPerNode |
integer (int32) |
Liczba slotów zadaniowych, których można użyć do uruchamiania współbieżnych zadań na pojedynczym węźle obliczeniowym w puli. Wartość domyślna to 1. Wartość maksymalna jest mniejsza od 4 razy liczbie rdzeni rozmiaru maszyny wirtualnej puli lub 256. |
| upgradePolicy |
Zasady uaktualniania puli. Opisuje zasady uaktualniania — automatyczne, ręczne lub stopniowe. |
|
| userAccounts |
Lista kont użytkowników do utworzenia w każdym węźle obliczeniowym w puli. |
|
| virtualMachineConfiguration |
Konfiguracja maszyny wirtualnej dla puli. Tę właściwość należy określić. |
|
| vmSize |
string |
Rozmiar maszyn wirtualnych w puli. Wszystkie maszyny wirtualne w puli mają ten sam rozmiar. Aby uzyskać informacje o dostępnych rozmiarach maszyn wirtualnych w pulach, zobacz Wybieranie rozmiaru maszyny wirtualnej dla węzłów obliczeniowych w puli Azure Batch (https://learn.microsoft.com/azure/batch/batch-pool-vm-sizes). |
BatchPublicIpAddressConfiguration
Konfiguracja publicznego adresu IP konfiguracji sieci puli.
| Nazwa | Typ | Opis |
|---|---|---|
| ipAddressIds |
string[] (arm-id) |
Lista publicznych adresów IP, których usługa Batch będzie używać podczas aprowizacji węzłów obliczeniowych. Liczba adresów IP określonych tutaj ogranicza maksymalny rozmiar puli — 100 dedykowanych węzłów lub 100 węzłów typu spot/low-priority można przydzielić dla każdego publicznego adresu IP. Na przykład pula wymagając 250 dedykowanych maszyn wirtualnych wymaga co najmniej 3 publicznych adresów IP. Każdy element tej kolekcji ma postać: /subscriptions/{subscription}/resourceGroups/{group}/providers/Microsoft.Network/publicIPAddresses/{ip}. |
| ipFamilies |
IPFamily[] |
Rodziny adresów IP używane do określania wersji adresów IP dostępnych w puli. Rodziny adresów IP służą do określania pul z jednym lub dwoma stosami. W przypadku pojedynczego stosu oczekiwana wartość to IPv4. W przypadku dwóch stosów oczekiwane wartości to IPv4 i IPv6. |
| ipTags |
IPTag[] |
Lista tagów IP skojarzonych z publicznymi adresami IP puli. Tagi IP służą do kategoryzowania i filtrowania publicznych adresów IP na potrzeby rozliczeń i zarządzania. |
| provision |
Typ aprowizacji dla publicznych adresów IP dla puli. Wartość domyślna to BatchManaged. |
BatchStartTask
Usługa Batch ponowi próbę wykonania zadań po wyzwoleniu operacji odzyskiwania w węźle. Przykłady operacji odzyskiwania obejmują (ale nie tylko) ponowne uruchomienie węzła w złej kondycji lub zniknięcie węzła obliczeniowego z powodu awarii hosta. Ponowne próby z powodu operacji odzyskiwania są niezależne i nie są liczone względem parametru maxTaskRetryCount. Nawet jeśli parametr maxTaskRetryCount wynosi 0, może wystąpić wewnętrzna ponowna próba spowodowana operacją odzyskiwania. W związku z tym wszystkie zadania powinny być idempotentne. Oznacza to, że zadania muszą tolerować przerywanie i ponowne uruchamianie bez powodowania uszkodzenia lub duplikowania danych. Najlepszym rozwiązaniem dla długotrwałych zadań jest użycie jakiejś formy tworzenia punktów kontrolnych. W niektórych przypadkach funkcja StartTask może zostać ponownie uruchomiona, mimo że węzeł obliczeniowy nie został ponownie uruchomiony. Należy zachować szczególną ostrożność, aby uniknąć zadań StartTasks, które tworzą proces przerwania lub instalują/uruchamiają usługi z katalogu roboczego StartTask, ponieważ uniemożliwi to usłudze Batch ponowne uruchomienie zadania StartTask.
| Nazwa | Typ | Opis |
|---|---|---|
| commandLine |
string |
Wiersz polecenia starttask. Wiersz polecenia nie jest uruchamiany w powłoce i dlatego nie może korzystać z funkcji powłoki, takich jak rozszerzenie zmiennej środowiskowej. Jeśli chcesz skorzystać z takich funkcji, należy wywołać powłokę w wierszu polecenia, na przykład za pomocą polecenia "cmd /c MyCommand" w systemie Windows lub "/bin/sh -c MyCommand" w systemie Linux. Jeśli wiersz polecenia odwołuje się do ścieżek plików, powinien użyć ścieżki względnej (względem katalogu roboczego zadania) lub użyć zmiennej środowiskowej udostępnionej w usłudze Batch (https://learn.microsoft.com/azure/batch/batch-compute-node-environment-variables). |
| containerSettings |
Ustawienia kontenera, pod którym działa StartTask. Gdy to zostanie określone, wszystkie katalogi rekurencyjnie poniżej AZ_BATCH_NODE_ROOT_DIR (korzenia katalogów Azure Batch na węźle) są mapowane do kontenera, wszystkie zmienne środowiskowe Task są mapowane do kontenera, a wiersz poleceń Task jest wykonywany w kontenerze. Pliki wytworzone w kontenerze poza AZ_BATCH_NODE_ROOT_DIR mogą nie być odzwierciedlone na dysku hosta, co oznacza, że API plików wsadowych nie będą miały dostępu do tych plików. |
|
| environmentSettings |
Lista ustawień zmiennych środowiskowych dla elementu StartTask. |
|
| maxTaskRetryCount |
integer (int32) |
Maksymalna liczba ponownych prób wykonania zadania. Usługa Batch ponawia próbę zadania, jeśli jego kod zakończenia jest inny niżzer. Należy pamiętać, że ta wartość steruje liczbą ponownych prób. Usługa Batch spróbuje raz wykonać zadanie, a następnie może ponowić próbę do tego limitu. Jeśli na przykład maksymalna liczba ponownych prób wynosi 3, usługa Batch próbuje wykonać zadanie do 4 razy (jedna początkowa próba i 3 ponownych prób). Jeśli maksymalna liczba ponownych prób wynosi 0, usługa Batch nie ponowi próby wykonania zadania. Jeśli maksymalna liczba ponownych prób wynosi -1, usługa Batch ponawia próbę zadania bez limitu, jednak nie jest to zalecane w przypadku zadania podrzędnego uruchamiania ani żadnego zadania podrzędnego. Wartość domyślna to 0 (bez ponownych prób). |
| resourceFiles |
Lista plików, które usługa Batch pobierze do węzła obliczeniowego przed uruchomieniem wiersza polecenia. Istnieje maksymalny rozmiar listy plików zasobów. Po przekroczeniu maksymalnego rozmiaru żądanie zakończy się niepowodzeniem, a kod błędu odpowiedzi to RequestEntityTooLarge. W takim przypadku należy zmniejszyć rozmiar kolekcji plików ResourceFiles. Można to osiągnąć przy użyciu plików .zip, pakietów aplikacji lub kontenerów platformy Docker. Pliki wymienione w ramach tego elementu znajdują się w katalogu roboczym zadania. |
|
| userIdentity |
Tożsamość użytkownika, pod którą działa StartTask. Jeśli zostanie pominięte, Zadanie działa jako użytkownik nieadministracyjny, unikalny dla Zadania. |
|
| waitForSuccess |
boolean |
Czy usługa Batch powinna czekać na pomyślne zakończenie zadania StartTask (czyli zakończenie z kodem zakończenia 0) przed zaplanowaniem zadań w węźle obliczeniowym. Jeśli wartość true i parametr StartTask zakończy się niepowodzeniem w węźle, usługa Batch ponawia próbę do maksymalnej liczby ponownych prób (maxTaskRetryCount). Jeśli zadanie nadal nie zostało ukończone pomyślnie po ponownych próbach, usługa Batch oznacza węzeł bezużyteczny i nie będzie planować zadań do niego. Ten warunek można wykryć za pomocą szczegółów stanu węzła obliczeniowego i informacji o błędzie. Jeśli wartość false, usługa Batch nie będzie czekać na ukończenie zadania StartTask. W takim przypadku inne zadania mogą rozpocząć wykonywanie w węźle obliczeniowym, gdy funkcja StartTask jest nadal uruchomiona; a nawet jeśli zadanie StartTask zakończy się niepowodzeniem, nowe zadania będą nadal zaplanowane w węźle obliczeniowym. Wartość domyślna to true. |
BatchTaskConstraints
Ograniczenia wykonywania, które mają zastosowanie do zadania.
| Nazwa | Typ | Opis |
|---|---|---|
| maxTaskRetryCount |
integer (int32) |
Maksymalna liczba ponownych prób wykonania zadania. Usługa Batch ponawia próbę zadania, jeśli jego kod zakończenia jest inny niżzer. Należy zauważyć, że ta wartość konkretnie kontroluje liczbę powtórek dla pliku wykonywalnego zadania z powodu niezerowego kodu wyjścia. Usługa Batch spróbuje raz wykonać zadanie, a następnie może ponowić próbę do tego limitu. Jeśli na przykład maksymalna liczba ponownych prób wynosi 3, usługa Batch próbuje wykonać zadanie do 4 razy (jedna początkowa próba i 3 ponownych prób). Jeśli maksymalna liczba powtórek wynosi 0, usługa wsadowa nie podejmuje próby po pierwszej próbie. Jeśli maksymalna liczba ponownych prób wynosi -1, usługa Batch ponawia próbę zadania bez limitu, jednak nie jest to zalecane w przypadku zadania podrzędnego uruchamiania ani żadnego zadania podrzędnego. Wartość domyślna to 0 (bez ponownych prób). |
| maxWallClockTime |
string (duration) |
Maksymalny czas, jaki może wykonać zadanie, mierzony od momentu jego rozpoczęcia. Jeśli zadanie nie zostanie ukończone w wyznaczonym czasie, usługa wsadowa je kończy. Jeśli nie jest to określone, nie ma limitu czasowego na czas trwania zadania. |
| retentionTime |
string (duration) |
Minimalny czas zachowania katalogu zadań na węźle obliczeniowym, w którym działał, od momentu zakończenia jego działania. Po upływie tego czasu usługa wsadowa może usunąć katalog zadań oraz całą jego zawartość. Domyślnie to 7 dni, czyli katalog zadań będzie przechowywany przez 7 dni, chyba że węzeł obliczeniowy zostanie usunięty lub zadanie usunięte. |
BatchTaskContainerSettings
Ustawienia kontenera dla zadania.
| Nazwa | Typ | Opis |
|---|---|---|
| containerHostBatchBindMounts |
Ścieżki, które chcesz zamontować w zadaniu kontenera. Jeśli ta tablica ma wartość null lub nie istnieje, zadanie kontenera zainstaluje cały dysk tymczasowy w systemie Windows (lub AZ_BATCH_NODE_ROOT_DIR w systemie Linux). Jeśli ta tablica jest ustawiona jako pusta, nie zainstaluje żadnych ścieżek danych w kontenerze. |
|
| containerRunOptions |
string |
Dodatkowe opcje polecenia create kontenera. Te dodatkowe opcje są dostarczane jako argumenty polecenia "docker create" oprócz tych kontrolowanych przez usługę Batch. |
| imageName |
string |
Obraz, którego używa się do stworzenia kontenera, w którym zadanie będzie działać. To jest pełne odniesienie do Image, jak byłoby określone jako "docker pull". Jeśli w nazwie obrazu nie ma tagu, domyślnie używa się tagu ":latest". |
| registry |
Prywatny rejestr, który zawiera obraz kontenera. To ustawienie można pominąć, jeśli było już dostępne podczas tworzenia puli. |
|
| workingDirectory |
Lokalizacja katalogu roboczego kontenera Task. Wartość domyślna to "taskWorkingDirectory". |
BatchTaskFailureMode
Enumy TaskFailure
| Wartość | Opis |
|---|---|
| noaction |
Nie należy nic robić. Stanowisko pozostaje aktywne, chyba że zostanie zwolnione lub unieruchomione w inny sposób. |
| performexitoptionsjobaction |
Zakończ pracę. ZakończenieReason zadania jest ustawiony na 'AllTasksComplete'. |
BatchTaskSchedulingPolicy
Określa sposób dystrybucji zadań w węzłach obliczeniowych.
| Nazwa | Typ | Domyślna wartość | Opis |
|---|---|---|---|
| jobDefaultOrder | none |
Kolejność planowania zadań z różnych zadań o tym samym priorytecie. Jeśli nie zostanie określony, wartość domyślna to none. |
|
| nodeFillType |
Sposób dystrybucji zadań między węzłami obliczeniowymi w puli. Jeśli nie zostanie określony, wartość domyślna zostanie rozłożona. |
BatchUefiSettings
Określa ustawienia zabezpieczeń, takie jak bezpieczny rozruch i maszyna wirtualna vTPM używane podczas tworzenia maszyny wirtualnej.
| Nazwa | Typ | Opis |
|---|---|---|
| secureBootEnabled |
boolean |
Określa, czy bezpieczny rozruch powinien być włączony na maszynie wirtualnej. |
| vTpmEnabled |
boolean |
Określa, czy maszyna wirtualna ma być włączona na maszynie wirtualnej. |
BatchVmDiskSecurityProfile
Określa ustawienia profilu zabezpieczeń dla dysku zarządzanego. Uwaga: Można ją ustawić tylko dla poufnych maszyn wirtualnych i jest to wymagane w przypadku korzystania z poufnych maszyn wirtualnych.
| Nazwa | Typ | Opis |
|---|---|---|
| securityEncryptionType |
Określa typ szyfrowania dysku zarządzanego. Jest ona ustawiona na VMGuestStateOnly na potrzeby szyfrowania tylko obiektu blob VMGuestState i nonPersistedTPM dla nietrwałego stanu oprogramowania układowego w obiekcie blob VMGuestState. Uwaga: Można ją ustawić tylko dla poufnych maszyn wirtualnych i jest wymagana w przypadku korzystania z poufnych maszyn wirtualnych. |
BatchVmImageReference
Odwołanie do obrazu witryny Marketplace usługi Azure Virtual Machines lub obrazu galerii obliczeniowej platformy Azure. Aby uzyskać listę wszystkich odwołań do obrazów witryny Azure Marketplace zweryfikowanych przez usługę Azure Batch, zobacz operację "Lista obsługiwanych obrazów".
| Nazwa | Typ | Opis |
|---|---|---|
| communityGalleryImageId |
string |
Unikalny identyfikator obrazu galerii społecznościowej. Ta właściwość wzajemnie wyklucza się z innymi właściwościami i może być pobierana z wywołania GET obrazu galerii społeczności. |
| exactVersion |
string |
Konkretna wersja obrazu platformy lub marketplace użytego do stworzenia węzła. To pole tylko do odczytu różni się od 'version' tylko wtedy, gdy wartość podany dla 'version' podczas tworzenia puli była 'laprint'. |
| offer |
string |
Typ oferty to Azure Virtual Machines Marketplace Image. Na przykład UbuntuServer lub WindowsServer. |
| publisher |
string |
Wydawca obrazu Azure Virtual Machines Marketplace. Na przykład Canonical lub MicrosoftWindowsServer. |
| sharedGalleryImageId |
string |
Unikalny identyfikator wspólnego zdjęcia galerii. Ta właściwość wzajemnie wyklucza się z innymi właściwościami i może zostać pobrana z wywołania GET obrazu galerii udostępnionej. |
| sku |
string |
SKU obrazu Azure Virtual Machines Marketplace. Na przykład 18.04-LTS lub 2019-Datacenter. |
| version |
string |
Wersja Azure Virtual Machines Marketplace Image. Można określić wartość 'najnowszy', aby wybrać najnowszą wersję obrazu. W przypadku pominięcia wartość domyślna to "latest". |
| virtualMachineImageId |
string (arm-id) |
Identyfikator zasobu usługi ARM obrazu galerii obliczeniowej platformy Azure. Węzły obliczeniowe w puli będą tworzone za pomocą tego ID obrazu. Ma ona formę /subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Compute/galleries/{galleryName}/images/{imageDefinitionName}/versions/{VersionId} lub /subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Compute/galleries/{galleryName}/images/{imageDefinitionName}, gdzie zawsze domyślnie wraca do najnowszej wersji obrazu. Ta własność jest wzajemnie wyłączna z innymi właściwościami ImageReference. Obraz Azure Compute Gallery Gallery musi mieć repliki w tym samym regionie i musi być w tej samej subskrypcji co konto Azure Batch. Jeśli wersja obrazu nie jest określona w imageId, zostanie użyta najnowsza wersja. Aby uzyskać informacje o ustawieniach zapory dla agenta Batch Compute Node, aby komunikował się z usługą https://learn.microsoft.com/azure/batch/nodes-and-pools#virtual-network-vnet-and-firewall-configurationBatch . |
CachingType
Enumy CachingType
| Wartość | Opis |
|---|---|
| none |
Tryb buforowania dysku nie jest włączony. |
| readonly |
Tryb buforowania dysku jest tylko do odczytu. |
| readwrite |
Tryb buforowania dysku jest odczytywany i zapisywany. |
CifsMountConfiguration
Informacje używane do nawiązywania połączenia z systemem plików CIFS.
| Nazwa | Typ | Opis |
|---|---|---|
| mountOptions |
string |
Dodatkowe opcje wiersza polecenia umożliwiające przekazanie polecenia instalacji. Są to opcje "net use" w systemach Windows i "instalowanie" w systemie Linux. |
| password |
string (password) |
Hasło używane do uwierzytelniania w systemie plików CIFS. |
| relativeMountPath |
string |
Ścieżka względna na węźle obliczeniowym, na którym system plików będzie montowany. Wszystkie systemy plików są instalowane względem katalogu instalacji usługi Batch, dostępnego za pośrednictwem zmiennej środowiskowej AZ_BATCH_NODE_MOUNTS_DIR. |
| source |
string |
Identyfikator URI systemu plików do zainstalowania. |
| username |
string |
Użytkownik do użycia do uwierzytelniania w systemie plików CIFS. |
ContainerHostBatchBindMountEntry
Wpis ścieżki i trybu instalacji, który chcesz zainstalować w kontenerze zadań.
| Nazwa | Typ | Opis |
|---|---|---|
| isReadOnly |
boolean |
Zainstaluj tę ścieżkę źródłową jako tryb tylko do odczytu lub nie. Wartość domyślna to false (tryb odczytu/zapisu). W przypadku systemu Linux, jeśli zainstalujesz tę ścieżkę jako tryb odczytu/zapisu, nie oznacza to, że wszyscy użytkownicy w kontenerze mają dostęp do odczytu/zapisu dla ścieżki, zależy to od dostępu na maszynie wirtualnej hosta. Jeśli ta ścieżka jest instalowana tylko do odczytu, wszyscy użytkownicy w kontenerze nie będą mogli modyfikować ścieżki. |
| source |
Można wybrać ścieżkę instalowaną dla klienta kontenera. |
ContainerHostDataPath
Ścieżki, które zostaną zainstalowane w kontenerze zadania kontenera.
| Wartość | Opis |
|---|---|
| Shared |
Ścieżka zadania obejmującego wiele wystąpień w celu udostępnienia plików. |
| Startup |
Ścieżka zadania podrzędnego uruchamiania. |
| VfsMounts |
Ścieżka zawiera wszystkie wirtualne systemy plików są instalowane w tym węźle. |
| Task |
Ścieżka zadania. |
| JobPrep |
Ścieżka zadania przygotowania zadania. |
| Applications |
Ścieżka aplikacji. |
ContainerRegistryReference
Prywatny rejestr kontenerów.
| Nazwa | Typ | Opis |
|---|---|---|
| identityReference |
Odwołanie do tożsamości przypisanej przez użytkownika w celu uzyskania dostępu do usługi Azure Container Registry zamiast nazwy użytkownika i hasła. |
|
| password |
string (password) |
Hasło do logowania się na serwerze rejestru. |
| registryServer |
string (uri) |
Adres URL rejestru. W przypadku pominięcia wartość domyślna to "docker.io". |
| username |
string |
Nazwa użytkownika do logowania się na serwerze rejestru. |
ContainerType
Enums ContainerType
| Wartość | Opis |
|---|---|
| dockerCompatible |
Technologia kontenera zgodna z platformą Docker będzie używana do uruchamiania kontenerów. |
| criCompatible |
Technologia oparta na cri będzie używana do uruchamiania kontenerów. |
ContainerWorkingDirectory
Enums ContainerWorkingDirectory
| Wartość | Opis |
|---|---|
| taskWorkingDirectory |
Użyj standardowego katalogu roboczygo Batch Service Task Task (Task Service Working Folder), który będzie zawierał pliki zasobów zadań wypełnione przez Batch. |
| containerImageDefault |
Użyj katalogu roboczego zdefiniowanego w kontenerze Image. Należy pamiętać, że ten katalog nie będzie zawierał plików zasobów pobranych przez Batch. |
DataDisk
Ustawienia, które będą używane przez dyski danych skojarzone z węzłami obliczeniowymi w puli. W przypadku korzystania z dołączonych dysków danych należy zainstalować i sformatować dyski z maszyny wirtualnej, aby ich używać.
| Nazwa | Typ | Opis |
|---|---|---|
| caching |
Typ buforowania, który ma być włączony dla dysków danych. Wartość domyślna buforowania to readwrite. Aby uzyskać informacje o opcjach buforowania, zobacz: https://blogs.msdn.microsoft.com/windowsazurestorage/2012/06/27/exploring-windows-azure-drives-disks-and-images/. |
|
| diskSizeGB |
integer (int32) |
Początkowy rozmiar dysku w gigabajtach. |
| lun |
integer (int32) |
Numer jednostki logicznej. Element logicalUnitNumber służy do unikatowego identyfikowania każdego dysku danych. W przypadku dołączania wielu dysków każda z nich powinna mieć odrębną wartość logicznąUnitNumber. Wartość musi należeć do przedziału od 0 do 63 włącznie. |
| managedDisk |
Parametry dysku zarządzanego. |
|
| storageAccountType |
Typ konta magazynu, który ma być używany dla dysku danych. W przypadku pominięcia wartość domyślna to "standard_lrs". |
DiffDiskPlacement
Określa efemeryczne rozmieszczenie dysku systemu operacyjnego dla wszystkich węzłów obliczeniowych (VM) w puli. Ta właściwość może być używana przez użytkownika w żądaniu, aby wybrać lokalizację, w której powinien znajdować się system operacyjny. np. miejsce na dysku pamięci podręcznej na potrzeby aprowizacji efemerycznego dysku systemu operacyjnego. Aby uzyskać więcej informacji na temat wymagań dotyczących rozmiaru dysku Ephemeral OS, prosimy zapoznać się z wymaganiami dotyczącymi rozmiaru dysku Ephemeral OS dla maszyn wirtualnych z Windows at i https://learn.microsoft.com/azure/virtual-machines/windows/ephemeral-os-disks#size-requirements Linuksa pod https://learn.microsoft.com/azure/virtual-machines/linux/ephemeral-os-disks#size-requirements
| Wartość | Opis |
|---|---|
| cachedisk |
Efemeryczny dysk systemu operacyjnego jest przechowywany w pamięci podręcznej maszyny wirtualnej. |
DiskCustomerManagedKey
Odwołanie do klucza zarządzanego przez klienta w celu zaszyfrowania dysku.
| Nazwa | Typ | Opis |
|---|---|---|
| identityReference |
Odwołanie do jednej z tożsamości puli w celu zaszyfrowania dysku. Ta tożsamość będzie używana do uzyskiwania dostępu do usługi KeyVault. |
|
| keyUrl |
string |
W pełni wersjonowany adres URL klucza wskazujący klucz w usłudze KeyVault. Segment wersji adresu URL jest wymagany niezależnie od wartości rotationToLatestKeyVersionEnabled. |
| rotationToLatestKeyVersionEnabled |
boolean |
Ustaw tę flagę na true, aby umożliwić automatyczną aktualizację szyfrowania dysku do najnowszej wersji klucza. Wartość domyślna to „false”. |
DiskEncryptionConfiguration
Konfiguracja szyfrowania dysków zastosowana w węzłach obliczeniowych w puli. Konfiguracja szyfrowania dysków nie jest obsługiwana w puli systemu Linux utworzonej za pomocą obrazu galerii obliczeń platformy Azure.
| Nazwa | Typ | Opis |
|---|---|---|
| customerManagedKey |
Odwołanie do klucza zarządzanego przez klienta w celu zaszyfrowania dysku systemu operacyjnego. Klucz zarządzany przez klienta zaszyfruje dysk systemu operacyjnego za pomocą EncryptionAtRest, a domyślnie zaszyfrujemy również dysk danych. Można go używać tylko wtedy, gdy pula jest skonfigurowana przy użyciu tożsamości, a program OsDisk jest ustawiony jako jeden z obiektów docelowych programu DiskEncryption. |
|
| targets |
Lista dysków docelowych obiektów docelowych usługi Batch zostanie zaszyfrowana w węźle obliczeniowym. Lista dysków docelowych obiektów docelowych usługi Batch zostanie zaszyfrowana w węźle obliczeniowym. |
DiskEncryptionSetParameters
Identyfikator zasobu usługi ARM zestawu szyfrowania dysku.
| Nazwa | Typ | Opis |
|---|---|---|
| id |
string (arm-id) |
Identyfikator zasobu usługi ARM zestawu szyfrowania dysku. Zasób musi znajdować się w tej samej subskrypcji co konto usługi Batch. |
DiskEncryptionTarget
Enumy DiskEncryptionTarget
| Wartość | Opis |
|---|---|
| osdisk |
Dysk systemu operacyjnego w węźle obliczeniowym jest szyfrowany. |
| temporarydisk |
Dysk tymczasowy w węźle obliczeniowym jest szyfrowany. W systemie Linux to szyfrowanie ma zastosowanie do innych partycji (takich jak te na zainstalowanych dyskach danych), gdy szyfrowanie odbywa się w czasie rozruchu. |
DynamicVNetAssignmentScope
Enums DynamicVNetAssignmentScope
| Wartość | Opis |
|---|---|
| none |
Nie włączono dynamicznego przypisania sieci wirtualnej. |
| job |
Dynamiczne przypisywanie sieci wirtualnej jest wykonywane na zadanie. |
ElevationLevel
Enumy ElevationLevel
| Wartość | Opis |
|---|---|
| nonadmin |
Użytkownik jest użytkownikiem standardowym bez podwyższonego poziomu dostępu. |
| admin |
Użytkownik jest użytkownikiem z podwyższonym poziomem dostępu i działa z pełnymi uprawnieniami administratora. |
EnvironmentSetting
Zmienna środowiskowa, która ma być ustawiana w procesie zadania.
| Nazwa | Typ | Opis |
|---|---|---|
| name |
string |
Nazwa zmiennej środowiskowej. |
| value |
string |
Wartość zmiennej środowiskowej. |
HostEndpointSettings
Określa określone ustawienia punktu końcowego hosta.
| Nazwa | Typ | Opis |
|---|---|---|
| inVMAccessControlProfileReferenceId |
string |
Określa odwołanie do identyfikatora zasobu InVMAccessControlProfileVersion w postaci /subscriptions/{SubscriptionId}/resourceGroups/{ResourceGroupName}/providers/Microsoft.Compute/galleries/{galleryName}/inVMAccessControlProfiles/{profile}/versions/{version}. |
| mode |
Określa tryb wykonywania zasad kontroli dostępu. |
HostEndpointSettingsModeTypes
Enums HostEndpointSettingsModeTypes
| Wartość | Opis |
|---|---|
| Audit |
W trybie inspekcji system działa tak, jakby wymuszał zasady kontroli dostępu, w tym emitowanie wpisów odmowy dostępu w dziennikach, ale w rzeczywistości nie odmawia żadnych żądań do hostowania punktów końcowych. |
| Enforce |
Tryb wymuszania jest zalecanym trybem działania, a system będzie egzekwował politykę kontroli dostępu. Ta właściwość nie może być używana razem z 'inVMAccessControlProfileReferenceId'. |
InboundEndpointProtocol
Enums InboundEndpointProtocol
| Wartość | Opis |
|---|---|
| tcp |
Użyj protokołu TCP dla punktu końcowego. |
| udp |
Użyj protokołu UDP dla punktu końcowego. |
IpAddressProvisioningType
IPAddressProvisioningType enums
| Wartość | Opis |
|---|---|
| batchmanaged |
Publiczny adres IP zostanie utworzony i zarządzany przez usługę Batch. W zależności od rozmiaru puli może istnieć wiele publicznych adresów IP. |
| usermanaged |
Publiczne adresy IP są udostępniane przez użytkownika i będą używane do aprowizowania węzłów obliczeniowych. |
| nopublicipaddresses |
Nie zostanie utworzony żaden publiczny adres IP. |
IPFamily
Rodziny adresów IP używane do określania wersji adresów IP dostępnych w puli.
| Wartość | Opis |
|---|---|
| IPv4 |
IPv4 jest dostępne w tej grupie. |
| IPv6 |
IPv6 jest dostępny w tej grupie. |
IPTag
Zawiera tag IP skojarzony z publicznym adresem IP.
| Nazwa | Typ | Opis |
|---|---|---|
| ipTagType |
string |
Typ tagu adresu IP. Przykład: FirstPartyUsage. |
| tag |
string |
Wartość tagu IP skojarzonego z publicznym adresem IP. Przykład: SQL. |
LinuxUserConfiguration
Właściwości używane do tworzenia konta użytkownika w węźle obliczeniowym systemu Linux.
| Nazwa | Typ | Opis |
|---|---|---|
| gid |
integer (int32) |
Identyfikator grupy dla konta użytkownika. Właściwości uid i gid muszą być określone razem lub w ogóle. Jeśli nie określono bazowego systemu operacyjnego, wybiera gid. |
| sshPrivateKey |
string (password) |
Prywatny klucz SSH do konta użytkownika. Klucz prywatny nie może być chroniony hasłem. Klucz prywatny służy do automatycznej konfiguracji uwierzytelniania SSH opartego na kluczu asymetrycznym pomiędzy węzłami obliczeniowymi w puli Linuksa, gdy właściwość puli enableInterNodeCommunication jest prawdziwa (jest ignorowana, jeśli enableInterNodeCommunication jest fałszywa). Robi to przez umieszczenie pary kluczy w katalogu .ssh użytkownika. Jeśli nie jest to określone, SSH bez hasła nie jest konfigurowane pomiędzy węzłami obliczeniowymi (nie ma żadnych modyfikacji katalogu .ssh użytkownika). |
| uid |
integer (int32) |
ID użytkownika konta użytkownika. Właściwości uid i gid muszą być określone razem lub w ogóle. Jeśli nie określono bazowego systemu operacyjnego, wybierze identyfikator uid. |
LoginMode
Enumy LoginMode
| Wartość | Opis |
|---|---|
| batch |
Tryb logowania LOGON32_LOGON_BATCH Win32. Tryb logowania wsadowego jest zalecany w przypadku długotrwałych procesów równoległych. |
| interactive |
Tryb logowania LOGON32_LOGON_INTERACTIVE Win32. UAC jest włączone w Windows VirtualMachineConfiguration Pools. Jeśli ta opcja jest używana z podwyższoną tożsamością użytkownika w WirtualMachineConfiguration Pool Windows, sesja użytkownika nie zostanie podniesiona, chyba że aplikacja wykonywana przez wiersz poleceń Zadania jest skonfigurowana tak, aby zawsze wymagała uprawnień administratorskich lub maksymalnie wymagała. |
ManagedDisk
Parametry dysku zarządzanego.
| Nazwa | Typ | Opis |
|---|---|---|
| diskEncryptionSet |
Określa identyfikator zasobu zestawu zasobów zestawu szyfrowania dysków zarządzanych przez klienta dla dysku zarządzanego. Można go ustawić tylko w trybie UserSubscription. |
|
| securityProfile |
Określa ustawienia profilu zabezpieczeń dla dysku zarządzanego. |
|
| storageAccountType |
Typ konta magazynu dla dysku zarządzanego. |
MountConfiguration
System plików do zainstalowania w każdym węźle.
| Nazwa | Typ | Opis |
|---|---|---|
| azureBlobFileSystemConfiguration |
Kontener usługi Azure Storage do zainstalowania przy użyciu funkcji FUSE obiektu blob w każdym węźle. Ta właściwość wzajemnie wyklucza się ze wszystkimi innymi właściwościami. |
|
| azureFileShareConfiguration |
Udział plików platformy Azure do zainstalowania w każdym węźle. Ta właściwość wzajemnie wyklucza się ze wszystkimi innymi właściwościami. |
|
| cifsMountConfiguration |
System plików CIFS/SMB do zainstalowania w każdym węźle. Ta właściwość wzajemnie wyklucza się ze wszystkimi innymi właściwościami. |
|
| nfsMountConfiguration |
System plików NFS do zainstalowania w każdym węźle. Ta właściwość wzajemnie wyklucza się ze wszystkimi innymi właściwościami. |
NetworkConfiguration
Konfiguracja sieci dla puli.
| Nazwa | Typ | Opis |
|---|---|---|
| dynamicVNetAssignmentScope |
Zakres dynamicznego przypisania sieci wirtualnej. |
|
| enableAcceleratedNetworking |
boolean |
Czy ta pula powinna włączyć przyspieszoną sieć. Przyspieszona sieć umożliwia wirtualizację we/wy pojedynczego katalogu głównego (SR-IOV) do maszyny wirtualnej, co może prowadzić do zwiększenia wydajności sieci. Aby uzyskać więcej informacji, zobacz: https://learn.microsoft.com/azure/virtual-network/accelerated-networking-overview. |
| endpointConfiguration |
Konfiguracja punktów końcowych na węzłach obliczeniowych w puli wsadowej. |
|
| publicIPAddressConfiguration |
Konfiguracja publicznego adresu IPAddress dla węzłów obliczeniowych w puli usługi Batch. |
|
| subnetId |
string |
Identyfikator zasobu ARM podsieci wirtualnej sieci, do którego dołączają węzły obliczeniowe puli. Jest to formularz /subscriptions/{subscription}/resourceGroups/{group}/providers/{provider}/virtualNetworks/{network}/subnets/{subnet}. Sieć wirtualna musi znajdować się w tym samym regionie i subskrypcji co konto usługi Azure Batch. Wskazana podsieć powinna mieć wystarczającą liczbę wolnych adresów IP, aby pomieścić liczbę węzłów obliczeniowych w puli. Jeśli podsieć nie ma wystarczającej liczby wolnych adresów IP, pula częściowo przydzieli węzły i wystąpi błąd zmiany rozmiaru. Jednostka usługi "MicrosoftAzureBatch" musi mieć rolę "Klasyczny współautor maszyny wirtualnej" Role-Based kontroli dostępu (RBAC) dla określonej sieci wirtualnej. Wskazana podsieć musi umożliwiać komunikację z usługą Azure Batch, aby umożliwić planowanie zadań na węzłach. Można to sprawdzić, sprawdzając, czy określona sieć wirtualna ma skojarzone sieciowe grupy zabezpieczeń. Jeśli komunikacja z węzłami w określonej podsieci zostanie odrzucona przez sieciową grupę zabezpieczeń, usługa Batch ustawi stan węzłów obliczeniowych na bezużyteczny. Obsługiwane są tylko wirtualne sieci ARM ("Microsoft.Network/virtualNetworks"). Jeśli określony VNet posiada powiązane grupy bezpieczeństwa sieciowego (NSG), należy włączyć kilka zarezerwowanych portów systemowych dla komunikacji przychodzącej, w tym porty 29876 i 29877. Włącz również połączenia wychodzące z usługą Azure Storage na porcie 443. Aby uzyskać więcej informacji, zobacz: https://learn.microsoft.com/azure/batch/nodes-and-pools#virtual-network-vnet-and-firewall-configuration |
NetworkSecurityGroupRule
Reguła sieciowej grupy zabezpieczeń, która ma być stosowana do przychodzącego punktu końcowego.
| Nazwa | Typ | Opis |
|---|---|---|
| access |
Akcja, która powinna zostać podjęta dla określonego adresu IP, zakresu podsieci lub tagu. |
|
| priority |
integer (int32) |
Priorytet tej reguły. Priorytety w puli muszą być unikalne i oceniane według priorytetu. Im niższa liczba, tym wyższy priorytet. Na przykład można określić reguły z liczbami zamówień 150, 250 i 350. Reguła z numerem porządkowym 150 ma pierwszeństwo przed regułą, która ma kolejność 250. Dozwolone priorytety to od 150 do 4096. Jeśli jakiekolwiek wartości zarezerwowane lub zduplikowane zostaną dostarczone, żądanie zakończy się niepowodzeniem z kodem stanu HTTP 400. |
| sourceAddressPrefix |
string |
Prefiks adresu źródłowego lub tag, który ma być zgodny z regułą. Prawidłowe wartości to pojedynczy adres IP (tj. 10.10.10.10.10), podsieć IP (tj. 192.168.1.0/24), tag domyślny lub * (dla wszystkich adresów). Jeśli podano inne wartości, żądanie zakończy się niepowodzeniem z kodem stanu HTTP 400. |
| sourcePortRanges |
string[] |
Zakresy portów źródłowych zgodne z regułą. Poprawne wartości to '' (dla wszystkich portów 0 - 65535), konkretny port (np. 22) lub zakres portów (np. 100-200). Porty muszą mieścić się w zakresie od 0 do 65535. Każdy wpis w tej kolekcji nie może nakładać się na żaden inny wpis (ani zakres, ani pojedynczy port). Jeśli podane są inne wartości, żądanie kończy się niepowodzeniem z kodem statusowym HTTP 400. Domyślna wartość to "". |
NetworkSecurityGroupRuleAccess
Enumy NetworkSecurityGroupRuleAccess
| Wartość | Opis |
|---|---|
| allow |
Zezwalaj na dostęp. |
| deny |
Odmowa dostępu. |
NfsMountConfiguration
Informacje używane do nawiązywania połączenia z systemem plików NFS.
| Nazwa | Typ | Opis |
|---|---|---|
| mountOptions |
string |
Dodatkowe opcje wiersza polecenia umożliwiające przekazanie polecenia instalacji. Są to opcje "net use" w systemach Windows i "instalowanie" w systemie Linux. |
| relativeMountPath |
string |
Ścieżka względna na węźle obliczeniowym, na którym system plików będzie montowany. Wszystkie systemy plików są instalowane względem katalogu instalacji usługi Batch, dostępnego za pośrednictwem zmiennej środowiskowej AZ_BATCH_NODE_MOUNTS_DIR. |
| source |
string |
Identyfikator URI systemu plików do zainstalowania. |
OutputFile
Podczas każdego przekazywania plików usługa Batch zapisuje dwa pliki dziennika w węźle obliczeniowym "fileuploadout.txt" i "fileuploaderr.txt". Te pliki dziennika służą do uzyskania dodatkowych informacji na temat konkretnego błędu.
| Nazwa | Typ | Opis |
|---|---|---|
| destination |
Cel dla pliku wyjściowego. |
|
| filePattern |
string |
Wzór wskazujący, które pliki (pliki) przesłać. Wspierane są zarówno ścieżki względne, jak i absolutne. Ścieżki względne są względne względem katalogu roboczego Task. Obsługiwane są następujące karty dzikie: * pasuje do 0 lub więcej znaków (na przykład wzór abc* pasowałby do abc lub abcdef), ** pasuje do dowolnego katalogu, ? Pasuje do dowolnej pojedynczej postaci, [ABC] do jednej z nawiasów, a [A-C] do jednej postaci w zakresie. Nawiasy mogą zawierać negację dopasowaną do dowolnego znaku nieokreślonego (na przykład [!abc] pasuje do dowolnego znaku oprócz a, b lub c). Jeśli nazwa pliku zaczyna się od "." jest domyślnie ignorowana, ale może zostać dopasowana przez wyraźne określenie (na przykład .gif nie dopasuje .a.gif, ale ..gif tak). Prosty przykład: ***.txt pasuje do każdego pliku, który nie zaczyna się od '.' i kończy się na .txt w katalogu roboczym Task lub dowolnym podkatalogu. Jeśli nazwa pliku zawiera znak dziki, można ją objąć nawiasami (na przykład abc[] pasuje do pliku o nazwie abc). Należy zauważyć, że zarówno \, jak i / są traktowane jako separatory katalogów na Windows, ale na Linuksie jest tylko / ((Linux). Zmienne środowiskowe (%var% na Windows lub $var na Linuksie) są rozszerzane przed zastosowaniem wzorca. |
| uploadOptions |
Dodatkowe opcje operacji przesyłania, w tym w jakich warunkach wykonać przesyłanie. |
OutputFileBlobContainerDestination
Określa miejsce docelowe przekazywania plików w kontenerze usługi Azure Blob Storage.
| Nazwa | Typ | Opis |
|---|---|---|
| containerUrl |
string (uri) |
URL kontenera w Azure Blob Storage, do którego należy przesłać plik(y). Jeśli nie używa się tożsamości zarządzanej, adres URL musi zawierać Wspólny Podpis Dostępu (SAS) przyznający uprawnienia do zapisu do kontenera. |
| identityReference |
Odniesienie do tożsamości przypisanej przez użytkownika do dostępu do Azure Blob Storage określone przez containerUrl. Tożsamość musi mieć dostęp do zapisu do kontenera Azure Blob Storage. |
|
| path |
string |
Docelowy blob lub wirtualny katalog w kontenerze Azure Storage. Jeśli filePattern odnosi się do konkretnego pliku (czyli nie zawiera dzikich znaków), to path to nazwa blobu, do którego należy przesłać ten plik. Jeśli plikWzorzec zawiera jeden lub więcej znaków dzikich (a zatem może pasować do wielu plików), to ścieżka to nazwa wirtualnego katalogu blobów (przypisanego do każdej nazwy blob), do którego należy przesłać plik(y). Jeśli zostanie pominięty, plik(y) są przesyłane do korzenia kontenera z nazwą blob-a odpowiadającą ich nazwie. |
| uploadHeaders |
Lista par nazwy-wartość dla nagłówków przeznaczonych do przesyłania plików wyjściowych. Te nagłówki zostaną określone podczas przesyłania plików do Azure Storage. Oficjalny dokument dotyczący dozwolonych nagłówków przy przesyłaniu blobów: https://learn.microsoft.com/rest/api/storageservices/put-blob#request-headers-all-blob-types. |
OutputFileDestination
Miejsce docelowe, do którego ma zostać przekazany plik.
| Nazwa | Typ | Opis |
|---|---|---|
| container |
Lokalizacja w Azure Blob storage, do której przesyłane są pliki. |
OutputFileUploadCondition
OutputFileUploadCondition enums
| Wartość | Opis |
|---|---|
| tasksuccess |
Plik(y) przesyłaj dopiero po zakończeniu procesu zadania z kodem wyjścia 0. |
| taskfailure |
Plik(y) przesyłaj dopiero po zakończeniu procesu zadania z niezerowym kodem wyjścia. |
| taskcompletion |
Przesyłaj plik(y) po zakończeniu procesu Zadania, niezależnie od kodu wyjścia. |
OutputFileUploadConfig
Opcje operacji przekazywania pliku wyjściowego, w tym w jakich warunkach należy wykonać przekazywanie.
| Nazwa | Typ | Opis |
|---|---|---|
| uploadCondition |
Warunki, w jakich plik wyjściowy Zadania lub zestaw plików powinien zostać przesłany. Domyślnie jest wykonywanie zadań. |
OutputFileUploadHeader
Para nazwa-wartość nagłówka HTTP
| Nazwa | Typ | Opis |
|---|---|---|
| name |
string |
Nazwa nagłówka nierozróżniająca wielkości wielkości liter, której należy użyć podczas przesyłania plików wyjściowych. |
| value |
string |
Wartość nagłówka używanego podczas przesyłania plików wyjściowych. |
ProxyAgentSettings
Określa ustawienia proxyAgent podczas tworzenia maszyny wirtualnej.
| Nazwa | Typ | Opis |
|---|---|---|
| enabled |
boolean |
Określa, czy funkcja protokołu Metadata Security Protocol powinna być włączona na maszynie wirtualnej, czy w zestawie skalowania maszyn wirtualnych. Wartość domyślna to False. |
| imds |
Ustawienia punktu końcowego IMDS. |
|
| wireServer |
Ustawienia punktu końcowego WireServer. |
ResourceFile
Jeden plik lub wiele plików do pobrania do węzła obliczeniowego.
| Nazwa | Typ | Opis |
|---|---|---|
| autoStorageContainerName |
string |
Nazwa kontenera magazynowego w konto automatycznego przechowywania. Właściwości autoStorageContainerName, storageContainerUrl i httpUrl wzajemnie się wykluczają i należy określić jedną z nich. |
| blobPrefix |
string |
Prefiks obiektu blob używany podczas pobierania obiektów blob z kontenera usługi Azure Storage. Zostaną pobrane tylko obiekty blob, których nazwy zaczynają się od określonego prefiksu. Właściwość jest prawidłowa tylko wtedy, gdy jest używana właściwość autoStorageContainerName lub storageContainerUrl. Ten prefiks może być częściową nazwą pliku lub podkatalogem. Jeśli prefiks nie zostanie określony, zostaną pobrane wszystkie pliki w kontenerze. |
| fileMode |
string |
Atrybut trybu uprawnień pliku w formacie ósemkowym. Ta właściwość dotyczy tylko plików pobieranych do Linux Compute Nodes. Zostanie zignorowany, jeśli jest określony dla pliku zasobów, który zostanie pobrany do węzła obliczeń Windows. Jeśli ta właściwość nie jest określona dla węzła obliczeniowego Linuksa, do pliku przypisywana jest domyślna wartość 0770. |
| filePath |
string |
Lokalizacja na węźle obliczeniowym, do której należy pobrać plik(y), względem katalogu roboczego zadania. Jeśli określono właściwość httpUrl, parametr filePath jest wymagany i opisuje ścieżkę, do której zostanie pobrany plik, w tym nazwę pliku. W przeciwnym razie, jeśli określono właściwość autoStorageContainerName lub storageContainerUrl, parametr filePath jest opcjonalny i jest katalogem do pobrania plików. W przypadku, gdy filePath jest używany jako katalog, każda struktura katalogów już skojarzona z danymi wejściowymi zostanie zachowana w całości i dołączona do określonego katalogu filePath. Określona ścieżka względna nie może wyjść z katalogu roboczego zadania (na przykład używając '..'). |
| httpUrl |
string (uri) |
Adres URL pliku do pobrania. Właściwości autoStorageContainerName, storageContainerUrl i httpUrl wzajemnie się wykluczają i należy określić jedną z nich. Jeśli adres URL wskazuje usługę Azure Blob Storage, musi być czytelny z węzłów obliczeniowych. Istnieją trzy sposoby uzyskiwania takiego adresu URL dla obiektu blob w usłudze Azure Storage: obejmują sygnaturę dostępu współdzielonego udzielając uprawnień do odczytu dla obiektu blob, używanie tożsamości zarządzanej z uprawnieniami do odczytu lub ustawianie listy ACL dla obiektu blob lub kontenera, aby zezwolić na dostęp publiczny. |
| identityReference |
Odniesienie do tożsamości przypisanej przez użytkownika do dostępu do Azure Blob Storage określone przez storageContainerUrl lub httpUrl. |
|
| storageContainerUrl |
string (uri) |
Adres URL kontenera obiektów blob w usłudze Azure Blob Storage. Właściwości autoStorageContainerName, storageContainerUrl i httpUrl wzajemnie się wykluczają i należy określić jedną z nich. Ten adres URL musi być czytelny i możliwy do wyświetlenia z węzłów obliczeniowych. Istnieją trzy sposoby uzyskania takiego adresu URL dla kontenera w usłudze Azure Storage: obejmują sygnaturę dostępu współdzielonego (SAS) udzielając uprawnień do odczytu i listy w kontenerze, używanie tożsamości zarządzanej z uprawnieniami do odczytu i listy lub ustawianie listy ACL dla kontenera, aby zezwolić na dostęp publiczny. |
RollingUpgradePolicy
Parametry konfiguracji używane podczas uaktualniania stopniowego.
| Nazwa | Typ | Opis |
|---|---|---|
| enableCrossZoneUpgrade |
boolean |
Zezwalaj usłudze VMSS na ignorowanie granic az podczas konstruowania partii uaktualniania. Weź pod uwagę domenę aktualizacji i parametr maxBatchInstancePercent w celu określenia rozmiaru partii. To pole może być ustawione na wartość true lub false tylko w przypadku używania wartości NodePlacementConfiguration jako strefowej. |
| maxBatchInstancePercent |
integer (int32) |
Maksymalny procent łącznych wystąpień maszyn wirtualnych, które zostaną uaktualnione jednocześnie przez uaktualnienie stopniowe w jednej partii. Ponieważ jest to maksimum, wystąpienia w złej kondycji w poprzednich lub przyszłych partiach mogą spowodować spadek procentu wystąpień w partii w celu zapewnienia większej niezawodności. Wartość tego pola powinna należeć do zakresu od 5 do 100 włącznie. Jeśli parametr maxBatchInstancePercent i maxUnhealthyInstancePercent są przypisywane z wartością, wartość maxBatchInstancePercent nie powinna być większa niż wartość maxUnhealthyInstancePercent. |
| maxUnhealthyInstancePercent |
integer (int32) |
Maksymalny procent łącznej liczby wystąpień maszyn wirtualnych w zestawie skalowania, które mogą być jednocześnie w złej kondycji, w wyniku uaktualnienia lub przez odnalezienie w stanie złej kondycji przez kontrolę kondycji maszyny wirtualnej przed przerwaniem uaktualnienia stopniowego. To ograniczenie zostanie sprawdzone przed uruchomieniem dowolnej partii. Wartość tego pola powinna należeć do zakresu od 5 do 100 włącznie. Jeśli parametr maxBatchInstancePercent i maxUnhealthyInstancePercent są przypisywane z wartością, wartość maxBatchInstancePercent nie powinna być większa niż wartość maxUnhealthyInstancePercent. |
| maxUnhealthyUpgradedInstancePercent |
integer (int32) |
Maksymalny procent uaktualnionych wystąpień maszyn wirtualnych, które można znaleźć w złej kondycji. Ta kontrola będzie miała miejsce po uaktualnieniu każdej partii. Jeśli ta wartość procentowa zostanie kiedykolwiek przekroczona, przerywa się aktualizacja stopniowa. Wartość tego pola powinna należeć do zakresu od 0 do 100 włącznie. |
| pauseTimeBetweenBatches |
string (duration) |
Czas oczekiwania między ukończeniem aktualizacji dla wszystkich maszyn wirtualnych w jednej partii a uruchomieniem następnej partii. Czas trwania należy określić w formacie ISO 8601. |
| prioritizeUnhealthyInstances |
boolean |
Uaktualnij wszystkie wystąpienia w złej kondycji w zestawie skalowania przed wszelkimi wystąpieniami w dobrej kondycji. |
| rollbackFailedInstancesOnPolicyBreach |
boolean |
Wycofywanie nie powiodło się wystąpienia do poprzedniego modelu, jeśli zasady uaktualniania stopniowego zostały naruszone. |
SecurityEncryptionTypes
Enumy SecurityEncryptionTypes
| Wartość | Opis |
|---|---|
| DiskWithVMGuestState |
EncryptionType dysku zarządzanego jest ustawiony na DiskWithVMGuestState na potrzeby szyfrowania dysku zarządzanego wraz z obiektem blob VMGuestState. Nie jest obsługiwany w dyskach danych. |
| NonPersistedTPM |
EncryptionType dysku zarządzanego jest ustawiony na NonPersistedTPM, aby nie utrwalać stanu oprogramowania układowego w obiekcie blob VMGuestState. |
| VMGuestStateOnly |
EncryptionType dysku zarządzanego jest ustawiony na VMGuestStateOnly w celu szyfrowania tylko obiektu blob VMGuestState. |
SecurityProfile
Określa ustawienia profilu zabezpieczeń dla maszyny wirtualnej lub zestawu skalowania maszyn wirtualnych.
| Nazwa | Typ | Opis |
|---|---|---|
| encryptionAtHost |
boolean |
Ta właściwość może być używana przez użytkownika w żądaniu włączenia lub wyłączenia szyfrowania hosta dla maszyny wirtualnej lub zestawu skalowania maszyn wirtualnych. Spowoduje to włączenie szyfrowania dla wszystkich dysków, w tym dysku zasobu/tymczasowego na samym hoście. Aby uzyskać więcej informacji na temat szyfrowania w wymaganiach dotyczących hosta, zobacz https://learn.microsoft.com/azure/virtual-machines/disk-encryption#supported-vm-sizes. |
| proxyAgentSettings |
Określa ustawienia proxyAgent podczas tworzenia maszyny wirtualnej. |
|
| securityType |
Określa typ zabezpieczeń maszyny wirtualnej. Musi być ustawiona na dowolną określoną wartość, aby włączyć interfejs UefiSettings. |
|
| uefiSettings |
Określa ustawienia zabezpieczeń, takie jak bezpieczny rozruch i maszyna wirtualna vTPM używane podczas tworzenia maszyny wirtualnej. Określa ustawienia zabezpieczeń, takie jak bezpieczny rozruch i maszyna wirtualna vTPM używane podczas tworzenia maszyny wirtualnej. |
SecurityTypes
Określa typ zabezpieczeń maszyny wirtualnej. Musi być ustawiona na dowolną określoną wartość, aby włączyć interfejs UefiSettings.
| Wartość | Opis |
|---|---|
| trustedLaunch |
Zaufane uruchamianie chroni przed zaawansowanymi i trwałymi technikami ataków. |
| confidentialvm |
Poufne przetwarzanie na platformie Azure oferuje poufne maszyny wirtualne przeznaczone dla dzierżaw z wysokimi wymaganiami dotyczącymi zabezpieczeń i poufności. Te maszyny wirtualne zapewniają silną, wymuszaną sprzętowo granicę, która pomaga spełnić twoje potrzeby w zakresie zabezpieczeń. Możesz użyć poufnych maszyn wirtualnych do migracji bez wprowadzania zmian w kodzie, a platforma chroni stan maszyny wirtualnej przed odczytem lub zmodyfikowaniem. |
ServiceArtifactReference
Określa identyfikator odwołania artefaktu usługi używany do ustawiania tej samej wersji obrazu dla wszystkich maszyn wirtualnych w zestawie skalowania w przypadku używania "najnowszej" wersji obrazu.
| Nazwa | Typ | Opis |
|---|---|---|
| id |
string |
Identyfikator referencyjny artefaktu serwisowego ServiceArtifactReference. Identyfikator odwołania artefaktu usługi w postaci /subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Compute/gallerys/{galleryName}/serviceArtifacts/{serviceArtifactName}/vmArtifactsProfiles/{vmArtifactsProfilesName} |
StorageAccountType
Wyliczenia StorageAccountType
| Wartość | Opis |
|---|---|
| standard_lrs |
Dysk danych powinien używać standardowego magazynu lokalnie nadmiarowego. |
| premium_lrs |
Dysk danych powinien używać magazynu lokalnie nadmiarowego w warstwie Premium. |
| standardssd_lrs |
Dysk danych/dysk systemu operacyjnego powinien używać magazynu lokalnie nadmiarowego SSD w warstwie Standardowa. |
UpgradeMode
Enumy UpgradeMode
| Wartość | Opis |
|---|---|
| automatic |
Wszystkie maszyny wirtualne w zestawie skalowania są automatycznie aktualizowane w tym samym czasie. |
| manual |
Kontrolujesz stosowanie aktualizacji do maszyn wirtualnych w zestawie skalowania. W tym celu należy użyć akcji manualUpgrade. |
| rolling |
Istniejące wystąpienia w zestawie skalowania są wyłączane w partiach, które mają zostać uaktualnione. Po zakończeniu uaktualniania partii wystąpienia zaczną ponownie kierować ruch, a następna partia rozpocznie się. Będzie to kontynuowane do momentu, aż wszystkie wystąpienia up-to-date. |
UpgradePolicy
Opisuje zasady uaktualniania — automatyczne, ręczne lub stopniowe.
| Nazwa | Typ | Opis |
|---|---|---|
| automaticOSUpgradePolicy |
Parametry konfiguracji używane do przeprowadzania automatycznego uaktualniania systemu operacyjnego. Parametry konfiguracji używane do przeprowadzania automatycznego uaktualniania systemu operacyjnego. |
|
| mode |
Określa tryb uaktualniania maszyn wirtualnych w zestawie skalowania. |
|
| rollingUpgradePolicy |
Parametry konfiguracji używane podczas uaktualniania stopniowego. |
UserAccount
Właściwości używane do tworzenia użytkownika używanego do wykonywania zadań w węźle obliczeniowym usługi Azure Batch.
| Nazwa | Typ | Opis |
|---|---|---|
| elevationLevel |
Poziom wysokości konta użytkownika. Wartość domyślna to nonAdmin. |
|
| linuxUserConfiguration |
Specyficzna dla Linuksa konfiguracja użytkownika dla konta użytkownika. Ta właściwość jest ignorowana, jeśli jest określona w puli Windows. Jeśli nie zostanie określony, użytkownik zostanie utworzony przy użyciu opcji domyślnych. |
|
| name |
string |
Nazwa konta użytkownika. Nazwy mogą zawierać dowolne znaki Unicode o maksymalnej długości do 20. |
| password |
string (password) |
Hasło do konta użytkownika. |
| windowsUserConfiguration |
Specyficzna dla Windows konfiguracja użytkownika dla konta użytkownika. Ta właściwość może być określona tylko wtedy, gdy użytkownik korzysta z puli Windows. Jeśli nie jest to określone i korzysta z puli Windows, użytkownik jest tworzony z domyślnymi opcjami. |
UserIdentity
Definicja tożsamości użytkownika, w ramach której jest uruchamiane zadanie. Określ właściwość userName lub autoUser, ale nie obie.
| Nazwa | Typ | Opis |
|---|---|---|
| autoUser |
Użytkownik automatyczny, pod którym uruchamiane jest zadanie. Właściwości userName i autoUser wzajemnie się wykluczają; należy określić jeden, ale nie oba te elementy. |
|
| username |
string |
Nazwa tożsamości użytkownika, pod którą wykonywane jest zadanie. Właściwości userName i autoUser wzajemnie się wykluczają; należy określić jeden, ale nie oba te elementy. |
VirtualMachineConfiguration
Konfiguracja węzłów obliczeniowych w puli oparta na infrastrukturze usługi Azure Virtual Machines.
| Nazwa | Typ | Opis |
|---|---|---|
| containerConfiguration |
Konfiguracja kontenera dla Pool. Jeśli jest to wskazane, konfiguracja jest przeprowadzana na każdym węźle obliczeniowym w puli, aby umożliwić wykonywanie zadań w kontenerach. Wszystkie zwykłe zadania i zadania menedżera zadań wykonywane na tej puli muszą określać właściwość containerSettings, a wszystkie pozostałe zadania mogą ją określać. |
|
| dataDisks |
Data |
Konfiguracja dla dysków danych dołączonych do węzłów obliczeniowych w puli. Ta właściwość musi być określona, jeśli węzły obliczeniowe w puli muszą mieć do siebie dołączone puste dyski danych. Nie można tego zaktualizować. Każdy węzeł obliczeniowy otrzymuje własny dysk (dysk nie jest współdzielonym plikiem). Istniejące dyski nie mogą być podłączone, każda podłączona dyska jest pusta. Gdy węzeł obliczeniowy zostaje usunięty z puli, dysk i wszystkie z nim powiązane dane również zostają usunięte. Dysk nie jest sformatowany po dołączeniu, musi być sformatowany przed użyciem – więcej informacji można znaleźć w zobacz https://learn.microsoft.com/azure/virtual-machines/linux/classic/attach-disk#initialize-a-new-data-disk-in-linux i https://learn.microsoft.com/azure/virtual-machines/windows/attach-disk-ps#add-an-empty-data-disk-to-a-virtual-machine. |
| diskEncryptionConfiguration |
Konfiguracja szyfrowania dysków dla puli. Jeśli określono, szyfrowanie jest wykonywane w każdym węźle w puli podczas aprowizacji węzłów. |
|
| extensions |
Rozszerzenie maszyny wirtualnej dla puli. Jeśli zostanie określony, rozszerzenia wymienione w tej konfiguracji zostaną zainstalowane w każdym węźle. |
|
| imageReference |
Odwołanie do obrazu witryny Marketplace usługi Azure Virtual Machines lub niestandardowego obrazu maszyny wirtualnej do użycia. |
|
| licenseType |
string |
Dotyczy to tylko obrazów zawierających system operacyjny Windows i powinno być używane tylko wtedy, gdy posiadasz ważne licencje lokalne dla węzłów obliczeniowych, które zostaną wdrożone. W przypadku pominięcia nie zastosowano rabatu na licencjonowanie lokalne. Wartości to: Windows_Server — licencja lokalna dotyczy systemu Windows Server. Windows_Client — licencja lokalna jest dla klienta systemu Windows. |
| nodeAgentSKUId |
string |
Jednostka SKU agenta węzła obliczeniowego usługi Batch do aprowizacji w węzłach obliczeniowych w puli. Agent węzła obliczeniowego usługi Batch to program uruchamiany w każdym węźle obliczeniowym w puli i udostępnia interfejs polecenia i sterowania między węzłem obliczeniowym a usługą Batch. Istnieją różne implementacje agenta węzła obliczeniowego nazywanego jednostkami SKU dla różnych systemów operacyjnych. Należy określić jednostkę SKU agenta węzła obliczeniowego zgodną z wybranym odwołaniem do obrazu. Aby uzyskać listę obsługiwanych jednostek SKU agenta węzła obliczeniowego wraz z listą zweryfikowanych odwołań do obrazów, zobacz operację "Lista obsługiwanych jednostek SKU agenta węzła obliczeniowego". |
| nodePlacementConfiguration |
Konfiguracja umieszczania węzła dla puli. Ta konfiguracja określi reguły dotyczące fizycznego przydzielania węzłów w puli. |
|
| osDisk |
Ustawienia dysku systemu operacyjnego maszyny wirtualnej. |
|
| securityProfile |
Określa ustawienia profilu zabezpieczeń dla maszyny wirtualnej lub zestawu skalowania maszyn wirtualnych. |
|
| serviceArtifactReference |
Określa identyfikator odwołania artefaktu usługi używany do ustawiania tej samej wersji obrazu dla wszystkich maszyn wirtualnych w zestawie skalowania w przypadku używania "najnowszej" wersji obrazu. Identyfikator odwołania artefaktu usługi w postaci /subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Compute/gallerys/{galleryName}/serviceArtifacts/{serviceArtifactName}/vmArtifactsProfiles/{vmArtifactsProfilesName} |
|
| windowsConfiguration |
Ustawienia systemu operacyjnego Windows na maszynie wirtualnej. Ta właściwość nie może być określana, jeśli właściwość imageReference określa obraz systemu Linux OS. |
VMExtension
Konfiguracja rozszerzeń maszyn wirtualnych.
| Nazwa | Typ | Opis |
|---|---|---|
| autoUpgradeMinorVersion |
boolean |
Wskazuje, czy rozszerzenie powinno używać nowszej wersji pomocniczej, jeśli jest ona dostępna w czasie wdrażania. Po wdrożeniu rozszerzenie nie uaktualni wersji pomocniczych, chyba że zostanie ponownie wdrożone, nawet jeśli ta właściwość ma wartość true. |
| enableAutomaticUpgrade |
boolean |
Wskazuje, czy rozszerzenie powinno zostać automatycznie uaktualnione przez platformę, jeśli jest dostępna nowsza wersja rozszerzenia. |
| name |
string |
Nazwa rozszerzenia maszyny wirtualnej. |
| protectedSettings |
object |
Rozszerzenie może zawierać ustawienia protectedSettings lub protectedSettingsFromKeyVault lub w ogóle nie są chronione. |
| provisionAfterExtensions |
string[] |
Kolekcja nazw rozszerzeń. Kolekcja nazw rozszerzeń, po których należy aprowizować to rozszerzenie. |
| publisher |
string |
Nazwa wydawcy programu obsługi rozszerzeń. |
| settings |
object |
Ustawienia publiczne w formacie JSON dla rozszerzenia. |
| type |
string |
Rodzaj przedłużenia. |
| typeHandlerVersion |
string |
Wersja programu obsługi skryptów. |
WindowsConfiguration
Ustawienia systemu operacyjnego Windows, które mają być stosowane do maszyny wirtualnej.
| Nazwa | Typ | Opis |
|---|---|---|
| enableAutomaticUpdates |
boolean |
Określa, czy aktualizacje automatyczne są włączone na maszynie wirtualnej. W przypadku pominięcia wartość domyślna to true. |
WindowsUserConfiguration
Właściwości używane do tworzenia konta użytkownika w węźle obliczeniowym systemu Windows.
| Nazwa | Typ | Opis |
|---|---|---|
| loginMode |
Tryb logowania dla użytkownika. Domyślnie to "partia". |