BatchJobReleaseTask interface

Pakiet:

@azure-rest/batch

Zadanie zwolnienia zadania do uruchomienia po zakończeniu zadania w dowolnym węźle obliczeniowym, w którym zostało uruchomione zadanie. Zadanie zwolnienia zadania jest uruchamiane po zakończeniu zadania z powodu jednego z następujących elementów: Użytkownik wywołuje interfejs API zakończenia zadania lub interfejs API usuwania zadania, gdy zadanie jest nadal aktywne, jest osiągane maksymalne ograniczenie czasu zegara ściany zadania, a zadanie jest nadal aktywne lub zadanie podrzędne zostało ukończone, a zadanie jest skonfigurowane do zakończenia po zakończeniu pracy Menedżera zadań. Zadanie zwolnienia zadania jest uruchamiane w każdym węźle, w którym zadania zostały uruchomione, a zadanie przygotowania zadania zostało uruchomione i ukończone. Jeśli odtwarzasz obraz węzła po uruchomieniu zadania przygotowania zadania, a zadanie kończy się bez dalszych zadań zadania uruchomionego w tym węźle (a tym samym zadanie przygotowania zadania nie zostanie uruchomione ponownie), zadanie zwolnienia zadania nie zostanie uruchomione w tym węźle obliczeniowym. Jeśli węzeł zostanie uruchomiony ponownie, gdy zadanie zwolnienia zadania jest nadal uruchomione, zadanie zwolnienia zadania zostanie uruchomione ponownie po uruchomieniu węzła obliczeniowego. Zadanie nie jest oznaczone jako ukończone, dopóki wszystkie zadania wydania zadania nie zostaną ukończone. Zadanie zwolnienia zadania jest uruchamiane w tle. Nie zajmuje miejsca planowania; oznacza to, że nie jest liczone do limitu taskSlotsPerNode określonego w puli.

Właściwości

