Task - Add

Usługa:

Batch Service

Wersja interfejsu API:

2023-11-01.18.0

Dodaje zadanie do określonego zadania.
Maksymalny okres istnienia zadania od dodania do ukończenia wynosi 180 dni. Jeśli zadanie nie zostało ukończone w ciągu 180 dni od dodania, zostanie zakończone przez usługę Batch i pozostawione w jakimkolwiek stanie było w tym czasie.

POST {batchUrl}/jobs/{jobId}/tasks?api-version=2023-11-01.18.0

Z parametrami opcjonalnymi:

POST {batchUrl}/jobs/{jobId}/tasks?timeout={timeout}&api-version=2023-11-01.18.0

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
batchUrl	path	True	string	Podstawowy adres URL wszystkich żądań obsługi Azure Batch.
jobId	path	True	string	Identyfikator zadania, do którego ma zostać dodane zadanie.
api-version	query	True	string	Wersja interfejsu API klienta.
timeout	query		integer int32	Maksymalny czas, który serwer może poświęcić na przetwarzanie żądania w sekundach. Wartość domyślna to 30 sekund.

Nagłówek żądania

Media Types: "application/json; odata=minimalmetadata"

Nazwa	Wymagane	Typ	Opis
client-request-id		string uuid	Tożsamość żądania wygenerowanego przez obiekt wywołujący w postaci identyfikatora GUID bez dekoracji, takiej jak nawiasy klamrowe, np. 9C4D50EE-2D56-4CD3-8152-34347DC9F2B0.
return-client-request-id		boolean	Czy serwer powinien zwrócić wartość client-request-id w odpowiedzi.
ocp-date		string date-time-rfc1123	Czas wystawienia żądania. Biblioteki klienckie zazwyczaj ustawiają tę wartość na bieżący czas zegara systemowego; ustaw go jawnie, jeśli bezpośrednio wywołujesz interfejs API REST.

Treść żądania

Media Types: "application/json; odata=minimalmetadata"

Nazwa	Wymagane	Typ	Opis
commandLine	True	string	Wiersz polecenia zadania. W przypadku zadań z wieloma wystąpieniami wiersz polecenia jest wykonywany jako zadanie podstawowe, po zakończeniu wykonywania wiersza polecenia koordynacji przez zadanie podstawowe i wszystkie podzadania. 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 przy użyciu polecenia "cmd /c MyCommand" w systemie Windows lub "/bin/sh -c MyCommand" w systemie Linux. Jeśli wiersz polecenia odnosi się do ścieżek plików, należy 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).
id	True	string	Ciąg, który jednoznacznie identyfikuje zadanie w zadaniu. 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 wielkości liter i niewrażliwy na wielkość liter (oznacza to, że w zadaniu mogą nie znajdować się dwa identyfikatory, które różnią się tylko wielkością liter).
affinityInfo		AffinityInformation	Wskazówka dotycząca lokalizacji, która może być używana przez usługę Batch do wybierania węzła obliczeniowego, na którym ma zostać uruchomione nowe zadanie.
applicationPackageReferences		ApplicationPackageReference[]	Lista pakietów wdrożonych przez usługę Batch w węźle obliczeniowym przed uruchomieniem wiersza polecenia. Pakiety aplikacji są pobierane i wdrażane w udostępnionym katalogu, a nie w katalogu roboczym zadania. W związku z tym, jeśli pakiet, do których odwołuje się odwołanie, znajduje się już w węźle i jest aktualny, nie jest on pobierany ponownie; używana jest istniejąca kopia w węźle obliczeniowym. Jeśli nie można zainstalować przywoływanego pakietu, na przykład z powodu usunięcia pakietu lub pobrania nie powiodło się, zadanie kończy się niepowodzeniem.
authenticationTokenSettings		AuthenticationTokenSettings	Ustawienia tokenu uwierzytelniania, którego zadanie może użyć do wykonywania operacji usługi Batch. Jeśli ta właściwość jest ustawiona, usługa Batch udostępnia zadanie z tokenem uwierzytelniania, który może służyć do uwierzytelniania operacji usługi Batch bez konieczności posiadania klucza dostępu do konta. Token jest dostarczany za pośrednictwem zmiennej środowiskowej AZ_BATCH_AUTHENTICATION_TOKEN. Operacje, które zadanie może wykonać przy użyciu tokenu, zależą od ustawień. Na przykład zadanie może zażądać uprawnień zadania w celu dodania innych zadań do zadania lub sprawdzenia stanu zadania lub innych zadań w ramach zadania.
constraints		TaskConstraints	Ograniczenia wykonywania, które mają zastosowanie do tego zadania. Jeśli nie określisz ograniczeń, parametr maxTaskRetryCount jest parametrem maxTaskRetryCount określonym dla zadania, wartość maxWallClockTime jest nieskończona, a czas przechowywania wynosi 7 dni.
containerSettings		TaskContainerSettings	Ustawienia kontenera, w którym jest uruchamiane zadanie. Jeśli pula, która będzie uruchamiać to zadanie, ma ustawiony kontenerKonfiguracja, musi być również ustawiona. Jeśli pula, która uruchomi to zadanie, nie ma ustawionego konteneraKonfiguracja, nie może być ustawiona. Po określeniu tej wartości wszystkie katalogi cyklicznie poniżej AZ_BATCH_NODE_ROOT_DIR (katalog główny katalogów Azure Batch w węźle) są mapowane na kontener, 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.
dependsOn		TaskDependencies	Zadania, od których zależy to zadanie. To zadanie nie zostanie zaplanowane do momentu pomyślnego ukończenia wszystkich zadań, od których zależy. Jeśli którykolwiek z tych zadań zakończy się niepowodzeniem i wyczerpuje liczbę ponownych prób, to zadanie nigdy nie zostanie zaplanowane. Jeśli zadanie nie ma wartości usesTaskDependencies ustawione na wartość true, a ten element jest obecny, żądanie kończy się niepowodzeniem z kodem błędu TaskDependenciesNotSpecifiedOnJob.
displayName		string	Nazwa wyświetlana zadania. Nazwa wyświetlana nie musi być unikatowa i może zawierać znaki Unicode o maksymalnej długości 1024.
environmentSettings		EnvironmentSetting[]	Lista ustawień zmiennych środowiskowych dla zadania.
exitConditions		ExitConditions	Określa sposób reagowania usługi Batch po zakończeniu zadania. Jak usługa Batch powinna odpowiadać po zakończeniu zadania.
multiInstanceSettings		MultiInstanceSettings	Obiekt wskazujący, że zadanie jest zadaniem z wieloma wystąpieniami i zawiera informacje o sposobie uruchamiania zadania z wieloma wystąpieniami. Zadania z wieloma wystąpieniami są często używane do obsługi zadań MPI. W przypadku mpI, jeśli którykolwiek z podzadań nie powiedzie się (na przykład z powodu zakończenia z kodem zakończenia bez zera) całe zadanie z wieloma wystąpieniami zakończy się niepowodzeniem. Zadanie z wieloma wystąpieniami zostanie następnie zakończone i ponowione, aż do limitu ponawiania prób.
outputFiles		OutputFile[]	Lista plików przekazanych przez usługę Batch z węzła obliczeniowego po uruchomieniu wiersza polecenia. W przypadku zadań z wieloma wystąpieniami pliki zostaną przekazane tylko z węzła obliczeniowego, na którym jest wykonywane zadanie podstawowe.
requiredSlots		integer	Liczba miejsc planowania wymaganych do uruchomienia 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 musi to być 1.
resourceFiles		ResourceFile[]	Lista plików, które usługa Batch pobierze do węzła obliczeniowego przed uruchomieniem wiersza polecenia. W przypadku zadań z wieloma wystąpieniami pliki zasobów zostaną pobrane tylko do węzła obliczeniowego, na którym jest wykonywane zadanie podstawowe. 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 resourceFiles. Można to osiągnąć przy użyciu plików .zip, pakietów aplikacji lub kontenerów platformy Docker.
userIdentity		UserIdentity	Tożsamość użytkownika, w ramach której jest uruchamiane zadanie. W przypadku pominięcia zadanie jest uruchamiane jako użytkownik niebędący administratorem unikatowym dla zadania.

