az batch pool

  • Odwołanie

Zarządzanie pulami usługi Batch.

Polecenia

az batch pool all-statistics

Wyświetl statystyki wszystkich pul w ramach konta usługi Batch.
az batch pool all-statistics show

Uzyskaj statystyki podsumowania okresu istnienia dla wszystkich pul na koncie usługi Batch.
az batch pool autoscale

Zarządzanie automatycznym skalowaniem pul usługi Batch.
az batch pool autoscale disable

Wyłącza automatyczne skalowanie dla puli.
az batch pool autoscale enable

Włącza automatyczne skalowanie dla puli.
az batch pool autoscale evaluate

Pobiera wynik oceny formuły automatycznego skalowania w puli.
az batch pool create

Utwórz pulę usługi Batch na koncie. Podczas tworzenia puli wybierz argumenty z konfiguracji Cloud Services lub konfiguracji maszyny wirtualnej.
az batch pool delete

Usuwa pulę z określonego konta.
az batch pool list

Wyświetla listę wszystkich pul w określonym koncie.
az batch pool node-counts

Pobieranie liczby węzłów dla pul usługi Batch.
az batch pool node-counts list

Pobiera liczbę węzłów obliczeniowych w każdym stanie pogrupowanych według puli.
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 resize

Zmień rozmiar puli usługi Batch lub zatrzymaj jej zmianę.
az batch pool set

Zaktualizuj właściwości puli usługi Batch. Aktualizacja właściwości w podgrupie spowoduje zresetowanie nieokreślonych właściwości tej grupy.
az batch pool show

Pobiera informacje o określonej puli.
az batch pool supported-images

Wykonywanie zapytań dotyczących obrazów maszyn wirtualnych obsługiwanych przez usługę Azure Batch.
az batch pool supported-images list

Wyświetla listę wszystkich obrazów maszyn wirtualnych obsługiwanych przez usługę Azure Batch.
az batch pool usage-metrics

Wyświetlanie metryk użycia pul usługi Batch.
az batch pool usage-metrics list

Wyświetla listę metryk użycia zagregowanych według puli w poszczególnych interwałach czasowych dla określonego konta.

az batch pool create

Edytuj

Utwórz pulę usługi Batch na koncie. Podczas tworzenia puli wybierz argumenty z konfiguracji 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 {2, 3, 4, 5, 6}]
                     [--os-version]
                     [--policy {regional, zonal}]
                     [--resize-timeout]
                     [--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]
                     [--vm-size]

Parametry opcjonalne

--account-endpoint

Punkt końcowy usługi Batch. Alternatywnie ustaw zmienną środowiskową: AZURE_BATCH_ENDPOINT.

--account-key

Klucz konta usługi Batch. Alternatywnie ustaw zmienną środowiskową: AZURE_BATCH_ACCESS_KEY.

--account-name

Nazwa konta usługi Batch. Alternatywnie ustaw zmienną środowiskową: AZURE_BATCH_ACCOUNT.

--application-licenses

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.

--application-package-references

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 ponownie z obrazu. W dowolnej puli istnieje maksymalnie 10 odwołań do pakietu. Identyfikatory aplikacji rozdzielone spacjami z opcjonalną wersją w formacie "id[#version]".

--auto-scale-formula

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/.

--certificate-references

W przypadku węzłów Windows usługa Batch instaluje certyfikaty w określonym magazynie i lokalizacji certyfikatów. W przypadku węzłów obliczeniowych systemu Linux certyfikaty są przechowywane w katalogu roboczym Zadania, a zmienna środowiskowa AZ_BATCH_CERTIFICATES_DIR jest dostarczana do zadania w celu wykonania zapytania 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. Odciski palca certyfikatu rozdzielone spacjami.

--disk-encryption-targets

Rozdzielona spacją lista DiskEncryptionTargets. bieżące możliwe wartości obejmują OsDisk i TemporaryDisk.

--enable-inter-node-communication

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. Wartość True, jeśli flaga jest obecna.

--id

Wymagane. 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 nie ma dwóch identyfikatorów puli, które różnią się tylko wielkością liter).

--image

