Udostępnij za pośrednictwem


az batch job

Zarządzanie zadaniami usługi Batch.

Polecenia

Nazwa Opis Typ Stan
az batch job create

Dodaj zadanie do konta usługi Batch.

Rdzeń GA
az batch job delete

Usuwa zadanie z konta usługi Batch.

Rdzeń GA
az batch job disable

Wyłącz zadanie usługi Batch.

Rdzeń GA
az batch job enable

Włącz zadanie usługi Batch.

Rdzeń GA
az batch job list

Wyświetl listę wszystkich zadań lub harmonogramu zadań na koncie usługi Batch.

Rdzeń GA
az batch job prep-release-status

Wyświetlanie stanu zadań przygotowywania i wydawania zadań podrzędnych w usłudze Batch.

Rdzeń GA
az batch job prep-release-status list

Wyświetla stan wykonywania zadania przygotowania i zwolnienia zadania dla określonego zadania w węzłach obliczeniowych, w których zostało uruchomione zadanie.

Rdzeń GA
az batch job reset

Zaktualizuj właściwości zadania usługi Batch. Nieokreślone właściwości, które można zaktualizować, są resetowane do ich wartości domyślnych.

Rdzeń GA
az batch job set

Zaktualizuj właściwości zadania usługi Batch. Aktualizowanie właściwości w podgrupie spowoduje zresetowanie nieokreślonych właściwości tej grupy.

Rdzeń GA
az batch job show

Pobiera informacje o określonym zadaniu usługi Batch.

Rdzeń GA
az batch job stop

Zatrzymaj uruchomione zadanie usługi Batch.

Rdzeń GA
az batch job task-counts

Wyświetl liczbę zadań i miejsc w zadaniu usługi Batch i ich stanach.

Rdzeń GA
az batch job task-counts show

Pobiera liczbę zadań dla określonego zadania.

Rdzeń GA

az batch job create

Dodaj zadanie do konta usługi Batch.

az batch job create [--account-endpoint]
                    [--account-key]
                    [--account-name]
                    [--allow-task-preemption]
                    [--id]
                    [--job-manager-task-application-package-references]
                    [--job-manager-task-command-line]
                    [--job-manager-task-environment-settings]
                    [--job-manager-task-id]
                    [--job-manager-task-resource-files]
                    [--job-max-task-retry-count]
                    [--job-max-wall-clock-time]
                    [--json-file]
                    [--max-parallel-tasks]
                    [--metadata]
                    [--on-all-tasks-complete]
                    [--pool-id]
                    [--priority]
                    [--required-slots]
                    [--uses-task-dependencies]

Przykłady

Utwórz nowe zadanie skojarzone z istniejącą pulą.

az batch job create --id job1 --pool-id pool1

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.

--allow-task-preemption

Czy zadania podrzędne w tym zadaniu mogą zostać wywłaszczone przez inne zadania o wysokim priorytcie. Jeśli wartość ma wartość True, inne zadania o wysokim priorytcie 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. Prawda, jeśli flaga jest obecna.

--id

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). Wymagane.

--job-manager-task-application-package-references

Lista pakietów aplikacji wdrożonych przez usługę Batch w węźle obliczeniowym przed uruchomieniem wiersza polecenia. Pakiety aplikacji są pobierane i wdrażane w katalogu udostępnionym, a nie w katalogu roboczym Zadanie. W związku z tym, jeśli przywoływanego pakietu aplikacji znajduje się już w węźle obliczeniowym i jest aktualny, nie jest on ponownie pobierany; używana jest istniejąca kopia w węźle obliczeniowym. Jeśli nie można zainstalować przywoływanego pakietu aplikacji, na przykład ze względu na to, że pakiet został usunięty lub pobieranie nie powiodło się, zadanie kończy się niepowodzeniem. Identyfikatory aplikacji rozdzielone spacjami z opcjonalną wersją w formacie "id[#version]".

--job-manager-task-command-line

Wiersz polecenia 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://docs.microsoft.com/en-us/azure/batch/batch-compute-node-environment-variables). Wymagane.

--job-manager-task-environment-settings

Lista ustawień zmiennych środowiskowych dla zadania Menedżera zadań. Wartości rozdzielone spacjami w formacie "key=value".

--job-manager-task-id

Ciąg, który jednoznacznie identyfikuje zadanie Menedżera zadań w ramach zadania. 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. Wymagane.

--job-manager-task-resource-files

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. Odwołania do zasobów rozdzielonych spacjami w formacie nazwa_pliku=httpurl.

