az batch pool
Uwaga
Ta grupa poleceń zawiera polecenia zdefiniowane zarówno w interfejsie wiersza polecenia platformy Azure, jak i w co najmniej jednym rozszerzeniu. Zainstaluj każde rozszerzenie, aby korzystać z rozszerzonych możliwości. Dowiedz się więcej o rozszerzeniach.
Zarządzanie pulami usługi Batch.
Polecenia
| Nazwa | Opis | Typ | Stan |
|---|---|---|---|
| az batch pool autoscale |
Zarządzanie automatycznym skalowaniem pul usługi Batch. |
Podstawowe funkcje | Ogólna dostępność |
| az batch pool autoscale disable |
Wyłącza automatyczne skalowanie puli. |
Podstawowe funkcje | Ogólna dostępność |
| az batch pool autoscale enable |
Włącza automatyczne skalowanie dla puli. |
Podstawowe funkcje | Ogólna dostępność |
| az batch pool autoscale evaluate |
Pobiera wynik oceny formuły automatycznego skalowania w puli. |
Podstawowe funkcje | Ogólna dostępność |
| az batch pool create |
Utwórz pulę usługi Batch na koncie. Podczas tworzenia puli wybierz argumenty z konfiguracji usług Cloud Services lub konfiguracji maszyny wirtualnej. |
Podstawowe funkcje | Ogólna dostępność |
| az batch pool create (azure-batch-cli-extensions rozszerzenie) |
Utwórz pulę usługi Batch na koncie. Podczas tworzenia puli wybierz argumenty z konfiguracji usług Cloud Services lub konfiguracji maszyny wirtualnej. |
Numer wewnętrzny | Ogólna dostępność |
| az batch pool delete |
Usuwa pulę z określonego konta. |
Podstawowe funkcje | Ogólna dostępność |
| az batch pool list |
Wyświetla listę wszystkich pul w określonym koncie. |
Podstawowe funkcje | Ogólna dostępność |
| az batch pool node-counts |
Pobieranie liczby węzłów dla pul usługi Batch. |
Podstawowe funkcje | Ogólna dostępność |
| az batch pool node-counts list |
Pobiera liczbę węzłów obliczeniowych w każdym stanie pogrupowanych według puli. |
Podstawowe funkcje | Ogólna dostępność |
| az batch pool reset |
Zaktualizuj właściwości puli usługi Batch. Nieokreślone właściwości, które można zaktualizować, są resetowane do ich wartości domyślnych. |
Podstawowe funkcje | Ogólna dostępność |
| az batch pool resize |
Zmiana rozmiaru lub zatrzymanie zmiany rozmiaru puli usługi Batch. |
Podstawowe funkcje | Ogólna dostępność |
| az batch pool set |
Zaktualizuj właściwości puli usługi Batch. Aktualizowanie właściwości w podgrupie spowoduje zresetowanie nieokreślonych właściwości tej grupy. |
Podstawowe funkcje | Ogólna dostępność |
| az batch pool show |
Pobiera informacje o określonej puli. |
Podstawowe funkcje | Ogólna dostępność |
| az batch pool supported-images |
Wykonywanie zapytań dotyczących obrazów maszyn wirtualnych obsługiwanych przez usługę Azure Batch. |
Podstawowe funkcje | Ogólna dostępność |
| az batch pool supported-images list |
Wyświetla listę wszystkich obrazów maszyn wirtualnych obsługiwanych przez usługę Azure Batch. |
Podstawowe funkcje | Ogólna dostępność |
| az batch pool usage-metrics |
Wyświetlanie metryk użycia pul usługi Batch. |
Podstawowe funkcje | Ogólna dostępność |
| az batch pool usage-metrics list |
Wyświetla listę metryk użycia, agregowanych według puli w poszczególnych interwałach czasu dla określonego konta. |
Podstawowe funkcje | Ogólna dostępność |
az batch pool create
Utwórz pulę usługi Batch na koncie. Podczas tworzenia puli wybierz argumenty z konfiguracji usług Cloud Services lub konfiguracji maszyny wirtualnej.
az batch pool create [--accelerated-networking {false, true}]
[--account-endpoint]
[--account-key]
[--account-name]
[--application-licenses]
[--application-package-references]
[--auto-scale-formula]
[--certificate-references]
[--defer-os-rolling-upgrade {false, true}]
[--disable-auto-rollback {false, true}]
[--disk-encryption-targets]
[--enable-auto-os-upgrade {false, true}]
[--enable-cross-zone-upgrade {false, true}]
[--enable-inter-node-communication]
[--enable-secure-boot {false, true}]
[--enable-vtpm {false, true}]
[--enable-write-accel {false, true}]
[--encryption-at-host {false, true}]
[--id]
[--image]
[--json-file]
[--max-batch-instance-percent]
[--max-unhealthy-instance-percent]
[--max-unhealthy-upgraded-instance-percent]
[--metadata]
[--node-agent-sku-id]
[--os-disk-caching {none, readonly, readwrite}]
[--os-disk-size]
[--os-family {2, 3, 4, 5, 6}]
[--os-version]
[--pause-time-between-batches]
[--placement {cachedisk}]
[--policy {regional, zonal}]
[--prioritize-unhealthy-instances {false, true}]
[--resize-timeout]
[--resource-tags]
[--rollback-failed-instances-on-policy-breach {false, true}]
[--security-type]
[--start-task-command-line]
[--start-task-resource-files]
[--start-task-wait-for-success]
[--storage-account-type {premium_lrs, standard_lrs, standardssd_lrs}]
[--target-communication {classic, default, simplified}]
[--target-dedicated-nodes]
[--target-low-priority-nodes]
[--targets]
[--task-slots-per-node]
[--upgrade-policy-mode {automatic, manual, rolling}]
[--use-rolling-upgrade-policy {false, true}]
[--vm-size]Parametry opcjonalne
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 (Omówienie sieci/przyspieszonej sieci). Ustaw wartość true, aby włączyć.
Punkt końcowy usługi Batch. Alternatywnie ustaw zmienną środowiskową: AZURE_BATCH_ENDPOINT.
Klucz konta usługi Batch. Alternatywnie ustaw zmienną środowiskową: AZURE_BATCH_ACCESS_KEY.
Nazwa konta usługi Batch. Alternatywnie ustaw zmienną środowiskową: AZURE_BATCH_ACCOUNT.
Lista licencji aplikacji musi być podzbiorem dostępnych licencji aplikacji usługi Batch. Jeśli zażądano licencji, która nie jest obsługiwana, tworzenie puli zakończy się niepowodzeniem. Wartości rozdzielone spacjami.
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. Identyfikatory aplikacji rozdzielone spacjami z opcjonalną wersją w formacie "id[#version]".
Formuła dla żądanej liczby węzłów obliczeniowych w puli. 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. Aby uzyskać więcej informacji na temat określania tej formuły, zobacz https://azure.microsoft.com/documentation/articles/batch-automatic-scaling/.
W przypadku węzłów systemu Windows usługa Batch instaluje certyfikaty w określonym magazynie certyfikatów i lokalizacji. W przypadku węzłów obliczeniowych systemu Linux certyfikaty są przechowywane w katalogu roboczym Zadanie, a zmienna środowiskowa AZ_BATCH_CERTIFICATES_DIR jest dostarczana do zadania, aby wykonać zapytanie o tę lokalizację. W przypadku certyfikatów z widocznością "remoteUser" katalog "certs" jest tworzony w katalogu głównym użytkownika (np. /home/{user-name}/certs) i certyfikaty są umieszczane w tym katalogu. Ostrzeżenie: Ta właściwość jest przestarzała i zostanie usunięta po lutym 2024 r. Zamiast tego użyj rozszerzenia Azure KeyVault. Odciski palca certyfikatu rozdzielane spacjami.
Odroczenie uaktualnień systemu operacyjnego na maszynach TVM, jeśli są uruchomione zadania. Prawda, jeśli flaga jest obecna.
Czy funkcja wycofywania obrazów systemu operacyjnego powinna być wyłączona. Prawda, jeśli flaga jest obecna.
Rozdzielona spacją lista DiskEncryptionTargets. bieżące możliwe wartości obejmują OsDisk i TemporaryDisk.
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.
Jeśli dla pul opartych na systemie Windows ustawiono wartość true, parametr WindowsConfiguration.enableAutomatic Aktualizacje nie można ustawić wartości true. Prawda, jeśli flaga jest obecna.
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. Prawda, jeśli flaga jest obecna.
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 false. Prawda, jeśli flaga jest obecna.
Włącz bezpieczny rozruch.
Włącz maszynę wirtualną vTPM.
Określ, czy na dysku ma być włączony lub wyłączony moduł writeAccelerator.
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. Domyślne zachowanie to: Szyfrowanie na hoście zostanie wyłączone, chyba że ta właściwość ma wartość true dla zasobu.
Wymagany. 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 zachowuje wielkość liter i nie uwzględnia wielkości liter (oznacza to, że w ramach konta nie ma dwóch identyfikatorów puli, które różnią się tylko wielkością liter).
Dokumentacja obrazu systemu operacyjnego. Może to być format "publisher:offer:sku[:version]" lub w pełni kwalifikowany identyfikator obrazu usługi ARM formularza "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Compute/images/{imageName}". Jeśli format "publisher:offer:sku[:version]" jest opcjonalny, a jeśli pominięto najnowszą wersję, zostanie użyta. Prawidłowe wartości można pobrać za pomocą polecenia "az batch pool supported-images list". Na przykład: "MicrosoftWindowsServer:WindowsServer:2012-R2-Datacenter:latest".
Plik zawierający specyfikację parametru właściwości w formacie JSON (sformatowany w celu dopasowania do treści żądania interfejsu API REST). Jeśli ten parametr zostanie określony, wszystkie argumenty parametru "Utwórz pulę właściwości" są ignorowane. Zobacz: https://docs.microsoft.com/en-us/rest/api/batchservice/pool/add?tabs=HTTP#request-body.
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.
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.
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.
Usługa Batch nie przypisuje żadnego znaczenia metadanym; służy wyłącznie do używania kodu użytkownika. Wartości rozdzielone spacjami w formacie "key=value".
Wymagany. 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".
Określ 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.
Początkowy rozmiar dysku w GB podczas tworzenia nowego dysku systemu operacyjnego.
Wymagany. Możliwe wartości to: 2 — Rodzina systemu operacyjnego 2, co odpowiada systemowi Windows Server 2008 R2 z dodatkiem SP1. 3 — Rodzina systemu operacyjnego 3, co odpowiada systemowi Windows Server 2012. 4 — Rodzina systemów operacyjnych 4, równoważna windows Server 2012 R2. 5 — Rodzina systemu operacyjnego 5, co odpowiada systemowi Windows Server 2016. 6 — Rodzina systemów operacyjnych 6, co odpowiada systemowi Windows Server 2019. Aby uzyskać więcej informacji, zobacz Wydania systemu operacyjnego gościa platformy Azure (https://azure.microsoft.com/documentation/articles/cloud-services-guestos-update-matrix/#releases).
Wartość domyślna to * określająca najnowszą wersję systemu operacyjnego dla określonej rodziny systemów operacyjnych.
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. Oczekiwany format to czas trwania ISO-8601.
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 w https://docs.microsoft.com/en-us/azure/virtual-machines/windows/ephemeral-os-disks#size-requirements witrynie i maszynami wirtualnymi z systemem Linux pod adresem https://docs.microsoft.com/en-us/azure/virtual-machines/linux/ephemeral-os-disks#size-requirements.
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.
Uaktualnij wszystkie wystąpienia w złej kondycji w zestawie skalowania przed wszelkimi wystąpieniami w dobrej kondycji. Prawda, jeśli flaga jest obecna.
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 zwróci błąd; Jeśli bezpośrednio wywołujesz interfejs API REST, kod stanu HTTP to 400 (Nieprawidłowe żądanie). Oczekiwany format to czas trwania ISO-8601.
Użytkownik może określić tagi zasobów dla puli. Każdy zasób utworzony dla puli zostanie również otagowany przez te same tagi zasobów.
Wycofywanie nie powiodło się wystąpienia do poprzedniego modelu, jeśli zasady uaktualniania stopniowego zostały naruszone. Prawda, jeśli flaga jest obecna.
Określ wartość SecurityType maszyny wirtualnej. Należy ustawić dowolną określoną wartość, aby włączyć interfejs Uefi Ustawienia. Domyślne zachowanie to: Uefi Ustawienia nie zostanie włączone, chyba że ta właściwość jest ustawiona.
Wymagany. 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 korzystać 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://docs.microsoft.com/en-us/azure/batch/batch-compute-node-environment-variables).
Pliki wymienione w ramach tego elementu znajdują się w katalogu roboczym zadania. Odwołania do zasobów rozdzielonych spacjami w formacie nazwa_pliku=httpurl.
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. Prawda, jeśli flaga jest obecna.
Typ konta magazynu dla dysku zarządzanego.
Żądany tryb komunikacji węzła dla puli. Jeśli ten element jest obecny, zastępuje istniejący element targetNodeCommunicationMode skonfigurowany w puli. Jeśli pominięto, wszystkie istniejące metadane pozostaną niezmienione.
Żą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.
Żą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.
W przypadku pominięcia żadne dyski w węzłach obliczeniowych w puli nie będą szyfrowane. W puli systemu Linux obsługiwana jest tylko opcja "TemporaryDisk"; w puli systemu Windows należy określić wartości "OsDisk" i "TemporaryDisk". Miejsca oddzielone dyski docelowe do szyfrowania. Wartości mogą być OsDisk lub TemporaryDisk.
Liczba miejsc zadań, których można użyć do uruchamiania współbieżnych zadań w jednym węźle obliczeniowym w puli. Domyślna wartość wynosi 1. Wartość maksymalna jest mniejsza od 4 razy liczbie rdzeni rozmiaru maszyny wirtualnej puli lub 256.
Tryb uaktualniania systemu operacyjnego puli.
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. Prawda, jeśli flaga jest obecna.
Wymagany. Aby uzyskać informacje o dostępnych rozmiarach maszyn wirtualnych dla pul usług w chmurze (pul utworzonych za pomocą funkcji cloudServiceConfiguration), zobacz Rozmiary dla usług Cloud Services (https://azure.microsoft.com/documentation/articles/cloud-services-sizes-specs/). Usługa Batch obsługuje wszystkie rozmiary maszyn wirtualnych usług Cloud Services z wyjątkiem ExtraSmall, A1V2 i A2V2. Aby uzyskać informacje o dostępnych rozmiarach maszyn wirtualnych dla pul przy użyciu obrazów z witryny Marketplace maszyn wirtualnych (pul utworzonych za pomocą funkcji virtualMachineConfiguration), zobacz Rozmiary maszyn wirtualnych (Linux) () lubhttps://azure.microsoft.com/documentation/articles/virtual-machines-linux-sizes/ Rozmiary maszyn wirtualnych (Windows) (https://azure.microsoft.com/documentation/articles/virtual-machines-windows-sizes/). Usługa Batch obsługuje wszystkie rozmiary maszyn wirtualnych platformy Azure z wyjątkiem STANDARD_A0 i z magazynem w warstwie Premium (STANDARD_GS, STANDARD_DS i serii STANDARD_DSV2).
Parametry globalne
Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.
Pokaż ten komunikat pomocy i zakończ pracę.
Pokaż tylko błędy, pomijając ostrzeżenia.
Format danych wyjściowych.
Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.
Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID.
Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.
az batch pool create (azure-batch-cli-extensions rozszerzenie)
Utwórz pulę usługi Batch na koncie. Podczas tworzenia puli wybierz argumenty z konfiguracji usług Cloud Services lub konfiguracji maszyny wirtualnej.
az batch pool create [--account-endpoint]
[--account-key]
[--account-name]
[--application-licenses]
[--application-package-references]
[--auto-scale-formula]
[--certificate-references]
[--disk-encryption-targets]
[--enable-inter-node-communication]
[--id]
[--image]
[--json-file]
[--metadata]
[--node-agent-sku-id]
[--os-family]
[--os-version]
[--parameters]
[--policy]
[--resize-timeout]
[--resource-group]
[--start-task-command-line]
[--start-task-resource-files]
[--start-task-wait-for-success]
[--target-dedicated-nodes]
[--target-low-priority-nodes]
[--targets]
[--task-slots-per-node]
[--template]
[--vm-size]Parametry opcjonalne
Punkt końcowy usługi Batch. Alternatywnie ustaw zmienną środowiskową: AZURE_BATCH_ENDPOINT.
Klucz konta usługi Batch. Alternatywnie ustaw zmienną środowiskową: AZURE_BATCH_ACCESS_KEY.
Nazwa konta usługi Batch. Alternatywnie ustaw zmienną środowiskową: AZURE_BATCH_ACCOUNT.
Lista licencji aplikacji musi być podzbiorem dostępnych licencji aplikacji usługi Batch. Jeśli zażądano licencji, która nie jest obsługiwana, tworzenie puli zakończy się niepowodzeniem.
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.
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. Aby uzyskać więcej informacji na temat określania tej formuły, zobacz "Automatyczne skalowanie węzłów obliczeniowych w puli usługi Azure Batch" (https://azure.microsoft.com/documentation/articles/batch-automatic-scaling/).
W przypadku węzłów systemu Windows usługa Batch instaluje certyfikaty w określonym magazynie certyfikatów i lokalizacji. W przypadku węzłów obliczeniowych systemu Linux certyfikaty są przechowywane w katalogu roboczym Zadanie, a zmienna środowiskowa AZ_BATCH_CERTIFICATES_DIR jest dostarczana do zadania, aby wykonać zapytanie o tę lokalizację. W przypadku certyfikatów z widocznością "remoteUser" katalog "certs" jest tworzony w katalogu głównym użytkownika (np. /home/{user-name}/certs) i certyfikaty są umieszczane w tym katalogu. Ostrzeżenie: Ta właściwość jest przestarzała i zostanie usunięta po lutym 2024 r. Zamiast tego użyj rozszerzenia Azure KeyVault.
Oddzielona lista spacji DiskEncryptionTargets. bieżące możliwe wartości obejmują OsDisk i TemporaryDisk.
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 false.
Wymagany. 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 zachowuje wielkość liter i nie uwzględnia wielkości liter (oznacza to, że w ramach konta nie ma dwóch identyfikatorów puli, które różnią się tylko wielkością liter).
Dokumentacja obrazu systemu operacyjnego. Może to być format "publisher:offer:sku[:version]" lub w pełni kwalifikowany identyfikator obrazu usługi ARM formularza "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Compute/images/{imageName}". Jeśli format "publisher:offer:sku[:version]" jest opcjonalny, a jeśli pominięto najnowszą wersję, zostanie użyta. Prawidłowe wartości można pobrać za pomocą polecenia "az batch pool node-agent-skus list". Na przykład: "MicrosoftWindowsServer:WindowsServer:2012-R2-Datacenter:latest".
Plik zawierający pulę do utworzenia w formacie JSON, jeśli ten parametr jest określony, wszystkie inne parametry są ignorowane.
Usługa Batch nie przypisuje żadnego znaczenia metadanym; służy wyłącznie do używania kodu użytkownika.
Jednostka SKU agenta węzła usługi Batch do aprowizowania w węzłach obliczeniowych w puli. Agent węzła usługi Batch to program uruchamiany w każdym węźle w puli i udostępnia interfejs polecenia i sterowania między węzłem a usługą Batch. Istnieją różne implementacje agenta węzła, znane jako jednostki SKU, dla różnych systemów operacyjnych. Należy określić jednostkę SKU agenta węzła zgodną z wybranym odwołaniem do obrazu. Aby uzyskać listę obsługiwanych jednostek SKU agenta węzła wraz z listą zweryfikowanych odwołań do obrazów, zobacz operację "Lista obsługiwanych jednostek SKU agenta węzła".
Rodzina systemu operacyjnego gościa platformy Azure, która ma zostać zainstalowana na maszynach wirtualnych w puli. Możliwe wartości to: 2 — Rodzina systemu operacyjnego 2, co odpowiada systemowi Windows Server 2008 R2 z dodatkiem SP1. 3 — Rodzina systemu operacyjnego 3, co odpowiada systemowi Windows Server 2012. 4 — Rodzina systemów operacyjnych 4, równoważna windows Server 2012 R2. 5 — Rodzina systemu operacyjnego 5, co odpowiada systemowi Windows Server 2016. Aby uzyskać więcej informacji, zobacz Wydania systemu operacyjnego gościa platformy Azure (https://azure.microsoft.com/documentation/articles/cloud-services-guestos-update-matrix/#releases). Dozwolone wartości: 2, 3, 4, 5.
Wartość domyślna to * określająca najnowszą wersję systemu operacyjnego dla określonej rodziny systemów operacyjnych.
Wartości parametrów dla pliku szablonu JSON puli usługi Batch. Można używać tylko z --template.
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. Dozwolone wartości: regionalna, strefowa.
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 zwróci błąd; Jeśli bezpośrednio wywołujesz interfejs API REST, kod stanu HTTP to 400 (Nieprawidłowe żądanie).
Grupa zasobów konta usługi Batch.
Wiersz polecenia zadania uruchamiania. 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 korzystać 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.
Lista plików, które usługa Batch pobierze do węzła obliczeniowego przed uruchomieniem wiersza polecenia. Odwołania do zasobów rozdzielonych spacjami w formacie nazwa_pliku=httpurl.
Czy usługa Batch powinna czekać na pomyślne zakończenie zadania uruchamiania (czyli zakończenie z kodem zakończenia 0) przed zaplanowaniem zadań w węźle obliczeniowym. Jeśli wartość true i zadanie uruchamiania zakończy się niepowodzeniem w węźle obliczeniowym, usługa Batch ponawia próbę zadania podrzędnego uruchamiania 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 oznaczy węzeł obliczeniowy jako bezużyteczny i nie będzie planować zadań podrzędnych. Ten warunek można wykryć za pomocą stanu węzła i szczegółów błędu planowania. Jeśli wartość false, usługa Batch nie będzie czekać na ukończenie zadania uruchamiania. W takim przypadku inne zadania mogą rozpocząć wykonywanie w węźle obliczeniowym, gdy zadanie uruchamiania jest nadal uruchomione; a nawet jeśli zadanie uruchamiania zakończy się niepowodzeniem, nowe zadania będą nadal zaplanowane w węźle. Wartością domyślną jest false. Prawda, jeśli flaga jest obecna.
Żą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.
Żą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.
W przypadku pominięcia żadne dyski w węzłach obliczeniowych w puli nie będą szyfrowane. W puli systemu Linux obsługiwana jest tylko opcja "TemporaryDisk"; w puli systemu Windows należy określić wartości "OsDisk" i "TemporaryDisk". Miejsca oddzielone dyski docelowe do szyfrowania. Wartości mogą być OsDisk lub TemporaryDisk.
Liczba miejsc zadań, których można użyć do uruchamiania współbieżnych zadań w jednym węźle obliczeniowym w puli. Domyślna wartość wynosi 1. Wartość maksymalna jest mniejsza od 4 razy liczbie rdzeni rozmiaru maszyny wirtualnej puli lub 256.
Plik szablonu JSON puli usługi Batch. Jeśli ten parametr zostanie określony, wszystkie inne parametry są ignorowane.
Wymagany. Aby uzyskać informacje o dostępnych rozmiarach maszyn wirtualnych dla pul usług w chmurze (pul utworzonych za pomocą funkcji cloudServiceConfiguration), zobacz Rozmiary dla usług Cloud Services (https://azure.microsoft.com/documentation/articles/cloud-services-sizes-specs/). Usługa Batch obsługuje wszystkie rozmiary maszyn wirtualnych usług Cloud Services z wyjątkiem ExtraSmall, A1V2 i A2V2. Aby uzyskać informacje o dostępnych rozmiarach maszyn wirtualnych dla pul przy użyciu obrazów z witryny Marketplace maszyn wirtualnych (pul utworzonych za pomocą funkcji virtualMachineConfiguration), zobacz Rozmiary maszyn wirtualnych (Linux) () lubhttps://azure.microsoft.com/documentation/articles/virtual-machines-linux-sizes/ Rozmiary maszyn wirtualnych (Windows) (https://azure.microsoft.com/documentation/articles/virtual-machines-windows-sizes/). Usługa Batch obsługuje wszystkie rozmiary maszyn wirtualnych platformy Azure z wyjątkiem STANDARD_A0 i z magazynem w warstwie Premium (STANDARD_GS, STANDARD_DS i serii STANDARD_DSV2).
Parametry globalne
Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.
Pokaż ten komunikat pomocy i zakończ pracę.
Pokaż tylko błędy, pomijając ostrzeżenia.
Format danych wyjściowych.
Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.
Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID.
Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.
az batch pool delete
Usuwa pulę z określonego konta.
Gdy zażądasz usunięcia puli, zostaną wykonane następujące akcje: stan puli zostanie ustawiony na usunięcie; wszystkie trwające operacje zmiany rozmiaru w puli są zatrzymywane; usługa Batch rozpoczyna zmianę rozmiaru puli na zero węzłów obliczeniowych; wszystkie zadania uruchomione w istniejących węzłach obliczeniowych są przerywane i ponownie kolejkowane (tak jak w przypadku żądania operacji zmiany rozmiaru puli z domyślną opcją ponownej kolejki); na koniec pula zostanie usunięta z systemu. Ponieważ uruchomione zadania są ponownie kolejkowane, użytkownik może ponownie uruchomić te zadania, aktualizując zadanie w celu kierowania innej puli. Następnie zadania mogą być uruchamiane w nowej puli. Jeśli chcesz zastąpić zachowanie ponownej kolejki, należy jawnie wywołać zmianę rozmiaru puli, aby zmniejszyć pulę do zera przed usunięciem puli. Jeśli wywołasz interfejs API aktualizacji, poprawek lub usuwania w puli w stanie usuwania, kod stanu HTTP 409 z kodem błędu PoolBeingDeleted zakończy się niepowodzeniem.
az batch pool delete --pool-id
[--account-endpoint]
[--account-key]
[--account-name]
[--if-match]
[--if-modified-since]
[--if-none-match]
[--if-unmodified-since]
[--yes]Parametry wymagane
Identyfikator puli do usunięcia.
Parametry opcjonalne
Punkt końcowy usługi Batch. Alternatywnie ustaw zmienną środowiskową: AZURE_BATCH_ENDPOINT.
Klucz konta usługi Batch. Alternatywnie ustaw zmienną środowiskową: AZURE_BATCH_ACCESS_KEY.
Nazwa konta usługi Batch. Alternatywnie ustaw zmienną środowiskową: AZURE_BATCH_ACCOUNT.
Wartość elementu ETag skojarzona z wersją zasobu znaną klientowi. Operacja zostanie wykonana tylko wtedy, gdy bieżący element ETag zasobu w usłudze dokładnie odpowiada wartości określonej przez klienta.
Sygnatura czasowa wskazująca czas ostatniej modyfikacji zasobu znanego klientowi. Operacja zostanie wykonana tylko wtedy, gdy zasób w usłudze został zmodyfikowany od określonego czasu.
Wartość elementu ETag skojarzona z wersją zasobu znaną klientowi. Operacja zostanie wykonana tylko wtedy, gdy bieżący element ETag zasobu w usłudze nie jest zgodny z wartością określoną przez klienta.
Sygnatura czasowa wskazująca czas ostatniej modyfikacji zasobu znanego klientowi. Operacja zostanie wykonana tylko wtedy, gdy zasób usługi nie został zmodyfikowany od określonego czasu.
Nie monituj o potwierdzenie.
Parametry globalne
Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.
Pokaż ten komunikat pomocy i zakończ pracę.
Pokaż tylko błędy, pomijając ostrzeżenia.
Format danych wyjściowych.
Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.
Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID.
Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.
az batch pool list
Wyświetla listę wszystkich pul w określonym koncie.
az batch pool list [--account-endpoint]
[--account-key]
[--account-name]
[--expand]
[--filter]
[--select]Parametry opcjonalne
Punkt końcowy usługi Batch. Alternatywnie ustaw zmienną środowiskową: AZURE_BATCH_ENDPOINT.
Klucz konta usługi Batch. Alternatywnie ustaw zmienną środowiskową: AZURE_BATCH_ACCESS_KEY.
Nazwa konta usługi Batch. Alternatywnie ustaw zmienną środowiskową: AZURE_BATCH_ACCOUNT.
Klauzula OData $expand.
Klauzula OData $filter. Aby uzyskać więcej informacji na temat konstruowania tego filtru, zobacz https://docs.microsoft.com/en-us/rest/api/batchservice/odata-filters-in-batch#list-pools.
Klauzula OData $select.
Parametry globalne
Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.
Pokaż ten komunikat pomocy i zakończ pracę.
Pokaż tylko błędy, pomijając ostrzeżenia.
Format danych wyjściowych.
Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.
Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID.
Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.
az batch pool reset
Zaktualizuj właściwości puli usługi Batch. Nieokreślone właściwości, które można zaktualizować, są resetowane do ich wartości domyślnych.
az batch pool reset --pool-id
[--account-endpoint]
[--account-key]
[--account-name]
[--application-package-references]
[--certificate-references]
[--json-file]
[--metadata]
[--start-task-command-line]
[--start-task-environment-settings]
[--start-task-max-task-retry-count]
[--start-task-wait-for-success]Parametry wymagane
Identyfikator puli do zaktualizowania.
Parametry opcjonalne
Punkt końcowy usługi Batch. Alternatywnie ustaw zmienną środowiskową: AZURE_BATCH_ENDPOINT.
Klucz konta usługi Batch. Alternatywnie ustaw zmienną środowiskową: AZURE_BATCH_ACCESS_KEY.
Nazwa konta usługi Batch. Alternatywnie ustaw zmienną środowiskową: AZURE_BATCH_ACCOUNT.
Wymagany. Lista zastępuje wszystkie istniejące odwołania do pakietu aplikacji w puli. Zmiany odwołań do pakietu aplikacji mają wpływ na wszystkie nowe węzły obliczeniowe przyłączone do puli, 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 aplikacji. Jeśli pominięto lub jeśli określisz pustą kolekcję, wszystkie istniejące odwołania do pakietów aplikacji zostaną usunięte z puli. W danej puli można określić maksymalnie 10 odwołań.
Wymagany. Ta lista zastępuje wszystkie istniejące odwołania do certyfikatów skonfigurowane w puli. Jeśli określisz pustą kolekcję, wszystkie istniejące odwołania do certyfikatów zostaną usunięte z puli. W przypadku węzłów systemu Windows usługa Batch instaluje certyfikaty w określonym magazynie certyfikatów i lokalizacji. W przypadku węzłów obliczeniowych systemu Linux certyfikaty są przechowywane w katalogu roboczym Zadanie, a zmienna środowiskowa AZ_BATCH_CERTIFICATES_DIR jest dostarczana do zadania, aby wykonać zapytanie o tę lokalizację. W przypadku certyfikatów z widocznością "remoteUser" katalog "certs" jest tworzony w katalogu głównym użytkownika (np. /home/{user-name}/certs) i certyfikaty są umieszczane w tym katalogu. Ostrzeżenie: Ta właściwość jest przestarzała i zostanie usunięta po lutym 2024 r. Zamiast tego użyj rozszerzenia Azure KeyVault.
Plik zawierający specyfikację parametru właściwości aktualizacji puli w formacie JSON (sformatowany w celu dopasowania do treści żądania interfejsu API REST). Jeśli ten parametr zostanie określony, wszystkie argumenty parametru aktualizacji puli zostaną zignorowane.
Wymagany. Ta lista zastępuje wszystkie istniejące metadane skonfigurowane w puli. Jeśli pominięto lub jeśli określisz pustą kolekcję, wszystkie istniejące metadane zostaną usunięte z puli.
Wiersz polecenia zadania uruchamiania. 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 korzystać 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.
Lista ustawień zmiennych środowiskowych dla zadania uruchamiania. Wartości rozdzielone spacjami w formacie "key=value".
Maksymalna liczba ponownych prób wykonania zadania.
Czy usługa Batch powinna czekać na pomyślne zakończenie zadania uruchamiania (czyli zakończenie z kodem zakończenia 0) przed zaplanowaniem zadań w węźle obliczeniowym. Prawda, jeśli flaga jest obecna, w przeciwnym razie wartość domyślna to False.
Parametry globalne
Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.
Pokaż ten komunikat pomocy i zakończ pracę.
Pokaż tylko błędy, pomijając ostrzeżenia.
Format danych wyjściowych.
Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.
Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID.
Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.
az batch pool resize
Zmiana rozmiaru lub zatrzymanie zmiany rozmiaru puli usługi Batch.
az batch pool resize --pool-id
[--abort]
[--account-endpoint]
[--account-key]
[--account-name]
[--if-match]
[--if-modified-since]
[--if-none-match]
[--if-unmodified-since]
[--node-deallocation-option {requeue, retaineddata, taskcompletion, terminate}]
[--resize-timeout]
[--target-dedicated-nodes]
[--target-low-priority-nodes]Parametry wymagane
Identyfikator puli.
Parametry opcjonalne
Zatrzymaj operację zmiany rozmiaru puli.
Punkt końcowy usługi Batch. Alternatywnie ustaw zmienną środowiskową: AZURE_BATCH_ENDPOINT.
Klucz konta usługi Batch. Alternatywnie ustaw zmienną środowiskową: AZURE_BATCH_ACCESS_KEY.
Nazwa konta usługi Batch. Alternatywnie ustaw zmienną środowiskową: AZURE_BATCH_ACCOUNT.
Operacja zostanie wykonana tylko wtedy, gdy bieżący element ETag zasobu dokładnie odpowiada określonej wartości.
Operacja zostanie wykonana tylko wtedy, gdy zasób został zmodyfikowany od określonego znacznika czasu.
Operacja nie zostanie wykonana tylko wtedy, gdy bieżący element ETag zasobu dokładnie pasuje do określonej wartości.
Operacja nie zostanie wykonana tylko wtedy, gdy zasób został zmodyfikowany od określonego znacznika czasu.
Gdy węzły mogą zostać usunięte z puli, jeśli rozmiar puli zostanie zmniejszony.
Wartość domyślna to 15 minut. Minimalna wartość to 5 minut. Jeśli określisz wartość mniejszą niż 5 minut, usługa Batch zwróci błąd; Jeśli bezpośrednio wywołujesz interfejs API REST, kod stanu HTTP to 400 (Nieprawidłowe żądanie).
Żądana liczba dedykowanych węzłów obliczeniowych w puli.
Żądana liczba węzłów obliczeniowych typu spot/o niskim priorytcie w puli.
Parametry globalne
Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.
Pokaż ten komunikat pomocy i zakończ pracę.
Pokaż tylko błędy, pomijając ostrzeżenia.
Format danych wyjściowych.
Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.
Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID.
Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.
az batch pool set
Zaktualizuj właściwości puli usługi Batch. Aktualizowanie właściwości w podgrupie spowoduje zresetowanie nieokreślonych właściwości tej grupy.
az batch pool set --pool-id
[--account-endpoint]
[--account-key]
[--account-name]
[--application-package-references]
[--certificate-references]
[--if-match]
[--if-modified-since]
[--if-none-match]
[--if-unmodified-since]
[--json-file]
[--metadata]
[--start-task-command-line]
[--start-task-environment-settings]
[--start-task-max-task-retry-count]
[--start-task-resource-files]
[--start-task-wait-for-success]
[--target-communication {classic, default, simplified}]Parametry wymagane
Identyfikator puli do zaktualizowania.
Parametry opcjonalne
Punkt końcowy usługi Batch. Alternatywnie ustaw zmienną środowiskową: AZURE_BATCH_ENDPOINT.
Klucz konta usługi Batch. Alternatywnie ustaw zmienną środowiskową: AZURE_BATCH_ACCESS_KEY.
Nazwa konta usługi Batch. Alternatywnie ustaw zmienną środowiskową: AZURE_BATCH_ACCOUNT.
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. Jeśli ten element jest obecny, zastępuje wszystkie istniejące odwołania do pakietu. Jeśli określisz pustą kolekcję, wszystkie odwołania do pakietu zostaną usunięte z puli. Jeśli pominięto, wszystkie istniejące odwołania do pakietu pozostaną niezmienione. Identyfikatory aplikacji rozdzielone spacjami z opcjonalną wersją w formacie "id[#version]".
Jeśli ten element jest obecny, zastępuje wszystkie istniejące odwołania do certyfikatów skonfigurowane w puli. W przypadku pominięcia wszystkie istniejące odwołania do certyfikatów pozostaną niezmienione. W przypadku węzłów systemu Windows usługa Batch instaluje certyfikaty w określonym magazynie certyfikatów i lokalizacji. W przypadku węzłów obliczeniowych systemu Linux certyfikaty są przechowywane w katalogu roboczym Zadanie, a zmienna środowiskowa AZ_BATCH_CERTIFICATES_DIR jest dostarczana do zadania, aby wykonać zapytanie o tę lokalizację. W przypadku certyfikatów z widocznością "remoteUser" katalog "certs" jest tworzony w katalogu głównym użytkownika (np. /home/{user-name}/certs) i certyfikaty są umieszczane w tym katalogu. Ostrzeżenie: Ta właściwość jest przestarzała i zostanie usunięta po lutym 2024 r. Zamiast tego użyj rozszerzenia Azure KeyVault. Odciski palca certyfikatu rozdzielane spacjami.
Wartość elementu ETag skojarzona z wersją zasobu znaną klientowi. Operacja zostanie wykonana tylko wtedy, gdy bieżący element ETag zasobu w usłudze dokładnie odpowiada wartości określonej przez klienta.
Sygnatura czasowa wskazująca czas ostatniej modyfikacji zasobu znanego klientowi. Operacja zostanie wykonana tylko wtedy, gdy zasób w usłudze został zmodyfikowany od określonego czasu.
Wartość elementu ETag skojarzona z wersją zasobu znaną klientowi. Operacja zostanie wykonana tylko wtedy, gdy bieżący element ETag zasobu w usłudze nie jest zgodny z wartością określoną przez klienta.
Sygnatura czasowa wskazująca czas ostatniej modyfikacji zasobu znanego klientowi. Operacja zostanie wykonana tylko wtedy, gdy zasób usługi nie został zmodyfikowany od określonego czasu.
Plik zawierający specyfikację parametru poprawki puli w formacie JSON (sformatowany w celu dopasowania do odpowiedniej treści interfejsu API REST). Jeśli ten parametr jest określony, wszystkie argumenty puli są ignorowane.
Jeśli ten element jest obecny, zastępuje wszystkie istniejące metadane skonfigurowane w puli. Jeśli określisz pustą kolekcję, wszystkie metadane zostaną usunięte z puli. Jeśli pominięto, wszystkie istniejące metadane pozostaną niezmienione. Wartości rozdzielone spacjami w formacie "key=value".
Wymagany. 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 korzystać 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://docs.microsoft.com/en-us/azure/batch/batch-compute-node-environment-variables).
Wartości rozdzielone spacjami w formacie "key=value".
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).
Pliki wymienione w ramach tego elementu znajdują się w katalogu roboczym zadania. Odwołania do zasobów rozdzielonych spacjami w formacie nazwa_pliku=httpurl.
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. Określ wartość "true" lub "false", aby zaktualizować właściwość.
Żądany tryb komunikacji węzła dla puli. Jeśli ten element jest obecny, zastępuje istniejący element targetNodeCommunicationMode skonfigurowany w puli. Jeśli pominięto, wszystkie istniejące metadane pozostaną niezmienione.
Parametry globalne
Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.
Pokaż ten komunikat pomocy i zakończ pracę.
Pokaż tylko błędy, pomijając ostrzeżenia.
Format danych wyjściowych.
Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.
Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID.
Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.
az batch pool show
Pobiera informacje o określonej puli.
az batch pool show --pool-id
[--account-endpoint]
[--account-key]
[--account-name]
[--expand]
[--if-match]
[--if-modified-since]
[--if-none-match]
[--if-unmodified-since]
[--select]Parametry wymagane
Identyfikator puli do pobrania.
Parametry opcjonalne
Punkt końcowy usługi Batch. Alternatywnie ustaw zmienną środowiskową: AZURE_BATCH_ENDPOINT.
Klucz konta usługi Batch. Alternatywnie ustaw zmienną środowiskową: AZURE_BATCH_ACCESS_KEY.
Nazwa konta usługi Batch. Alternatywnie ustaw zmienną środowiskową: AZURE_BATCH_ACCOUNT.
Klauzula OData $expand.
Wartość elementu ETag skojarzona z wersją zasobu znaną klientowi. Operacja zostanie wykonana tylko wtedy, gdy bieżący element ETag zasobu w usłudze dokładnie odpowiada wartości określonej przez klienta.
Sygnatura czasowa wskazująca czas ostatniej modyfikacji zasobu znanego klientowi. Operacja zostanie wykonana tylko wtedy, gdy zasób w usłudze został zmodyfikowany od określonego czasu.
Wartość elementu ETag skojarzona z wersją zasobu znaną klientowi. Operacja zostanie wykonana tylko wtedy, gdy bieżący element ETag zasobu w usłudze nie jest zgodny z wartością określoną przez klienta.
Sygnatura czasowa wskazująca czas ostatniej modyfikacji zasobu znanego klientowi. Operacja zostanie wykonana tylko wtedy, gdy zasób usługi nie został zmodyfikowany od określonego czasu.
Klauzula OData $select.
Parametry globalne
Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.
Pokaż ten komunikat pomocy i zakończ pracę.
Pokaż tylko błędy, pomijając ostrzeżenia.
Format danych wyjściowych.
Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.
Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID.
Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.