Dokumentacja obrazu systemu operacyjnego. Może to być format "publisher:offer:sku[:version]" lub w pełni kwalifikowany identyfikator obrazu usługi ARM w postaci "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Compute/images/{imageName}". Jeśli format "publisher:offer:sku[:version]", wersja jest opcjonalna i 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".

--json-file

Plik zawierający specyfikację puli w formacie JSON (sformatowany w celu dopasowania do odpowiedniej treści interfejsu API REST). Jeśli ten parametr jest określony, wszystkie argumenty "{group_title(arg[0])}" są ignorowane.

--metadata

Usługa Batch nie przypisuje żadnego znaczenia do metadanych; jest on przeznaczony wyłącznie do korzystania z kodu użytkownika. Wartości rozdzielone spacjami w formacie "key=value".

--node-agent-sku-id

Wymagane. Agent węzła obliczeniowego usługi Batch to program, który działa w każdym węźle obliczeniowym w puli i udostępnia interfejs 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".

--os-family

Wymagane. Możliwe wartości to: 2 — rodzina systemów operacyjnych 2, równoważna Windows Server 2008 R2 SP1. 3 — Rodzina systemu operacyjnego 3, równoważna Windows Server 2012. 4 — Rodzina systemów operacyjnych 4, równoważna Windows Server 2012 R2. 5 — Rodzina systemu operacyjnego 5, równoważna Windows Server 2016. 6 — Rodzina systemów operacyjnych 6, równoważna Windows Server 2019. Aby uzyskać więcej informacji, zobacz Wersje systemu operacyjnego gościa platformy Azure (https://azure.microsoft.com/documentation/articles/cloud-services-guestos-update-matrix/#releases).

akceptowane wartości: 2, 3, 4, 5, 6
--os-version

Wartość domyślna określa * najnowszą wersję systemu operacyjnego dla określonej rodziny systemów operacyjnych.

--policy

Typ zasad umieszczania węzłów 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.

akceptowane wartości: regional, zonal
--resize-timeout

Ten limit czasu dotyczy tylko skalowania ręcznego; nie ma żadnego efektu, gdy właściwość enableAutoScale jest ustawiona na wartość true. Wartość domyślna to 15 minut. Wartość minimalna 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.

--start-task-command-line

Wymagane. Wiersz polecenia nie jest uruchamiany w powłoce i dlatego nie może korzystać z funkcji powłoki, takich jak rozszerzanie zmiennych środowiskowych. 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 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ę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).

--start-task-resource-files

Pliki wymienione w tym elemecie znajdują się w katalogu roboczym zadania. Odwołania do zasobów rozdzielonych spacjami w formacie nazwa_pliku=httpurl.

--start-task-wait-for-success

Określa, czy usługa Batch powinna czekać na pomyślne zakończenie zadania StartTask (czyli zakończenie pracy z kodem zakończenia 0) przed zaplanowaniem jakichkolwiek zadań w węźle obliczeniowym. Jeśli wartość true i zadanie StartTask zakończy się niepowodzeniem w węźle, usługa Batch ponawia próbę uruchomienia do maksymalnej liczby ponownych prób (maxTaskRetryCount). Jeśli zadanie nadal nie zostało ukończone pomyślnie po wszystkich 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 informacji o stanie węzła obliczeniowego i 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 zadanie StartTask jest nadal uruchomione; 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. Wartość True, jeśli flaga jest obecna.

--target-dedicated-nodes

Żądana liczba dedykowanych węzłów obliczeniowych w puli. Nie można określić tej właściwości, jeśli właściwość enableAutoScale jest ustawiona na wartość true. Jeśli parametr enableAutoScale ma wartość false, musisz ustawić wartość targetDedicatedNodes, targetLowPriorityNodes lub oba te węzły.

--target-low-priority-nodes

Żądana liczba węzłów obliczeniowych typu spot/low-priority w puli. Nie można określić tej właściwości, jeśli właściwość enableAutoScale jest ustawiona na wartość true. Jeśli parametr enableAutoScale ma wartość false, musisz ustawić wartość targetDedicatedNodes, targetLowPriorityNodes lub oba te węzły.

--targets

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 Windows należy określić wartości "OsDisk" i "TemporaryDisk". Miejsca oddzielone dyski docelowe do szyfrowania. Wartości mogą być wartościami OsDisk lub TemporaryDisk.

