Udostępnij przez


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).

poolId
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: 1
maximum: 1000

Maksymalna liczba elementów do zwrócenia w odpowiedzi. Maksymalnie można zwrócić 1000 wniosków.

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 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

BatchNodeListResult

Żądanie zakończyło się pomyślnie.

Nagłówki

  • ETag: string
  • Last-Modified: string
  • client-request-id: string
  • request-id: string
Other Status Codes

BatchError

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
AutoUserScope

Enumy AutoUserScope

AutoUserSpecification

Określa opcje dla użytkownika automatycznego, który uruchamia zadanie usługi Azure Batch.

BatchError

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

BatchErrorDetail

Element dodatkowych informacji zawartych w odpowiedzi na błąd usługi Azure Batch.

BatchErrorMessage

Komunikat o błędzie odebrany w odpowiedzi na błąd usługi Azure Batch.

BatchErrorSourceCategory

Enumy BatchErrorSourceCategory

BatchNode

Węzeł obliczeniowy w usłudze Batch.

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.

BatchNodeEndpointConfiguration

Konfiguracja punktu końcowego dla węzła obliczeniowego.

BatchNodeError

Błąd napotkany przez węzeł obliczeniowy.

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.

BatchNodeListResult

Wynik wyświetlania listy węzłów obliczeniowych w puli.

BatchNodeState

Enums BatchNodeState

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.

BatchStartTaskInfo

Informacje na temat elementu StartTask uruchomionego w węźle obliczeniowym.

BatchStartTaskState

Enums BatchStartTaskState

BatchTaskContainerExecutionInfo

Zawiera informacje o kontenerze, który wykonuje zadanie.

BatchTaskContainerSettings

Ustawienia kontenera dla zadania.

BatchTaskExecutionInfo

Informacje o wykonywaniu zadania.

BatchTaskExecutionResult

Enumy BatchTaskExecutionResult

BatchTaskFailureInfo

Informacje o niepowodzeniu zadania.

BatchTaskInfo

Informacje o zadaniu uruchomionym w węźle obliczeniowym.

BatchTaskState

Enumy BatchTaskState

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".

ContainerHostBatchBindMountEntry

Wpis ścieżki i trybu instalacji, który chcesz zainstalować w kontenerze zadań.

ContainerHostDataPath

Ścieżki, które zostaną zainstalowane w kontenerze zadania kontenera.

ContainerRegistryReference

Prywatny rejestr kontenerów.

ContainerWorkingDirectory

Enums ContainerWorkingDirectory

ElevationLevel

Enumy ElevationLevel

EnvironmentSetting

Zmienna środowiskowa, która ma być ustawiana w procesie zadania.

InboundEndpoint

Przychodzący punkt końcowy w węźle obliczeniowym.

InboundEndpointProtocol

Enums InboundEndpointProtocol

NameValuePair

Reprezentuje parę nazwa-wartość.

ResourceFile

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

SchedulingState

Harmonogramowanie Stanu

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.

VirtualMachineInfo

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

ElevationLevel

Poziom podniesienia uprawnień użytkownika automatycznego. Wartość domyślna to nonAdmin.

scope

AutoUserScope

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

BatchErrorMessage

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 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

BatchNodeEndpointConfiguration

Konfiguracja punktu końcowego dla węzła obliczeniowego.

errors

BatchNodeError[]

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

BatchNodeAgentInfo

Informacje o wersji agenta węzła obliczeniowego i czasie uaktualniania węzła obliczeniowego do nowej wersji.

recentTasks

BatchTaskInfo[]

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

SchedulingState

Określa, czy węzeł obliczeniowy jest dostępny do planowania zadań.

startTask

BatchStartTask

Zadanie określone do uruchomienia w węźle obliczeniowym podczas dołączania do puli.

startTaskInfo

BatchStartTaskInfo

Informacje o środowisku uruchomieniowym dotyczące wykonywania elementu StartTask w węźle obliczeniowym.

state

BatchNodeState

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

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

InboundEndpoint[]

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

NameValuePair[]

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

BatchNode[]

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

BatchTaskContainerSettings

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

EnvironmentSetting[]

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

ResourceFile[]

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

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

BatchTaskContainerExecutionInfo

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

BatchTaskFailureInfo

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

BatchTaskExecutionResult

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

BatchStartTaskState

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

ContainerHostBatchBindMountEntry[]

Ś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

ContainerRegistryReference

Prywatny rejestr, który zawiera obraz kontenera. To ustawienie można pominąć, jeśli było już dostępne podczas tworzenia puli.

workingDirectory

ContainerWorkingDirectory

Lokalizacja katalogu roboczego kontenera Task. Wartość domyślna to "taskWorkingDirectory".

BatchTaskExecutionInfo

Informacje o wykonywaniu zadania.

Nazwa Typ Opis
containerInfo

BatchTaskContainerExecutionInfo

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

BatchTaskFailureInfo

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

BatchTaskExecutionResult

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

BatchErrorSourceCategory

Kategoria błędu zadania.

code

string

Identyfikator błędu Zadania. Kody są niezmienne i mają być używane programowo.

details

NameValuePair[]

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

BatchTaskExecutionInfo

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

BatchTaskState

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

ContainerHostDataPath

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

BatchNodeIdentityReference

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

InboundEndpointProtocol

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

BatchNodeIdentityReference

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

AutoUserSpecification

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

BatchVmImageReference

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'.