--job-max-task-retry-count

Maksymalna liczba ponownych prób wykonania każdego 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 każde 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 ponawia ponawia próby zadań. Jeśli maksymalna liczba ponownych prób wynosi -1, usługa Batch ponawia próby zadania bez limitu. Wartość domyślna to 0 (bez ponownych prób).

--job-max-wall-clock-time

Maksymalny czas, przez który zadanie może zostać uruchomiony, mierzony od momentu utworzenia zadania. Jeśli zadanie nie zostanie ukończone w limicie czasu, usługa Batch zakończy je i wszystkie zadania, które są nadal uruchomione. W takim przypadku przyczyną zakończenia będzie MaxWallClockTimeExpiry. Jeśli ta właściwość nie zostanie określona, nie ma limitu czasu na czas uruchomienia zadania. Oczekiwany format to czas trwania ISO-8601.

--json-file

Plik zawierający specyfikację zadania w formacie JSON (sformatowany w celu dopasowania do odpowiedniej treści interfejsu API REST). Jeśli ten parametr jest określony, wszystkie argumenty zadania są ignorowane.

--max-parallel-tasks

Maksymalna liczba zadań, które mogą być wykonywane równolegle dla zadania. Wartość parametru maxParallelTasks musi być -1 lub większa niż 0, jeśli jest 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. Wartości rozdzielone spacjami w formacie "key=value".

--on-all-tasks-complete

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. Znane wartości to: "noaction" i "terminatejob".

--pool-id

Identyfikator istniejącej puli. Wszystkie zadania zadania zadania zostaną uruchomione w określonej puli. Upewnij się, że pula, do której odwołuje się ta właściwość, istnieje. Jeśli pula nie istnieje w czasie, gdy usługa Batch próbuje zaplanować zadanie, żadne zadania dla zadania nie będą uruchamiane do momentu utworzenia puli o tym identyfikatorze. Należy pamiętać, że usługa Batch nie odrzuci żądania zadania; po prostu nie będzie uruchamiać zadań, dopóki pula nie istnieje. Należy określić identyfikator puli lub specyfikację puli automatycznej, ale nie obie.

--priority

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.

--required-slots

Liczba miejsc planowania, których wymaga uruchomienie zadania. Wartość domyślna to 1. Zadanie można zaplanować tylko w węźle obliczeniowym, jeśli węzeł ma wystarczającą ilość dostępnych wolnych miejsc planowania. W przypadku zadań z wieloma wystąpieniami ta właściwość nie jest obsługiwana i nie może być określona.

--uses-task-dependencies

Czy zadania w zadaniu mogą definiować zależności od siebie. Wartość domyślna to false. Prawda, jeśli flaga jest obecna.

Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

--output -o

Format danych wyjściowych.

Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc
Domyślna wartość: json
--query

Ciąg zapytania JMESPath. Aby uzyskać więcej informacji i przykładów, zobacz http://jmespath.org/.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

az batch job delete

Usuwa zadanie z konta usługi Batch.

az batch job delete --job-id
                    [--account-endpoint]
                    [--account-key]
                    [--account-name]
                    [--if-match]
                    [--if-modified-since]
                    [--if-none-match]
                    [--if-unmodified-since]
                    [--yes]

Przykłady

Usuń zadanie przy użyciu identyfikatora zadania bez monitu o potwierdzenie.

az batch job delete --job-id job1 --yes

Parametry wymagane

--job-id

Identyfikator zadania do usunięcia. Wymagane.

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

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

--if-unmodified-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.

--yes -y

Nie monituj o potwierdzenie.

Domyślna wartość: False
Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

--output -o

Format danych wyjściowych.

Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc
Domyślna wartość: json
--query

Ciąg zapytania JMESPath. Aby uzyskać więcej informacji i przykładów, zobacz http://jmespath.org/.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

az batch job disable

Wyłącz zadanie usługi Batch.

az batch job disable --job-id
                     [--account-endpoint]
                     [--account-key]
                     [--account-name]
                     [--disable-tasks]
                     [--if-match]
                     [--if-modified-since]
                     [--if-none-match]
                     [--if-unmodified-since]
                     [--json-file]

Przykłady

Wyłącz zadanie i ponownie utwórz kolejkę wszystkich uruchomionych zadań.

az batch job disable --job-id job1 --disable-tasks requeue

Parametry wymagane

--job-id

Identyfikator zadania do wyłączenia. Wymagane.

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.

--disable-tasks