Odpowiedzi

Nazwa	Typ	Opis
201 Created		Żądanie usługi Batch zakończyło się pomyślnie. Nagłówki client-request-id: string request-id: string ETag: string Last-Modified: string DataServiceId: string
Other Status Codes	BatchError	Błąd usługi Batch.

Zabezpieczenia

azure_auth

Microsoft Entra przepływ kodu uwierzytelniania OAuth 2.0

Typ: oauth2
Flow: implicit
Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/authorize

Zakresy

Nazwa	Opis
user_impersonation	Personifikuj konto użytkownika

Authorization

Typ: apiKey
W: header

Przykłady

Add a basic task

Add a task with container settings

Add a task with exit conditions

Add a task with extra slot requirement

Add a basic task

Przykładowe żądanie

HTTP

POST account.region.batch.azure.com/jobs/jobId/tasks?api-version=2023-11-01.18.0



{
  "id": "task1",
  "commandLine": "cmd /c echo task1"
}

Przykładowa odpowiedź

Kod stanu:

201

Add a task with container settings

Przykładowe żądanie

HTTP

POST account.region.batch.azure.com/jobs/jobId/tasks?api-version=2023-11-01.18.0



{
  "id": "taskId",
  "commandLine": "bash -c 'echo hello'",
  "containerSettings": {
    "imageName": "ubuntu",
    "containerRunOptions": "--rm"
  },
  "userIdentity": {
    "autoUser": {
      "scope": "task",
      "elevationLevel": "nonadmin"
    }
  }
}

Przykładowa odpowiedź

Kod stanu:

201

Add a task with exit conditions

Przykładowe żądanie

HTTP

POST account.region.batch.azure.com/jobs/jobId/tasks?api-version=2023-11-01.18.0



{
  "id": "taskId",
  "commandLine": "cmd /c exit 3",
  "exitConditions": {
    "exitCodeRanges": [
      {
        "start": 2,
        "end": 4,
        "exitOptions": {
          "jobAction": "terminate"
        }
      }
    ]
  },
  "userIdentity": {
    "autoUser": {
      "scope": "task",
      "elevationLevel": "nonadmin"
    }
  }
}

Przykładowa odpowiedź

Kod stanu:

201

Add a task with extra slot requirement

Przykładowe żądanie

HTTP

POST account.region.batch.azure.com/jobs/jobId/tasks?api-version=2023-11-01.18.0



{
  "id": "task1",
  "requiredSlots": 2,
  "commandLine": "cmd /c echo task1"
}

Przykładowa odpowiedź

Kod stanu:

201

Definicje