--task-slots-per-node

Liczba miejsc zadań, których można użyć do uruchamiania współbieżnych zadań w jednym węźle obliczeniowym w puli. Wartość domyślna to 1. Wartość maksymalna to 4 razy mniejsza liczba rdzeni rozmiaru maszyny wirtualnej puli lub 256.

--vm-size

Wymagane. Aby uzyskać informacje o dostępnych rozmiarach maszyn wirtualnych dla pul Cloud Services (pul utworzonych za pomocą funkcji cloudServiceConfiguration), zobacz Rozmiary dla Cloud Services (https://azure.microsoft.com/documentation/articles/cloud-services-sizes-specs/). Usługa Batch obsługuje wszystkie rozmiary maszyn wirtualnych 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 Virtual Machines Marketplace (pule utworzone za pomocą polecenia virtualMachineConfiguration), zobacz Rozmiary dla Virtual Machines (Linux) (https://azure.microsoft.com/documentation/articles/virtual-machines-linux-sizes/)lub Rozmiary dla Virtual Machines (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 tych z magazynem w warstwie Premium (STANDARD_GS, STANDARD_DS i serii STANDARD_DSV2).

az batch pool delete

Edytuj

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 jakby zażądano 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. Zadania można następnie uruchamiać w nowej puli. Jeśli chcesz zastąpić zachowanie ponownego kolejkowania, przed usunięciem puli należy jawnie wywołać metodę zmiany rozmiaru puli, aby zmniejszyć pulę do zera. Jeśli wywołasz interfejs API aktualizacji, poprawki 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

--pool-id

Identyfikator puli do usunięcia.

Parametry opcjonalne

--account-endpoint

Punkt końcowy usługi Batch. Alternatywnie ustaw zmienną środowiskową: AZURE_BATCH_ENDPOINT.

--account-key

Klucz konta usługi Batch. Alternatywnie ustaw zmienną środowiskową: AZURE_BATCH_ACCESS_KEY.

--account-name

Nazwa konta usługi Batch. Alternatywnie ustaw zmienną środowiskową: AZURE_BATCH_ACCOUNT.

--if-match

Wartość elementu ETag skojarzona z wersją zasobu znanego klientowi. Operacja zostanie wykonana tylko wtedy, gdy bieżący element ETag zasobu w usłudze dokładnie odpowiada wartości określonej przez klienta.

--if-modified-since

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.

--if-none-match

Wartość elementu ETag skojarzona z wersją zasobu znanego klientowi. Operacja zostanie wykonana tylko wtedy, gdy bieżący element ETag zasobu w usłudze jest niezgodny z wartością określoną przez klienta.

--if-unmodified-since

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.

--yes -y

Nie monituj o potwierdzenie.

az batch pool list

Edytuj

Wyświetla listę wszystkich pul w określonym koncie.

az batch pool list [--account-endpoint]
                   [--account-key]
                   [--account-name]
                   [--expand]
                   [--filter]
                   [--select]

Parametry opcjonalne

--account-endpoint

Punkt końcowy usługi Batch. Alternatywnie ustaw zmienną środowiskową: AZURE_BATCH_ENDPOINT.

--account-key

Klucz konta usługi Batch. Alternatywnie ustaw zmienną środowiskową: AZURE_BATCH_ACCESS_KEY.

--account-name

Nazwa konta usługi Batch. Alternatywnie ustaw zmienną środowiskową: AZURE_BATCH_ACCOUNT.

--rozwiń

Klauzula OData $expand.

--filter

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.

--select

Klauzula OData $select.

az batch pool reset

Edytuj

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

--pool-id

Identyfikator puli do zaktualizowania.

Parametry opcjonalne

--account-endpoint

Punkt końcowy usługi Batch. Alternatywnie ustaw zmienną środowiskową: AZURE_BATCH_ENDPOINT.

--account-key

Klucz konta usługi Batch. Alternatywnie ustaw zmienną środowiskową: AZURE_BATCH_ACCESS_KEY.

--account-name

Nazwa konta usługi Batch. Alternatywnie ustaw zmienną środowiskową: AZURE_BATCH_ACCOUNT.

--application-package-references

Wymagane. 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 z obrazu. W dowolnej puli istnieje maksymalnie 10 odwołań do pakietu aplikacji. W przypadku pominięcia lub określenia pustej kolekcji 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ń.

--certificate-references

Wymagane. 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 Windows usługa Batch instaluje certyfikaty w określonym magazynie i lokalizacji certyfikatów. W przypadku węzłów obliczeniowych systemu Linux certyfikaty są przechowywane w katalogu roboczym Zadania, a zmienna środowiskowa AZ_BATCH_CERTIFICATES_DIR jest dostarczana do zadania w celu wykonania zapytania 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.

--json-file

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.

--metadata

Wymagane. Ta lista zastępuje wszystkie istniejące metadane skonfigurowane w puli. W przypadku pominięcia lub określenia pustej kolekcji wszystkie istniejące metadane zostaną usunięte z puli.

--start-task-command-line

Wiersz polecenia zadania uruchamiania. Wiersz polecenia nie jest uruchamiany w powłoce i dlatego nie może korzystać z funkcji powłoki, takich jak rozszerzanie zmiennych środowiskowych. 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 Windows lub "/bin/sh -c MyCommand" w systemie Linux.

--start-task-environment-settings

Lista ustawień zmiennych środowiskowych dla zadania uruchamiania. Wartości rozdzielone spacjami w formacie "key=value".

--start-task-max-task-retry-count

Maksymalna liczba ponownych prób wykonania zadania.

--start-task-wait-for-success

Określa, czy usługa Batch powinna czekać na pomyślne zakończenie zadania uruchamiania (czyli zakończenie pracy z kodem zakończenia 0) przed zaplanowaniem zadań w węźle obliczeniowym. Wartość True, jeśli flaga jest obecna, w przeciwnym razie wartość domyślna to False.

az batch pool resize

Edytuj

Zmień rozmiar puli usługi Batch lub zatrzymaj jej zmianę.

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

--pool-id

Identyfikator puli.

Parametry opcjonalne

--abort

Zatrzymaj operację zmiany rozmiaru puli.

--account-endpoint

Punkt końcowy usługi Batch. Alternatywnie ustaw zmienną środowiskową: AZURE_BATCH_ENDPOINT.

--account-key

Klucz konta usługi Batch. Alternatywnie ustaw zmienną środowiskową: AZURE_BATCH_ACCESS_KEY.

--account-name

Nazwa konta usługi Batch. Alternatywnie ustaw zmienną środowiskową: AZURE_BATCH_ACCOUNT.

--if-match

Operacja zostanie wykonana tylko wtedy, gdy bieżący element ETag zasobu dokładnie odpowiada określonej wartości.

--if-modified-since

Operacja zostanie wykonana tylko wtedy, gdy zasób został zmodyfikowany od określonego znacznika czasu.

--if-none-match

Operacja nie zostanie wykonana tylko wtedy, gdy bieżący element ETag zasobu dokładnie odpowiada określonej wartości.

--if-unmodified-since

Operacja nie zostanie wykonana tylko wtedy, gdy zasób został zmodyfikowany od określonego znacznika czasu.

--node-deallocation-option

Gdy węzły mogą zostać usunięte z puli, jeśli rozmiar puli zostanie zmniejszony.

akceptowane wartości: requeue, retaineddata, taskcompletion, terminate
--resize-timeout

Wartość domyślna to 15 minut. Wartość minimalna 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).