Co zrobić z aktywnymi zadaniami skojarzonymi z zadaniem. Wymagane. Znane wartości to: "requeue", "terminate" i "wait".

--if-match

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.

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

--if-unmodified-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.

--json-file

Plik zawierający specyfikację zawartości w formacie JSON (sformatowany w celu dopasowania do odpowiedniej treści interfejsu API REST). Jeśli ten parametr zostanie określony, wszystkie argumenty zawartości są ignorowane.

Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

--output -o

Format danych wyjściowych.

Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc
Domyślna wartość: json
--query

Ciąg zapytania JMESPath. Aby uzyskać więcej informacji i przykładów, zobacz http://jmespath.org/.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

az batch job enable

Włącz zadanie usługi Batch.

az batch job enable --job-id
                    [--account-endpoint]
                    [--account-key]
                    [--account-name]
                    [--if-match]
                    [--if-modified-since]
                    [--if-none-match]
                    [--if-unmodified-since]

Przykłady

Włącz zadanie.

az batch job enable --job-id job1

Parametry wymagane

--job-id

Identyfikator zadania do włączenia. Wymagane.

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

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

--if-unmodified-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.

Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

--output -o

Format danych wyjściowych.

Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc
Domyślna wartość: json
--query

Ciąg zapytania JMESPath. Aby uzyskać więcej informacji i przykładów, zobacz http://jmespath.org/.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

az batch job list

Wyświetl listę wszystkich zadań lub harmonogramu zadań na koncie usługi Batch.

az batch job list [--account-endpoint]
                  [--account-key]
                  [--account-name]
                  [--expand]
                  [--filter]
                  [--job-schedule-id]
                  [--select]

Przykłady

Wyświetlanie listy wszystkich zadań na koncie usługi Batch

az batch job list

Wyświetlanie listy wszystkich harmonogramów zadań na koncie usługi Batch

az batch job list --job-schedule-id jobschedule1

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. Wymagane jest tylko ustawienie zmiennej środowiskowej według zmiennej środowiskowej: AZURE_BATCH_ACCOUNT.

--expand

Klauzula OData $expand.

--filter

Klauzula OData $filter. Aby uzyskać więcej informacji na temat konstruowania tego filtru, zobacz https://learn.microsoft.com/rest/api/batchservice/odata-filters-in-batch.

--job-schedule-id

Identyfikator harmonogramu zadań, z którego chcesz uzyskać listę zadań. W przypadku pominięcia wyświetla listę wszystkich zadań na koncie.

--select

Klauzula OData $select.

Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

--output -o

Format danych wyjściowych.

Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc
Domyślna wartość: json
--query

Ciąg zapytania JMESPath. Aby uzyskać więcej informacji i przykładów, zobacz http://jmespath.org/.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

az batch job reset

Zaktualizuj właściwości zadania usługi Batch. Nieokreślone właściwości, które można zaktualizować, są resetowane do ich wartości domyślnych.

az batch job reset --job-id
                   [--account-endpoint]
                   [--account-key]
                   [--account-name]
                   [--allow-task-preemption]
                   [--if-match]
                   [--if-modified-since]
                   [--if-none-match]
                   [--if-unmodified-since]
                   [--job-max-task-retry-count]
                   [--job-max-wall-clock-time]
                   [--json-file]
                   [--max-parallel-tasks]
                   [--metadata]
                   [--on-all-tasks-complete]
                   [--pool-id]
                   [--priority]

Przykłady

Zresetuj wszystkie właściwości zadania z wyjątkiem priorytetu.

az batch job reset --job-id job1 --priority 100

Parametry wymagane

--job-id

Identyfikator zadania, którego właściwości chcesz zaktualizować. Wymagane.

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.

--allow-task-preemption

Czy zadania podrzędne w tym zadaniu mogą zostać wywłaszczone przez inne zadania o wysokim priorytcie. Jeśli wartość ma wartość True, inne zadania o wysokim priorytcie 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. Prawda, jeśli flaga jest obecna.

--if-match

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.

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

--if-unmodified-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.

--job-max-task-retry-count

Maksymalna liczba ponownych prób wykonania każdego 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 każde 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 ponawia ponawia próby zadań. Jeśli maksymalna liczba ponownych prób wynosi -1, usługa Batch ponawia próby zadania bez limitu. Wartość domyślna to 0 (bez ponownych prób).

--job-max-wall-clock-time

