Nodes - List Nodes
Lista węzłów obliczeniowych w określonej puli.
GET {endpoint}/pools/{poolId}/nodes?api-version=2025-06-01
GET {endpoint}/pools/{poolId}/nodes?api-version=2025-06-01&timeOut={timeOut}&maxresults={maxresults}&$filter={$filter}&$select={$select}
Parametry identyfikatora URI
| Nazwa | W | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
endpoint
|
path | True |
string (uri) |
Punkt końcowy konta usługi Batch (na przykład: https://batchaccount.eastus2.batch.azure.com). |
|
pool
|
path | True |
string |
ID puli, z której chcesz wymienić węzły obliczeniowe. |
|
api-version
|
query | True |
string minLength: 1 |
Wersja interfejsu API do użycia dla tej operacji. |
|
$filter
|
query |
string |
Klauzula OData $filter. Więcej informacji o konstrukcji tego filtra można znaleźć w .https://learn.microsoft.com/rest/api/batchservice/odata-filters-in-batch#list-nodes-in-a-pool |
|
|
$select
|
query |
string[] |
Klauzula OData $select. |
|
|
maxresults
|
query |
integer (int32) minimum: 1maximum: 1000 |
Maksymalna liczba elementów do zwrócenia w odpowiedzi. Maksymalnie można zwrócić 1000 wniosków. |
|
|
time
|
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 domyślna wersja domyślna.". |
Nagłówek żądania
| Nazwa | Wymagane | Typ | Opis |
|---|---|---|---|
| client-request-id |
string |
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-rfc7231) |
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 |
Żądanie zakończyło się pomyślnie. Nagłówki
|
|
| Other Status Codes |
Nieoczekiwana odpowiedź na błąd. |
Zabezpieczenia
OAuth2Auth
Typ:
oauth2
Flow:
implicit
Adres URL autoryzacji:
https://login.microsoftonline.com/common/oauth2/v2.0/authorize
Zakresy
| Nazwa | Opis |
|---|---|
| https://batch.core.windows.net//.default |
Przykłady
Node list
Przykładowe żądanie
GET {endpoint}/pools/poolId/nodes?api-version=2025-06-01
Przykładowa odpowiedź
{
"value": [
{
"id": "tvm-1695681911_1-20161122t193202z",
"url": "https://account.region.batch.azure.com/pools/poolId/nodes/tvm-1695681911_1-20161122t193202z",
"state": "idle",
"schedulingState": "enabled",
"stateTransitionTime": "2025-11-22T22:22:27.2236818Z",
"lastBootTime": "2025-11-22T22:22:24.4634125Z",
"allocationTime": "2025-11-22T19:32:02.8155319Z",
"ipAddress": "1.1.1.1",
"ipv6Address": "1.1.1.1",
"affinityId": "TVM:tvm-1695681911_1-20161122t193202z",
"vmSize": "Standard_D2_v5",
"totalTasksRun": 0,
"totalTasksSucceeded": 0,
"runningTasksCount": 0,
"runningTaskSlotsCount": 0,
"isDedicated": true,
"startTask": {
"commandLine": "cmd /c echo hello",
"userIdentity": {
"autoUser": {
"scope": "task",
"elevationLevel": "nonadmin"
}
},
"maxTaskRetryCount": 0,
"waitForSuccess": false
},
"virtualMachineInfo": {
"imageReference": {
"publisher": "Canonical",
"offer": "ubuntu-24_04-lts",
"sku": "server",
"version": "latest",
"exactVersion": "latest"
}
},
"startTaskInfo": {
"state": "completed",
"startTime": "2025-11-22T22:22:27.2236818Z",
"endTime": "2025-11-22T22:22:27.567189Z",
"exitCode": 0,
"retryCount": 0
},
"nodeAgentInfo": {
"version": "1.2.0.0",
"lastUpdateTime": "2025-11-22T22:22:24.4634125Z"
}
},
{
"id": "tvm-1695681911_2-20161122t193202z",
"url": "https://account.region.batch.azure.com/pools/poolId/nodes/tvm-1695681911_2-20161122t193202z",
"state": "idle",
"schedulingState": "enabled",
"stateTransitionTime": "2025-11-22T19:37:31.4285526Z",
"lastBootTime": "2025-11-22T19:37:28.623369Z",
"allocationTime": "2025-11-22T19:32:02.8155319Z",
"ipAddress": "1.1.1.1",
"ipv6Address": "1.1.1.1",
"affinityId": "TVM:tvm-1695681911_2-20161122t193202z",
"vmSize": "Standard_D2_v5",
"totalTasksRun": 0,
"totalTasksSucceeded": 0,
"runningTasksCount": 0,
"runningTaskSlotsCount": 0,
"isDedicated": true,
"startTask": {
"commandLine": "cmd /c echo hello",
"userIdentity": {
"autoUser": {
"scope": "task",
"elevationLevel": "nonadmin"
}
},
"maxTaskRetryCount": 0,
"waitForSuccess": false
},
"virtualMachineInfo": {
"imageReference": {
"publisher": "Canonical",
"offer": "ubuntu-24_04-lts",
"sku": "server",
"version": "latest",
"exactVersion": "latest"
}
},
"startTaskInfo": {
"state": "completed",
"startTime": "2025-11-22T19:37:31.4285526Z",
"endTime": "2025-11-22T19:37:31.838028Z",
"exitCode": 0,
"retryCount": 0
},
"nodeAgentInfo": {
"version": "1.2.0.0",
"lastUpdateTime": "2025-11-22T22:22:24.4634125Z"
}
},
{
"id": "tvm-1695681911_3-20161122t193202z",
"url": "https://account.region.batch.azure.com/pools/poolId/nodes/tvm-1695681911_3-20161122t193202z",
"state": "idle",
"schedulingState": "enabled",
"stateTransitionTime": "2025-11-22T19:36:51.0013378Z",
"lastBootTime": "2025-11-22T19:36:48.21721Z",
"allocationTime": "2025-11-22T19:32:02.8155319Z",
"ipAddress": "1.1.1.1",
"ipv6Address": "1.1.1.1",
"affinityId": "TVM:tvm-1695681911_3-20161122t193202z",
"vmSize": "Standard_D2_v5",
"totalTasksRun": 0,
"totalTasksSucceeded": 0,
"runningTasksCount": 0,
"runningTaskSlotsCount": 0,
"isDedicated": true,
"startTask": {
"commandLine": "cmd /c echo hello",
"userIdentity": {
"autoUser": {
"scope": "task",
"elevationLevel": "nonadmin"
}
},
"maxTaskRetryCount": 0,
"waitForSuccess": false
},
"virtualMachineInfo": {
"imageReference": {
"publisher": "Canonical",
"offer": "ubuntu-24_04-lts",
"sku": "server",
"version": "latest",
"exactVersion": "latest"
}
},
"startTaskInfo": {
"state": "completed",
"startTime": "2025-11-22T19:36:51.0013378Z",
"endTime": "2025-11-22T19:36:51.2363447Z",
"exitCode": 0,
"retryCount": 0
},
"nodeAgentInfo": {
"version": "1.2.0.0",
"lastUpdateTime": "2025-11-22T22:22:24.4634125Z"
}
}
]
}
Definicje
| Nazwa | Opis |
|---|---|
|
Auto |
Enumy AutoUserScope |
|
Auto |
Określa opcje dla użytkownika automatycznego, który uruchamia zadanie usługi Azure 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. |
|
Batch |
Komunikat o błędzie odebrany w odpowiedzi na błąd usługi Azure Batch. |
|
Batch |
Enumy BatchErrorSourceCategory |
|
Batch |
Węzeł obliczeniowy w usłudze Batch. |
|
Batch |
Agent węzła obliczeniowego usługi Batch to program uruchamiany w każdym węźle obliczeniowym w puli i zapewnia możliwość usługi Batch w węźle obliczeniowym. |
|
Batch |
Konfiguracja punktu końcowego dla węzła obliczeniowego. |
|
Batch |
Błąd napotkany przez węzeł obliczeniowy. |
|
Batch |
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. |
|
Batch |
Wynik wyświetlania listy węzłów obliczeniowych w puli. |
|
Batch |
Enums BatchNodeState |
|
Batch |
Usługa Batch ponowi próbę wykonania zadań po wyzwoleniu operacji odzyskiwania w węźle. Przykłady operacji odzyskiwania obejmują (ale nie tylko) ponowne uruchomienie węzła w złej kondycji lub zniknięcie węzła obliczeniowego z powodu awarii hosta. Ponowne próby z powodu operacji odzyskiwania są niezależne i nie są liczone względem parametru maxTaskRetryCount. Nawet jeśli parametr maxTaskRetryCount wynosi 0, może wystąpić wewnętrzna ponowna próba spowodowana operacją odzyskiwania. W związku z tym wszystkie zadania powinny być idempotentne. Oznacza to, że zadania muszą tolerować przerywanie i ponowne uruchamianie bez powodowania uszkodzenia lub duplikowania danych. Najlepszym rozwiązaniem dla długotrwałych zadań jest użycie jakiejś formy tworzenia punktów kontrolnych. W niektórych przypadkach funkcja StartTask może zostać ponownie uruchomiona, mimo że węzeł obliczeniowy nie został ponownie uruchomiony. Należy zachować szczególną ostrożność, aby uniknąć zadań StartTasks, które tworzą proces przerwania lub instalują/uruchamiają usługi z katalogu roboczego StartTask, ponieważ uniemożliwi to usłudze Batch ponowne uruchomienie zadania StartTask. |
|
Batch |
Informacje na temat elementu StartTask uruchomionego w węźle obliczeniowym. |
|
Batch |
Enums BatchStartTaskState |
|
Batch |
Zawiera informacje o kontenerze, który wykonuje zadanie. |
|
Batch |
Ustawienia kontenera dla zadania. |
|
Batch |
Informacje o wykonywaniu zadania. |
|
Batch |
Enumy BatchTaskExecutionResult |
|
Batch |
Informacje o niepowodzeniu zadania. |
|
Batch |
Informacje o zadaniu uruchomionym w węźle obliczeniowym. |
|
Batch |
Enumy BatchTaskState |
|
Batch |
Odwołanie do obrazu witryny Marketplace usługi Azure Virtual Machines lub obrazu galerii obliczeniowej platformy Azure. Aby uzyskać listę wszystkich odwołań do obrazów witryny Azure Marketplace zweryfikowanych przez usługę Azure Batch, zobacz operację "Lista obsługiwanych obrazów". |
|
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 |
Enums ContainerWorkingDirectory |
|
Elevation |
Enumy ElevationLevel |
|
Environment |
Zmienna środowiskowa, która ma być ustawiana w procesie zadania. |
|
Inbound |
Przychodzący punkt końcowy w węźle obliczeniowym. |
|
Inbound |
Enums InboundEndpointProtocol |
|
Name |
Reprezentuje parę nazwa-wartość. |
|
Resource |
Jeden plik lub wiele plików do pobrania do węzła obliczeniowego. |
|
Scheduling |
Harmonogramowanie Stanu |
|
User |
Definicja tożsamości użytkownika, w ramach której jest uruchamiane zadanie. Określ właściwość userName lub autoUser, ale nie obie. |
|
Virtual |
Informacje o bieżącym stanie maszyny wirtualnej. |
AutoUserScope
Enumy AutoUserScope
| Wartość | Opis |
|---|---|
| task |
Określa, że usługa powinna utworzyć nowego użytkownika do zadania. |
| pool |
Określa, że zadanie jest wykonywane jako wspólne automatyczne konto użytkownika, które jest tworzone na każdym węźle obliczeniowym w puli. |
AutoUserSpecification
Określa opcje dla użytkownika automatycznego, który uruchamia zadanie usługi Azure Batch.
| Nazwa | Typ | Opis |
|---|---|---|
| elevationLevel |
Poziom podniesienia uprawnień użytkownika automatycznego. Wartość domyślna to nonAdmin. |
|
| scope |
Zakres 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. Na przykład, jeśli zadanie mutuje rejestr w sposób, który może mieć wpływ na inne zadania. |
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. |
BatchErrorMessage
Komunikat o błędzie odebrany w odpowiedzi na błąd usługi Azure Batch.
| Nazwa | Typ | Opis |
|---|---|---|
| lang |
string |
Kod językowy komunikatu o błędzie. |
| value |
string |
Tekst wiadomości. |
BatchErrorSourceCategory
Enumy BatchErrorSourceCategory
| Wartość | Opis |
|---|---|
| usererror |
Błąd wynika z problemu użytkownika, na przykład z błędnej konfiguracji. |
| servererror |
Błąd wynika z wewnętrznego problemu z serwerem. |
BatchNode
Węzeł obliczeniowy w usłudze Batch.
| Nazwa | Typ | Opis |
|---|---|---|
| affinityId |
string |
Identyfikator, który można przekazać podczas dodawania zadania, aby zażądać, aby zadanie było zaplanowane w tym węźle obliczeniowym. Należy pamiętać, że jest to tylko miękka koligacja. Jeśli docelowy węzeł obliczeniowy jest zajęty lub niedostępny w czasie zaplanowanego zadania, zadanie zostanie zaplanowane w innym miejscu. |
| allocationTime |
string (date-time) |
Czas przydzielania tego węzła obliczeniowego do puli. Jest to czas, kiedy węzeł obliczeniowy został początkowo przydzielony i nie zmienia się po ustawieniu. Nie jest aktualizowany, gdy węzeł obliczeniowy jest poprawiany lub wywłaszczony. |
| endpointConfiguration |
Konfiguracja punktu końcowego dla węzła obliczeniowego. |
|
| errors |
Lista błędów, które są obecnie napotykane przez węzeł obliczeniowy. |
|
| id |
string |
Identyfikator węzła obliczeniowego. Każdy węzeł obliczeniowy dodawany do puli ma przypisany unikatowy identyfikator. Za każdym razem, gdy węzeł obliczeniowy zostanie usunięty z puli, wszystkie jego pliki lokalne zostaną usunięte, a identyfikator zostanie odzyskany i może zostać ponownie użyty dla nowych węzłów obliczeniowych. |
| ipAddress |
string |
Adres IP, którego mogą używać inne węzły do komunikowania się z tym węzłem obliczeniowym. Każdy węzeł obliczeniowy dodawany do puli ma przypisany unikatowy adres IP. Za każdym razem, gdy węzeł obliczeniowy zostanie usunięty z puli, wszystkie jego pliki lokalne zostaną usunięte, a adres IP zostanie odzyskany i może zostać użyty ponownie dla nowych węzłów obliczeniowych. |
| ipv6Address |
string |
Adres IPv6, którego inne węzły mogą używać do komunikowania się z tym węzłem obliczeniowym. Każdy węzeł obliczeniowy dodawany do puli ma przypisany unikatowy adres IP. Za każdym razem, gdy węzeł obliczeniowy zostanie usunięty z puli, wszystkie jego pliki lokalne zostaną usunięte, a adres IP zostanie odzyskany i może zostać użyty ponownie dla nowych węzłów obliczeniowych. Ta właściwość nie będzie dostępna, jeśli pula nie jest skonfigurowana dla protokołu IPv6. |
| isDedicated |
boolean |
Czy ten węzeł obliczeniowy jest dedykowanym węzłem obliczeniowym. Jeśli wartość false, węzeł obliczeniowy jest węzłem obliczeniowym typu spot/low-priority. |
| lastBootTime |
string (date-time) |
Ostatni raz, kiedy węzeł obliczeniowy został uruchomiony. Ta właściwość może nie być obecna, jeśli stan węzła obliczeniowego jest bezużyteczny. |
| nodeAgentInfo |
Informacje o wersji agenta węzła obliczeniowego i czasie uaktualniania węzła obliczeniowego do nowej wersji. |
|
| recentTasks |
Lista zadań, których stan został ostatnio zmieniony. Ta właściwość jest obecna tylko wtedy, gdy co najmniej jedno zadanie zostało uruchomione w tym węźle obliczeniowym, ponieważ zostało przypisane do puli. |
|
| runningTaskSlotsCount |
integer (int32) |
Całkowita liczba miejsc planowania używanych przez aktualnie uruchomione zadania podrzędne w węźle obliczeniowym. Dotyczy to zadań podrzędnych Menedżera zadań i zadań normalnych, ale nie podrzędnych przygotowania zadań, zwolnienia zadania lub uruchamiania. |
| runningTasksCount |
integer (int32) |
Całkowita liczba aktualnie uruchomionych zadań podrzędnych w węźle obliczeniowym. Dotyczy to zadań podrzędnych Menedżera zadań i zadań normalnych, ale nie podrzędnych przygotowania zadań, zwolnienia zadania lub uruchamiania. |
| schedulingState |
Określa, czy węzeł obliczeniowy jest dostępny do planowania zadań. |
|
| startTask |
Zadanie określone do uruchomienia w węźle obliczeniowym podczas dołączania do puli. |
|
| startTaskInfo |
Informacje o środowisku uruchomieniowym dotyczące wykonywania elementu StartTask w węźle obliczeniowym. |
|
| state |
Bieżący stan węzła obliczeniowego. |
|
| stateTransitionTime |
string (date-time) |
Czas, w którym węzeł obliczeniowy wprowadził bieżący stan. |
| totalTasksRun |
integer (int32) |
Całkowita liczba zadań zakończonych w węźle obliczeniowym. Dotyczy to zadań podrzędnych Menedżera zadań i zadań normalnych, ale nie podrzędnych przygotowania zadań, zwolnienia zadania lub uruchamiania. |
| totalTasksSucceeded |
integer (int32) |
Całkowita liczba zadań zakończonych pomyślnie (z kodem exitCode 0) w węźle obliczeniowym. Dotyczy to zadań podrzędnych Menedżera zadań i zadań normalnych, ale nie podrzędnych przygotowania zadań, zwolnienia zadania lub uruchamiania. |
| url |
string (uri) |
Adres URL węzła obliczeniowego. |
| virtualMachineInfo |
Informacje o bieżącym stanie maszyny wirtualnej. |
|
| vmSize |
string |
Rozmiar maszyny wirtualnej hostująca węzeł obliczeniowy. Aby uzyskać informacje o dostępnych rozmiarach maszyn wirtualnych w pulach, zobacz Wybieranie rozmiaru maszyny wirtualnej dla węzłów obliczeniowych w puli Azure Batch (https://learn.microsoft.com/azure/batch/batch-pool-vm-sizes). |
BatchNodeAgentInfo
Agent węzła obliczeniowego usługi Batch to program uruchamiany w każdym węźle obliczeniowym w puli i zapewnia możliwość usługi Batch w węźle obliczeniowym.
| Nazwa | Typ | Opis |
|---|---|---|
| lastUpdateTime |
string (date-time) |
Czas, gdy agent węzła obliczeniowego był aktualizowany na węźle obliczeniowym. To ostatni raz, gdy agent Compute Node został zaktualizowany do nowej wersji. |
| version |
string |
Wersja agenta Batch Compute Node działającego na węźle Compute. Ten numer wersji można sprawdzić w notatkach do wydania agenta Compute Node, znajdujących się w .https://github.com/Azure/Batch/blob/master/changelogs/nodeagent/CHANGELOG.md |
BatchNodeEndpointConfiguration
Konfiguracja punktu końcowego dla węzła obliczeniowego.
| Nazwa | Typ | Opis |
|---|---|---|
| inboundEndpoints |
Lista punktów końcowych przychodzących dostępnych na węźle Compute. |
BatchNodeError
Błąd napotkany przez węzeł obliczeniowy.
| Nazwa | Typ | Opis |
|---|---|---|
| code |
string |
Identyfikator dla błędu węzła Compute. Kody są niezmienne i mają być używane programowo. |
| errorDetails |
Lista dodatkowych szczegółów błędu związanych z błędem węzła obliczeniowego. |
|
| message |
string |
Komunikat opisujący błąd węzła obliczeniowego, przeznaczony do wyświetlania w interfejsie użytkownika. |
BatchNodeIdentityReference
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 (arm-id) |
Identyfikator zasobu usługi ARM tożsamości przypisanej przez użytkownika. |
BatchNodeListResult
Wynik wyświetlania listy węzłów obliczeniowych w puli.
| Nazwa | Typ | Opis |
|---|---|---|
| odata.nextLink |
string (uri) |
Adres URL, aby uzyskać następny zestaw wyników. |
| value |
Lista węzłów obliczeniowych. |
BatchNodeState
Enums BatchNodeState
| Wartość | Opis |
|---|---|
| idle |
Węzeł obliczeniowy obecnie nie wykonuje zadania. |
| rebooting |
Węzeł Compute się restartuje. |
| reimaging |
Węzeł Compute jest reimaginowany. |
| running |
Węzeł Compute wykonuje jedno lub więcej zadań (poza zadaniem startowym). |
| unusable |
Węzeł obliczeniowy nie może być używany do wykonywania zadań z powodu błędów. |
| creating |
Usługa Batch pozyskała bazową maszynę wirtualną z Azure Compute, ale jeszcze nie zaczęła dołączać do Pool. |
| starting |
Usługa Batch rozpoczyna się na bazowej maszynie wirtualnej. |
| waitingforstarttask |
Zadanie StartTask zaczęło działać na węźle Compute, ale ustawiono waitForSuccess i StartTask jeszcze się nie zakończyło. |
| starttaskfailed |
Zadanie StartTask zawiodło na węźle Compute (i wyczerpało wszystkie próby), więc ustawiono waitForSuccess. Węzeł Compute Node nie nadaje się do uruchamiania zadań. |
| unknown |
Usługa Batch straciła kontakt z węzłem Compute i nie zna jego rzeczywistego stanu. |
| leavingpool |
Węzeł Compute opuszcza pulę, albo dlatego, że użytkownik go wyraźnie usunął, albo dlatego, że pula zmienia rozmiar lub automatycznie skaluje się w dół. |
| offline |
Węzeł Obliczeniowy obecnie nie wykonuje Zadania, a planowanie nowych Zadań do Węzła Obliczeniowego jest wyłączone. |
| preempted |
Węzeł obliczeniowy typu spot/low-priority został wywłaszczone. Zadania, które były uruchomione w węźle obliczeniowym, gdy został on wywłaszczone, zostaną ponownie zaplanowane, gdy inny węzeł obliczeniowy stanie się dostępny. |
| upgradingos |
Węzeł Compute Node przechodzi operację aktualizacji systemu operacyjnego. |
| deallocated |
Węzeł Obliczeniowy jest deallokowany. |
| deallocating |
Węzeł Obliczeniowy wykonuje deallocing. |
BatchStartTask
Usługa Batch ponowi próbę wykonania zadań po wyzwoleniu operacji odzyskiwania w węźle. Przykłady operacji odzyskiwania obejmują (ale nie tylko) ponowne uruchomienie węzła w złej kondycji lub zniknięcie węzła obliczeniowego z powodu awarii hosta. Ponowne próby z powodu operacji odzyskiwania są niezależne i nie są liczone względem parametru maxTaskRetryCount. Nawet jeśli parametr maxTaskRetryCount wynosi 0, może wystąpić wewnętrzna ponowna próba spowodowana operacją odzyskiwania. W związku z tym wszystkie zadania powinny być idempotentne. Oznacza to, że zadania muszą tolerować przerywanie i ponowne uruchamianie bez powodowania uszkodzenia lub duplikowania danych. Najlepszym rozwiązaniem dla długotrwałych zadań jest użycie jakiejś formy tworzenia punktów kontrolnych. W niektórych przypadkach funkcja StartTask może zostać ponownie uruchomiona, mimo że węzeł obliczeniowy nie został ponownie uruchomiony. Należy zachować szczególną ostrożność, aby uniknąć zadań StartTasks, które tworzą proces przerwania lub instalują/uruchamiają usługi z katalogu roboczego StartTask, ponieważ uniemożliwi to usłudze Batch ponowne uruchomienie zadania StartTask.
| Nazwa | Typ | Opis |
|---|---|---|
| commandLine |
string |
Wiersz polecenia starttask. 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, pod którym działa StartTask. Gdy to zostanie określone, wszystkie katalogi rekurencyjnie poniżej AZ_BATCH_NODE_ROOT_DIR (korzenia katalogów Azure Batch na węźle) są mapowane do kontenera, wszystkie zmienne środowiskowe Task są mapowane do kontenera, a wiersz poleceń Task jest wykonywany w kontenerze. Pliki wytworzone w kontenerze poza AZ_BATCH_NODE_ROOT_DIR mogą nie być odzwierciedlone na dysku hosta, co oznacza, że API plików wsadowych nie będą miały dostępu do tych plików. |
|
| environmentSettings |
Lista ustawień zmiennych środowiskowych dla elementu StartTask. |
|
| maxTaskRetryCount |
integer (int32) |
Maksymalna liczba ponownych prób wykonania 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 wykonać 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 ponowi próby wykonania zadania. Jeśli maksymalna liczba ponownych prób wynosi -1, usługa Batch ponawia próbę zadania bez limitu, jednak nie jest to zalecane w przypadku zadania podrzędnego uruchamiania ani żadnego zadania podrzędnego. Wartość domyślna to 0 (bez ponownych prób). |
| 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. |
|
| userIdentity |
Tożsamość użytkownika, pod którą działa StartTask. Jeśli zostanie pominięte, Zadanie działa jako użytkownik nieadministracyjny, unikalny dla Zadania. |
|
| waitForSuccess |
boolean |
Czy usługa Batch powinna czekać na pomyślne zakończenie zadania StartTask (czyli zakończenie z kodem zakończenia 0) przed zaplanowaniem zadań w węźle obliczeniowym. Jeśli wartość true i parametr StartTask zakończy się niepowodzeniem w węźle, usługa Batch ponawia próbę do maksymalnej liczby ponownych prób (maxTaskRetryCount). Jeśli zadanie nadal nie zostało ukończone pomyślnie po ponownych próbach, usługa Batch oznacza węzeł bezużyteczny i nie będzie planować zadań do niego. Ten warunek można wykryć za pomocą szczegółów stanu węzła obliczeniowego i informacji o błędzie. Jeśli wartość false, usługa Batch nie będzie czekać na ukończenie zadania StartTask. W takim przypadku inne zadania mogą rozpocząć wykonywanie w węźle obliczeniowym, gdy funkcja StartTask jest nadal uruchomiona; a nawet jeśli zadanie StartTask zakończy się niepowodzeniem, nowe zadania będą nadal zaplanowane w węźle obliczeniowym. Wartość domyślna to true. |
BatchStartTaskInfo
Informacje na temat elementu StartTask uruchomionego w węźle obliczeniowym.
| Nazwa | Typ | Opis |
|---|---|---|
| containerInfo |
Informacje o kontenerze, w którym wykonywane jest zadanie. Ta właściwość jest ustawiona tylko wtedy, gdy zadanie działa w kontekście kontenerowym. |
|
| endTime |
string (date-time) |
Moment, w którym StartTask przestało działać. To jest czas zakończenia najnowszego uruchomienia StartTask, jeśli ten rozpoczęcie się zakończył (nawet jeśli ten rozpoczęcie zakończył się niepowodzeniem i jest w toku powtórka). Ten element nie występuje, jeśli StartTask jest aktualnie uruchomiony. |
| exitCode |
integer (int32) |
Kod wyjścia programu określony w wierszu poleceń StartTask. Ta właściwość jest ustawiana tylko wtedy, gdy StartTask znajduje się w stanie ukończenia. Ogólnie rzecz biorąc, kod wyjścia dla procesu odzwierciedla konkretną konwencję zaimplementowaną przez twórcę aplikacji dla tego procesu. Jeśli używasz wartości kodu wyjścia do podejmowania decyzji w kodzie, upewnij się, że znasz konwencję kodu wyjścia stosowaną przez proces aplikacji. Jednak jeśli usługa Batch zakończy StartTask (z powodu limitu czasu lub zakończenia użytkownika przez API), możesz zobaczyć kod wyjściowy zdefiniowany przez system operacyjny. |
| failureInfo |
Informacje opisujące ewentualne niepowodzenie zadania. Ta właściwość jest ustawiona tylko wtedy, gdy zadanie jest w stanie ukończonym i napotkało awarię. |
|
| lastRetryTime |
string (date-time) |
Ostatni raz, gdy rozpoczęła się powtórka zadania. Ten element występuje tylko wtedy, gdy zadanie zostało ponownie spróbowane (tzn. retryCount jest różny od zera). Jeśli jest obecny, zazwyczaj jest to to samo co startTime, ale może się różnić, jeśli zadanie zostało ponownie uruchomione z powodów innych niż powtórka; na przykład, jeśli węzeł obliczeniowy został zrestartowany podczas ponownej próby, to czas startu zostaje zaktualizowany, ale ostatni czas próby próby nie. |
| result |
Wynik wykonania zadania. Jeśli wartość to 'failed', szczegóły awarii można znaleźć w właściwości failureInfo. |
|
| retryCount |
integer (int32) |
Liczba powtórzeń wykonania zadania przez usługę wsadową. Błędy aplikacji zadania (niezerowy kod wyjścia) są powtarzane, błędy wstępnego przetwarzania (zadanie nie mogło zostać wykonane), a błędy przesyłania plików nie są powtarzane. Usługa Batch ponownie spróbuje zadanie do limitu określonego przez ograniczenia. |
| startTime |
string (date-time) |
Czas, w którym StartTask zaczął działać. Ta wartość jest resetowana za każdym razem, gdy zadanie jest restartowane lub próbowane (czyli jest to ostatni moment, gdy StartTask zaczęło działać). |
| state |
Stan StartTask na węźle obliczeniowym. |
BatchStartTaskState
Enums BatchStartTaskState
| Wartość | Opis |
|---|---|
| running |
StartTask jest obecnie uruchomiony. |
| completed |
StartTask zakończyło się z kodem wyjścia 0, StartTask zawiodło i limit powtórek został osiągnięty, albo proces StartTask nie został uruchomiony z powodu błędów przygotowania zadań (takich jak niepowodzenia pobierania plików zasobów). |
BatchTaskContainerExecutionInfo
Zawiera informacje o kontenerze, który wykonuje zadanie.
| Nazwa | Typ | Opis |
|---|---|---|
| containerId |
string |
Identyfikacja kontenera. |
| error |
string |
Szczegółowe informacje o błędach dotyczących kontenera. To jest szczegółowy ciąg błędów z usługi Docker, jeśli jest dostępny. Jest równoważne polu błędu zwracanemu przez "docker inspect". |
| state |
string |
Stan pojemnika. Taki jest stan kontenera według usługi Docker. Jest to równoważne polu statusu zwracanemu przez "docker inspect". |
BatchTaskContainerSettings
Ustawienia kontenera dla zadania.
| Nazwa | Typ | Opis |
|---|---|---|
| containerHostBatchBindMounts |
Ścieżki, które chcesz zamontować w zadaniu kontenera. Jeśli ta tablica ma wartość null lub nie istnieje, zadanie kontenera zainstaluje cały dysk tymczasowy w systemie Windows (lub AZ_BATCH_NODE_ROOT_DIR w systemie Linux). Jeśli ta tablica jest ustawiona jako pusta, nie zainstaluje żadnych ścieżek danych w kontenerze. |
|
| containerRunOptions |
string |
Dodatkowe opcje polecenia create kontenera. Te dodatkowe opcje są dostarczane jako argumenty polecenia "docker create" oprócz tych kontrolowanych przez usługę Batch. |
| imageName |
string |
Obraz, którego używa się do stworzenia kontenera, w którym zadanie będzie działać. To jest pełne odniesienie do Image, jak byłoby określone jako "docker pull". Jeśli w nazwie obrazu nie ma tagu, domyślnie używa się tagu ":latest". |
| registry |
Prywatny rejestr, który zawiera obraz kontenera. To ustawienie można pominąć, jeśli było już dostępne podczas tworzenia puli. |
|
| workingDirectory |
Lokalizacja katalogu roboczego kontenera Task. Wartość domyślna to "taskWorkingDirectory". |
BatchTaskExecutionInfo
Informacje o wykonywaniu zadania.
| Nazwa | Typ | Opis |
|---|---|---|
| containerInfo |
Informacje o kontenerze, w którym wykonywane jest zadanie. Ta właściwość jest ustawiona tylko wtedy, gdy zadanie działa w kontekście kontenerowym. |
|
| endTime |
string (date-time) |
Czas, w którym zadanie zostało ukończone. Ta właściwość jest ustawiona tylko wtedy, gdy zadanie znajduje się w stanie Zakończone. |
| exitCode |
integer (int32) |
Kod wyjścia programu określony w wierszu poleceń Task. Ta właściwość jest ustawiana tylko wtedy, gdy zadanie znajduje się w stanie ukończonym. Ogólnie rzecz biorąc, kod wyjścia dla procesu odzwierciedla konkretną konwencję zaimplementowaną przez twórcę aplikacji dla tego procesu. Jeśli używasz wartości kodu wyjścia do podejmowania decyzji w kodzie, upewnij się, że znasz konwencję kodu wyjścia stosowaną przez proces aplikacji. Jednak jeśli usługa wsadowa zakończy zadanie (z powodu limitu czasu lub zakończenia przez API), możesz zobaczyć kod wyjścia zdefiniowany przez system operacyjny. |
| failureInfo |
Informacje opisujące ewentualne niepowodzenie zadania. Ta właściwość jest ustawiona tylko wtedy, gdy zadanie jest w stanie ukończonym i napotkało awarię. |
|
| lastRequeueTime |
string (date-time) |
Ostatni raz, gdy zadanie zostało ponownie zakolejone przez usługę Batch w wyniku żądania użytkownika. Ta właściwość jest ustawiana tylko wtedy, gdy liczba requeueCount jest różna od zera. |
| lastRetryTime |
string (date-time) |
Ostatni raz, gdy rozpoczęła się powtórka zadania. Ten element występuje tylko wtedy, gdy zadanie zostało ponownie spróbowane (tzn. retryCount jest różny od zera). Jeśli jest obecny, zazwyczaj jest to to samo co startTime, ale może się różnić, jeśli zadanie zostało ponownie uruchomione z powodów innych niż powtórka; na przykład, jeśli węzeł obliczeniowy został zrestartowany podczas ponownej próby, to czas startu zostaje zaktualizowany, ale ostatni czas próby próby nie. |
| requeueCount |
integer (int32) |
Liczba razy, gdy zadanie było ponownie kolejkowane przez usługę wsadową w wyniku żądania użytkownika. Gdy użytkownik usuwa węzły obliczeniowe z puli (poprzez zmianę rozmiaru/zmniejszanie puli) lub gdy zadanie jest wyłączane, użytkownik może określić, że wykonywane zadania na węzłach obliczeniowych zostaną ponownie zakolejone do wykonania. To liczenie pokazuje, ile razy zadanie było ponownie kolejkowane z tych powodów. |
| result |
Wynik wykonania zadania. Jeśli wartość to 'failed', szczegóły awarii można znaleźć w właściwości failureInfo. |
|
| retryCount |
integer (int32) |
Liczba powtórzeń wykonania zadania przez usługę wsadową. Błędy aplikacji zadania (niezerowy kod wyjścia) są powtarzane, błędy wstępnego przetwarzania (zadanie nie mogło zostać wykonane), a błędy przesyłania plików nie są powtarzane. Usługa Batch ponownie spróbuje zadanie do limitu określonego przez ograniczenia. |
| startTime |
string (date-time) |
Czas, w którym Zadanie zaczęło działać. "Running" odpowiada stanowi działania (running), więc jeśli zadanie określa pliki zasobów lub pakiety, to czas rozpoczęcia odzwierciedla moment, w którym zadanie zaczęło je pobierać lub wdrażać. Jeśli zadanie zostało ponownie uruchomione lub podjęte ponownie, to jest to najnowszy moment, kiedy zadanie zaczęło działać. Ta właściwość występuje tylko dla zadań będących w stanie uruchomienia lub zakończenia. |
BatchTaskExecutionResult
Enumy BatchTaskExecutionResult
| Wartość | Opis |
|---|---|
| success |
Zadanie przebiegło pomyślnie. |
| failure |
Podczas przetwarzania zadania wystąpił błąd. Awaria mogła nastąpić przed uruchomieniem procesu Zadania, podczas jego wykonywania lub po jego zakończeniu. |
BatchTaskFailureInfo
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 tym błędem. |
|
| message |
string |
Komunikat opisujący błąd zadania, przeznaczony do wyświetlania w interfejsie użytkownika. |
BatchTaskInfo
Informacje o zadaniu uruchomionym w węźle obliczeniowym.
| Nazwa | Typ | Opis |
|---|---|---|
| executionInfo |
Informacje o realizacji zadania. |
|
| jobId |
string |
ID zadania, do którego należy zadanie. |
| subtaskId |
integer (int32) |
ID podzadania, jeśli zadanie jest zadaniem wieloinstancyjnym. |
| taskId |
string |
Identyfikator zadania. |
| taskState |
Obecny stan Zadania. |
|
| taskUrl |
string (uri) |
URL zadania. |
BatchTaskState
Enumy BatchTaskState
| Wartość | Opis |
|---|---|
| active |
Zadanie jest w kolejce i może się uruchomić, ale obecnie nie jest przypisane do węzła obliczeniowego. Zadanie wchodzi w ten stan w momencie utworzenia, gdy jest włączone po wyłączeniu lub gdy oczekuje na ponowną próbę po nieudanym uruchomieniu. |
| preparing |
Zadanie zostało przypisane do węzła obliczeniowego, ale czeka na wykonanie wymaganego zadania przygotowania zadania na tym węźle. Jeśli zadanie Przygotowania Zadania zakończy się sukcesem, przechodzi do działania. Jeśli zadanie Przygotowania Zadania nie powiedzie, Zadanie powróci do aktywnego stanu i będzie kwalifikować się do przypisania do innego węzła obliczeniowego. |
| running |
Zadanie jest uruchamiane na węźle obliczeniowym. Obejmuje to przygotowanie na poziomie zadania, takie jak pobieranie plików zasobów czy wdrażanie pakietów określonych w zadaniu – nie oznacza to koniecznie, że linia poleceń zadania rozpoczęła działanie. |
| completed |
Zadanie nie może już zostać wykonane, zazwyczaj dlatego, że zadanie zakończyło się pomyślnie lub zadanie zakończyło się niepowodzeniem i wyczerpało limit powtórek. Zadanie jest również oznaczane jako zakończone, jeśli wystąpił błąd podczas jego uruchomienia lub gdy zadanie zostało zakończone. |
BatchVmImageReference
Odwołanie do obrazu witryny Marketplace usługi Azure Virtual Machines lub obrazu galerii obliczeniowej platformy Azure. Aby uzyskać listę wszystkich odwołań do obrazów witryny Azure Marketplace zweryfikowanych przez usługę Azure Batch, zobacz operację "Lista obsługiwanych obrazów".
| Nazwa | Typ | Opis |
|---|---|---|
| communityGalleryImageId |
string |
Unikalny identyfikator obrazu galerii społecznościowej. Ta właściwość wzajemnie wyklucza się z innymi właściwościami i może być pobierana z wywołania GET obrazu galerii społeczności. |
| exactVersion |
string |
Konkretna wersja obrazu platformy lub marketplace użytego do stworzenia węzła. To pole tylko do odczytu różni się od 'version' tylko wtedy, gdy wartość podany dla 'version' podczas tworzenia puli była 'laprint'. |
| offer |
string |
Typ oferty to Azure Virtual Machines Marketplace Image. Na przykład UbuntuServer lub WindowsServer. |
| publisher |
string |
Wydawca obrazu Azure Virtual Machines Marketplace. Na przykład Canonical lub MicrosoftWindowsServer. |
| sharedGalleryImageId |
string |
Unikalny identyfikator wspólnego zdjęcia galerii. Ta właściwość wzajemnie wyklucza się z innymi właściwościami i może zostać pobrana z wywołania GET obrazu galerii udostępnionej. |
| sku |
string |
SKU obrazu Azure Virtual Machines Marketplace. Na przykład 18.04-LTS lub 2019-Datacenter. |
| version |
string |
Wersja Azure Virtual Machines Marketplace Image. Można określić wartość 'najnowszy', aby wybrać najnowszą wersję obrazu. W przypadku pominięcia wartość domyślna to "latest". |
| virtualMachineImageId |
string (arm-id) |
Identyfikator zasobu usługi ARM obrazu galerii obliczeniowej platformy Azure. Węzły obliczeniowe w puli będą tworzone za pomocą tego ID obrazu. Ma ona formę /subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Compute/galleries/{galleryName}/images/{imageDefinitionName}/versions/{VersionId} lub /subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Compute/galleries/{galleryName}/images/{imageDefinitionName}, gdzie zawsze domyślnie wraca do najnowszej wersji obrazu. Ta własność jest wzajemnie wyłączna z innymi właściwościami ImageReference. Obraz Azure Compute Gallery Gallery musi mieć repliki w tym samym regionie i musi być w tej samej subskrypcji co konto Azure Batch. Jeśli wersja obrazu nie jest określona w imageId, zostanie użyta najnowsza wersja. Aby uzyskać informacje o ustawieniach zapory dla agenta Batch Compute Node, aby komunikował się z usługą https://learn.microsoft.com/azure/batch/nodes-and-pools#virtual-network-vnet-and-firewall-configurationBatch . |
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). W przypadku systemu Linux, jeśli zainstalujesz tę ścieżkę jako tryb odczytu/zapisu, nie oznacza to, że wszyscy użytkownicy w kontenerze mają dostęp do odczytu/zapisu dla ścieżki, zależy to od dostępu na maszynie wirtualnej hosta. Jeśli ta ścieżka jest instalowana tylko do odczytu, wszyscy użytkownicy w kontenerze nie będą mogli modyfikować ścieżki. |
| source |
Można wybrać ścieżkę instalowaną dla klienta kontenera. |
ContainerHostDataPath
Ścieżki, które zostaną zainstalowane w kontenerze zadania kontenera.
| Wartość | Opis |
|---|---|
| Shared |
Ścieżka zadania obejmującego wiele wystąpień w celu udostępnienia plików. |
| Startup |
Ścieżka zadania podrzędnego uruchamiania. |
| VfsMounts |
Ścieżka zawiera wszystkie wirtualne systemy plików są instalowane w tym węźle. |
| Task |
Ścieżka zadania. |
| JobPrep |
Ścieżka zadania przygotowania zadania. |
| Applications |
Ścieżka aplikacji. |
ContainerRegistryReference
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 (password) |
Hasło do logowania się na serwerze rejestru. |
| registryServer |
string (uri) |
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
Enums ContainerWorkingDirectory
| Wartość | Opis |
|---|---|
| taskWorkingDirectory |
Użyj standardowego katalogu roboczygo Batch Service Task Task (Task Service Working Folder), który będzie zawierał pliki zasobów zadań wypełnione przez Batch. |
| containerImageDefault |
Użyj katalogu roboczego zdefiniowanego w kontenerze Image. Należy pamiętać, że ten katalog nie będzie zawierał plików zasobów pobranych przez Batch. |
ElevationLevel
Enumy ElevationLevel
| Wartość | Opis |
|---|---|
| nonadmin |
Użytkownik jest użytkownikiem standardowym bez podwyższonego poziomu dostępu. |
| admin |
Użytkownik jest użytkownikiem z podwyższonym poziomem dostępu i działa z pełnymi uprawnieniami administratora. |
EnvironmentSetting
Zmienna środowiskowa, która ma być ustawiana w procesie zadania.
| Nazwa | Typ | Opis |
|---|---|---|
| name |
string |
Nazwa zmiennej środowiskowej. |
| value |
string |
Wartość zmiennej środowiskowej. |
InboundEndpoint
Przychodzący punkt końcowy w węźle obliczeniowym.
| Nazwa | Typ | Opis |
|---|---|---|
| backendPort |
integer (int32) |
Numer portu backendowego punktu końcowego. |
| frontendPort |
integer (int32) |
Publiczny numer portu końcowego. |
| name |
string |
Nazwa punktu końcowego. |
| protocol |
Protokół punktu końcowego. |
|
| publicFQDN |
string |
Publiczna, w pełni kwalifikowana domena dla węzła obliczeniowego. |
| publicIPAddress |
string |
Publiczny adres IP węzła Compute. |
InboundEndpointProtocol
Enums InboundEndpointProtocol
| Wartość | Opis |
|---|---|
| tcp |
Użyj protokołu TCP dla punktu końcowego. |
| udp |
Użyj protokołu UDP dla punktu końcowego. |
NameValuePair
Reprezentuje parę nazwa-wartość.
| Nazwa | Typ | Opis |
|---|---|---|
| name |
string |
Nazwa w parze imię-wartość. |
| value |
string |
Wartość w parze imię-wartość. |
ResourceFile
Jeden plik lub wiele plików do pobrania do węzła obliczeniowego.
| Nazwa | Typ | Opis |
|---|---|---|
| autoStorageContainerName |
string |
Nazwa kontenera magazynowego w konto automatycznego przechowywania. 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, zostaną pobrane wszystkie pliki w kontenerze. |
| fileMode |
string |
Atrybut trybu uprawnień pliku w formacie ósemkowym. Ta właściwość dotyczy tylko plików pobieranych do Linux Compute Nodes. Zostanie zignorowany, jeśli jest określony dla pliku zasobów, który zostanie pobrany do węzła obliczeń Windows. Jeśli ta właściwość nie jest określona dla węzła obliczeniowego Linuksa, do pliku przypisywana jest domyślna wartość 0770. |
| filePath |
string |
Lokalizacja na węźle obliczeniowym, do której należy pobrać plik(y), względem katalogu roboczego zadania. Jeśli określono właściwość httpUrl, 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 filePath 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 wyjść z katalogu roboczego zadania (na przykład używając '..'). |
| httpUrl |
string (uri) |
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 usługę Azure Blob Storage, musi być czytelny z węzłów obliczeniowych. Istnieją trzy sposoby uzyskiwania takiego adresu URL dla obiektu blob w usłudze Azure Storage: obejmują sygnaturę dostępu współdzielonego udzielając uprawnień do odczytu dla obiektu blob, używanie tożsamości zarządzanej z uprawnieniami do odczytu lub ustawianie listy ACL dla obiektu blob lub kontenera, aby zezwolić na dostęp publiczny. |
| identityReference |
Odniesienie do tożsamości przypisanej przez użytkownika do dostępu do Azure Blob Storage określone przez storageContainerUrl lub httpUrl. |
|
| storageContainerUrl |
string (uri) |
Adres URL kontenera obiektów blob w usłudze 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 uzyskania takiego adresu URL dla kontenera w usłudze Azure Storage: obejmują sygnaturę dostępu współdzielonego (SAS) udzielając uprawnień do odczytu i listy w kontenerze, używanie tożsamości zarządzanej z uprawnieniami do odczytu i listy lub ustawianie listy ACL dla kontenera, aby zezwolić na dostęp publiczny. |
SchedulingState
Harmonogramowanie Stanu
| Wartość | Opis |
|---|---|
| enabled |
Zadania mogą być planowane na węźle obliczeniowym. |
| disabled |
Na węźle Compute nie będą planowane żadne nowe zadania. Zadania już działające na węźle obliczeniowym mogą nadal być zakończone. Wszystkie węzły obliczeniowe zaczynają się z włączonym harmonogramem. |
UserIdentity
Definicja tożsamości użytkownika, w ramach której jest uruchamiane zadanie. Określ właściwość userName lub autoUser, ale nie obie.
| Nazwa | Typ | Opis |
|---|---|---|
| autoUser |
Użytkownik automatyczny, pod którym uruchamiane jest zadanie. Właściwości userName i autoUser wzajemnie się wykluczają; należy określić jeden, ale nie oba te elementy. |
|
| username |
string |
Nazwa tożsamości użytkownika, pod którą wykonywane jest zadanie. Właściwości userName i autoUser wzajemnie się wykluczają; należy określić jeden, ale nie oba te elementy. |
VirtualMachineInfo
Informacje o bieżącym stanie maszyny wirtualnej.
| Nazwa | Typ | Opis |
|---|---|---|
| imageReference |
Odniesienie do obrazu Marketplace z Azure Virtual Machine. |
|
| scaleSetVmResourceId |
string |
Identyfikator zasobu aktualnego VM Virtual Machine Scale Set węzła obliczeniowego. Zdefiniowane tylko wtedy, gdy konto wsadowe zostało utworzone z własnością poolAllocationMode ustawioną na 'UserSubscription'. |