--target-dedicated-nodes

Żądana liczba dedykowanych węzłów obliczeniowych w puli.

--target-low-priority-nodes

Żądana liczba węzłów obliczeniowych typu spot/low-priority w puli.

az batch pool set

Edytuj

Zaktualizuj właściwości puli usługi Batch. Aktualizacja 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]

Parametry wymagane

--pool-id

Identyfikator puli do zaktualizowania.

Parametry opcjonalne

--account-endpoint

Punkt końcowy usługi Batch. Alternatywnie ustaw zmienną środowiskową: AZURE_BATCH_ENDPOINT.

--account-key

Klucz konta usługi Batch. Alternatywnie ustaw zmienną środowiskową: AZURE_BATCH_ACCESS_KEY.

--account-name

Nazwa konta usługi Batch. Alternatywnie ustaw zmienną środowiskową: AZURE_BATCH_ACCOUNT.

--application-package-references

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 ponownie z obrazu. 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. W przypadku pominięcia wszystkie istniejące odwołania do pakietu pozostaną niezmienione. Identyfikatory aplikacji rozdzielone spacjami z opcjonalną wersją w formacie "id[#version]".

--certificate-references

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 Windows usługa Batch instaluje certyfikaty w określonym magazynie i lokalizacji certyfikatów. W przypadku węzłów obliczeniowych systemu Linux certyfikaty są przechowywane w katalogu roboczym Zadania, a zmienna środowiskowa AZ_BATCH_CERTIFICATES_DIR jest dostarczana do zadania w celu wykonania zapytania 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. Odciski palca certyfikatu rozdzielone spacjami.