Nazwa	Opis
AccessScope	Zasoby usługi Batch, do których token udziela dostępu.
AffinityInformation	Wskazówka dotycząca lokalizacji, która może być używana przez usługę Batch do wybierania węzła obliczeniowego, na którym ma zostać uruchomione zadanie.
ApplicationPackageReference	Odwołanie do pakietu do wdrożenia w węzłach obliczeniowych.
AuthenticationTokenSettings	Ustawienia tokenu uwierzytelniania, którego zadanie może użyć do wykonywania operacji usługi Batch.
AutoUserScope	Zakres dla użytkownika automatycznego
AutoUserSpecification	Określa parametry dla użytkownika automatycznego, który uruchamia zadanie w usłudze Batch.
BatchError	Odebrano odpowiedź o błędzie z usługi Azure Batch.
BatchErrorDetail	Element dodatkowych informacji zawartych w odpowiedzi Azure Batch błędu.
ComputeNodeIdentityReference	Odwołanie do tożsamości przypisanej przez użytkownika skojarzonej z pulą usługi Batch, której będzie używać węzeł obliczeniowy.
ContainerRegistry	Prywatny rejestr kontenerów.
ContainerWorkingDirectory	Lokalizacja katalogu roboczego zadania kontenera.
DependencyAction	Akcja wykonywana przez usługę Batch na zadania, które zależą od tego zadania.
ElevationLevel	Poziom podniesienia uprawnień użytkownika.
EnvironmentSetting	Zmienna środowiskowa, która ma zostać ustawiona w procesie zadania.
ErrorMessage	Komunikat o błędzie odebrany w odpowiedzi Azure Batch błędu.
ExitCodeMapping	Jak usługa Batch powinna odpowiedzieć, jeśli zadanie zakończy działanie z określonym kodem zakończenia.
ExitCodeRangeMapping	Zakres kodów zakończenia i sposób, w jaki usługa Batch powinna reagować na kody zakończenia w tym zakresie.
ExitConditions	Określa sposób reagowania usługi Batch po zakończeniu zadania.
ExitOptions	Określa sposób, w jaki usługa Batch reaguje na określony warunek zakończenia.
HttpHeader	Para nazwa-wartość nagłówka HTTP
JobAction	Akcja do wykonania zadania zawierającego zadanie, jeśli zadanie zostanie zakończone z danym warunkiem zakończenia, a właściwość onTaskFailed zadania to "performExitOptionsJobAction".
MultiInstanceSettings	Ustawienia określające sposób uruchamiania zadania z wieloma wystąpieniami.
OutputFile	Specyfikacja przekazywania plików z węzła obliczeniowego Azure Batch do innej lokalizacji po zakończeniu wykonywania procesu zadania przez usługę Batch.
OutputFileBlobContainerDestination	Określa miejsce docelowe przekazywania plików w kontenerze usługi Azure Blob Storage.
OutputFileDestination	Miejsce docelowe, do którego ma zostać przekazany plik.
OutputFileUploadCondition	Warunki, w których należy przekazać plik wyjściowy zadania lub zestaw plików.
OutputFileUploadOptions	Szczegółowe informacje o operacji przekazywania pliku wyjściowego, w tym o warunkach do wykonania przekazywania.
ResourceFile	Jeden plik lub wiele plików do pobrania do węzła obliczeniowego.
TaskAddParameter	Zadanie Azure Batch do dodania.
TaskConstraints	Ograniczenia wykonywania, które mają być stosowane do zadania.
TaskContainerSettings	Ustawienia kontenera dla zadania.
TaskDependencies	Określa wszelkie zależności zadania. Każde zadanie, które jest jawnie określone lub w zakresie zależności, musi zostać ukończone przed zaplanowaniem zadania zależnego.
TaskIdRange	Zakres identyfikatorów zadań, od których może zależeć zadanie. Wszystkie zadania z identyfikatorami w zakresie muszą zostać wykonane pomyślnie przed zaplanowaniem zależnego zadania.
UserIdentity	Definicja tożsamości użytkownika, w ramach której jest uruchamiane zadanie.

AccessScope

Zasoby usługi Batch, do których token udziela dostępu.

Nazwa	Typ	Opis
job	string	Udziela dostępu do wykonywania wszystkich operacji w zadaniu zawierającym zadanie.

AffinityInformation

Wskazówka dotycząca lokalizacji, która może być używana przez usługę Batch do wybierania węzła obliczeniowego, na którym ma zostać uruchomione zadanie.

Nazwa	Typ	Opis
affinityId	string	Nieprzezroczysty ciąg reprezentujący lokalizację węzła obliczeniowego lub zadanie, które zostało uruchomione wcześniej. Możesz przekazać identyfikator koligacji węzła, aby wskazać, że to zadanie musi zostać uruchomione w tym węźle obliczeniowym. Należy pamiętać, że jest to po prostu miękkie koligacja. Jeśli docelowy węzeł obliczeniowy jest zajęty lub niedostępny w czasie zaplanowanego zadania, zadanie zostanie zaplanowane w innym miejscu.

ApplicationPackageReference

Odwołanie do pakietu do wdrożenia w węzłach obliczeniowych.

Nazwa	Typ	Opis
applicationId	string	Identyfikator aplikacji do wdrożenia. Podczas tworzenia puli identyfikator aplikacji pakietu musi być w pełni kwalifikowany (/subscriptions/{subscriptionId}/resourceGroups/{resourceGroups}/providers/Microsoft.Batch/batchAccounts/{accountName}/applications/{applicationName}).
version	string	Wersja aplikacji do wdrożenia. W przypadku pominięcia zostanie wdrożona domyślna wersja. Jeśli zostanie to pominięte w puli, a dla tej aplikacji nie zostanie określona żadna domyślna wersja, żądanie zakończy się niepowodzeniem z kodem błędu InvalidApplicationPackageReferences i kodem stanu HTTP 409. Jeśli zostanie to pominięte w zadaniu, a dla tej aplikacji nie zostanie określona żadna domyślna wersja, zadanie zakończy się niepowodzeniem z powodu błędu przetwarzania wstępnego.

AuthenticationTokenSettings

Ustawienia tokenu uwierzytelniania, którego zadanie może użyć do wykonywania operacji usługi Batch.

Nazwa	Typ	Opis
access	AccessScope[]	Zasoby usługi Batch, do których token udziela dostępu. Token uwierzytelniania udziela dostępu do ograniczonego zestawu operacji usługi Batch. Obecnie jedyną obsługiwaną wartością właściwości dostępu jest "zadanie", które przyznaje dostęp do wszystkich operacji związanych z zadaniem zawierającym zadanie.

AutoUserScope

Zakres dla użytkownika automatycznego

Nazwa	Typ	Opis
pool	string	Określa, że zadanie jest uruchamiane jako wspólne konto użytkownika automatycznego, które jest tworzone w każdym węźle obliczeniowym w puli.
task	string	Określa, że usługa powinna utworzyć nowego użytkownika zadania.

AutoUserSpecification

Określa parametry dla użytkownika automatycznego, który uruchamia zadanie w usłudze Batch.