commandLine	Wiersz polecenia zadania zwolnienia zadania. Wiersz polecenia nie jest uruchamiany w powłoce i dlatego nie może korzystać z funkcji powłoki, takich jak rozszerzenie zmiennej środowiskowej. Jeśli chcesz skorzystać z takich funkcji, należy wywołać powłokę w wierszu polecenia, na przykład za pomocą polecenia "cmd /c MyCommand" w systemie Windows lub "/bin/sh -c MyCommand" w systemie Linux. Jeśli wiersz polecenia odwołuje się do ścieżek plików, powinien użyć ścieżki względnej (względem katalogu roboczego zadania) lub użyć zmiennej środowiskowej udostępnionej w usłudze Batch (https://learn.microsoft.com/azure/batch/batch-compute-node-environment-variables).
containerSettings	Ustawienia kontenera, w którym jest uruchamiane zadanie zwolnienia zadania. Po określeniu tej wartości wszystkie katalogi rekursywnie poniżej AZ_BATCH_NODE_ROOT_DIR (katalogi główne katalogów usługi Azure Batch w węźle) są mapowane do kontenera, wszystkie zmienne środowiskowe zadania są mapowane do kontenera, a wiersz polecenia zadania jest wykonywany w kontenerze. Pliki utworzone w kontenerze poza AZ_BATCH_NODE_ROOT_DIR mogą nie zostać odzwierciedlone na dysku hosta, co oznacza, że interfejsy API plików usługi Batch nie będą mogły uzyskać dostępu do tych plików.
environmentSettings	Lista ustawień zmiennych środowiskowych dla zadania zwolnienia zadania.
id	Ciąg, który jednoznacznie identyfikuje zadanie zwolnienia zadania 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. Jeśli ta właściwość nie zostanie określona, usługa Batch przypisze domyślną wartość "jobrelease". Żadne inne zadanie w zadaniu nie może mieć tego samego identyfikatora co zadanie zwolnienia zadania. Jeśli spróbujesz przesłać zadanie o tym samym identyfikatorze, usługa Batch odrzuci żądanie z kodem błędu TaskIdSameAsJobReleaseTask; Jeśli bezpośrednio wywołujesz interfejs API REST, kod stanu HTTP to 409 (konflikt).
maxWallClockTime	Maksymalny czas, jaki upłynął, przez który zadanie zwolnienia zadania może być uruchamiane w danym węźle obliczeniowym mierzonym od momentu uruchomienia zadania. Jeśli zadanie nie zostanie ukończone w limicie czasu, usługa Batch zakończy je. Wartość domyślna to 15 minut. Nie można określić limitu czasu dłuższego niż 15 minut. Jeśli tak, usługa Batch odrzuca ją z powodu błędu; Jeśli bezpośrednio wywołujesz interfejs API REST, kod stanu HTTP to 400 (Nieprawidłowe żądanie).
resourceFiles	Lista plików, które usługa Batch pobierze do węzła obliczeniowego przed uruchomieniem wiersza polecenia. Istnieje maksymalny rozmiar listy plików zasobów. Po przekroczeniu maksymalnego rozmiaru żądanie zakończy się niepowodzeniem, a kod błędu odpowiedzi to RequestEntityTooLarge. W takim przypadku należy zmniejszyć rozmiar kolekcji plików ResourceFiles. Można to osiągnąć przy użyciu plików .zip, pakietów aplikacji lub kontenerów platformy Docker. Pliki wymienione w ramach tego elementu znajdują się w katalogu roboczym zadania.
retentionTime	Minimalny czas przechowywania katalogu Zadań dla zadania zwolnienia zadania w węźle obliczeniowym. Po tym czasie usługa Batch może usunąć katalog Task i całą jego zawartość. Wartość domyślna to 7 dni, tj. katalog zadań zostanie zachowany przez 7 dni, chyba że węzeł obliczeniowy zostanie usunięty lub zadanie zostanie usunięte.
userIdentity	Tożsamość użytkownika, w ramach której jest uruchamiane zadanie zwolnienia zadania. W przypadku pominięcia zadanie jest uruchamiane jako użytkownik niebędący administratorem unikatowym dla zadania.

Szczegóły właściwości

commandLine

Wiersz polecenia zadania zwolnienia zadania. Wiersz polecenia nie jest uruchamiany w powłoce i dlatego nie może korzystać z funkcji powłoki, takich jak rozszerzenie zmiennej środowiskowej. Jeśli chcesz skorzystać z takich funkcji, należy wywołać powłokę w wierszu polecenia, na przykład za pomocą polecenia "cmd /c MyCommand" w systemie Windows lub "/bin/sh -c MyCommand" w systemie Linux. Jeśli wiersz polecenia odwołuje się do ścieżek plików, powinien użyć ścieżki względnej (względem katalogu roboczego zadania) lub użyć zmiennej środowiskowej udostępnionej w usłudze Batch (https://learn.microsoft.com/azure/batch/batch-compute-node-environment-variables).

commandLine: string

Wartość właściwości

string

containerSettings

Ustawienia kontenera, w którym jest uruchamiane zadanie zwolnienia zadania. Po określeniu tej wartości wszystkie katalogi rekursywnie poniżej AZ_BATCH_NODE_ROOT_DIR (katalogi główne katalogów usługi Azure Batch w węźle) są mapowane do kontenera, wszystkie zmienne środowiskowe zadania są mapowane do kontenera, a wiersz polecenia zadania jest wykonywany w kontenerze. Pliki utworzone w kontenerze poza AZ_BATCH_NODE_ROOT_DIR mogą nie zostać odzwierciedlone na dysku hosta, co oznacza, że interfejsy API plików usługi Batch nie będą mogły uzyskać dostępu do tych plików.

containerSettings?: BatchTaskContainerSettings

Wartość właściwości

BatchTaskContainerSettings

environmentSettings

Lista ustawień zmiennych środowiskowych dla zadania zwolnienia zadania.

environmentSettings?: EnvironmentSetting[]

Wartość właściwości

EnvironmentSetting[]

id

Ciąg, który jednoznacznie identyfikuje zadanie zwolnienia zadania 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. Jeśli ta właściwość nie zostanie określona, usługa Batch przypisze domyślną wartość "jobrelease". Żadne inne zadanie w zadaniu nie może mieć tego samego identyfikatora co zadanie zwolnienia zadania. Jeśli spróbujesz przesłać zadanie o tym samym identyfikatorze, usługa Batch odrzuci żądanie z kodem błędu TaskIdSameAsJobReleaseTask; Jeśli bezpośrednio wywołujesz interfejs API REST, kod stanu HTTP to 409 (konflikt).

id?: string

Wartość właściwości

string

maxWallClockTime

Maksymalny czas, jaki upłynął, przez który zadanie zwolnienia zadania może być uruchamiane w danym węźle obliczeniowym mierzonym od momentu uruchomienia zadania. Jeśli zadanie nie zostanie ukończone w limicie czasu, usługa Batch zakończy je. Wartość domyślna to 15 minut. Nie można określić limitu czasu dłuższego niż 15 minut. Jeśli tak, usługa Batch odrzuca ją z powodu błędu; Jeśli bezpośrednio wywołujesz interfejs API REST, kod stanu HTTP to 400 (Nieprawidłowe żądanie).

maxWallClockTime?: string

Wartość właściwości

string

resourceFiles

Lista plików, które usługa Batch pobierze do węzła obliczeniowego przed uruchomieniem wiersza polecenia. Istnieje maksymalny rozmiar listy plików zasobów. Po przekroczeniu maksymalnego rozmiaru żądanie zakończy się niepowodzeniem, a kod błędu odpowiedzi to RequestEntityTooLarge. W takim przypadku należy zmniejszyć rozmiar kolekcji plików ResourceFiles. Można to osiągnąć przy użyciu plików .zip, pakietów aplikacji lub kontenerów platformy Docker. Pliki wymienione w ramach tego elementu znajdują się w katalogu roboczym zadania.

resourceFiles?: ResourceFile[]

Wartość właściwości

ResourceFile[]

retentionTime

Minimalny czas przechowywania katalogu Zadań dla zadania zwolnienia zadania w węźle obliczeniowym. Po tym czasie usługa Batch może usunąć katalog Task i całą jego zawartość. Wartość domyślna to 7 dni, tj. katalog zadań zostanie zachowany przez 7 dni, chyba że węzeł obliczeniowy zostanie usunięty lub zadanie zostanie usunięte.

retentionTime?: string

Wartość właściwości

string

userIdentity

Tożsamość użytkownika, w ramach której jest uruchamiane zadanie zwolnienia zadania. W przypadku pominięcia zadanie jest uruchamiane jako użytkownik niebędący administratorem unikatowym dla zadania.

userIdentity?: UserIdentity

Wartość właściwości

UserIdentity