--if-match

Wartość elementu ETag skojarzona z wersją zasobu znanego klientowi. Operacja zostanie wykonana tylko wtedy, gdy bieżący element ETag zasobu w usłudze dokładnie odpowiada wartości określonej przez klienta.

--if-modified-since

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.

--if-none-match

Wartość elementu ETag skojarzona z wersją zasobu znanego klientowi. Operacja zostanie wykonana tylko wtedy, gdy bieżący element ETag zasobu w usłudze jest niezgodny z wartością określoną przez klienta.

--if-unmodified-since

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.

--json-file

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 "{group_title(arg[0])}" są ignorowane.

--metadata

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".

--start-task-command-line

Wymagane. Wiersz polecenia nie jest uruchamiany w powłoce i dlatego nie może korzystać z funkcji powłoki, takich jak rozszerzanie zmiennych środowiskowych. 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 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ę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).

--start-task-environment-settings

Wartości rozdzielone spacjami w formacie "key=value".

--start-task-max-task-retry-count

Maksymalna liczba ponownych prób wykonania zadania. Usługa Batch ponawia próbę zadania, jeśli jego kod zakończenia jest niezerowy. Należy pamiętać, że ta wartość określa w szczególności 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 maksymalnie 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.

--start-task-resource-files

Pliki wymienione w tym elemecie znajdują się w katalogu roboczym zadania. Odwołania do zasobów rozdzielonych spacjami w formacie nazwa_pliku=httpurl.

--start-task-wait-for-success

Określa, czy usługa Batch powinna czekać na pomyślne zakończenie zadania StartTask (czyli zakończenie pracy z kodem zakończenia 0) przed zaplanowaniem jakichkolwiek zadań w węźle obliczeniowym. Jeśli wartość true i zadanie StartTask zakończy się niepowodzeniem w węźle, usługa Batch ponawia próbę uruchomienia do maksymalnej liczby ponownych prób (maxTaskRetryCount). Jeśli zadanie nadal nie zostało ukończone pomyślnie po wszystkich 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 informacji o stanie węzła obliczeniowego i 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 zadanie StartTask jest nadal uruchomione; 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ść.

az batch pool show

Edytuj

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

--pool-id

Identyfikator puli do pobrania.

Parametry opcjonalne

--account-endpoint

Punkt końcowy usługi Batch. Alternatywnie ustaw zmienną środowiskową: AZURE_BATCH_ENDPOINT.

--account-key

Klucz konta usługi Batch. Alternatywnie ustaw zmienną środowiskową: AZURE_BATCH_ACCESS_KEY.

--account-name

Nazwa konta usługi Batch. Alternatywnie ustaw zmienną środowiskową: AZURE_BATCH_ACCOUNT.

--rozwiń

Klauzula OData $expand.

--if-match

Wartość elementu ETag skojarzona z wersją zasobu znanego klientowi. Operacja zostanie wykonana tylko wtedy, gdy bieżący element ETag zasobu w usłudze dokładnie odpowiada wartości określonej przez klienta.

--if-modified-since

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.

--if-none-match

Wartość elementu ETag skojarzona z wersją zasobu znanego klientowi. Operacja zostanie wykonana tylko wtedy, gdy bieżący element ETag zasobu w usłudze jest niezgodny z wartością określoną przez klienta.

--if-unmodified-since

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.

--select

Klauzula OData $select.