Nazwa	Typ	Opis
elevationLevel	ElevationLevel	Poziom podniesienia uprawnień użytkownika automatycznego. Wartość domyślna to nonAdmin.
scope	AutoUserScope	Zakres dla użytkownika automatycznego Wartość domyślna to pula. Jeśli pula jest uruchomiona w systemie Windows, należy określić wartość Zadanie, jeśli wymagana jest ściślejsza izolacja między zadaniami. Jeśli na przykład zadanie wycisza rejestr w sposób, który może mieć wpływ na inne zadania, lub jeśli certyfikaty zostały określone w puli, które nie powinny być dostępne przez normalne zadania, ale powinny być dostępne przez zadania StartTasks.

BatchError

Odebrano odpowiedź o błędzie z usługi Azure Batch.

Nazwa	Typ	Opis
code	string	Identyfikator błędu. Kody są niezmienne i mają być używane programowo.
message	ErrorMessage	Komunikat opisujący błąd, który ma być odpowiedni do wyświetlania w interfejsie użytkownika.
values	BatchErrorDetail[]	Kolekcja par klucz-wartość zawierająca dodatkowe szczegóły dotyczące błędu.

BatchErrorDetail

Element dodatkowych informacji zawartych w odpowiedzi Azure Batch błędu.

Nazwa	Typ	Opis
key	string	Identyfikator określający znaczenie właściwości Value.
value	string	Dodatkowe informacje zawarte w odpowiedzi na błąd.

ComputeNodeIdentityReference

Odwołanie do tożsamości przypisanej przez użytkownika skojarzonej z pulą usługi Batch, której będzie używać węzeł obliczeniowy.

Nazwa	Typ	Opis
resourceId	string	Identyfikator zasobu usługi ARM tożsamości przypisanej przez użytkownika.

ContainerRegistry

Prywatny rejestr kontenerów.

Nazwa	Typ	Opis
identityReference	ComputeNodeIdentityReference	Odwołanie do tożsamości przypisanej przez użytkownika w celu uzyskania dostępu do Azure Container Registry zamiast nazwy użytkownika i hasła. Odwołanie do tożsamości przypisanej przez użytkownika skojarzonej z pulą usługi Batch, która będzie używana przez węzeł obliczeniowy.
password	string	Hasło do logowania się na serwerze rejestru.
registryServer	string	Adres URL rejestru. W przypadku pominięcia wartość domyślna to "docker.io".
username	string	Nazwa użytkownika do logowania się na serwerze rejestru.

ContainerWorkingDirectory

Lokalizacja katalogu roboczego zadania kontenera.

Nazwa	Typ	Opis
containerImageDefault	string	Użyj katalogu roboczego zdefiniowanego w obrazie kontenera. Należy pamiętać, że ten katalog nie będzie zawierać plików zasobów pobranych przez usługę Batch.
taskWorkingDirectory	string	Użyj standardowego katalogu roboczego zadania usługi Batch, który będzie zawierać pliki zasobów zadań wypełniane przez usługę Batch.

DependencyAction

Akcja wykonywana przez usługę Batch na zadania, które zależą od tego zadania.

Nazwa	Typ	Opis
block	string	Blokuje zadania oczekujące na to zadanie, uniemożliwiając ich zaplanowanie.
satisfy	string	Spełnianie zadań oczekujących na to zadanie; po spełnieniu wszystkich zależności zadanie zostanie zaplanowane do uruchomienia.

ElevationLevel

Poziom podniesienia uprawnień użytkownika.

Nazwa	Typ	Opis
admin	string	Użytkownik jest użytkownikiem z podwyższonym poziomem dostępu i działa z pełnymi uprawnieniami administratora.
nonadmin	string	Użytkownik jest użytkownikiem standardowym bez podwyższonego poziomu dostępu.

EnvironmentSetting

Zmienna środowiskowa, która ma zostać ustawiona w procesie zadania.

Nazwa	Typ	Opis
name	string	Nazwa zmiennej środowiskowej.
value	string	Wartość zmiennej środowiskowej.

ErrorMessage

Komunikat o błędzie odebrany w odpowiedzi Azure Batch błędu.

Nazwa	Typ	Opis
lang	string	Kod języka komunikatu o błędzie
value	string	Tekst wiadomości.

ExitCodeMapping

Jak usługa Batch powinna odpowiedzieć, jeśli zadanie zakończy działanie z określonym kodem zakończenia.

Nazwa	Typ	Opis
code	integer	Kod zakończenia procesu.
exitOptions	ExitOptions	Jak usługa Batch powinna odpowiedzieć, jeśli zadanie zakończy działanie za pomocą tego kodu zakończenia.

ExitCodeRangeMapping

Zakres kodów zakończenia i sposób, w jaki usługa Batch powinna reagować na kody zakończenia w tym zakresie.

Nazwa	Typ	Opis
end	integer	Ostatni kod zakończenia w zakresie.
exitOptions	ExitOptions	Jak usługa Batch powinna odpowiadać, jeśli zadanie zakończy działanie z kodem zakończenia w zakresie od początku do końca (włącznie).
start	integer	Pierwszy kod zakończenia w zakresie.

ExitConditions

Określa sposób reagowania usługi Batch po zakończeniu zadania.

Nazwa	Typ	Opis
default	ExitOptions	Jak usługa Batch powinna odpowiedzieć, jeśli zadanie zakończy się niepowodzeniem z warunkiem zakończenia, który nie jest objęty żadnym z innych właściwości. Ta wartość jest używana, jeśli właściwość Task kończy działanie z kodem zakończenia niezerowym, które nie ma na liście w kolekcji exitCodes lub exitCodeRanges, z błędem przetwarzania wstępnego, jeśli właściwość preProcessingError nie jest obecna, lub z błędem przekazywania pliku, jeśli właściwość fileUploadError nie jest obecna. Jeśli w kodzie zakończenia 0 chcesz użyć domyślnego zachowania, musisz je jawnie wyświetlić przy użyciu kolekcji exitCodes lub exitCodeRanges.
exitCodeRanges	ExitCodeRangeMapping[]	Lista zakresów kodu zakończenia zadania i sposobu, w jaki usługa Batch powinna odpowiadać na nie.
exitCodes	ExitCodeMapping[]	Lista poszczególnych kodów zakończenia zadania i sposobu reagowania na nie usługi Batch.
fileUploadError	ExitOptions	Jak usługa Batch powinna reagować, jeśli wystąpi błąd przekazywania pliku. Jeśli zadanie zakończyło działanie z kodem zakończenia określonym za pośrednictwem exitCodes lub exitCodeRanges, a następnie napotkało błąd przekazywania pliku, akcja określona przez kod zakończenia ma pierwszeństwo.
preProcessingError	ExitOptions	Jak usługa Batch powinna odpowiedzieć, jeśli zadanie nie powiedzie się z powodu błędu.

