Task - List
Wyświetla listę wszystkich zadań skojarzonych z określonym zadaniem.
W przypadku zadań obejmujących wiele wystąpień informacje, takie jak koligacjaId, executionInfo i nodeInfo, zapoznaj się z podstawowym zadaniem. Użyj interfejsu API podzadania listy, aby pobrać informacje o podzadaniach.
GET {batchUrl}/jobs/{jobId}/tasks?api-version=2024-07-01.20.0
GET {batchUrl}/jobs/{jobId}/tasks?$filter={$filter}&$select={$select}&$expand={$expand}&maxresults={maxresults}&timeout={timeout}&api-version=2024-07-01.20.0
Parametry identyfikatora URI
Nazwa | W | Wymagane | Typ | Opis |
---|---|---|---|---|
batch
|
path | True |
string |
Podstawowy adres URL dla wszystkich żądań usługi Azure Batch. |
job
|
path | True |
string |
Identyfikator zadania. |
api-version
|
query | True |
string |
Wersja interfejsu API klienta. |
$expand
|
query |
string |
Klauzula OData $expand. |
|
$filter
|
query |
string |
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#list-tasks. |
|
$select
|
query |
string |
Klauzula OData $select. |
|
maxresults
|
query |
integer int32 |
Maksymalna liczba elementów do zwrócenia w odpowiedzi. Można zwrócić maksymalnie 1000 zadań. |
|
timeout
|
query |
integer int32 |
Maksymalny czas przetwarzania żądania przez serwer w sekundach. Wartość domyślna to 30 sekund. Jeśli wartość jest większa niż 30, zostanie użyta wartość domyślna. |
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ć identyfikator żądania klienta 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. |
Odpowiedzi
Nazwa | Typ | Opis |
---|---|---|
200 OK |
Odpowiedź zawierająca listę zadań. Nagłówki
|
|
Other Status Codes |
Błąd usługi Batch. |
Zabezpieczenia
azure_auth
Microsoft Entra OAuth 2.0 — przepływ kodu uwierzytelniania
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
Task list
Przykładowe żądanie
GET account.region.batch.azure.com/jobs/jobId/tasks?api-version=2024-07-01.20.0
Przykładowa odpowiedź
{
"value": [
{
"id": "task1",
"url": "https://account.region.batch.azure.com/jobs/jobId/tasks/task1",
"eTag": "0x8D4125FD1A825A4",
"creationTime": "2016-11-21T22:43:31.4733476Z",
"lastModified": "2016-11-21T22:43:31.4733476Z",
"state": "active",
"stateTransitionTime": "2016-11-21T22:43:31.4733476Z",
"commandLine": "cmd /c echo task1",
"userIdentity": {
"autoUser": {
"scope": "task",
"elevationLevel": "nonadmin"
}
},
"constraints": {
"maxWallClockTime": "P10675199DT2H48M5.4775807S",
"retentionTime": "P10675199DT2H48M5.4775807S",
"maxTaskRetryCount": 0
},
"requiredSlots": 2,
"executionInfo": {
"retryCount": 0,
"requeueCount": 0
}
},
{
"id": "task2",
"url": "https://account.region.batch.azure.com/jobs/jobId/tasks/task2",
"eTag": "0x8D4125FD2153345",
"creationTime": "2016-11-21T22:43:31.6736345Z",
"lastModified": "2016-11-21T22:43:32.1880389Z",
"state": "active",
"stateTransitionTime": "2016-11-21T22:43:31.6736345Z",
"commandLine": "cmd /c echo task2",
"userIdentity": {
"autoUser": {
"scope": "task",
"elevationLevel": "nonadmin"
}
},
"constraints": {
"maxWallClockTime": "P10675199DT2H48M5.4775807S",
"retentionTime": "P10675199DT2H48M5.4775807S",
"maxTaskRetryCount": 3
},
"requiredSlots": 2,
"executionInfo": {
"retryCount": 0,
"requeueCount": 0
}
}
]
}
Definicje
Nazwa | Opis |
---|---|
Access |
Zasoby usługi Batch, do których token udziela dostępu. |
Affinity |
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. |
Application |
Odwołanie do pakietu do wdrożenia w węzłach obliczeniowych. |
Authentication |
Ustawienia tokenu uwierzytelniania, którego zadanie może używać do wykonywania operacji usługi Batch. |
Auto |
Zakres użytkownika automatycznego |
Auto |
Określa parametry dla użytkownika automatycznego, który uruchamia zadanie w usłudze Batch. |
Batch |
Odebrano odpowiedź o błędzie z usługi Azure Batch. |
Batch |
Element dodatkowych informacji zawartych w odpowiedzi na błąd usługi Azure Batch. |
Cloud |
Zadanie usługi Azure Batch. |
Cloud |
Wynik wyświetlania listy zadań w zadaniu. |
Compute |
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. |
Compute |
Informacje o węźle obliczeniowym, na którym uruchomiono zadanie. |
Container |
Wpis ścieżki i trybu instalacji, który chcesz zainstalować w kontenerze zadań. |
Container |
Ścieżki, które zostaną zainstalowane w kontenerze zadania kontenera. |
Container |
Prywatny rejestr kontenerów. |
Container |
Lokalizacja katalogu roboczego zadania kontenera. |
Dependency |
Akcja wykonywana przez usługę Batch dla zadań, które zależą od tego zadania. |
Elevation |
Poziom podniesienia uprawnień użytkownika. |
Environment |
Zmienna środowiskowa, która ma być ustawiana w procesie zadania. |
Error |
Kategoria błędu. |
Error |
Komunikat o błędzie odebrany w odpowiedzi na błąd usługi Azure Batch. |
Exit |
Jak usługa Batch powinna odpowiadać, jeśli zadanie zakończy działanie z określonym kodem zakończenia. |
Exit |
Zakres kodów zakończenia i sposobu, w jaki usługa Batch powinna reagować na kody zakończenia w tym zakresie. |
Exit |
Określa, jak usługa Batch powinna odpowiadać po zakończeniu zadania. |
Exit |
Określa sposób, w jaki usługa Batch reaguje na określony warunek zakończenia. |
Http |
Para nazwa-wartość nagłówka HTTP |
Job |
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". |
Multi |
Ustawienia określające sposób uruchamiania zadania obejmującego wiele wystąpień. |
Name |
Reprezentuje parę nazwa-wartość. |
Output |
Specyfikacja przekazywania plików z węzła obliczeniowego usługi Azure Batch do innej lokalizacji po zakończeniu wykonywania procesu zadania przez usługę Batch. |
Output |
Określa miejsce docelowe przekazywania plików w kontenerze usługi Azure Blob Storage. |
Output |
Miejsce docelowe, do którego ma zostać przekazany plik. |
Output |
Warunki, w których należy przekazać plik wyjściowy zadania lub zestaw plików. |
Output |
Szczegółowe informacje o operacji przekazywania pliku wyjściowego, w tym o warunkach, w których należy wykonać przekazywanie. |
Resource |
Jeden plik lub wiele plików do pobrania do węzła obliczeniowego. |
Task |
Ograniczenia wykonywania, które mają zastosowanie do zadania. |
Task |
Zawiera informacje o kontenerze, który wykonuje zadanie. |
Task |
Ustawienia kontenera dla zadania. |
Task |
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. |
Task |
Informacje o wykonywaniu zadania. |
Task |
Wynik wykonania zadania. |
Task |
Informacje o niepowodzeniu zadania. |
Task |
Zakres identyfikatorów zadań, od których może zależeć zadanie. Wszystkie zadania z identyfikatorami w zakresie muszą zostać ukończone pomyślnie przed zaplanowaniem zależnego zadania. |
Task |
Stan zadania. |
Task |
Statystyki użycia zasobów dla zadania. |
User |
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 |
Nieprzezroczystym ciąg reprezentujący lokalizację węzła obliczeniowego lub zadanie, które zostało wcześniej uruchomione. |
ApplicationPackageReference
Odwołanie do pakietu do wdrożenia w węzłach obliczeniowych.
Nazwa | Typ | Opis |
---|---|---|
applicationId |
string |
Identyfikator aplikacji do wdrożenia. |
version |
string |
Wersja aplikacji do wdrożenia. W przypadku pominięcia zostanie wdrożona domyślna wersja. |
AuthenticationTokenSettings
Ustawienia tokenu uwierzytelniania, którego zadanie może używać do wykonywania operacji usługi Batch.
Nazwa | Typ | Opis |
---|---|---|
access |
Zasoby usługi Batch, do których token udziela dostępu. |
AutoUserScope
Zakres 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 dla zadania. |
AutoUserSpecification
Określa parametry dla użytkownika automatycznego, który uruchamia zadanie w usłudze Batch.
Nazwa | Typ | Opis |
---|---|---|
elevationLevel |
Poziom podniesienia uprawnień użytkownika automatycznego. |
|
scope |
Zakres użytkownika automatycznego |
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 |
Komunikat opisujący błąd, który ma być odpowiedni do wyświetlania w interfejsie użytkownika. |
|
values |
Kolekcja par klucz-wartość zawierająca dodatkowe szczegóły dotyczące błędu. |
BatchErrorDetail
Element dodatkowych informacji zawartych w odpowiedzi na błąd usługi Azure Batch.
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. |
CloudTask
Zadanie usługi Azure Batch.
Nazwa | Typ | Opis |
---|---|---|
affinityInfo |
Wskazówka dotycząca lokalizacji, która może być używana przez usługę Batch w celu wybrania węzła obliczeniowego, na którym ma zostać uruchomione nowe zadanie. |
|
applicationPackageReferences |
Lista pakietów wdrożonych przez usługę Batch w węźle obliczeniowym przed uruchomieniem wiersza polecenia. |
|
authenticationTokenSettings |
Ustawienia tokenu uwierzytelniania, którego zadanie może używać do wykonywania operacji usługi Batch. |
|
commandLine |
string |
Wiersz polecenia zadania. |
constraints |
Ograniczenia wykonywania, które mają zastosowanie do tego zadania. |
|
containerSettings |
Ustawienia kontenera, w którym jest uruchamiane zadanie. |
|
creationTime |
string |
Czas tworzenia zadania. |
dependsOn |
Zadania, od których zależy to zadanie. |
|
displayName |
string |
Nazwa wyświetlana zadania. |
eTag |
string |
Element ETag zadania. |
environmentSettings |
Lista ustawień zmiennych środowiskowych dla zadania. |
|
executionInfo |
Informacje o wykonaniu zadania. |
|
exitConditions |
Określa, jak usługa Batch powinna odpowiadać po zakończeniu zadania. |
|
id |
string |
Ciąg, który jednoznacznie identyfikuje zadanie w ramach zadania. |
lastModified |
string |
Czas ostatniej modyfikacji zadania. |
multiInstanceSettings |
Obiekt wskazujący, że zadanie jest zadaniem z wieloma wystąpieniami i zawiera informacje o sposobie uruchamiania zadania z wieloma wystąpieniami. |
|
nodeInfo |
Informacje o węźle obliczeniowym, na którym uruchomiono zadanie. |
|
outputFiles |
Lista plików przekazanych przez usługę Batch z węzła obliczeniowego po uruchomieniu wiersza polecenia. |
|
previousState |
Poprzedni stan zadania. |
|
previousStateTransitionTime |
string |
Czas, w którym zadanie wprowadziło poprzedni stan. |
requiredSlots |
integer |
Liczba miejsc planowania, których wymaga uruchomienie zadania. |
resourceFiles |
Lista plików, które usługa Batch pobierze do węzła obliczeniowego przed uruchomieniem wiersza polecenia. |
|
state |
Bieżący stan zadania. |
|
stateTransitionTime |
string |
Czas, w którym zadanie wprowadziło bieżący stan. |
stats |
Statystyki użycia zasobów dla zadania. |
|
url |
string |
Adres URL zadania. |
userIdentity |
Tożsamość użytkownika, w ramach której jest uruchamiane zadanie. |
CloudTaskListResult
Wynik wyświetlania listy zadań w zadaniu.
Nazwa | Typ | Opis |
---|---|---|
odata.nextLink |
string |
Adres URL umożliwiający uzyskanie następnego zestawu wyników. |
value |
Lista zadań. |
ComputeNodeIdentityReference
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.
Nazwa | Typ | Opis |
---|---|---|
resourceId |
string |
Identyfikator zasobu usługi ARM tożsamości przypisanej przez użytkownika. |
ComputeNodeInformation
Informacje o węźle obliczeniowym, na którym uruchomiono zadanie.
Nazwa | Typ | Opis |
---|---|---|
affinityId |
string |
Identyfikator węzła, na którym uruchomiono zadanie, który można przekazać podczas dodawania zadania, aby zażądać, aby zadanie było zaplanowane w tym węźle obliczeniowym. |
nodeId |
string |
Identyfikator węzła obliczeniowego, na którym uruchomiono zadanie. |
nodeUrl |
string |
Adres URL węzła obliczeniowego, na którym uruchomiono zadanie. |
poolId |
string |
Identyfikator puli, na której uruchomiono zadanie. |
taskRootDirectory |
string |
Katalog główny zadania w węźle obliczeniowym. |
taskRootDirectoryUrl |
string |
Adres URL katalogu głównego zadania w węźle obliczeniowym. |
ContainerHostBatchBindMountEntry
Wpis ścieżki i trybu instalacji, który chcesz zainstalować w kontenerze zadań.
Nazwa | Typ | Opis |
---|---|---|
isReadOnly |
boolean |
Zainstaluj tę ścieżkę źródłową jako tryb tylko do odczytu lub nie. Wartość domyślna to false (tryb odczytu/zapisu). |
source |
Można wybrać ścieżkę instalowaną dla klienta kontenera. |
ContainerHostDataPath
Ścieżki, które zostaną zainstalowane w kontenerze zadania kontenera.
Nazwa | Typ | Opis |
---|---|---|
Applications |
string |
Ścieżka aplikacji. |
JobPrep |
string |
Ścieżka zadania przygotowania zadania. |
Shared |
string |
Ścieżka zadania obejmującego wiele wystąpień w celu udostępnienia plików. |
Startup |
string |
Ścieżka zadania podrzędnego uruchamiania. |
Task |
string |
Ścieżka zadania. |
VfsMounts |
string |
Ścieżka zawiera wszystkie wirtualne systemy plików są instalowane w tym węźle. |
ContainerRegistry
Prywatny rejestr kontenerów.
Nazwa | Typ | Opis |
---|---|---|
identityReference |
Odwołanie do tożsamości przypisanej przez użytkownika w celu uzyskania dostępu do usługi Azure Container Registry zamiast nazwy użytkownika i hasła. |
|
password |
string |
Hasło do logowania się na serwerze rejestru. |
registryServer |
string |
Adres URL rejestru. |
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 dla zadań, 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łnij zadania oczekujące na to zadanie; gdy wszystkie zależności zostaną spełnione, 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 być ustawiana w procesie zadania.
Nazwa | Typ | Opis |
---|---|---|
name |
string |
Nazwa zmiennej środowiskowej. |
value |
string |
Wartość zmiennej środowiskowej. |
ErrorCategory
Kategoria błędu.
Nazwa | Typ | Opis |
---|---|---|
servererror |
string |
Błąd jest spowodowany wewnętrznym problemem z serwerem. |
usererror |
string |
Błąd jest spowodowany problemem użytkownika, takim jak błędna konfiguracja. |
ErrorMessage
Komunikat o błędzie odebrany w odpowiedzi na błąd usługi Azure Batch.
Nazwa | Typ | Opis |
---|---|---|
lang |
string |
Kod języka komunikatu o błędzie |
value |
string |
Tekst wiadomości. |
ExitCodeMapping
Jak usługa Batch powinna odpowiadać, jeśli zadanie zakończy działanie z określonym kodem zakończenia.
Nazwa | Typ | Opis |
---|---|---|
code |
integer |
Kod zakończenia procesu. |
exitOptions |
Jak usługa Batch powinna odpowiedzieć, jeśli zadanie zakończy działanie z tym kodem zakończenia. |
ExitCodeRangeMapping
Zakres kodów zakończenia i sposobu, 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 |
Jak usługa Batch powinna odpowiedzieć, jeśli zadanie zakończy działanie z kodem zakończenia w zakresie rozpoczynającym się (włącznie). |
|
start |
integer |
Pierwszy kod zakończenia w zakresie. |
ExitConditions
Określa, jak usługa Batch powinna odpowiadać po zakończeniu zadania.
Nazwa | Typ | Opis |
---|---|---|
default |
Jak usługa Batch powinna odpowiedzieć, jeśli zadanie zakończy się niepowodzeniem z warunkiem zakończenia, który nie jest objęty żadną z innych właściwości. |
|
exitCodeRanges |
Lista zakresów kodu zakończenia zadania i sposobu reagowania na nie przez usługę Batch. |
|
exitCodes |
Lista poszczególnych kodów zakończenia zadania i sposobu, w jaki usługa Batch powinna odpowiadać na nie. |
|
fileUploadError |
Jak usługa Batch powinna odpowiadać w przypadku wystąpienia błędu przekazywania pliku. |
|
preProcessingError |
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 |
Akcja wykonywana przez usługę Batch dla zadań, które zależą od tego zadania. |
|
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". |
HttpHeader
Para nazwa-wartość nagłówka HTTP
Nazwa | Typ | Opis |
---|---|---|
name |
string |
Bez uwzględniania wielkości liter nazwa nagłówka, która ma być używana podczas przekazywania plików wyjściowych |
value |
string |
Wartość nagłówka, która ma być używana podczas przekazywania plików wyjściowych |
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".
Nazwa | Typ | Opis |
---|---|---|
disable |
string |
Wyłącz zadanie. Jest to równoważne wywołaniu interfejsu API wyłączania zadania z wartością disableTasks w kolejce. |
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 obejmującego wiele wystąpień.
Nazwa | Typ | Opis |
---|---|---|
commonResourceFiles |
Lista plików pobranych przez usługę Batch przed uruchomieniem wiersza polecenia koordynacji. |
|
coordinationCommandLine |
string |
Wiersz polecenia do uruchomienia na wszystkich węzłach obliczeniowych, aby umożliwić im koordynowanie, gdy podstawowy uruchamia główne polecenie zadanie. |
numberOfInstances |
integer |
Liczba węzłów obliczeniowych wymaganych przez zadanie. |
NameValuePair
Reprezentuje parę nazwa-wartość.
Nazwa | Typ | Opis |
---|---|---|
name |
string |
Nazwa w parze name-value. |
value |
string |
Wartość w parze name-value. |
OutputFile
Specyfikacja przekazywania plików z węzła obliczeniowego usługi Azure Batch do innej lokalizacji po zakończeniu wykonywania procesu zadania przez usługę Batch.
Nazwa | Typ | Opis |
---|---|---|
destination |
Miejsce docelowe plików wyjściowych. |
|
filePattern |
string |
Wzorzec wskazujący, które pliki mają być przekazywane. |
uploadOptions |
Dodatkowe opcje operacji przekazywania, w tym w 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 usłudze Azure Blob Storage, do którego mają być przekazywane pliki. |
identityReference |
Odwołanie do tożsamości przypisanej przez użytkownika w celu uzyskania dostępu do usługi Azure Blob Storage określonej przez containerUrl |
|
path |
string |
Docelowy obiekt blob lub katalog wirtualny w kontenerze usługi Azure Storage. |
uploadHeaders |
Lista par nazwa-wartość dla nagłówków, które mają być używane podczas przekazywania plików wyjściowych |
OutputFileDestination
Miejsce docelowe, do którego ma zostać przekazany plik.
Nazwa | Typ | Opis |
---|---|---|
container |
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 z kodem zakończenia bezzerowym. |
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, w których należy wykonać przekazywanie.
Nazwa | Typ | Opis |
---|---|---|
uploadCondition |
Warunki, w których należy przekazać plik wyjściowy zadania lub zestaw plików. |
ResourceFile
Jeden plik lub wiele plików do pobrania do węzła obliczeniowego.
Nazwa | Typ | Opis |
---|---|---|
autoStorageContainerName |
string |
Nazwa kontenera magazynu na koncie automatycznego magazynu. |
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. |
fileMode |
string |
Atrybut trybu uprawnień pliku w formacie ósemkowym. |
filePath |
string |
Lokalizacja w węźle obliczeniowym, do którego mają być pobierane pliki względem katalogu roboczego zadania. |
httpUrl |
string |
Adres URL pliku do pobrania. |
identityReference |
Odwołanie do tożsamości przypisanej przez użytkownika w celu uzyskania dostępu do usługi Azure Blob Storage określonej przez wartość storageContainerUrl lub httpUrl |
|
storageContainerUrl |
string |
Adres URL kontenera obiektów blob w usłudze Azure Blob Storage. |
TaskConstraints
Ograniczenia wykonywania, które mają zastosowanie do zadania.
Nazwa | Typ | Opis |
---|---|---|
maxTaskRetryCount |
integer |
Maksymalna liczba ponownych prób wykonania zadania. Usługa Batch ponawia próbę zadania, jeśli jego kod zakończenia jest inny niżzer. |
maxWallClockTime |
string |
Maksymalny czas, który upłynął, który może zostać uruchomiony przez zadanie, mierzony od momentu uruchomienia zadania. Jeśli zadanie nie zostanie ukończone w limicie czasu, usługa Batch zakończy je. |
retentionTime |
string |
Minimalny czas przechowywania katalogu zadań w węźle obliczeniowym, w którym został uruchomiony, od momentu zakończenia wykonywania. Po tym czasie usługa Batch może usunąć katalog Task i całą jego zawartość. |
TaskContainerExecutionInformation
Zawiera informacje o kontenerze, który wykonuje zadanie.
Nazwa | Typ | Opis |
---|---|---|
containerId |
string |
Identyfikator kontenera. |
error |
string |
Szczegółowe informacje o błędzie dotyczące kontenera. |
state |
string |
Stan kontenera. |
TaskContainerSettings
Ustawienia kontenera dla zadania.
Nazwa | Typ | Opis |
---|---|---|
containerHostBatchBindMounts |
Ścieżki, które chcesz zamontować w zadaniu kontenera. |
|
containerRunOptions |
string |
Dodatkowe opcje polecenia create kontenera. |
imageName |
string |
Obraz używany do utworzenia kontenera, w którym zostanie uruchomione zadanie. |
registry |
Prywatny rejestr zawierający obraz kontenera. |
|
workingDirectory |
Lokalizacja katalogu roboczego zadania kontenera. |
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 |
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. |
TaskExecutionInformation
Informacje o wykonywaniu zadania.
Nazwa | Typ | Opis |
---|---|---|
containerInfo |
Informacje o kontenerze, w którym jest wykonywane zadanie. |
|
endTime |
string |
Czas, w którym zadanie zostało ukończone. |
exitCode |
integer |
Kod zakończenia programu określony w wierszu polecenia zadania. |
failureInfo |
Informacje opisujące błąd zadania, jeśli istnieje. |
|
lastRequeueTime |
string |
Ostatni czas, w którym zadanie zostało ponownie w kolejce przez usługę Batch w wyniku żądania użytkownika. |
lastRetryTime |
string |
Ostatni raz, w którym uruchomiono ponowną próbę zadania. |
requeueCount |
integer |
Liczba ponownych kolejek zadania przez usługę Batch w wyniku żądania użytkownika. |
result |
Wynik wykonania zadania. |
|
retryCount |
integer |
Liczba ponownych prób wykonania zadania przez usługę Batch. |
startTime |
string |
Czas, w którym zadanie zaczęło działać. |
TaskExecutionResult
Wynik wykonania zadania.
Nazwa | Typ | Opis |
---|---|---|
failure |
string |
Wystąpił błąd podczas przetwarzania zadania. Błąd mógł wystąpić przed uruchomieniem procesu zadania, podczas wykonywania procesu zadania lub po zakończeniu procesu zadania. |
success |
string |
Zadanie zakończyło się pomyślnie. |
TaskFailureInformation
Informacje o niepowodzeniu zadania.
Nazwa | Typ | Opis |
---|---|---|
category |
Kategoria błędu zadania. |
|
code |
string |
Identyfikator błędu zadania. Kody są niezmienne i mają być używane programowo. |
details |
Lista dodatkowych szczegółów związanych z błędem. |
|
message |
string |
Komunikat opisujący błąd zadania, który ma być odpowiedni do wyświetlania w interfejsie użytkownika. |
TaskIdRange
Zakres identyfikatorów zadań, od których może zależeć zadanie. Wszystkie zadania z identyfikatorami w zakresie muszą zostać ukończone pomyślnie przed zaplanowaniem zależnego zadania.
Nazwa | Typ | Opis |
---|---|---|
end |
integer |
Ostatni identyfikator zadania w zakresie. |
start |
integer |
Pierwszy identyfikator zadania w zakresie. |
TaskState
Stan zadania.
Nazwa | Typ | Opis |
---|---|---|
active |
string |
Zadanie jest w kolejce i można je uruchomić, ale nie jest obecnie przypisane do węzła obliczeniowego. Zadanie wprowadza ten stan po jego utworzeniu, gdy jest włączone po wyłączeniu lub gdy oczekuje na ponowienie próby po nieudanym uruchomieniu. |
completed |
string |
Zadanie nie kwalifikuje się już do uruchomienia, zwykle dlatego, że zadanie zakończyło się pomyślnie lub zadanie zakończyło się niepowodzeniem i wyczerpało limit ponawiania prób. Zadanie jest również oznaczone jako ukończone, jeśli wystąpił błąd podczas uruchamiania zadania lub gdy zadanie zostało zakończone. |
preparing |
string |
Zadanie zostało przydzielone do węzła obliczeniowego, ale oczekuje na ukończenie wymaganego zadania przygotowania zadania w węźle obliczeniowym. Jeśli zadanie przygotowania zadania zakończy się pomyślnie, zadanie zostanie przeniesione do uruchomienia. Jeśli zadanie przygotowania zadania zakończy się niepowodzeniem, zadanie powróci do aktywnej i będzie kwalifikować się do przypisania do innego węzła obliczeniowego. |
running |
string |
Zadanie jest uruchomione w węźle obliczeniowym. Obejmuje to przygotowanie na poziomie zadania, takie jak pobieranie plików zasobów lub wdrażanie pakietów określonych w zadaniu — niekoniecznie oznacza to, że wiersz polecenia zadania rozpoczął wykonywanie. |
TaskStatistics
Statystyki użycia zasobów dla zadania.
Nazwa | Typ | Opis |
---|---|---|
kernelCPUTime |
string |
Łączny czas procesora CPU trybu jądra (sumowany na wszystkich rdzeniach i wszystkich węzłach obliczeniowych) używany przez zadanie. |
lastUpdateTime |
string |
Czas ostatniej aktualizacji statystyk. Wszystkie statystyki są ograniczone do zakresu między startTime i lastUpdateTime. |
readIOGiB |
number |
Łączna liczba gibibajtów odczytanych z dysku przez zadanie. |
readIOps |
integer |
Całkowita liczba operacji odczytu dysku wykonanych przez zadanie. |
startTime |
string |
Godzina rozpoczęcia zakresu czasu objętego statystykami. |
url |
string |
Adres URL statystyk. |
userCPUTime |
string |
Łączny czas procesora CPU trybu użytkownika (sumowany na wszystkich rdzeniach i wszystkich węzłach obliczeniowych) używany przez zadanie. |
waitTime |
string |
Łączny czas oczekiwania zadania. Czas oczekiwania zadania jest definiowany jako czas, który upłynął między utworzeniem zadania a rozpoczęciem wykonywania zadania. (Jeśli zadanie zostanie ponowione z powodu awarii, czas oczekiwania to czas ostatniego wykonania zadania). |
wallClockTime |
string |
Łączna godzina zegara ściany zadania. |
writeIOGiB |
number |
Łączna liczba gibibajtów zapisywanych na dysku przez zadanie. |
writeIOps |
integer |
Całkowita liczba operacji zapisu na dysku wykonanych przez zadanie. |
UserIdentity
Definicja tożsamości użytkownika, w ramach której jest uruchamiane zadanie.
Nazwa | Typ | Opis |
---|---|---|
autoUser |
Użytkownik automatyczny, w ramach którego jest uruchamiane zadanie. |
|
username |
string |
Nazwa tożsamości użytkownika, w ramach której jest uruchamiane zadanie. |