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
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.
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.
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.
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]".
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.
Lista ustawień zmiennych środowiskowych dla zadania Menedżera zadań. Wartości rozdzielone spacjami w formacie "key=value".
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.
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.
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).
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.
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.
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.
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".
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".
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.
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.
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.
Czy zadania w zadaniu mogą definiować zależności od siebie. Wartość domyślna to false. Prawda, jeśli flaga jest obecna.
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. Aby uzyskać więcej informacji i przykładów, zobacz http://jmespath.org/.
Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu az account set -s NAME_OR_ID
.
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
Identyfikator zadania do usunięcia. Wymagane.
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 w usłudze 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. Aby uzyskać więcej informacji i przykładów, zobacz http://jmespath.org/.
Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu az account set -s NAME_OR_ID
.
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
Identyfikator zadania do wyłączenia. Wymagane.
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.
Co zrobić z aktywnymi zadaniami skojarzonymi z zadaniem. Wymagane. Znane wartości to: "requeue", "terminate" i "wait".
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 w usłudze został zmodyfikowany od określonego czasu.
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
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. Aby uzyskać więcej informacji i przykładów, zobacz http://jmespath.org/.
Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu az account set -s NAME_OR_ID
.
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
Identyfikator zadania do włączenia. Wymagane.
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 w usłudze został zmodyfikowany od określonego czasu.
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. Aby uzyskać więcej informacji i przykładów, zobacz http://jmespath.org/.
Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu az account set -s NAME_OR_ID
.
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
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. Wymagane jest tylko ustawienie zmiennej środowiskowej według zmiennej środowiskowej: AZURE_BATCH_ACCOUNT.
Klauzula OData $expand.
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.
Identyfikator harmonogramu zadań, z którego chcesz uzyskać listę zadań. W przypadku pominięcia wyświetla listę wszystkich zadań na koncie.
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. Aby uzyskać więcej informacji i przykładów, zobacz http://jmespath.org/.
Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu az account set -s NAME_OR_ID
.
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
Identyfikator zadania, którego właściwości chcesz zaktualizować. Wymagane.
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.
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.
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 w usłudze został zmodyfikowany od określonego czasu.
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).
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.
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.
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.
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".
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".
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.
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
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. Aby uzyskać więcej informacji i przykładów, zobacz http://jmespath.org/.
Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu az account set -s NAME_OR_ID
.
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
Identyfikator zadania, którego właściwości chcesz zaktualizować. Wymagane.
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.
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.
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 w usłudze został zmodyfikowany od określonego czasu.
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).
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.
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.
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.
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".
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".
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.
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
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. Aby uzyskać więcej informacji i przykładów, zobacz http://jmespath.org/.
Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu az account set -s NAME_OR_ID
.
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
Identyfikator zadania. Wymagane.
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 w usłudze 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. Aby uzyskać więcej informacji i przykładów, zobacz http://jmespath.org/.
Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu az account set -s NAME_OR_ID
.
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
Identyfikator zadania do zakończenia. Wymagane.
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 w usłudze został zmodyfikowany od określonego czasu.
Przyczyna zakończenia.
Tekst, który ma być wyświetlany jako plik TerminateReason zadania. Wartość domyślna to "UserTerminate".
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. Aby uzyskać więcej informacji i przykładów, zobacz http://jmespath.org/.
Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu az account set -s NAME_OR_ID
.
Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.