ExitOptions

Określa sposób, w jaki usługa Batch reaguje na określony warunek zakończenia.

Nazwa	Typ	Opis
dependencyAction	DependencyAction	Akcja wykonywana przez usługę Batch na zadania, które zależą od tego zadania. Możliwe wartości są "spełnione" (zezwalanie na postęp zadań zależnych) i "blokuj" (zadania zależne nadal czekają). Usługa Batch nie obsługuje jeszcze anulowania zadań zależnych.
jobAction	JobAction	Akcja wykonywana dla zadania zawierającego zadanie, jeśli zadanie zostanie zakończone z danym warunkiem zakończenia, a właściwość onTaskFailed zadania to "performExitOptionsJobAction". Wartość domyślna nie dotyczy kodu zakończenia 0 i zakończenia dla wszystkich innych warunków zakończenia. Jeśli właściwość onTaskFailed zadania jest noaction, określenie tej właściwości zwraca błąd i dodanie żądania zadania kończy się niepowodzeniem z powodu nieprawidłowej wartości właściwości; jeśli bezpośrednio wywołujesz interfejs API REST, kod stanu HTTP to 400 (nieprawidłowe żądanie).

HttpHeader

Para nazwa-wartość nagłówka HTTP

Nazwa	Typ	Opis
name	string	Nazwa nagłówka bez uwzględniania wielkości liter, która ma być używana podczas przekazywania plików wyjściowych
value	string	Wartość nagłówka do użycia podczas przekazywania plików wyjściowych

JobAction

Akcja do wykonania zadania zawierającego zadanie, jeśli zadanie zostanie zakończone z danym warunkiem zakończenia, a właściwość onTaskFailed zadania to "performExitOptionsJobAction".

Nazwa	Typ	Opis
disable	string	Wyłącz zadanie. Jest to równoważne wywołaniu wyłączonego interfejsu API zadania z wartością disableTasks ponownego kolejkowania.
none	string	Nie podejmij żadnych działań.
terminate	string	Zakończ zadanie. Parametr terminateReason w poleceniu ExecutionInfo zadania jest ustawiony na wartość "TaskFailed".

MultiInstanceSettings

Ustawienia określające sposób uruchamiania zadania z wieloma wystąpieniami.

Nazwa	Typ	Opis
commonResourceFiles	ResourceFile[]	Lista plików pobranych przez usługę Batch przed uruchomieniem wiersza polecenia koordynacji. Różnica między typowymi plikami zasobów i plikami zasobów zadania polega na tym, że typowe pliki zasobów są pobierane dla wszystkich podzadań, w tym podstawowych, podczas gdy pliki zasobów zadań są pobierane tylko dla podstawowego. Należy również pamiętać, że te pliki zasobów nie są pobierane do katalogu roboczego zadania, ale zamiast tego są pobierane do katalogu głównego zadania (jeden katalog powyżej katalogu roboczego). 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 ResourceFiles. Można to osiągnąć przy użyciu plików .zip, pakietów aplikacji lub kontenerów platformy Docker.
coordinationCommandLine	string	Wiersz polecenia do uruchomienia we wszystkich węzłach obliczeniowych, aby umożliwić ich koordynowanie, gdy podstawowy uruchamia główne polecenie Zadanie. Typowy wiersz polecenia koordynacji uruchamia usługę w tle i sprawdza, czy usługa jest gotowa do przetwarzania komunikatów między węzłami.
numberOfInstances	integer	Liczba węzłów obliczeniowych wymaganych przez zadanie. Jeśli pominięto, wartość domyślna to 1.

OutputFile

Specyfikacja przekazywania plików z węzła obliczeniowego Azure Batch do innej lokalizacji po zakończeniu wykonywania procesu zadania przez usługę Batch.

Nazwa	Typ	Opis
destination	OutputFileDestination	Miejsce docelowe plików wyjściowych.
filePattern	string	Wzorzec wskazujący, które pliki mają być przekazywane. Obsługiwane są ścieżki względne i bezwzględne. Ścieżki względne są względne względem katalogu roboczego zadania. Obsługiwane są następujące symbole wieloznaczne: * pasuje do 0 lub większej liczby znaków (na przykład wzorzec abc* pasuje do abc lub abcdef), ** pasuje do dowolnego katalogu, ? pasuje do dowolnego pojedynczego znaku, [abc] pasuje do jednego znaku w nawiasach, a [a-c] pasuje do jednego znaku w zakresie. Nawiasy mogą zawierać negację, aby dopasować dowolny nie określony znak (na przykład [!abc] pasuje do dowolnego znaku, ale a, b lub c). Jeśli nazwa pliku zaczyna się od "." jest domyślnie ignorowana, ale może być zgodna przez jawne określenie jej (na przykład .gif nie będzie pasować do .a.gif, ale ..gif będzie). Prosty przykład: ***.txt pasuje do dowolnego pliku, który nie rozpoczyna się w folderze ""., a kończy się .txt w katalogu roboczym zadania lub w żadnym podkatalogu. Jeśli nazwa pliku zawiera symbol wieloznaczny, można go użyć nawiasów kwadratowych (na przykład abc[] będzie pasować do pliku o nazwie abc). Należy pamiętać, że zarówno \, jak i / są traktowane jako separatory katalogów w systemie Windows, ale tylko / jest w systemie Linux. Zmienne środowiskowe (%var% w systemie Windows lub $var w systemie Linux) są rozszerzane przed zastosowaniem wzorca.
uploadOptions	OutputFileUploadOptions	Dodatkowe opcje operacji przekazywania, w tym na jakich warunkach należy wykonać przekazywanie.