Maksymalny czas, przez który zadanie może zostać uruchomiony, mierzony od momentu utworzenia zadania. Jeśli zadanie nie zostanie ukończone w limicie czasu, usługa Batch zakończy je i wszystkie zadania, które są nadal uruchomione. W takim przypadku przyczyną zakończenia będzie MaxWallClockTimeExpiry. Jeśli ta właściwość nie zostanie określona, nie ma limitu czasu na czas uruchomienia zadania. Oczekiwany format to czas trwania ISO-8601.

--json-file

Plik zawierający specyfikację zadania w formacie JSON (sformatowany w celu dopasowania do odpowiedniej treści interfejsu API REST). Jeśli ten parametr jest określony, wszystkie argumenty zadania są ignorowane.

--max-parallel-tasks

Maksymalna liczba zadań, które mogą być wykonywane równolegle dla zadania. Wartość parametru maxParallelTasks musi być -1 lub większa niż 0, jeśli jest 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. Wartości rozdzielone spacjami w formacie "key=value".

--on-all-tasks-complete

Akcja, jaką usługa Batch powinna wykonać, gdy wszystkie zadania w zadaniu są w stanie ukończonym. Wartość domyślna to noaction. Znane wartości to: "noaction" i "terminatejob".

--pool-id

Identyfikator istniejącej puli. Wszystkie zadania zadania zadania zostaną uruchomione w określonej puli. Upewnij się, że pula, do której odwołuje się ta właściwość, istnieje. Jeśli pula nie istnieje w czasie, gdy usługa Batch próbuje zaplanować zadanie, żadne zadania dla zadania nie będą uruchamiane do momentu utworzenia puli o tym identyfikatorze. Należy pamiętać, że usługa Batch nie odrzuci żądania zadania; po prostu nie będzie uruchamiać zadań, dopóki pula nie istnieje. Należy określić identyfikator puli lub specyfikację puli automatycznej, ale nie obie.

--priority

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.

Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

--output -o

Format danych wyjściowych.

Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc
Domyślna wartość: json
--query

Ciąg zapytania JMESPath. Aby uzyskać więcej informacji i przykładów, zobacz http://jmespath.org/.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

az batch job set

Zaktualizuj właściwości zadania usługi Batch. Aktualizowanie właściwości w podgrupie spowoduje zresetowanie nieokreślonych właściwości tej grupy.

az batch job set --job-id
                 [--account-endpoint]
                 [--account-key]
                 [--account-name]
                 [--allow-task-preemption]
                 [--if-match]
                 [--if-modified-since]
                 [--if-none-match]
                 [--if-unmodified-since]
                 [--job-max-task-retry-count]
                 [--job-max-wall-clock-time]
                 [--json-file]
                 [--max-parallel-tasks]
                 [--metadata]
                 [--on-all-tasks-complete]
                 [--pool-id]
                 [--priority]

Przykłady

Aktualizowanie priorytetu zadania.

az batch job set --job-id job1 --priority 100

Parametry wymagane

--job-id

Identyfikator zadania, którego właściwości chcesz zaktualizować. Wymagane.

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.

--allow-task-preemption

Czy zadania podrzędne w tym zadaniu mogą zostać wywłaszczone przez inne zadania o wysokim priorytcie. Jeśli wartość ma wartość True, inne zadania o wysokim priorytcie 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. Prawda, jeśli flaga jest obecna.

--if-match

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.

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

--if-unmodified-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.

--job-max-task-retry-count

Maksymalna liczba ponownych prób wykonania każdego 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 każde 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 ponawia ponawia próby zadań. Jeśli maksymalna liczba ponownych prób wynosi -1, usługa Batch ponawia próby zadania bez limitu. Wartość domyślna to 0 (bez ponownych prób).

--job-max-wall-clock-time

Maksymalny czas, przez który zadanie może zostać uruchomiony, mierzony od momentu utworzenia zadania. Jeśli zadanie nie zostanie ukończone w limicie czasu, usługa Batch zakończy je i wszystkie zadania, które są nadal uruchomione. W takim przypadku przyczyną zakończenia będzie MaxWallClockTimeExpiry. Jeśli ta właściwość nie zostanie określona, nie ma limitu czasu na czas uruchomienia zadania. Oczekiwany format to czas trwania ISO-8601.

--json-file

Plik zawierający specyfikację zadania w formacie JSON (sformatowany w celu dopasowania do odpowiedniej treści interfejsu API REST). Jeśli ten parametr jest określony, wszystkie argumenty zadania są ignorowane.

--max-parallel-tasks