OutputFileBlobContainerDestination

Określa miejsce docelowe przekazywania plików w kontenerze usługi Azure Blob Storage.

Nazwa	Typ	Opis
containerUrl	string	Adres URL kontenera w Azure Blob Storage, do którego mają być przekazywane pliki. Jeśli nie używasz tożsamości zarządzanej, adres URL musi zawierać sygnaturę dostępu współdzielonego udzielając uprawnień zapisu do kontenera.
identityReference	ComputeNodeIdentityReference	Odwołanie do tożsamości przypisanej przez użytkownika w celu uzyskania dostępu do Azure Blob Storage określonego przez containerUrl Tożsamość musi mieć dostęp do zapisu do kontenera Azure Blob Storage
path	string	Docelowy obiekt blob lub katalog wirtualny w kontenerze usługi Azure Storage. Jeśli plikPattern odwołuje się do określonego pliku (tj. nie zawiera symboli wieloznacznych), ścieżka jest nazwą obiektu blob, do którego należy przekazać ten plik. Jeśli plikPattern zawiera co najmniej jedną symbol wieloznaczny (i w związku z tym może być zgodna z wieloma plikami), ścieżka jest nazwą katalogu wirtualnego obiektu blob (który jest poprzedzany każdą nazwą obiektu blob), do którego mają zostać przekazane pliki. Jeśli pominięto, pliki są przekazywane do katalogu głównego kontenera o nazwie obiektu blob pasującego do nazwy pliku.
uploadHeaders	HttpHeader[]	Lista par name-value dla nagłówków, które mają być używane w przekazywaniu plików wyjściowych Te nagłówki zostaną określone podczas przekazywania plików do usługi Azure Storage. Oficjalny dokument dotyczący dozwolonych nagłówków podczas przekazywania obiektów blob: https://docs.microsoft.com/en-us/rest/api/storageservices/put-blob#request-headers-all-blob-types

OutputFileDestination

Miejsce docelowe, do którego ma zostać przekazany plik.

Nazwa	Typ	Opis
container	OutputFileBlobContainerDestination	Lokalizacja w usłudze Azure Blob Storage, do której są przekazywane pliki.

OutputFileUploadCondition

Warunki, w których należy przekazać plik wyjściowy zadania lub zestaw plików.

Nazwa	Typ	Opis
taskcompletion	string	Przekaż pliki po zakończeniu procesu zadania, niezależnie od tego, jaki był kod zakończenia.
taskfailure	string	Przekaż pliki tylko po zakończeniu procesu zadania przy użyciu kodu zakończenia bezzerowego.
tasksuccess	string	Przekaż pliki tylko po zakończeniu procesu zadania z kodem zakończenia 0.

OutputFileUploadOptions

Szczegółowe informacje o operacji przekazywania pliku wyjściowego, w tym o warunkach do wykonania przekazywania.

Nazwa	Typ	Opis
uploadCondition	OutputFileUploadCondition	Warunki, w których należy przekazać plik wyjściowy zadania lub zestaw plików. Wartość domyślna to taskcompletion.

ResourceFile

Jeden plik lub wiele plików do pobrania do węzła obliczeniowego.

Nazwa	Typ	Opis
autoStorageContainerName	string	Nazwa kontenera magazynu na koncie magazynu automatycznego. Właściwości autoStorageContainerName, storageContainerUrl i httpUrl wzajemnie się wykluczają i należy określić jedną z nich.
blobPrefix	string	Prefiks obiektu blob używany podczas pobierania obiektów blob z kontenera usługi Azure Storage. Zostaną pobrane tylko obiekty blob, których nazwy zaczynają się od określonego prefiksu. Właściwość jest prawidłowa tylko wtedy, gdy jest używana właściwość autoStorageContainerName lub storageContainerUrl. Ten prefiks może być częściową nazwą pliku lub podkatalogem. Jeśli prefiks nie zostanie określony, wszystkie pliki w kontenerze zostaną pobrane.
fileMode	string	Atrybut trybu uprawnień pliku w formacie ósemkowym. Ta właściwość ma zastosowanie tylko do plików pobieranych do węzłów obliczeniowych systemu Linux. Zostanie on zignorowany, jeśli zostanie określony dla pliku resourceFile, który zostanie pobrany do węzła obliczeniowego systemu Windows. Jeśli ta właściwość nie zostanie określona dla węzła obliczeniowego systemu Linux, do pliku zostanie zastosowana wartość domyślna 0770.
filePath	string	Lokalizacja węzła obliczeniowego, do którego mają być pobierane pliki względem katalogu roboczego zadania. Jeśli właściwość httpUrl jest określona, parametr filePath jest wymagany i opisuje ścieżkę, do której zostanie pobrany plik, w tym nazwę pliku. W przeciwnym razie, jeśli określono właściwość autoStorageContainerName lub storageContainerUrl, parametr filePath jest opcjonalny i jest katalogem do pobrania plików. W przypadku, gdy plikPath jest używany jako katalog, każda struktura katalogów już skojarzona z danymi wejściowymi zostanie zachowana w całości i dołączona do określonego katalogu filePath. Określona ścieżka względna nie może wyprzeć katalogu roboczego zadania (na przykład przy użyciu polecenia ".".
httpUrl	string	Adres URL pliku do pobrania. Właściwości autoStorageContainerName, storageContainerUrl i httpUrl wzajemnie się wykluczają i należy określić jedną z nich. Jeśli adres URL wskazuje Azure Blob Storage, musi być czytelny z węzłów obliczeniowych. Istnieją trzy sposoby uzyskania takiego adresu URL dla obiektu blob w usłudze Azure Storage: obejmują sygnaturę dostępu współdzielonego udzielając uprawnień do odczytu w obiekcie blob, użyć tożsamości zarządzanej z uprawnieniem do odczytu lub ustawić listę ACL dla obiektu blob lub kontenera, aby zezwolić na dostęp publiczny.
identityReference	ComputeNodeIdentityReference	Odwołanie do tożsamości przypisanej przez użytkownika do użycia w celu uzyskania dostępu do Azure Blob Storage określonego przez storageContainerUrl lub httpUrl Odwołanie do tożsamości przypisanej przez użytkownika skojarzonej z pulą usługi Batch, której będzie używać węzeł obliczeniowy.
storageContainerUrl	string	Adres URL kontenera obiektów blob w Azure Blob Storage. Właściwości autoStorageContainerName, storageContainerUrl i httpUrl wzajemnie się wykluczają i należy określić jedną z nich. Ten adres URL musi być czytelny i możliwy do wyświetlenia z węzłów obliczeniowych. Istnieją trzy sposoby uzyskiwania takiego adresu URL dla kontenera w usłudze Azure Storage: obejmują sygnaturę dostępu współdzielonego udzielając uprawnień do odczytu i listy w kontenerze, używanie tożsamości zarządzanej z uprawnieniami do odczytu i listy lub ustawienie listy ACL dla kontenera, aby zezwolić na dostęp publiczny.

TaskAddParameter

Zadanie Azure Batch do dodania.

Nazwa	Typ	Opis
affinityInfo	AffinityInformation	Wskazówka dotycząca lokalizacji, która może być używana przez usługę Batch do wybierania węzła obliczeniowego, na którym ma zostać uruchomione nowe zadanie.
applicationPackageReferences	ApplicationPackageReference[]	Lista pakietów, które usługa Batch zostanie wdrożona w węźle obliczeniowym przed uruchomieniem wiersza polecenia. Pakiety aplikacji są pobierane i wdrażane w udostępnionym katalogu, a nie w katalogu roboczym Zadania. W związku z tym jeśli pakiet, do których odwołuje się odwołanie, znajduje się już w węźle i jest aktualny, nie jest on pobierany ponownie; jest używana istniejąca kopia w węźle obliczeniowym. Jeśli nie można zainstalować przywoływanego pakietu, na przykład ze względu na to, że pakiet został usunięty lub pobieranie nie powiodło się, zadanie kończy się niepowodzeniem.
authenticationTokenSettings	AuthenticationTokenSettings	Ustawienia tokenu uwierzytelniania, którego zadanie może użyć do wykonywania operacji usługi Batch. Jeśli ta właściwość jest ustawiona, usługa Batch udostępnia zadaniu token uwierzytelniania, który może służyć do uwierzytelniania operacji usługi Batch bez konieczności posiadania klucza dostępu do konta. Token jest dostarczany za pośrednictwem zmiennej środowiskowej AZ_BATCH_AUTHENTICATION_TOKEN. Operacje, które zadanie może wykonać przy użyciu tokenu, zależą od ustawień. Na przykład zadanie może zażądać uprawnień zadania w celu dodania innych zadań do zadania lub sprawdzenia stanu zadania lub innych zadań podrzędnych w ramach zadania.
commandLine	string	Wiersz polecenia zadania. W przypadku zadań z wieloma wystąpieniami wiersz polecenia jest wykonywany jako zadanie podstawowe, po zakończeniu wykonywania wiersza polecenia koordynacji przez zadanie podstawowe i wszystkie podzadania. 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 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ę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).
constraints	TaskConstraints	Ograniczenia wykonywania, które mają zastosowanie do tego zadania. Jeśli nie określisz ograniczeń, parametr maxTaskRetryCount jest parametrem maxTaskRetryCount określonym dla zadania, parametr maxWallClockTime jest nieskończony, a parametr retentionTime wynosi 7 dni.
containerSettings	TaskContainerSettings	Ustawienia kontenera, w którym jest uruchamiane zadanie. Jeśli pula, która będzie uruchamiać to zadanie, ma ustawioną wartość containerConfiguration, należy to również ustawić. Jeśli pula, która uruchomi to zadanie, nie ma ustawionego konteneraKonfiguracja, nie można go ustawić. Po określeniu tego ustawienia wszystkie katalogi cyklicznie poniżej AZ_BATCH_NODE_ROOT_DIR (katalog główny katalogów 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.
dependsOn	TaskDependencies	Zadania, od których zależy to zadanie. To zadanie nie zostanie zaplanowane do momentu pomyślnego ukończenia wszystkich zadań, od których zależy. Jeśli którykolwiek z tych zadań zakończy się niepowodzeniem i wyczerpuje liczbę ponownych prób, to zadanie nigdy nie zostanie zaplanowane. Jeśli zadanie nie ma parametru usesTaskDependencies ustawionego na wartość true, a ten element jest obecny, żądanie kończy się niepowodzeniem z kodem błędu TaskDependenciesNotSpecifiedOnJob.
displayName	string	Nazwa wyświetlana zadania. Nazwa wyświetlana nie musi być unikatowa i może zawierać znaki Unicode o maksymalnej długości 1024.
environmentSettings	EnvironmentSetting[]	Lista ustawień zmiennych środowiskowych dla zadania.
exitConditions	ExitConditions	Określa, jak usługa Batch powinna odpowiadać po zakończeniu zadania. Jak usługa Batch powinna odpowiadać po zakończeniu zadania.
id	string	Ciąg, który jednoznacznie identyfikuje zadanie 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. Identyfikator zachowuje wielkość liter i nie uwzględnia wielkości liter (oznacza to, że w zadaniu nie ma dwóch identyfikatorów, które różnią się tylko wielkością liter).
multiInstanceSettings	MultiInstanceSettings	Obiekt wskazujący, że zadanie jest zadaniem o wielu wystąpieniach i zawiera informacje o sposobie uruchamiania zadania z wieloma wystąpieniami. Zadania z wieloma wystąpieniami są często używane do obsługi zadań MPI. W przypadku mpI, jeśli którykolwiek z podzadań zakończy się niepowodzeniem (na przykład z powodu zakończenia z kodem zakończenia innego niż zero), całe zadanie obejmujące wiele wystąpień kończy się niepowodzeniem. Zadanie obejmujące wiele wystąpień jest następnie przerywane i ponawiane do limitu ponawiania prób.
outputFiles	OutputFile[]	Lista plików, które usługa Batch przekaże z węzła obliczeniowego po uruchomieniu wiersza polecenia. W przypadku zadań z wieloma wystąpieniami pliki zostaną przekazane tylko z węzła obliczeniowego, na którym jest wykonywane zadanie podstawowe.
requiredSlots	integer	Liczba miejsc planowania wymaganych do uruchomienia zadania. Wartość domyślna to 1. Zadanie można zaplanować tylko w węźle obliczeniowym, jeśli węzeł ma wystarczającą liczbę wolnych miejsc planowania. W przypadku zadań z wieloma wystąpieniami musi to być wartość 1.
resourceFiles	ResourceFile[]	Lista plików, które usługa Batch pobierze do węzła obliczeniowego przed uruchomieniem wiersza polecenia. W przypadku zadań z wieloma wystąpieniami pliki zasobów zostaną pobrane tylko do węzła obliczeniowego, na którym jest wykonywane zadanie podstawowe. 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 ResourceFiles. Można to osiągnąć przy użyciu plików .zip, pakietów aplikacji lub kontenerów platformy Docker.
userIdentity	UserIdentity	Tożsamość użytkownika, w ramach której jest uruchamiane zadanie. W przypadku pominięcia zadanie jest uruchamiane jako użytkownik niebędący administratorem unikatowym dla zadania.

TaskConstraints

Ograniczenia wykonywania, które mają być stosowane do zadania.

Nazwa	Typ	Opis
maxTaskRetryCount	integer	Maksymalna liczba ponownych prób zadania. Usługa Batch ponawia próbę zadania, jeśli jego kod zakończenia jest niezerowy. Należy pamiętać, że ta wartość w szczególności kontroluje liczbę ponownych prób dla pliku wykonywalnego zadania z powodu kodu zakończenia niezerowego. Usługa Batch spróbuje raz 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 spróbuje wykonać zadanie do 4 razy (jedna początkowa próba i 3 ponownych prób). Jeśli maksymalna liczba ponownych prób wynosi 0, usługa Batch nie ponowi próby wykonania zadania po pierwszej próbie. Jeśli maksymalna liczba ponownych prób to -1, usługa Batch ponawia próbę zadania bez limitu, jednak nie jest to zalecane w przypadku zadania uruchamiania ani żadnego zadania. Wartość domyślna to 0 (bez ponownych prób).
maxWallClockTime	string	Maksymalny czas, który upłynął do uruchomienia zadania, mierzony od momentu uruchomienia zadania. Jeśli zadanie nie zostanie ukończone w ramach limitu czasu, usługa Batch go zakończy. Jeśli ta wartość nie jest określona, nie ma limitu czasu na czas uruchomienia zadania.
retentionTime	string	Minimalny czas przechowywania katalogu zadań w węźle obliczeniowym, w którym został uruchomiony, od momentu ukończenia wykonywania. Po tym czasie usługa Batch może usunąć katalog Zadań 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.

TaskContainerSettings

Ustawienia kontenera dla zadania.

Nazwa	Typ	Opis
containerRunOptions	string	Dodatkowe opcje polecenia tworzenia kontenera. Te dodatkowe opcje są dostarczane jako argumenty polecenia "docker create" oprócz tych kontrolowanych przez usługę Batch.
imageName	string	Obraz używany do utworzenia kontenera, w którym zostanie uruchomione zadanie. Jest to pełne odwołanie do obrazu, które zostanie określone jako "ściąganie platformy Docker". Jeśli żaden tag nie zostanie podany jako część nazwy obrazu, tag ":latest" jest używany jako domyślny.
registry	ContainerRegistry	Rejestr prywatny zawierający obraz kontenera. To ustawienie można pominąć, jeśli zostało już udostępnione podczas tworzenia puli.
workingDirectory	ContainerWorkingDirectory	Lokalizacja katalogu roboczego zadania kontenera. Wartość domyślna to "taskWorkingDirectory".

TaskDependencies

Określa wszelkie zależności zadania. Każde zadanie, które jest jawnie określone lub w zakresie zależności, musi zostać ukończone przed zaplanowaniem zadania zależnego.

Nazwa	Typ	Opis
taskIdRanges	TaskIdRange[]	Lista zakresów identyfikatorów zadań, od których zależy to zadanie. Wszystkie zadania we wszystkich zakresach muszą zostać ukończone pomyślnie przed zaplanowaniem zależnego zadania.
taskIds	string[]	Lista identyfikatorów zadań, od których zależy to zadanie. Wszystkie zadania na tej liście muszą zostać ukończone pomyślnie przed zaplanowanym zadaniem zależnym. Kolekcja taskIds jest ograniczona do 64000 znaków (tj. łączna długość wszystkich identyfikatorów zadań). Jeśli kolekcja taskIds przekracza maksymalną długość, żądanie dodawania zadania kończy się niepowodzeniem z kodem błędu TaskDependencyListTooLong. W tym przypadku rozważ użycie zakresów identyfikatorów zadań.

TaskIdRange

Zakres identyfikatorów zadań, od których może zależeć zadanie. Wszystkie zadania z identyfikatorami w zakresie muszą zostać wykonane pomyślnie przed zaplanowaniem zależnego zadania.

Nazwa	Typ	Opis
end	integer	Ostatni identyfikator zadania w zakresie.
start	integer	Pierwszy identyfikator zadania w zakresie.

UserIdentity

Definicja tożsamości użytkownika, w ramach której jest uruchamiane zadanie.

Nazwa	Typ	Opis
autoUser	AutoUserSpecification	Użytkownik automatyczny, w ramach którego jest uruchamiane zadanie. Właściwości userName i autoUser wzajemnie się wykluczają; Musisz określić jeden, ale nie oba.
username	string	Nazwa tożsamości użytkownika, w ramach której jest uruchamiane zadanie. Właściwości userName i autoUser wzajemnie się wykluczają; Musisz określić jeden, ale nie oba.