Maksymalna liczba zadań, które mogą być wykonywane równolegle dla zadania. Wartość parametru maxParallelTasks musi być -1 lub większa niż 0, jeśli jest 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. Jeśli pominięto, istniejące metadane zadania pozostaną niezmienione. Wartości rozdzielone spacjami w formacie "key=value".

--on-all-tasks-complete

Akcja, jaką usługa Batch powinna wykonać, gdy wszystkie zadania w zadaniu są w stanie ukończonym. W przypadku pominięcia zachowanie ukończenia pozostanie niezmienione. Nie można zmienić wartości z terminatejob na noaction — oznacza to, że po włączeniu automatycznego kończenia zadań nie można go ponownie wyłączyć. Jeśli spróbujesz to zrobić, żądanie zakończy się niepowodzeniem z odpowiedzią o błędzie "nieprawidłowa wartość właściwości"; Jeśli bezpośrednio wywołujesz interfejs API REST, kod stanu HTTP to 400 (Nieprawidłowe żądanie). Znane wartości to: "noaction" i "terminatejob".

--pool-id

Identyfikator istniejącej puli. Wszystkie zadania zadania zadania zostaną uruchomione w określonej puli. Upewnij się, że pula, do której odwołuje się ta właściwość, istnieje. Jeśli pula nie istnieje w czasie, gdy usługa Batch próbuje zaplanować zadanie, żadne zadania dla zadania nie będą uruchamiane do momentu utworzenia puli o tym identyfikatorze. Należy pamiętać, że usługa Batch nie odrzuci żądania zadania; po prostu nie będzie uruchamiać zadań, dopóki pula nie istnieje. Należy określić identyfikator puli lub specyfikację puli automatycznej, ale nie obie.

--priority

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. W przypadku pominięcia priorytet zadania pozostanie niezmieniony.

Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

--output -o

Format danych wyjściowych.

Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc
Domyślna wartość: json
--query

Ciąg zapytania JMESPath. Aby uzyskać więcej informacji i przykładów, zobacz http://jmespath.org/.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

az batch job show

Pobiera informacje o określonym zadaniu usługi Batch.

az batch job show --job-id
                  [--account-endpoint]
                  [--account-key]
                  [--account-name]
                  [--expand]
                  [--if-match]
                  [--if-modified-since]
                  [--if-none-match]
                  [--if-unmodified-since]
                  [--select]

Przykłady

Zawiera szczegółowe informacje o zadaniu.

az batch job show --job-id job1

Parametry wymagane

--job-id

Identyfikator zadania. Wymagane.

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.

--expand

Klauzula OData $expand.

--if-match

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.

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

--if-unmodified-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.

--select

Klauzula OData $select.

Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

--output -o

Format danych wyjściowych.

Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc
Domyślna wartość: json
--query

Ciąg zapytania JMESPath. Aby uzyskać więcej informacji i przykładów, zobacz http://jmespath.org/.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

az batch job stop

Zatrzymaj uruchomione zadanie usługi Batch.

Zakończ określone zadanie, oznaczając je jako ukończone. Po odebraniu żądania zakończenia zadania usługa Batch ustawia zadanie na stan zakończenia. Następnie usługa Batch kończy wszystkie uruchomione zadania skojarzone z zadaniem i uruchamia wszystkie wymagane zadania zwolnienia zadań. Następnie zadanie przechodzi do stanu ukończonego. Jeśli istnieją jakiekolwiek zadania w zadaniu w stanie aktywnym, pozostaną one w stanie aktywnym. Po zakończeniu zadania nie można dodawać nowych zadań, a pozostałe aktywne zadania nie zostaną zaplanowane.

az batch job stop --job-id
                  [--account-endpoint]
                  [--account-key]
                  [--account-name]
                  [--if-match]
                  [--if-modified-since]
                  [--if-none-match]
                  [--if-unmodified-since]
                  [--terminate-reason]

Przykłady

Zatrzymaj zadanie i podaj przyczynę zakończenia

az batch job stop --job-id job1 --terminate-reason "Completed workflow"

Parametry wymagane

--job-id

Identyfikator zadania do zakończenia. Wymagane.

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

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

--if-unmodified-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.

--terminate-reason

Przyczyna zakończenia.

Tekst, który ma być wyświetlany jako plik TerminateReason zadania. Wartość domyślna to "UserTerminate".

Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

--output -o

Format danych wyjściowych.

Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc
Domyślna wartość: json
--query

Ciąg zapytania JMESPath. Aby uzyskać więcej informacji i przykładów, zobacz http://jmespath.org/.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.