Job Schedule - List

Wyświetla listę wszystkich harmonogramów zadań na określonym koncie.

GET {batchUrl}/jobschedules?api-version=2022-01-01.15.0
GET {batchUrl}/jobschedules?$filter={$filter}&$select={$select}&$expand={$expand}&maxresults={maxresults}&timeout={timeout}&api-version=2022-01-01.15.0

Parametry identyfikatora URI

Name In Required Type Description
batchUrl
path True
  • string

Podstawowy adres URL wszystkich żądań obsługi Azure Batch.

api-version
query True
  • string

Wersja interfejsu API klienta.

$expand
query
  • string

Klauzula $expand OData.

$filter
query
  • string

Klauzula $filter OData. Aby uzyskać więcej informacji na temat konstruowania tego filtru, zobacz https://docs.microsoft.com/en-us/rest/api/batchservice/odata-filters-in-batch#list-job-schedules.

$select
query
  • string

Klauzula $select OData.

maxresults
query
  • integer
int32

Maksymalna liczba elementów do zwrócenia w odpowiedzi. Można zwrócić maksymalnie 1000 harmonogramów zadań.

timeout
query
  • integer
int32

Maksymalny czas, który serwer może poświęcić na przetwarzanie żądania w sekundach. Wartość domyślna to 30 sekund.

Nagłówek żądania

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

Name Required Type Description
client-request-id
  • string
uuid

Tożsamość żądania wygenerowanego przez obiekt wywołujący w postaci identyfikatora GUID bez dekoracji, takiej jak nawiasy klamrowe, np. 9C4D50EE-2D56-4CD3-8152-34347DC9F2B0.

return-client-request-id
  • boolean

Czy serwer powinien zwrócić wartość client-request-id w odpowiedzi.

ocp-date
  • string
date-time-rfc1123

Czas wystawienia żądania. Biblioteki klienckie zazwyczaj ustawiają tę wartość na bieżący czas zegara systemowego; ustaw go jawnie, jeśli bezpośrednio wywołujesz interfejs API REST.

Odpowiedzi

Name Type Description
200 OK

Odpowiedź zawierająca listę harmonogramów zadań.

Headers

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

Błąd usługi Batch.

Zabezpieczenia

azure_auth

Azure Active Directory OAuth2 Flow

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name Description
user_impersonation Personifikuj konto użytkownika

Authorization

Type: apiKey
In: header

Przykłady

JobSchedule list

Sample Request

GET account.region.batch.azure.com/jobschedules?api-version=2022-01-01.15.0


Sample Response

{
  "value": [
    {
      "id": "jobSchedule1",
      "url": "https://account.region.batch.azure.com/jobschedules/jobSchedule1",
      "eTag": "0x8D40FFD2E10996A",
      "lastModified": "2016-11-18T21:52:24.0064874Z",
      "creationTime": "2016-11-18T21:52:22.5431125Z",
      "state": "active",
      "stateTransitionTime": "2016-11-18T21:52:24.0064874Z",
      "previousState": "disabled",
      "previousStateTransitionTime": "2016-11-18T21:52:23.6471782Z",
      "jobSpecification": {
        "priority": 0,
        "maxParallelTasks": -1,
        "allowTaskPreemption": false,
        "usesTaskDependencies": false,
        "onAllTasksComplete": "noaction",
        "onTaskFailure": "noaction",
        "constraints": {
          "maxWallClockTime": "P10675199DT2H48M5.4775807S",
          "maxTaskRetryCount": 0
        },
        "poolInfo": {
          "poolId": "poolId"
        }
      },
      "executionInfo": {
        "recentJob": {
          "url": "https://account.region.batch.azure.com/jobs/jobSchedule1:job-1",
          "id": "jobSchedule1:job-1"
        }
      }
    },
    {
      "id": "jobSchedule2",
      "url": "https://account.region.batch.azure.com/jobschedules/jobSchedule2",
      "eTag": "0x8D40FFCFF760B51",
      "lastModified": "2016-11-18T21:51:05.8184017Z",
      "creationTime": "2016-11-18T21:51:05.8184017Z",
      "state": "active",
      "stateTransitionTime": "2016-11-18T21:51:05.8184017Z",
      "schedule": {
        "doNotRunUntil": "2020-01-01T12:30:00Z"
      },
      "jobSpecification": {
        "priority": 0,
        "maxParallelTasks": -1,
        "usesTaskDependencies": false,
        "onAllTasksComplete": "noaction",
        "onTaskFailure": "noaction",
        "constraints": {
          "maxWallClockTime": "P10675199DT2H48M5.4775807S",
          "maxTaskRetryCount": 0
        },
        "poolInfo": {
          "poolId": "testPool2"
        }
      },
      "executionInfo": {
        "nextRunTime": "2020-01-01T12:30:00Z"
      }
    }
  ]
}

Definicje

ApplicationPackageReference

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

AuthenticationTokenSettings

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

AutoPoolSpecification

Określa charakterystykę tymczasowej "puli automatycznej". Usługa Batch utworzy tę automatyczną pulę po przesłaniu zadania.

AutoUserScope

Zakres użytkownika automatycznego

AutoUserSpecification

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

AzureBlobFileSystemConfiguration

Informacje używane do nawiązywania połączenia z kontenerem usługi Azure Storage przy użyciu systemu Blobfuse.

AzureFileShareConfiguration

Informacje używane do nawiązywania połączenia z udziałem plików platformy Azure.

BatchError

Odpowiedź o błędzie odebrana z usługi Azure Batch.

BatchErrorDetail

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

CachingType

Typ buforowania, który ma być włączony dla dysku.

CertificateReference

Odwołanie do certyfikatu do zainstalowania w węzłach obliczeniowych w puli.

CertificateStoreLocation

Lokalizacja magazynu certyfikatów w węźle obliczeniowym, w którym ma zostać zainstalowany certyfikat.

CIFSMountConfiguration

Informacje używane do nawiązywania połączenia z systemem plików CIFS.

CloudJobSchedule

Harmonogram zadań, który umożliwia cykliczne zadania, określając czas uruchamiania zadań i specyfikację używaną do tworzenia każdego zadania.

CloudJobScheduleListResult

Wynik wyświetlania listy harmonogramów zadań na koncie.

CloudServiceConfiguration

Konfiguracja węzłów obliczeniowych w puli na podstawie platformy Azure Cloud Services.

ComputeNodeFillType

Jak zadania są dystrybuowane między węzłami obliczeniowymi w puli.

ComputeNodeIdentityReference

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

ContainerConfiguration

Konfiguracja pul z obsługą kontenerów.

ContainerRegistry

Prywatny rejestr kontenerów.

ContainerType

Technologia kontenera do użycia.

ContainerWorkingDirectory

Lokalizacja katalogu roboczego zadania kontenera.

DataDisk

Ustawienia które będą używane przez dyski danych skojarzone z węzłami obliczeniowymi w puli. W przypadku korzystania z dołączonych dysków danych należy zainstalować i sformatować dyski z poziomu maszyny wirtualnej, aby ich używać.

DiffDiskPlacement

Określa efemeryczne umieszczanie dysku systemu operacyjnego dla wszystkich węzłów obliczeniowych (maszyn wirtualnych) w puli.

DiffDiskSettings

Określa efemeryczne Ustawienia dysku systemu operacyjnego używanego przez węzeł obliczeniowy (VM).

DiskEncryptionConfiguration

Konfiguracja szyfrowania dysków zastosowana w węzłach obliczeniowych w puli. Konfiguracja szyfrowania dysków nie jest obsługiwana w puli systemu Linux utworzonej przy użyciu obrazu Shared Image Gallery.

DynamicVNetAssignmentScope

Zakres dynamicznego przypisania sieci wirtualnej.

ElevationLevel

Poziom podniesienia uprawnień użytkownika.

EnvironmentSetting

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

ErrorMessage

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

HttpHeader

Para nazwa-wartość nagłówka HTTP

ImageReference

Odwołanie do obrazu witryny Azure Virtual Machines Marketplace lub obrazu Shared Image Gallery. Aby uzyskać listę wszystkich odwołań do obrazu Azure Marketplace zweryfikowanych przez Azure Batch, zobacz operację "Wyświetl obsługiwane obrazy".

InboundEndpointProtocol

Protokół punktu końcowego.

InboundNATPool

Przychodzącą pulę translatora adresów sieciowych, która może służyć do obsługi określonych portów w węzłach obliczeniowych w puli usługi Batch zewnętrznie.

IPAddressProvisioningType

Typ aprowizacji dla publicznych adresów IP dla puli.

JobConstraints

Ograniczenia wykonywania zadania.

JobManagerTask

Określa szczegóły zadania Menedżera zadań.

JobNetworkConfiguration

Konfiguracja sieci dla zadania.

JobPreparationTask

Zadanie podrzędne przygotowania zadania do uruchomienia przed wszystkimi zadaniami zadania w dowolnym węźle obliczeniowym.

JobReleaseTask

Zadanie zwolnienia zadania do uruchomienia po ukończeniu zadania w dowolnym węźle obliczeniowym, w którym zostało uruchomione zadanie.

JobScheduleExecutionInformation

Zawiera informacje o zadaniach, które zostały uruchomione i będą uruchamiane zgodnie z harmonogramem zadań.

JobScheduleState

Stan harmonogramu zadań.

JobScheduleStatistics

Statystyki użycia zasobów dla harmonogramu zadań.

JobSpecification

Określa szczegóły zadań do utworzenia zgodnie z harmonogramem.

LinuxUserConfiguration

Właściwości używane do tworzenia konta użytkownika w węźle obliczeniowym systemu Linux.

LoginMode

Tryb logowania użytkownika

MetadataItem

Para nazwa-wartość skojarzona z zasobem usługi Batch.

MountConfiguration

System plików do zainstalowania w każdym węźle.

NetworkConfiguration

Konfiguracja sieci dla puli.

NetworkSecurityGroupRule

Reguła sieciowej grupy zabezpieczeń, która ma być stosowana do przychodzącego punktu końcowego.

NetworkSecurityGroupRuleAccess

Akcja, która powinna zostać podjęta dla określonego adresu IP, zakresu podsieci lub tagu.

NFSMountConfiguration

Informacje używane do nawiązywania połączenia z systemem plików NFS.

NodePlacementConfiguration

Konfiguracja umieszczania węzłów dla puli.

NodePlacementPolicyType

Zasady umieszczania dla przydzielania węzłów w puli.

OnAllTasksComplete

Akcja, jaką usługa Batch powinna wykonać, gdy wszystkie zadania w zadaniu są w stanie ukończonym.

OnTaskFailure

Akcja, jaką usługa Batch powinna wykonać, gdy dowolne zadanie w zadaniu zakończy się niepowodzeniem.

OSDisk

Ustawienia dla dysku systemu operacyjnego węzła obliczeniowego (VM).

OutputFile

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

OutputFileBlobContainerDestination

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

OutputFileDestination

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

OutputFileUploadCondition

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

OutputFileUploadOptions

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

PoolEndpointConfiguration

Konfiguracja punktu końcowego dla puli.

PoolInformation

Określa sposób przypisywanie zadania do puli.

PoolLifetimeOption

Minimalny okres istnienia utworzonych automatycznych pul oraz sposób przypisywaniu wielu zadań zgodnie z harmonogramem do pul.

PoolSpecification

Specyfikacja tworzenia nowej puli.

PublicIPAddressConfiguration

Konfiguracja publicznego adresu IP konfiguracji sieci puli.

RecentJob

Informacje o najnowszym zadaniu do uruchomienia w harmonogramie zadań.

ResourceFile

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

Schedule

Harmonogram, zgodnie z którym zadania zostaną utworzone. Wszystkie czasy są stałe w formacie UTC i nie mają wpływu na czas letni.

StartTask

Zadanie uruchamiane po dołączeniu węzła do puli w usłudze Azure Batch lub po ponownym uruchomieniu lub ponownym uruchomieniu węzła obliczeniowego lub ponownym obrazie.

StorageAccountType

Typ konta magazynu do użycia w tworzeniu dysków danych.

TaskConstraints

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

TaskContainerSettings

Ustawienia kontenera dla zadania.

TaskSchedulingPolicy

Określa sposób dystrybucji zadań w węzłach obliczeniowych.

UserAccount

Właściwości używane do tworzenia użytkownika używanego do wykonywania zadań w węźle obliczeniowym Azure Batch.

UserIdentity

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

VirtualMachineConfiguration

Konfiguracja węzłów obliczeniowych w puli na podstawie infrastruktury usługi Azure Virtual Machines.

VMExtension

Konfiguracja rozszerzeń maszyn wirtualnych.

WindowsConfiguration

Windows ustawienia systemu operacyjnego, które mają być stosowane do maszyny wirtualnej.

WindowsUserConfiguration

Właściwości używane do tworzenia konta użytkownika w węźle obliczeniowym Windows.

ApplicationPackageReference

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

Name Type Description
applicationId
  • string

Identyfikator aplikacji do wdrożenia.

version
  • string

Wersja aplikacji do wdrożenia. Jeśli pominięto, zostanie wdrożona domyślna wersja.
Jeśli pominięto tę wersję w puli i nie określono domyślnej wersji dla tej aplikacji, żądanie kończy się niepowodzeniem z kodem błędu InvalidApplicationPackageReferences i kodem stanu HTTP 409. Jeśli pominięto to zadanie i nie określono domyślnej wersji dla tej aplikacji, zadanie kończy się niepowodzeniem z powodu błędu przetwarzania wstępnego.

AuthenticationTokenSettings

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

Name Type Description
access
  • string[]

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

AutoPoolSpecification

Określa charakterystykę tymczasowej "puli automatycznej". Usługa Batch utworzy tę automatyczną pulę po przesłaniu zadania.

Name Type Description
autoPoolIdPrefix
  • string

Prefiks, który ma zostać dodany do unikatowego identyfikatora po automatycznym utworzeniu puli.
Usługa Batch przypisuje każdemu automatycznemu puli unikatowy identyfikator podczas tworzenia. Aby odróżnić pule utworzone do różnych celów, można określić ten element, aby dodać prefiks do przypisanego identyfikatora. Prefiks może mieć długość do 20 znaków.

keepAlive
  • boolean

Czy zachować pulę automatyczną przy życiu po wygaśnięciu okresu istnienia.
Jeśli wartość false, usługa Batch usunie pulę po jego okresie istnienia (zgodnie z ustawieniem poolLifetimeOption) wygaśnie; oznacza to, że po zakończeniu zadania lub harmonogramu zadań. Jeśli jest to prawda, usługa Batch nie usuwa automatycznie puli. Do użytkownika należy usunięcie automatycznie utworzonych pul za pomocą tej opcji.

pool

Specyfikacja puli dla puli automatycznej.

poolLifetimeOption

Minimalny okres istnienia utworzonych automatycznych pul oraz sposób przypisywaniu wielu zadań zgodnie z harmonogramem do pul.

AutoUserScope

Zakres użytkownika automatycznego

Name Type Description
pool
  • string

Określa, że zadanie jest uruchamiane jako typowe konto użytkownika automatycznego, które jest tworzone w każdym węźle obliczeniowym w puli.

task
  • string

Określa, że usługa powinna utworzyć nowego użytkownika dla zadania.

AutoUserSpecification

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

Name Type Description
elevationLevel

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

scope

Zakres dla użytkownika automatycznego
Wartość domyślna to pula. Jeśli pula jest uruchomiona Windows należy określić wartość Zadanie, jeśli wymagana jest ściślejsza izolacja między zadaniami. Jeśli na przykład zadanie wycisza rejestr w sposób, który może mieć wpływ na inne zadania, lub jeśli certyfikaty zostały określone w puli, która nie powinna być dostępna przez normalne zadania, ale powinna być dostępna przez zadania StartTasks.

AzureBlobFileSystemConfiguration

Informacje używane do nawiązywania połączenia z kontenerem usługi Azure Storage przy użyciu systemu Blobfuse.

Name Type Description
accountKey
  • string

Klucz konta usługi Azure Storage.
Ta właściwość wyklucza się wzajemnie zarówno z kluczem sasKey, jak i tożsamością; należy określić dokładnie jedną z nich.

accountName
  • string

Nazwa konta usługi Azure Storage.

blobfuseOptions
  • string

Dodatkowe opcje wiersza polecenia umożliwiające przekazanie polecenia instalacji.
Są to opcje "net use" w opcjach Windows i "instalowanie" w systemie Linux.

containerName
  • string

Nazwa kontenera Azure Blob Storage.

identityReference

Odwołanie do tożsamości przypisanej przez użytkownika do użycia w celu uzyskania dostępu do nazwy kontenera
Ta właściwość wyklucza się wzajemnie zarówno z kluczem konta, jak i kluczem sasKey; należy określić dokładnie jedną.

relativeMountPath
  • string

Ścieżka względna w węźle obliczeniowym, w którym zostanie zainstalowany system plików
Wszystkie systemy plików są instalowane względem katalogu instalacji usługi Batch, dostępnego za pośrednictwem zmiennej środowiskowej AZ_BATCH_NODE_MOUNTS_DIR.

sasKey
  • string

Token SAS usługi Azure Storage.
Ta właściwość wyklucza się wzajemnie zarówno z kluczem konta, jak i tożsamością; należy określić dokładnie jedną z nich.

AzureFileShareConfiguration

Informacje używane do nawiązywania połączenia z udziałem plików platformy Azure.

Name Type Description
accountKey
  • string

Klucz konta usługi Azure Storage.

accountName
  • string

Nazwa konta usługi Azure Storage.

azureFileUrl
  • string

Adres URL Azure Files.
Jest to formularz "https://{account}.file.core.windows.net/".

mountOptions
  • string

Dodatkowe opcje wiersza polecenia, które mają być przekazywane do polecenia instalacji.
Są to opcje "net use" w opcjach Windows i "instalowanie" w systemie Linux.

relativeMountPath
  • string

Ścieżka względna w węźle obliczeniowym, w którym zostanie zainstalowany system plików
Wszystkie systemy plików są instalowane względem katalogu instalacji usługi Batch, dostępnego za pośrednictwem zmiennej środowiskowej AZ_BATCH_NODE_MOUNTS_DIR.

BatchError

Odpowiedź o błędzie odebrana z usługi Azure Batch.

Name Type Description
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 Azure Batch błędu.

Name Type Description
key
  • string

Identyfikator określający znaczenie właściwości Value.

value
  • string

Dodatkowe informacje zawarte w odpowiedzi na błąd.

CachingType

Typ buforowania, który ma być włączony dla dysku.

Name Type Description
none
  • string

Tryb buforowania dysku nie jest włączony.

readonly
  • string

Tryb buforowania dysku jest tylko do odczytu.

readwrite
  • string

Tryb buforowania dysku jest odczytywany i zapisywany.

CertificateReference

Odwołanie do certyfikatu do zainstalowania w węzłach obliczeniowych w puli.

Name Type Description
storeLocation

Lokalizacja magazynu certyfikatów w węźle obliczeniowym, w którym ma zostać zainstalowany certyfikat.
Wartość domyślna to currentuser. Ta właściwość ma zastosowanie tylko w przypadku pul skonfigurowanych przy użyciu Windows węzłów obliczeniowych (czyli utworzonych za pomocą elementu cloudServiceConfiguration lub virtualMachineConfiguration przy użyciu odwołania do obrazu Windows). W przypadku węzłów obliczeniowych systemu Linux certyfikaty są przechowywane w katalogu roboczym Zadania, a zmienna środowiskowa AZ_BATCH_CERTIFICATES_DIR jest dostarczana do zadania w celu wykonania zapytania o tę lokalizację. W przypadku certyfikatów z widocznością "remoteUser" katalog "certs" jest tworzony w katalogu głównym użytkownika (np. /home/{user-name}/certs) i Certyfikaty są umieszczane w tym katalogu.

storeName
  • string

Nazwa magazynu certyfikatów w węźle obliczeniowym, w którym ma zostać zainstalowany certyfikat.
Ta właściwość ma zastosowanie tylko w przypadku pul skonfigurowanych przy użyciu Windows węzłów obliczeniowych (czyli utworzonych za pomocą elementu cloudServiceConfiguration lub virtualMachineConfiguration przy użyciu odwołania do obrazu Windows). Typowe nazwy sklepów to: My, Root, CA, Trust, Disallowed, TrustedPeople, TrustedPublisher, AuthRoot, AddressBook, ale można również użyć dowolnej niestandardowej nazwy sklepu. Wartość domyślna to Mój.

thumbprint
  • string

Odcisk palca certyfikatu.

thumbprintAlgorithm
  • string

Algorytm, z którym jest skojarzony odcisk palca. Musi to być sha1.

visibility
  • string[]

Które konta użytkowników w węźle obliczeniowym powinny mieć dostęp do prywatnych danych certyfikatu.
W tej kolekcji można określić więcej niż jedną widoczność. Wartość domyślna to wszystkie konta.

CertificateStoreLocation

Lokalizacja magazynu certyfikatów w węźle obliczeniowym, w którym ma zostać zainstalowany certyfikat.

Name Type Description
currentuser
  • string

Certyfikaty należy zainstalować w magazynie certyfikatów CurrentUser.

localmachine
  • string

Certyfikaty należy zainstalować w magazynie certyfikatów LocalMachine.

CIFSMountConfiguration

Informacje używane do nawiązywania połączenia z systemem plików CIFS.

Name Type Description
mountOptions
  • string

Dodatkowe opcje wiersza polecenia, które mają być przekazywane do polecenia instalacji.
Są to opcje "net use" w opcjach Windows i "instalowanie" w systemie Linux.

password
  • string

Hasło do użycia do uwierzytelniania w systemie plików CIFS.

relativeMountPath
  • string

Ścieżka względna w węźle obliczeniowym, w którym zostanie zainstalowany system plików
Wszystkie systemy plików są instalowane względem katalogu instalacji usługi Batch, dostępnego za pośrednictwem zmiennej środowiskowej AZ_BATCH_NODE_MOUNTS_DIR.

source
  • string

Identyfikator URI systemu plików do zainstalowania.

username
  • string

Użytkownik do użycia do uwierzytelniania w systemie plików CIFS.

CloudJobSchedule

Harmonogram zadań, który umożliwia cykliczne zadania, określając czas uruchamiania zadań i specyfikację używaną do tworzenia każdego zadania.

Name Type Description
creationTime
  • string

Czas tworzenia harmonogramu zadań.

displayName
  • string

Nazwa wyświetlana harmonogramu.

eTag
  • string

Element ETag harmonogramu zadań.
Jest to nieprzezroczystych ciągów. Można go użyć do wykrywania, czy harmonogram zadań zmienił się między żądaniami. W szczególności można przekazać element ETag z żądaniem harmonogramu zadań aktualizacji, aby określić, że zmiany powinny obowiązywać tylko wtedy, gdy nikt inny nie zmodyfikował harmonogramu w międzyczasie.

executionInfo

Informacje o zadaniach, które zostały i będą uruchamiane zgodnie z tym harmonogramem.

id
  • string

Ciąg, który jednoznacznie identyfikuje harmonogram w ramach konta.

jobSpecification

Szczegóły zadań do utworzenia zgodnie z tym harmonogramem.

lastModified
  • string

Czas ostatniej modyfikacji harmonogramu zadań.
Jest to ostatni raz, w którym dane na poziomie harmonogramu, takie jak specyfikacja zadania lub informacje o cyklu, uległy zmianie. Nie uwzględnia zmian na poziomie zadania, takich jak tworzone nowe zadania lub zmiana stanu zadania.

metadata

Lista par name-value skojarzonych z harmonogramem jako metadanych.
Usługa Batch nie przypisuje żadnego znaczenia do metadanych; służy wyłącznie do używania kodu użytkownika.

previousState

Poprzedni stan harmonogramu zadań.
Ta właściwość nie jest obecna, jeśli harmonogram zadań jest w stanie początkowym aktywności.

previousStateTransitionTime
  • string

Godzina, w której harmonogram zadań został wprowadzony w poprzednim stanie.
Ta właściwość nie jest obecna, jeśli harmonogram zadań jest w stanie początkowym aktywności.

schedule

Harmonogram, zgodnie z którym zadania zostaną utworzone.
Wszystkie czasy są stałe w formacie UTC i nie mają wpływu na czas letni.

state

Bieżący stan harmonogramu zadań.

stateTransitionTime
  • string

Godzina, w której harmonogram zadań został wprowadzony w bieżącym stanie.

stats

Statystyki użycia zasobów okresu istnienia dla harmonogramu zadań. Statystyki mogą nie być natychmiast dostępne. Usługa Batch wykonuje okresowe zestawienie statystyk. Typowe opóźnienie wynosi około 30 minut.

url
  • string

Adres URL harmonogramu zadań.

CloudJobScheduleListResult

Wynik wyświetlania listy harmonogramów zadań na koncie.

Name Type Description
odata.nextLink
  • string

Adres URL umożliwiający uzyskanie następnego zestawu wyników.

value

Lista harmonogramów zadań.

CloudServiceConfiguration

Konfiguracja węzłów obliczeniowych w puli na podstawie platformy Azure Cloud Services.

Name Type Description
osFamily
  • string

Rodzina systemu operacyjnego gościa platformy Azure, która ma zostać zainstalowana na maszynach wirtualnych w puli.
Możliwe wartości to: 2 — rodzina systemów operacyjnych 2, równoważna Windows Server 2008 R2 SP1. 3 — Rodzina systemu operacyjnego 3, równoważna Windows Server 2012. 4 — Rodzina systemów operacyjnych 4, równoważna Windows Server 2012 R2. 5 — Rodzina systemu operacyjnego 5, równoważna Windows Server 2016. 6 — Rodzina systemów operacyjnych 6, równoważna Windows Server 2019. Aby uzyskać więcej informacji, zobacz Wersje systemu operacyjnego gościa platformy Azure (https://azure.microsoft.com/documentation/articles/cloud-services-guestos-update-matrix/#releases).

osVersion
  • string

Wersja systemu operacyjnego gościa platformy Azure, która ma zostać zainstalowana na maszynach wirtualnych w puli.
Wartość domyślna to * określająca najnowszą wersję systemu operacyjnego dla określonej rodziny systemu operacyjnego.

ComputeNodeFillType

Jak zadania są dystrybuowane między węzłami obliczeniowymi w puli.

Name Type Description
pack
  • string

Jak najwięcej zadań (taskSlotsPerNode) należy przypisać do każdego węzła obliczeniowego w puli, zanim wszystkie zadania zostaną przypisane do następnego węzła obliczeniowego w puli.

spread
  • string

Zadania powinny być przydzielane równomiernie we wszystkich węzłach obliczeniowych w puli.

ComputeNodeIdentityReference

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

Name Type Description
resourceId
  • string

Identyfikator zasobu usługi ARM tożsamości przypisanej przez użytkownika.

ContainerConfiguration

Konfiguracja pul z obsługą kontenerów.

Name Type Description
containerImageNames
  • string[]

Kolekcja nazw obrazów kontenera.
Jest to pełne odwołanie do obrazu, które zostanie określone jako "ściąganie platformy Docker". Obraz będzie pozyskiwany z domyślnego rejestru platformy Docker, chyba że obraz jest w pełni kwalifikowany z alternatywnym rejestrem.

containerRegistries

Dodatkowe rejestry prywatne, z których można ściągać kontenery.
Jeśli jakiekolwiek obrazy muszą zostać pobrane z rejestru prywatnego, który wymaga poświadczeń, należy podać te poświadczenia tutaj.

type

Używana technologia kontenerów.

ContainerRegistry

Prywatny rejestr kontenerów.

Name Type Description
identityReference

Odwołanie do tożsamości przypisanej przez użytkownika w celu uzyskania dostępu do Azure Container Registry zamiast nazwy użytkownika i hasła.
Odwołanie do tożsamości przypisanej przez użytkownika skojarzonej z pulą usługi Batch, której będzie używać węzeł obliczeniowy.

password
  • string

Hasło do logowania się na serwerze rejestru.

registryServer
  • string

Adres URL rejestru.
Jeśli pominięto, wartość domyślna to "docker.io".

username
  • string

Nazwa użytkownika do logowania się na serwerze rejestru.

ContainerType

Technologia kontenera do użycia.

Name Type Description
dockerCompatible
  • string

Do uruchamiania kontenerów zostanie użyta technologia kontenera zgodna z platformą Docker.

ContainerWorkingDirectory

Lokalizacja katalogu roboczego zadania kontenera.

Name Type Description
containerImageDefault
  • string

Użyj katalogu roboczego zdefiniowanego w obrazie kontenera. Pamiętaj, że ten katalog nie będzie zawierać plików zasobów pobranych przez usługę Batch.

taskWorkingDirectory
  • string

Użyj standardowego katalogu roboczego zadania usługi Batch, który będzie zawierać pliki zasobów zadań wypełniane przez usługę Batch.

DataDisk

Ustawienia które będą używane przez dyski danych skojarzone z węzłami obliczeniowymi w puli. W przypadku korzystania z dołączonych dysków danych należy zainstalować i sformatować dyski z poziomu maszyny wirtualnej, aby ich używać.

Name Type Description
caching

Typ buforowania, który ma być włączony dla dysków danych.
Wartość domyślna buforowania to readwrite. Aby uzyskać informacje o opcjach buforowania, zobacz: https://blogs.msdn.microsoft.com/windowsazurestorage/2012/06/27/exploring-windows-azure-drives-disks-and-images/.

diskSizeGB
  • integer

Początkowy rozmiar dysku w gigabajtach.

lun
  • integer

Numer jednostki logicznej.
Jednostka lun służy do unikatowego identyfikowania każdego dysku danych. W przypadku dołączania wielu dysków każdy powinien mieć odrębną jednostkę lun. Wartość musi należeć do przedziału od 0 do 63 włącznie.

storageAccountType

Typ konta magazynu, który ma być używany dla dysku danych.
W przypadku pominięcia wartość domyślna to "standard_lrs".

DiffDiskPlacement

Określa efemeryczne umieszczanie dysku systemu operacyjnego dla wszystkich węzłów obliczeniowych (maszyn wirtualnych) w puli.

Name Type Description
CacheDisk
  • string

Efemeryczny dysk systemu operacyjnego jest przechowywany w pamięci podręcznej maszyny wirtualnej.

DiffDiskSettings

Określa efemeryczne Ustawienia dysku systemu operacyjnego używanego przez węzeł obliczeniowy (VM).

Name Type Description
placement

Określa efemeryczne umieszczanie dysku dla dysku systemu operacyjnego dla wszystkich maszyn wirtualnych w puli.
Ta właściwość może być używana przez użytkownika w żądaniu, aby wybrać lokalizację, np. miejsce na dysku pamięci podręcznej na potrzeby aprowizacji dysku efemerycznego systemu operacyjnego. Aby uzyskać więcej informacji na temat wymagań dotyczących rozmiaru dysku efemerycznego systemu operacyjnego, zapoznaj się z wymaganiami dotyczącymi rozmiaru dysku efemerycznego systemu operacyjnego dla maszyn wirtualnych Windows na maszynach wirtualnych z systemem Linux i na https://docs.microsoft.com/en-us/azure/virtual-machines/windows/ephemeral-os-disks#size-requirements stronie https://docs.microsoft.com/en-us/azure/virtual-machines/linux/ephemeral-os-disks#size-requirements.

DiskEncryptionConfiguration

Konfiguracja szyfrowania dysków zastosowana w węzłach obliczeniowych w puli. Konfiguracja szyfrowania dysków nie jest obsługiwana w puli systemu Linux utworzonej przy użyciu obrazu Shared Image Gallery.

Name Type Description
targets
  • string[]

Lista dysków przeznaczonych dla usługi Batch zostanie zaszyfrowana w węźle obliczeniowym.
W przypadku pominięcia żadne dyski w węzłach obliczeniowych w puli nie będą szyfrowane. W puli systemu Linux obsługiwana jest tylko opcja "TemporaryDisk"; w puli Windows należy określić wartości "OsDisk" i "TemporaryDisk".

DynamicVNetAssignmentScope

Zakres dynamicznego przypisania sieci wirtualnej.

Name Type Description
job
  • string

Dynamiczne przypisywanie sieci wirtualnej jest wykonywane na zadanie.

none
  • string

Nie włączono dynamicznego przypisania sieci wirtualnej.

ElevationLevel

Poziom podniesienia uprawnień użytkownika.

Name Type Description
admin
  • string

Użytkownik jest użytkownikiem z podwyższonym poziomem dostępu i działa z pełnymi uprawnieniami administratora.

nonadmin
  • string

Użytkownik jest użytkownikiem standardowym bez podwyższonego poziomu dostępu.

EnvironmentSetting

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

Name Type Description
name
  • string

Nazwa zmiennej środowiskowej.

value
  • string

Wartość zmiennej środowiskowej.

ErrorMessage

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

Name Type Description
lang
  • string

Kod języka komunikatu o błędzie

value
  • string

Tekst wiadomości.

HttpHeader

Para nazwa-wartość nagłówka HTTP

Name Type Description
name
  • string

Bez uwzględniania wielkości liter nazwa nagłówka, która ma być używana podczas przekazywania plików wyjściowych

value
  • string

Wartość nagłówka do użycia podczas przekazywania plików wyjściowych

ImageReference

Odwołanie do obrazu witryny Azure Virtual Machines Marketplace lub obrazu Shared Image Gallery. Aby uzyskać listę wszystkich odwołań do obrazu Azure Marketplace zweryfikowanych przez Azure Batch, zobacz operację "Wyświetl obsługiwane obrazy".

Name Type Description
exactVersion
  • string

Określona wersja obrazu platformy lub obrazu z witryny Marketplace używana do utworzenia węzła. To pole tylko do odczytu różni się od wartości "version" tylko wtedy, gdy wartość określona dla "version" podczas tworzenia puli była "latest".

offer
  • string

Typ oferty obrazu witryny Azure Virtual Machines Marketplace.
Na przykład UbuntuServer lub WindowsServer.

publisher
  • string

Wydawca obrazu witryny Azure Virtual Machines Marketplace.
Na przykład Canonical lub MicrosoftWindowsServer.

sku
  • string

Jednostka SKU obrazu witryny Azure Virtual Machines Marketplace.
Na przykład 18.04-LTS lub 2019-Datacenter.

version
  • string

Wersja obrazu witryny Azure Virtual Machines Marketplace.
Można określić wartość "latest", aby wybrać najnowszą wersję obrazu. W przypadku pominięcia wartość domyślna to "latest".

virtualMachineImageId
  • string

Identyfikator zasobu usługi ARM obrazu Shared Image Gallery. Węzły obliczeniowe w puli zostaną utworzone przy użyciu tego identyfikatora obrazu. Jest to formularz /subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Compute/galleries/{galleryName}/images/{imageDefinitionName}/versions/{VersionId} lub /subscriptions/{subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Compute/gallerys/{galleryName}/images/{imageDefinitionName} dla zawsze domyślnej wersji obrazu.
Ta właściwość wzajemnie się wyklucza z innymi właściwościami ImageReference. Obraz Shared Image Gallery musi mieć repliki w tym samym regionie i musi znajdować się w tej samej subskrypcji co konto Azure Batch. Jeśli wersja obrazu nie zostanie określona w identyfikatorze imageId, zostanie użyta najnowsza wersja. Aby uzyskać informacje o ustawieniach zapory dla agenta węzła obliczeniowego usługi Batch do komunikowania się z usługą Batch, zobacz https://docs.microsoft.com/en-us/azure/batch/batch-api-basics#virtual-network-vnet-and-firewall-configuration.

InboundEndpointProtocol

Protokół punktu końcowego.

Name Type Description
tcp
  • string

Użyj protokołu TCP dla punktu końcowego.

udp
  • string

Użyj protokołu UDP dla punktu końcowego.

InboundNATPool

Przychodzącą pulę translatora adresów sieciowych, która może służyć do obsługi określonych portów w węzłach obliczeniowych w puli usługi Batch zewnętrznie.

Name Type Description
backendPort
  • integer

Numer portu w węźle obliczeniowym.
Musi to być unikatowe w puli usługi Batch. Dopuszczalne wartości to od 1 do 65535 z wyjątkiem 22, 3389, 29876 i 29877, ponieważ są one zarezerwowane. Jeśli podano jakiekolwiek wartości zarezerwowane, żądanie zakończy się niepowodzeniem z kodem stanu HTTP 400.

frontendPortRangeEnd
  • integer

Ostatni numer portu w zakresie portów zewnętrznych, które będą używane do zapewnienia dostępu przychodzącego do zapleczaPort w poszczególnych węzłach obliczeniowych.
Dopuszczalny zakres wartości z zakresu od 1 do 65534 z wyjątkiem portów z zakresu od 50000 do 55000, które są zarezerwowane przez usługę Batch. Wszystkie zakresy w puli muszą być odrębne i nie mogą się nakładać. Każdy zakres musi zawierać co najmniej 40 portów. Jeśli jakiekolwiek wartości zarezerwowane lub nakładające się są podane żądanie kończy się niepowodzeniem z kodem stanu HTTP 400.

frontendPortRangeStart
  • integer

Pierwszy numer portu w zakresie portów zewnętrznych, które będą używane do zapewnienia dostępu przychodzącego do zapleczaPort w poszczególnych węzłach obliczeniowych.
Dopuszczalny zakres wartości z zakresu od 1 do 65534 z wyjątkiem portów z zakresu od 50000 do 55000, które są zarezerwowane. Wszystkie zakresy w puli muszą być odrębne i nie mogą się nakładać. Każdy zakres musi zawierać co najmniej 40 portów. Jeśli jakiekolwiek wartości zarezerwowane lub nakładające się są podane żądanie kończy się niepowodzeniem z kodem stanu HTTP 400.

name
  • string

Nazwa punktu końcowego.
Nazwa musi być unikatowa w puli usługi Batch, może zawierać litery, cyfry, podkreślenia, kropki i łączniki. Nazwy muszą zaczynać się literą lub cyfrą, muszą kończyć się literą, cyfrą lub podkreśleniami i nie mogą przekraczać 77 znaków. Jeśli podano nieprawidłowe wartości, żądanie kończy się niepowodzeniem z kodem stanu HTTP 400.

networkSecurityGroupRules

Lista reguł sieciowej grupy zabezpieczeń, które zostaną zastosowane do punktu końcowego.
Maksymalna liczba reguł, które można określić we wszystkich punktach końcowych w puli usługi Batch, wynosi 25. Jeśli nie określono reguł sieciowej grupy zabezpieczeń, zostanie utworzona domyślna reguła zezwalania na dostęp przychodzący do określonego zapleczaPort. Jeśli maksymalna liczba reguł sieciowej grupy zabezpieczeń zostanie przekroczona, żądanie zakończy się niepowodzeniem z kodem stanu HTTP 400.

protocol

Protokół punktu końcowego.

IPAddressProvisioningType

Typ aprowizacji dla publicznych adresów IP dla puli.

Name Type Description
batchmanaged
  • string

Publiczny adres IP zostanie utworzony i zarządzany przez usługę Batch. W zależności od rozmiaru puli może istnieć wiele publicznych adresów IP.

nopublicipaddresses
  • string

Nie zostanie utworzony publiczny adres IP.

usermanaged
  • string

Publiczne adresy IP są udostępniane przez użytkownika i będą używane do aprowizowania węzłów obliczeniowych.

JobConstraints

Ograniczenia wykonywania zadania.

Name Type Description
maxTaskRetryCount
  • integer

Maksymalna liczba ponownych prób każdego zadania. Usługa Batch ponawia próbę zadania, jeśli jego kod zakończenia jest niezerowy.
Należy pamiętać, że ta wartość określa w szczególności liczbę ponownych prób. Usługa Batch spróbuje raz wykonać każde 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 ponawia próby 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 (brak ponownych prób)

maxWallClockTime
  • string

Maksymalny czas, który upłynął do uruchomienia zadania, mierzony od momentu utworzenia zadania.
Jeśli zadanie nie zostanie ukończone w limicie czasu, usługa Batch zakończy je i wszystkie zadania, które są nadal uruchomione. W takim przypadku przyczyną zakończenia będzie MaxWallClockTimeExpiry. Jeśli ta właściwość nie jest określona, nie ma limitu czasu na czas uruchomienia zadania.

JobManagerTask

Określa szczegóły zadania Menedżera zadań.

Name Type Description
allowLowPriorityNode
  • boolean

Czy zadanie Menedżera zadań może być uruchamiane w węźle obliczeniowym typu spot/low-priority.
Wartością domyślną jest true.

applicationPackageReferences

Lista pakietów aplikacji, które usługa Batch zostanie wdrożona w węźle obliczeniowym przed uruchomieniem wiersza polecenia.
Pakiety aplikacji są pobierane i wdrażane w udostępnionym katalogu, a nie w katalogu roboczym Zadania. W związku z tym, jeśli pakiet aplikacji, do których odwołuje się odwołanie, znajduje się już w węźle obliczeniowym i jest aktualny, nie jest on ponownie pobierany; jest używana istniejąca kopia w węźle obliczeniowym. Jeśli nie można zainstalować przywoływanego pakietu aplikacji, na przykład dlatego, że pakiet został usunięty lub pobieranie nie powiodło się, zadanie kończy się niepowodzeniem.

authenticationTokenSettings

Ustawienia tokenu uwierzytelniania, którego zadanie może użyć do wykonywania operacji usługi Batch.
Jeśli ta właściwość jest ustawiona, usługa Batch udostępnia zadaniu token uwierzytelniania, który może służyć do uwierzytelniania operacji usługi Batch bez konieczności posiadania klucza dostępu do konta. Token jest dostarczany za pośrednictwem zmiennej środowiskowej AZ_BATCH_AUTHENTICATION_TOKEN. Operacje, które zadanie może wykonać przy użyciu tokenu, zależą od ustawień. Na przykład zadanie może zażądać uprawnień zadania w celu dodania innych zadań do zadania lub sprawdzenia stanu zadania lub innych zadań podrzędnych w ramach zadania.

commandLine
  • string

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

constraints

Ograniczenia, które mają zastosowanie do zadania Menedżera zadań.

containerSettings

Ustawienia kontenera, w którym jest uruchamiane zadanie Menedżera zadań.
Jeśli pula, która będzie uruchamiać to zadanie, ma ustawioną wartość containerConfiguration, należy to również ustawić. Jeśli pula, która uruchomi to zadanie, nie ma ustawionego konteneraKonfiguracja, nie można go ustawić. Po określeniu tego ustawienia wszystkie katalogi cyklicznie poniżej AZ_BATCH_NODE_ROOT_DIR (katalog główny katalogów Azure Batch w węźle) są mapowane do kontenera, wszystkie zmienne środowiskowe zadania są mapowane do kontenera, a wiersz polecenia zadania jest wykonywany w kontenerze. Pliki utworzone w kontenerze poza AZ_BATCH_NODE_ROOT_DIR mogą nie zostać odzwierciedlone na dysku hosta, co oznacza, że interfejsy API plików usługi Batch nie będą mogły uzyskać dostępu do tych plików.

displayName
  • string

Nazwa wyświetlana zadania Menedżera zadań.
Nie musi być unikatowa i może zawierać znaki Unicode o maksymalnej długości 1024.

environmentSettings

Lista ustawień zmiennych środowiskowych dla zadania Menedżera zadań.

id
  • string

Ciąg, który jednoznacznie identyfikuje zadanie Menedżera zadań w ramach zadania.
Identyfikator może zawierać dowolną kombinację znaków alfanumerycznych, w tym łączników i podkreśleń, i nie może zawierać więcej niż 64 znaków.

killJobOnCompletion
  • boolean

Czy ukończenie zadania Menedżera zadań oznacza ukończenie całego zadania.
Jeśli ma wartość true, po zakończeniu zadania Menedżera zadań usługa Batch oznacza zadanie jako ukończone. Jeśli jakiekolwiek zadania są nadal uruchomione w tej chwili (inne niż wydanie zadania), te zadania zostaną zakończone. Jeśli wartość false, ukończenie zadania Menedżera zadań nie ma wpływu na stan zadania. W takim przypadku należy użyć atrybutu onAllTasksComplete w celu zakończenia zadania lub jawnego zakończenia zadania przez klienta lub użytkownika. Przykładem takiego działania jest utworzenie zestawu zadań przez Menedżera zadań, ale nie ma dalszej roli w ich wykonaniu. Wartością domyślną jest true. Jeśli używasz atrybutów onAllTasksComplete i onTaskFailure do kontrolowania okresu istnienia zadania i używania zadania Menedżera zadań tylko do utworzenia zadań dla zadania (nie do monitorowania postępu), należy ustawić wartość killJobOnCompletion na wartość false.

outputFiles

Lista plików, które usługa Batch przekaże z węzła obliczeniowego po uruchomieniu wiersza polecenia.
W przypadku zadań z wieloma wystąpieniami pliki zostaną przekazane tylko z węzła obliczeniowego, na którym jest wykonywane zadanie podstawowe.

requiredSlots
  • integer

Liczba miejsc planowania, których wymaga uruchomienie zadania.
Wartość domyślna to 1. Zadanie można zaplanować tylko w węźle obliczeniowym, jeśli węzeł ma wystarczającą liczbę wolnych miejsc planowania. W przypadku zadań obejmujących wiele wystąpień ta właściwość nie jest obsługiwana i nie może być określona.

resourceFiles

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

runExclusive
  • boolean

Określa, czy zadanie Menedżera zadań wymaga wyłącznego użycia węzła obliczeniowego, w którym jest uruchamiany.
Jeśli ma wartość true, żadne inne zadania nie będą uruchamiane w tym samym węźle, o ile menedżer zadań jest uruchomiony. Jeśli wartość false, inne zadania mogą być uruchamiane jednocześnie z Menedżerem zadań w węźle obliczeniowym. Zadanie Menedżera zadań jest zwykle liczone względem współbieżnego limitu zadań węzła obliczeniowego, dlatego jest to istotne tylko wtedy, gdy węzeł obliczeniowy zezwala na wiele współbieżnych zadań. Wartością domyślną jest true.

userIdentity

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

JobNetworkConfiguration

Konfiguracja sieci dla zadania.

Name Type Description
subnetId
  • string

Identyfikator zasobu usługi ARM podsieci sieci wirtualnej, do której węzły obliczeniowe uruchomione z zadania zostaną przyłączone przez czas trwania zadania. Będzie to działać tylko z pulą VirtualMachineConfiguration.
Sieć wirtualna musi znajdować się w tym samym regionie i subskrypcji co konto Azure Batch. Określona podsieć powinna mieć wystarczającą liczbę wolnych adresów IP, aby pomieścić liczbę węzłów obliczeniowych, które będą uruchamiać zadania z zadania. Może to być maksymalnie liczba węzłów obliczeniowych w puli. Jednostka usługi "MicrosoftAzureBatch" musi mieć rolę "Współautor klasycznej maszyny wirtualnej" Role-Based Access Control (RBAC) dla określonej sieci wirtualnej, aby usługa Azure Batch mogła planować zadania w węzłach. Można to zweryfikować, sprawdzając, czy określona sieć wirtualna ma skojarzone sieciowe grupy zabezpieczeń. Jeśli komunikacja z węzłami w określonej podsieci zostanie odrzucona przez sieciową grupę zabezpieczeń, usługa Batch ustawi stan węzłów obliczeniowych na bezużyteczny. Jest to formularz /subscriptions/{subscription}/resourceGroups/{group}/providers/{provider}/virtualNetworks/{network}/subnets/{subnet}. Jeśli określona sieć wirtualna ma skojarzone sieciowe grupy zabezpieczeń, należy włączyć kilka zarezerwowanych portów systemowych dla komunikacji przychodzącej z usługi Azure Batch. W przypadku pul utworzonych przy użyciu konfiguracji maszyny wirtualnej włącz porty 29876 i 29877, a także port 22 dla systemu Linux i port 3389 dla Windows. Port 443 jest również wymagany do otwierania połączeń wychodzących na potrzeby komunikacji z usługą Azure Storage. Aby uzyskać więcej informacji, zobacz: https://docs.microsoft.com/en-us/azure/batch/batch-api-basics#virtual-network-vnet-and-firewall-configuration

JobPreparationTask

Zadanie podrzędne przygotowania zadania do uruchomienia przed wszystkimi zadaniami zadania w dowolnym węźle obliczeniowym.

Name Type Description
commandLine
  • string

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

constraints

Ograniczenia, które mają zastosowanie do zadania przygotowania zadania.

containerSettings

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

environmentSettings

Lista ustawień zmiennych środowiskowych dla zadania przygotowania zadania.

id
  • string

Ciąg, który jednoznacznie identyfikuje zadanie przygotowania zadania w ramach zadania.
Identyfikator może zawierać dowolną kombinację znaków alfanumerycznych, w tym łączników i podkreśleń, i nie może zawierać więcej niż 64 znaków. Jeśli ta właściwość nie zostanie określona, usługa Batch przypisze wartość domyślną "jobpreparation". Żadne inne zadanie w zadaniu nie może mieć tego samego identyfikatora co zadanie przygotowania zadania. Jeśli spróbujesz przesłać zadanie o tym samym identyfikatorze, usługa Batch odrzuci żądanie z kodem błędu TaskIdSameAsJobPreparationTask; Jeśli bezpośrednio wywołujesz interfejs API REST, kod stanu HTTP to 409 (Konflikt).

rerunOnNodeRebootAfterSuccess
  • boolean

Czy usługa Batch powinna ponownie uruchomić zadanie przygotowania zadania po ponownym uruchomieniu węzła obliczeniowego.
Zadanie przygotowania zadania jest zawsze uruchamiane ponownie, jeśli węzeł obliczeniowy jest odtwarzany z obrazu lub jeśli zadanie przygotowania zadania nie zostało ukończone (np. z powodu ponownego uruchomienia podczas uruchamiania zadania). W związku z tym zawsze należy napisać zadanie przygotowania zadania, aby było idempotentne i zachowywać się poprawnie, jeśli jest uruchamiane wiele razy. Wartością domyślną jest true.

resourceFiles

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

userIdentity

Tożsamość użytkownika, w ramach której jest uruchamiane zadanie przygotowania zadania.
W przypadku pominięcia zadanie jest uruchamiane jako użytkownik niebędący administratorem unikatowym dla zadania w węzłach obliczeniowych Windows lub użytkownik niebędący administratorem unikatowym dla puli w węzłach obliczeniowych systemu Linux.

waitForSuccess
  • boolean

Określa, czy usługa Batch powinna czekać na pomyślne zakończenie zadania przygotowania zadania przed zaplanowanie innych zadań zadania w węźle obliczeniowym. Zadanie przygotowania zadania zostało ukończone pomyślnie, jeśli zostanie zakończone z kodem zakończenia 0.
Jeśli wartość true i zadanie przygotowania zadania zakończy się niepowodzeniem w węźle, usługa Batch ponowi próbę zadania podrzędnego przygotowania zadania do maksymalnej liczby ponownych prób (jak określono w elemecie ograniczeń). Jeśli zadanie nadal nie zostało ukończone pomyślnie po wszystkich ponownych próbach, usługa Batch nie będzie planować zadań zadania podrzędnego do węzła. Węzeł pozostaje aktywny i kwalifikuje się do uruchamiania zadań innych zadań. Jeśli wartość false, usługa Batch nie będzie czekać na ukończenie zadania przygotowania zadania. W takim przypadku inne zadania zadania podrzędne mogą rozpocząć wykonywanie w węźle obliczeniowym, gdy zadanie podrzędne przygotowania zadania jest nadal uruchomione; a nawet jeśli zadanie przygotowania zadania zakończy się niepowodzeniem, nowe zadania będą nadal zaplanowane w węźle obliczeniowym. Wartością domyślną jest true.

JobReleaseTask

Zadanie zwolnienia zadania do uruchomienia po ukończeniu zadania w dowolnym węźle obliczeniowym, w którym zostało uruchomione zadanie.

Name Type Description
commandLine
  • string

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

containerSettings

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

environmentSettings

Lista ustawień zmiennych środowiskowych dla zadania zwolnienia zadania.

id
  • string

Ciąg, który jednoznacznie identyfikuje zadanie zwolnienia zadania w ramach zadania.
Identyfikator może zawierać dowolną kombinację znaków alfanumerycznych, w tym łączników i podkreśleń, i nie może zawierać więcej niż 64 znaków. Jeśli ta właściwość nie zostanie określona, usługa Batch przypisze domyślną wartość "jobrelease". Żadne inne zadanie w zadaniu nie może mieć tego samego identyfikatora co zadanie zwolnienia zadania. Jeśli spróbujesz przesłać zadanie o tym samym identyfikatorze, usługa Batch odrzuci żądanie z kodem błędu TaskIdSameAsJobReleaseTask; Jeśli bezpośrednio wywołujesz interfejs API REST, kod stanu HTTP to 409 (Konflikt).

maxWallClockTime
  • string

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

resourceFiles

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

retentionTime
  • string

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

userIdentity

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

JobScheduleExecutionInformation

Zawiera informacje o zadaniach, które zostały uruchomione i będą uruchamiane zgodnie z harmonogramem zadań.

Name Type Description
endTime
  • string

Godzina zakończenia harmonogramu.
Ta właściwość jest ustawiana tylko wtedy, gdy harmonogram zadań jest w stanie ukończonym.

nextRunTime
  • string

Następnym razem, w którym zostanie utworzone zadanie zgodnie z tym harmonogramem.
Ta właściwość ma znaczenie tylko wtedy, gdy harmonogram jest w stanie aktywnym, gdy nadejdzie czas. Jeśli na przykład harmonogram jest wyłączony, żadne zadanie nie zostanie utworzone w następnym czasie, chyba że zadanie zostanie włączone przed tym.

recentJob

Informacje o najnowszym zadaniu w harmonogramie zadań.
Ta właściwość jest obecna tylko wtedy, gdy co najmniej jedno zadanie zostało uruchomione zgodnie z harmonogramem.

JobScheduleState

Stan harmonogramu zadań.

Name Type Description
active
  • string

Harmonogram zadań jest aktywny i utworzy zadania zgodnie z harmonogramem.

completed
  • string

Harmonogram zadań został zakończony, osiągając czas zakończenia lub przez użytkownika jawnego zakończenia.

deleting
  • string

Użytkownik zażądał usunięcia harmonogramu zadań, ale operacja usuwania jest nadal w toku. Harmonogram nie zainicjuje żadnych nowych zadań dla tego harmonogramu zadań i usunie wszystkie istniejące zadania i zadania zgodnie z harmonogramem zadań, w tym wszystkie aktywne zadania. Harmonogram zadań zostanie usunięty, gdy wszystkie zadania i zadania w harmonogramie zadań zostały usunięte.

disabled
  • string

Użytkownik wyłączył harmonogram zadań. Harmonogram nie zainicjuje żadnych nowych zadań zgodnie z tym harmonogramem, ale wszystkie istniejące aktywne zadania będą nadal uruchamiane.

terminating
  • string

Harmonogram zadań nie ma więcej pracy do wykonania lub został jawnie zakończony przez użytkownika, ale operacja zakończenia jest nadal w toku. Harmonogram nie zainicjuje żadnych nowych zadań dla tego harmonogramu zadań ani nie jest aktywne żadne istniejące zadanie.

JobScheduleStatistics

Statystyki użycia zasobów dla harmonogramu zadań.

Name Type Description
kernelCPUTime
  • string

Łączny czas procesora CPU w trybie jądra (zsumowany na wszystkich rdzeniach i wszystkich węzłach obliczeniowych) używany przez wszystkie zadania we wszystkich zadaniach utworzonych zgodnie z harmonogramem.

lastUpdateTime
  • string

Czas ostatniej aktualizacji statystyk. Wszystkie statystyki są ograniczone do zakresu od startTime do lastUpdateTime.

numFailedTasks
  • integer

Łączna liczba zadań zakończonych niepowodzeniem w danym zakresie czasu w obszarze Zadania utworzone zgodnie z harmonogramem. Zadanie kończy się niepowodzeniem, jeśli wyczerpuje maksymalną liczbę ponownych prób bez zwracania kodu zakończenia 0.

numSucceededTasks
  • integer

Łączna liczba zadań zakończonych pomyślnie w danym zakresie czasu w obszarze Zadania utworzone zgodnie z harmonogramem. Zadanie zostanie ukończone pomyślnie, jeśli zwróci kod zakończenia 0.

numTaskRetries
  • integer

Łączna liczba ponownych prób w danym przedziale czasu dla wszystkich zadań we wszystkich zadaniach utworzonych zgodnie z harmonogramem.

readIOGiB
  • number

Łączna liczba gibibajtów odczytanych z dysku przez wszystkie zadania we wszystkich zadaniach utworzonych zgodnie z harmonogramem.

readIOps
  • integer

Całkowita liczba operacji odczytu dysku wykonanych przez wszystkie zadania we wszystkich zadaniach utworzonych zgodnie z harmonogramem.

startTime
  • string

Godzina rozpoczęcia zakresu czasu objętego statystykami.

url
  • string

Adres URL statystyk.

userCPUTime
  • string

Łączny czas procesora CPU w trybie użytkownika (zsumowany na wszystkich rdzeniach i wszystkich węzłach obliczeniowych) używany przez wszystkie zadania we wszystkich zadaniach utworzonych zgodnie z harmonogramem.

waitTime
  • string

Łączny czas oczekiwania wszystkich zadań we wszystkich zadaniach utworzonych zgodnie z harmonogramem. Czas oczekiwania zadania jest definiowany jako czas, który upłynął między utworzeniem zadania a rozpoczęciem wykonywania zadania. (Jeśli zadanie jest ponawiane z powodu awarii, czas oczekiwania to czas ostatniego wykonania zadania).
Ta wartość jest zgłaszana tylko w statystykach okresu istnienia konta; nie jest uwzględniana w statystykach zadań.

wallClockTime
  • string

Łączny czas zegara ściany wszystkich zadań we wszystkich zadaniach utworzonych zgodnie z harmonogramem.
Czas zegara ściany to czas, który upłynął od momentu uruchomienia zadania w węźle obliczeniowym do momentu zakończenia (lub do czasu ostatniej aktualizacji statystyk, jeśli zadanie nie zostało zakończone do tego czasu). Jeśli zadanie zostało ponowione, obejmuje to czas zegara ściany wszystkich ponownych prób zadania.

writeIOGiB
  • number

Łączna liczba gibibajtów zapisywanych na dysku przez wszystkie zadania we wszystkich zadaniach utworzonych zgodnie z harmonogramem.

writeIOps
  • integer

Całkowita liczba operacji zapisu na dysku wykonanych przez wszystkie zadania we wszystkich zadaniach utworzonych zgodnie z harmonogramem.

JobSpecification

Określa szczegóły zadań do utworzenia zgodnie z harmonogramem.

Name Type Default Value Description
allowTaskPreemption
  • boolean

Czy zadania w tym zadaniu mogą być wywłaszczone przez inne zadania o wysokim priorytcie
Jeśli wartość ma wartość True, inne zadania o wysokim priorytetu przesłane do systemu będą miały pierwszeństwo i będą mogły ponownie kolejkować zadania z tego zadania. Po utworzeniu zadania można zaktualizować element allowTaskPreemption zadania przy użyciu interfejsu API zadania aktualizacji.

commonEnvironmentSettings

Lista typowych ustawień zmiennych środowiskowych. Te zmienne środowiskowe są ustawiane dla wszystkich zadań w zadaniach utworzonych w ramach tego harmonogramu (w tym Menedżera zadań, Przygotowania zadania i Zadania zwolnienia zadania).
Poszczególne zadania mogą zastąpić ustawienie środowiska określone w tym miejscu, określając tę samą nazwę ustawienia z inną wartością.

constraints

Ograniczenia wykonywania dla zadań utworzonych zgodnie z tym harmonogramem.

displayName
  • string

Nazwa wyświetlana zadań utworzonych zgodnie z tym harmonogramem.
Nazwa nie musi być unikatowa i może zawierać znaki Unicode o maksymalnej długości 1024.

jobManagerTask

Szczegóły zadania Menedżera zadań, które mają zostać uruchomione po uruchomieniu zadania zgodnie z tym harmonogramem.
Jeśli zadanie nie określi zadania Menedżera zadań, użytkownik musi jawnie dodać zadania do zadania przy użyciu interfejsu API zadań. Jeśli zadanie określi zadanie Menedżera zadań, usługa Batch utworzy zadanie Menedżera zadań podczas tworzenia zadania i spróbuje zaplanować zadanie Menedżera zadań przed zaplanowaniem innych zadań w zadaniu.

jobPreparationTask

Zadanie przygotowania zadania dla zadań utworzonych zgodnie z tym harmonogramem.
Jeśli zadanie ma zadanie przygotowania zadania, usługa Batch uruchomi zadanie przygotowania zadania w węźle przed uruchomieniem jakichkolwiek zadań tego zadania w tym węźle obliczeniowym.

jobReleaseTask

Zadanie zwolnienia zadania dla zadań utworzonych zgodnie z tym harmonogramem.
Głównym celem zadania zwolnienia zadania jest cofnięcie zmian w węzłach wprowadzonych przez zadanie przygotowania zadania. Przykładowe działania obejmują usuwanie plików lokalnych lub zamykanie usług, które zostały uruchomione w ramach przygotowania zadania. Nie można określić zadania zwolnienia zadania bez określania zadania podrzędnego przygotowania zadania. Usługa Batch uruchamia zadanie zwolnienia zadania w węzłach obliczeniowych, w których uruchomiono zadanie przygotowania zadania.

maxParallelTasks
  • integer
-1

Maksymalna liczba zadań, które można wykonać równolegle dla zadania.
Wartość parametru maxParallelTasks musi być -1 lub większa niż 0, jeśli zostanie określona. Jeśli nie zostanie określona, wartość domyślna to -1, co oznacza, że nie ma limitu liczby zadań, które można uruchamiać jednocześnie. Po utworzeniu zadania można zaktualizować element maxParallelTasks zadania przy użyciu interfejsu API zadania aktualizacji.

metadata

Lista par nazwa-wartość skojarzona z każdym zadaniem utworzonym w ramach tego harmonogramu jako metadanymi.
Usługa Batch nie przypisuje żadnego znaczenia do metadanych; jest on przeznaczony wyłącznie do korzystania z kodu użytkownika.

networkConfiguration

Konfiguracja sieci dla zadania.

onAllTasksComplete

Akcja usługi Batch powinna być wykonywana, gdy wszystkie zadania w zadaniu utworzonym w ramach tego harmonogramu są w stanie ukończonym.
Należy pamiętać, że jeśli zadanie nie zawiera żadnych zadań, wszystkie zadania są uznawane za ukończone. W związku z tym ta opcja jest najczęściej używana z zadaniem Menedżera zadań; Jeśli chcesz użyć automatycznego kończenia zadań bez Menedżera zadań, najpierw należy ustawić wartość onAllTasksComplete na noaction i zaktualizować właściwości zadania, aby ustawić wartość onAllTasksComplete, aby zakończyć zadanie po zakończeniu dodawania zadań. Wartość domyślna to noaction.

onTaskFailure

Akcja usługi Batch powinna być wykonywana, gdy jakiekolwiek zadanie zakończy się niepowodzeniem w zadaniu utworzonym zgodnie z tym harmonogramem. Zadanie jest uważane za niepowodzenie, jeśli nie powiodło się, jeśli wystąpił błądInfo. BłądInfo jest ustawiany, jeśli zadanie kończy się kodem zakończenia niezerowym po wyczerpaniu liczby ponownych prób lub jeśli wystąpił błąd podczas uruchamiania zadania, na przykład z powodu błędu pobierania pliku zasobu.
Wartość domyślna to noaction.

poolInfo

Pula, w której usługa Batch uruchamia zadania zadań utworzonych w ramach tego harmonogramu.

priority
  • integer

Priorytet zadań utworzonych zgodnie z tym harmonogramem.
Wartości priorytetu mogą wahać się od -1000 do 1000, a wartość -1000 jest najniższym priorytetem i 1000 jest najwyższym priorytetem. Wartość domyślna to 0. Ten priorytet jest używany jako domyślny dla wszystkich zadań w harmonogramie zadań. Priorytet zadania można zaktualizować po jego utworzeniu przy użyciu interfejsu API zadania aktualizacji.

usesTaskDependencies
  • boolean

Czy zadania w zadaniu mogą definiować zależności od siebie. Wartością domyślną jest false.

LinuxUserConfiguration

Właściwości używane do tworzenia konta użytkownika w węźle obliczeniowym systemu Linux.

Name Type Description
gid
  • integer

Identyfikator grupy dla konta użytkownika.
Właściwości uid i gid muszą być określone razem lub w ogóle nie. Jeśli nie określono bazowego systemu operacyjnego, wybiera gid.

sshPrivateKey
  • string

Klucz prywatny SSH dla konta użytkownika.
Klucz prywatny nie może być chroniony hasłem. Klucz prywatny służy do automatycznego konfigurowania uwierzytelniania opartego na kluczu asymetrycznym dla protokołu SSH między węzłami obliczeniowymi w puli systemu Linux, gdy właściwość EnableInterNodeCommunication puli ma wartość true (jest ignorowana, jeśli właściwość enableInterNodeCommunication ma wartość false). Robi to, umieszczając parę kluczy w katalogu .ssh użytkownika. Jeśli nie zostanie określony, protokół SSH bez hasła nie jest skonfigurowany między węzłami obliczeniowymi (nie jest wykonywana żadna modyfikacja katalogu ssh użytkownika).

uid
  • integer

Identyfikator użytkownika konta użytkownika.
Właściwości uid i gid muszą być określone razem lub w ogóle nie. Jeśli nie określono bazowego systemu operacyjnego, wybierze identyfikator uid.

LoginMode

Tryb logowania użytkownika

Name Type Description
batch
  • string

Tryb logowania LOGON32_LOGON_BATCH Win32. Tryb logowania wsadowego jest zalecany w przypadku długotrwałych procesów równoległych.

interactive
  • string

Tryb logowania LOGON32_LOGON_INTERACTIVE Win32. Kontrola konta użytkownika jest włączona w Windows VirtualMachineConfiguration Pools. Jeśli ta opcja jest używana z tożsamością użytkownika z podwyższonym poziomem uprawnień w puli Windows VirtualMachineConfiguration, sesja użytkownika nie zostanie podwyższona, chyba że aplikacja wykonywana przez wiersz polecenia zadania jest skonfigurowana tak, aby zawsze wymagała uprawnień administracyjnych lub zawsze wymagać maksymalnego uprawnień.

MetadataItem

Para nazwa-wartość skojarzona z zasobem usługi Batch.

Name Type Description
name
  • string

Nazwa elementu metadanych.

value
  • string

Wartość elementu metadanych.

MountConfiguration

System plików do zainstalowania w każdym węźle.

Name Type Description
azureBlobFileSystemConfiguration

Kontener usługi Azure Storage do zainstalowania przy użyciu funkcji FUSE obiektu blob w każdym węźle.
Ta właściwość wyklucza się wzajemnie ze wszystkimi innymi właściwościami.

azureFileShareConfiguration

Udział plików platformy Azure do zainstalowania w każdym węźle.
Ta właściwość wyklucza się wzajemnie ze wszystkimi innymi właściwościami.

cifsMountConfiguration

System plików CIFS/SMB do zainstalowania w każdym węźle.
Ta właściwość wyklucza się wzajemnie ze wszystkimi innymi właściwościami.

nfsMountConfiguration

System plików NFS do zainstalowania w każdym węźle.
Ta właściwość wyklucza się wzajemnie ze wszystkimi innymi właściwościami.

NetworkConfiguration

Konfiguracja sieci dla puli.

Name Type Description
dynamicVNetAssignmentScope

Zakres dynamicznego przypisania sieci wirtualnej.

endpointConfiguration

Konfiguracja punktów końcowych w węzłach obliczeniowych w puli usługi Batch.
Konfiguracja punktu końcowego puli jest obsługiwana tylko w pulach z właściwością virtualMachineConfiguration.

publicIPAddressConfiguration

Konfiguracja publicznego adresu IP Dla węzłów obliczeniowych w puli usługi Batch.
Właściwość konfiguracji publicznego adresu IP jest obsługiwana tylko w pulach z właściwością virtualMachineConfiguration.

subnetId
  • string

Identyfikator zasobu usługi ARM podsieci sieci wirtualnej, do której zostaną przyłączone węzły obliczeniowe puli. Jest to formularz /subscriptions/{subscription}/resourceGroups/{group}/providers/{provider}/virtualNetworks/{network}/subnets/{subnet}.
Sieć wirtualna musi znajdować się w tym samym regionie i subskrypcji co konto Azure Batch. Określona podsieć powinna mieć wystarczającą liczbę wolnych adresów IP, aby pomieścić liczbę węzłów obliczeniowych w puli. Jeśli podsieć nie ma wystarczającej liczby wolnych adresów IP, pula częściowo przydzieli węzły i wystąpi błąd zmiany rozmiaru. Jednostka usługi "MicrosoftAzureBatch" musi mieć rolę "Współautor klasycznej maszyny wirtualnej" Role-Based Access Control (RBAC) dla określonej sieci wirtualnej. Określona podsieć musi zezwalać na komunikację z usługi Azure Batch, aby móc planować zadania w węzłach. Można to zweryfikować, sprawdzając, czy określona sieć wirtualna ma skojarzone sieciowe grupy zabezpieczeń. Jeśli komunikacja z węzłami w określonej podsieci zostanie odrzucona przez sieciową grupę zabezpieczeń, usługa Batch ustawi stan węzłów obliczeniowych na bezużyteczny. W przypadku pul utworzonych za pomocą polecenia virtualMachineConfiguration obsługiwane są tylko sieci wirtualne USŁUGI ARM (Microsoft.Network/virtualNetworks), ale w przypadku pul utworzonych za pomocą klasy cloudServiceConfiguration obsługiwane są zarówno sieci wirtualne ARM, jak i klasyczne. Jeśli określona sieć wirtualna ma skojarzone sieciowe grupy zabezpieczeń, należy włączyć kilka zarezerwowanych portów systemu na potrzeby komunikacji przychodzącej. W przypadku pul utworzonych przy użyciu konfiguracji maszyny wirtualnej włącz porty 29876 i 29877, a także port 22 dla systemu Linux i port 3389 dla Windows. W przypadku pul utworzonych przy użyciu konfiguracji usługi w chmurze włącz porty 10100, 20100 i 30100. Włącz również połączenia wychodzące z usługą Azure Storage na porcie 443. Aby uzyskać więcej informacji, zobacz: https://docs.microsoft.com/en-us/azure/batch/batch-api-basics#virtual-network-vnet-and-firewall-configuration

NetworkSecurityGroupRule

Reguła sieciowej grupy zabezpieczeń, która ma być stosowana do przychodzącego punktu końcowego.

Name Type Description
access

Akcja, która powinna zostać podjęta dla określonego adresu IP, zakresu podsieci lub tagu.

priority
  • integer

Priorytet dla tej reguły.
Priorytety w puli muszą być unikatowe i są oceniane w kolejności priorytetu. Im niższa liczba jest wyższa niż priorytet. Można na przykład określić reguły z numerami porządkowymi 150, 250 i 350. Reguła z numerem porządkowym 150 ma pierwszeństwo przed regułą, która ma kolejność 250. Dozwolone priorytety to od 150 do 4096. Jeśli podano jakiekolwiek wartości zarezerwowane lub zduplikowane, żądanie kończy się niepowodzeniem z kodem stanu HTTP 400.

sourceAddressPrefix
  • string

Prefiks lub tag adresu źródłowego zgodny z regułą.
Prawidłowe wartości to pojedynczy adres IP (tj. 10.10.10.10.10), podsieć IP (tj. 192.168.1.0/24), tag domyślny lub * (dla wszystkich adresów). Jeśli podano inne wartości, żądanie kończy się niepowodzeniem z kodem stanu HTTP 400.

sourcePortRanges
  • string[]

Zakresy portów źródłowych pasujące do reguły.
Prawidłowe wartości to "" (dla wszystkich portów 0 – 65535), określony port (tj. 22) lub zakres portów (tj. 100–200). Porty muszą znajdować się w zakresie od 0 do 65535. Każdy wpis w tej kolekcji nie może nakładać się na inny wpis (zakres lub pojedynczy port). Jeśli podano inne wartości, żądanie kończy się niepowodzeniem z kodem stanu HTTP 400. Wartość domyślna to "".

NetworkSecurityGroupRuleAccess

Akcja, która powinna zostać podjęta dla określonego adresu IP, zakresu podsieci lub tagu.

Name Type Description
allow
  • string

Zezwalaj na dostęp.

deny
  • string

Odmowa dostępu.

NFSMountConfiguration

Informacje używane do nawiązywania połączenia z systemem plików NFS.

Name Type Description
mountOptions
  • string

Dodatkowe opcje wiersza polecenia, które mają być przekazywane do polecenia instalacji.
Są to opcje "net use" w opcjach Windows i "instalowanie" w systemie Linux.

relativeMountPath
  • string

Ścieżka względna w węźle obliczeniowym, w którym zostanie zainstalowany system plików
Wszystkie systemy plików są instalowane względem katalogu instalacji usługi Batch, dostępnego za pośrednictwem zmiennej środowiskowej AZ_BATCH_NODE_MOUNTS_DIR.

source
  • string

Identyfikator URI systemu plików do zainstalowania.

NodePlacementConfiguration

Konfiguracja umieszczania węzłów dla puli.

Name Type Description
policy

Typ zasad umieszczania węzłów w pulach usługi Batch.
Zasady alokacji używane przez usługę Batch do aprowizowania węzłów. Jeśli nie zostanie określony, usługa Batch użyje zasad regionalnych.

NodePlacementPolicyType

Zasady umieszczania dla przydzielania węzłów w puli.

Name Type Description
regional
  • string

Wszystkie węzły w puli zostaną przydzielone w tym samym regionie.

zonal
  • string

Węzły w puli będą rozmieszczone w różnych strefach dostępności z najlepszym równoważeniem wysiłku.

OnAllTasksComplete

Akcja, jaką usługa Batch powinna wykonać, gdy wszystkie zadania w zadaniu są w stanie ukończonym.

Name Type Description
noaction
  • string

Nic nie robić. Zadanie pozostaje aktywne, chyba że zostało przerwane lub wyłączone w inny sposób.

terminatejob
  • string

Zakończ zadanie. Parametr terminateReason zadania jest ustawiony na wartość "AllTasksComplete".

OnTaskFailure

Akcja, jaką usługa Batch powinna wykonać, gdy dowolne zadanie w zadaniu zakończy się niepowodzeniem.

Name Type Description
noaction
  • string

Nic nie robić. Zadanie pozostaje aktywne, chyba że zostało przerwane lub wyłączone w inny sposób.

performexitoptionsjobaction
  • string

Wykonaj akcję skojarzona z warunkiem zakończenia zadania w kolekcji ExitConditions zadania. (Może to spowodować, że nie zostanie podjęta żadna akcja, jeśli jest to określone zadanie).

OSDisk

Ustawienia dla dysku systemu operacyjnego węzła obliczeniowego (VM).

Name Type Description
ephemeralOSDiskSettings

Określa efemeryczny dysk Ustawienia dla dysku systemu operacyjnego używanego przez węzeł obliczeniowy (VM).

OutputFile

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

Name Type Description
destination

Miejsce docelowe plików wyjściowych.

filePattern
  • string

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

uploadOptions

Dodatkowe opcje operacji przekazywania, w tym na jakich warunkach należy wykonać przekazywanie.

OutputFileBlobContainerDestination

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

Name Type Description
containerUrl
  • string

Adres URL kontenera w Azure Blob Storage, do którego mają być przekazywane pliki.
Jeśli nie używasz tożsamości zarządzanej, adres URL musi zawierać sygnaturę dostępu współdzielonego udzielając uprawnień do zapisu w kontenerze.

identityReference

Odwołanie do tożsamości przypisanej przez użytkownika w celu uzyskania dostępu do Azure Blob Storage określonych przez containerUrl
Tożsamość musi mieć dostęp do zapisu do kontenera Azure Blob Storage

path
  • string

Docelowy obiekt blob lub katalog wirtualny w kontenerze usługi Azure Storage.
Jeśli parametr filePattern odwołuje się do określonego pliku (tj. nie zawiera symboli wieloznacznych), ścieżka to nazwa obiektu blob, do którego ma być przekazywany ten plik. Jeśli plikPattern zawiera co najmniej jeden symbol wieloznaczny (i w związku z tym może być zgodny z wieloma plikami), ścieżka jest nazwą katalogu wirtualnego obiektu blob (który jest poprzedzany każdą nazwą obiektu blob), do którego mają zostać przekazane pliki. W przypadku pominięcia pliki są przekazywane do katalogu głównego kontenera z nazwą obiektu blob pasującą do nazwy pliku.

uploadHeaders

Lista par nazwa-wartość dla nagłówków, które mają być używane w przekazywaniu plików wyjściowych
Te nagłówki zostaną określone podczas przekazywania plików do usługi Azure Storage. Aby uzyskać więcej informacji, zobacz Request Headers (Wszystkie typy obiektów blob) .

OutputFileDestination

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

Name Type Description
container

Lokalizacja w usłudze Azure Blob Storage, do której są przekazywane pliki.

OutputFileUploadCondition

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

Name Type Description
taskcompletion
  • string

Przekaż pliki po zakończeniu procesu zadania, niezależnie od kodu zakończenia.

taskfailure
  • string

Przekaż pliki dopiero po zakończeniu procesu zadania z kodem zakończenia bezzerowym.

tasksuccess
  • string

Przekaż pliki dopiero po zakończeniu procesu zadania z kodem zakończenia 0.

OutputFileUploadOptions

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

Name Type Description
uploadCondition

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

PoolEndpointConfiguration

Konfiguracja punktu końcowego dla puli.

Name Type Description
inboundNATPools

Lista pul nat dla ruchu przychodzącego, których można użyć do adresowania określonych portów na pojedynczym węźle obliczeniowym zewnętrznie.
Maksymalna liczba pul nat dla ruchu przychodzącego na pulę usługi Batch wynosi 5. Jeśli maksymalna liczba przychodzących pul nat zostanie przekroczona, żądanie zakończy się niepowodzeniem z kodem stanu HTTP 400. Nie można go określić, jeśli parametr IPAddressProvisioningType ma wartość NoPublicIPAddresses.

PoolInformation

Określa sposób przypisywanie zadania do puli.

Name Type Description
autoPoolSpecification

Cechy tymczasowej "puli automatycznej". Usługa Batch utworzy tę automatyczną pulę po przesłaniu zadania.
Jeśli tworzenie puli automatycznej zakończy się niepowodzeniem, usługa Batch przeniesie zadanie do stanu ukończonego, a błąd tworzenia puli zostanie ustawiony we właściwości błędu planowania zadania. Usługa Batch zarządza okresem istnienia (zarówno tworzeniem, jak i, chyba że określono wartość keepAlive, usunięcie) puli automatycznej. Wszystkie akcje użytkownika, które wpływają na okres istnienia puli automatycznej, gdy zadanie jest aktywne, spowoduje nieoczekiwane zachowanie. Należy określić identyfikator puli lub specyfikację puli automatycznej, ale nie obie.

poolId
  • string

Identyfikator istniejącej puli. Wszystkie zadania zadania zadania zostaną uruchomione w określonej puli.
Upewnij się, że pula, do której odwołuje się ta właściwość, istnieje. Jeśli pula nie istnieje w czasie, gdy usługa Batch próbuje zaplanować zadanie, żadne zadania dla zadania nie zostaną uruchomione do momentu utworzenia puli o tym identyfikatorze. Należy pamiętać, że usługa Batch nie odrzuci żądania zadania; po prostu nie będzie uruchamiać zadań, dopóki pula nie istnieje. Należy określić identyfikator puli lub specyfikację puli automatycznej, ale nie obie.

PoolLifetimeOption

Minimalny okres istnienia utworzonych automatycznych pul oraz sposób przypisywaniu wielu zadań zgodnie z harmonogramem do pul.

Name Type Description
job
  • string

Pula istnieje przez cały okres istnienia zadania, do którego jest ona dedykowana. Usługa Batch tworzy pulę podczas tworzenia zadania. Jeśli opcja "job" jest stosowana do harmonogramu zadań, usługa Batch tworzy nową automatyczną pulę dla każdego zadania utworzonego zgodnie z harmonogramem.

jobschedule
  • string

Pula istnieje przez okres istnienia harmonogramu zadań. Usługa Batch tworzy pulę podczas tworzenia pierwszego zadania zgodnie z harmonogramem. Tę opcję można zastosować tylko do harmonogramów zadań, a nie do zadań.

PoolSpecification

Specyfikacja tworzenia nowej puli.

Name Type Description
applicationLicenses
  • string[]

Lista licencji aplikacji udostępnianych przez usługę Batch w każdym węźle obliczeniowym w puli.
Lista licencji aplikacji musi być podzbiorem dostępnych licencji aplikacji usługi Batch. Jeśli zażądano licencji, która nie jest obsługiwana, tworzenie puli zakończy się niepowodzeniem. Dozwolone licencje dostępne na basenie to "maya", "vray", "3dsmax", "arnold". Dodatkowa opłata jest naliczana za każdą licencję aplikacji dodaną do puli.

applicationPackageReferences

Lista pakietów do zainstalowania w każdym węźle obliczeniowym w puli.
Zmiany odwołań do pakietu mają wpływ na wszystkie nowe węzły łączące pulę, ale nie mają wpływu na węzły obliczeniowe, które znajdują się już w puli, dopóki nie zostaną ponownie uruchomione lub ponownie z obrazu. W dowolnej puli istnieje maksymalnie 10 odwołań do pakietu.

autoScaleEvaluationInterval
  • string

Interwał czasu, w którym ma automatycznie dostosować rozmiar puli zgodnie z formułą autoskalowania.
Wartość domyślna to 15 minut. Minimalna i maksymalna wartość to odpowiednio 5 minut i 168 godzin. Jeśli określisz wartość mniejszą niż 5 minut lub większą niż 168 godzin, usługa Batch odrzuci żądanie z nieprawidłowym błędem wartości właściwości; jeśli bezpośrednio wywołujesz interfejs API REST, kod stanu HTTP to 400 (nieprawidłowe żądanie).

autoScaleFormula
  • string

Formuła żądanej liczby węzłów obliczeniowych w puli.
Nie można określić tej właściwości, jeśli wartość enableAutoScale jest ustawiona na wartość false. Jest to wymagane, jeśli wartość enableAutoScale jest ustawiona na wartość true. Formuła jest sprawdzana pod kątem ważności przed utworzeniem puli. Jeśli formuła jest nieprawidłowa, usługa Batch odrzuca żądanie ze szczegółowymi informacjami o błędzie.

certificateReferences

Lista certyfikatów do zainstalowania w każdym węźle obliczeniowym w puli.
W przypadku węzłów Windows usługa Batch instaluje certyfikaty w określonym magazynie i lokalizacji certyfikatów. W przypadku węzłów obliczeniowych systemu Linux certyfikaty są przechowywane w katalogu roboczym Zadania, a zmienna środowiskowa AZ_BATCH_CERTIFICATES_DIR jest dostarczana do zadania w celu wykonania zapytania o tę lokalizację. W przypadku certyfikatów z widocznością "remoteUser" katalog "certs" jest tworzony w katalogu głównym użytkownika (np. /home/{user-name}/certs) i Certyfikaty są umieszczane w tym katalogu.

cloudServiceConfiguration

Konfiguracja usługi w chmurze dla puli.
Tę właściwość należy określić, jeśli należy utworzyć pulę przy użyciu maszyn wirtualnych paaS platformy Azure. Ta właściwość i element virtualMachineConfiguration wzajemnie się wykluczają i należy określić jedną z właściwości. Jeśli żadna z nich nie zostanie określona, usługa Batch zwróci błąd; jeśli bezpośrednio wywołujesz interfejs API REST, kod stanu HTTP to 400 (nieprawidłowe żądanie). Nie można określić tej właściwości, jeśli konto usługi Batch zostało utworzone z właściwością poolAllocationMode ustawioną na wartość "UserSubscription".

displayName
  • string

Nazwa wyświetlana puli.
Nazwa wyświetlana nie musi być unikatowa i może zawierać znaki Unicode o maksymalnej długości 1024.

enableAutoScale
  • boolean

Określa, czy rozmiar puli powinien być automatycznie dostosowywany w czasie.
Jeśli wartość false, należy określić co najmniej jeden element targetDedicatedNodes i targetLowPriorityNodes. Jeśli wartość true, element autoScaleFormula jest wymagany. Pula automatycznie zmienia rozmiar zgodnie z formułą. Wartość domyślna to false.

enableInterNodeCommunication
  • boolean

Czy pula zezwala na bezpośrednią komunikację między węzłami obliczeniowymi.
Włączenie komunikacji między węzłami ogranicza maksymalny rozmiar puli z powodu ograniczeń wdrażania w węzłach obliczeniowych puli. Może to spowodować, że pula nie osiągnie żądanego rozmiaru. Wartość domyślna to false.

metadata

Lista par nazwa-wartość skojarzona z pulą jako metadanymi.
Usługa Batch nie przypisuje żadnego znaczenia do metadanych; jest on przeznaczony wyłącznie do korzystania z kodu użytkownika.

mountConfiguration

Lista systemów plików do zainstalowania w każdym węźle w puli.
Obsługuje to Azure Files, NFS, CIFS/SMB i Blobfuse.

networkConfiguration

Konfiguracja sieci dla puli.
Konfiguracja sieci dla puli.

resizeTimeout
  • string

Limit czasu alokacji węzłów obliczeniowych do puli.
Ten limit czasu dotyczy tylko skalowania ręcznego; nie ma żadnego wpływu, gdy wartość enableAutoScale jest ustawiona na wartość true. Wartość domyślna to 15 minut. Minimalna wartość to 5 minut. Jeśli określisz wartość mniejszą niż 5 minut, usługa Batch odrzuca żądanie z powodu błędu; jeśli bezpośrednio wywołujesz interfejs API REST, kod stanu HTTP to 400 (nieprawidłowe żądanie).

startTask

Zadanie do uruchomienia w każdym węźle obliczeniowym podczas dołączania do puli. Zadanie jest uruchamiane po dodaniu węzła obliczeniowego do puli lub ponownym uruchomieniu węzła obliczeniowego.
Usługa Batch ponowi próbę wykonania zadań po wyzwoleniu operacji odzyskiwania w węźle. Przykłady operacji odzyskiwania obejmują (ale nie są ograniczone do) po ponownym uruchomieniu węzła w złej kondycji lub zniknięciu 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 w przypadku długotrwałych zadań jest użycie jakiejś formy tworzenia punktów kontrolnych. W niektórych przypadkach funkcja StartTask może zostać uruchomiona ponownie, 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.

targetDedicatedNodes
  • integer

Żądana liczba dedykowanych węzłów obliczeniowych w puli.
Nie można określić tej właściwości, jeśli dla właściwości enableAutoScale ustawiono wartość true. Jeśli wartość enableAutoScale jest ustawiona na wartość false, musisz ustawić wartość targetDedicatedNodes, targetLowPriorityNodes lub oba te węzły.

targetLowPriorityNodes
  • integer

Żądana liczba węzłów obliczeniowych typu spot/low-priority w puli.
Nie można określić tej właściwości, jeśli dla właściwości enableAutoScale ustawiono wartość true. Jeśli wartość enableAutoScale jest ustawiona na wartość false, musisz ustawić wartość targetDedicatedNodes, targetLowPriorityNodes lub oba te węzły.

taskSchedulingPolicy

Sposób dystrybucji zadań między węzłami obliczeniowymi w puli.
Jeśli nie zostanie określony, wartość domyślna zostanie rozłożona.

taskSlotsPerNode
  • integer

Liczba miejsc zadań, których można użyć do uruchamiania współbieżnych zadań w jednym węźle obliczeniowym w puli.
Wartość domyślna to 1. Maksymalna wartość jest mniejsza niż 4 razy mniejsza liczba rdzeni maszyny wirtualnej VmSize puli lub 256.

userAccounts

Lista kont użytkowników do utworzenia w każdym węźle obliczeniowym w puli.

virtualMachineConfiguration

Konfiguracja maszyny wirtualnej dla puli.
Tę właściwość należy określić, jeśli pula musi zostać utworzona za pomocą maszyn wirtualnych IaaS platformy Azure. Ta właściwość i właściwość cloudServiceConfiguration wzajemnie się wykluczają i należy określić jedną z właściwości. Jeśli żadna z nich nie zostanie określona, usługa Batch zwróci błąd; jeśli bezpośrednio wywołujesz interfejs API REST, kod stanu HTTP to 400 (nieprawidłowe żądanie).

vmSize
  • string

Rozmiar maszyn wirtualnych w puli. Wszystkie maszyny wirtualne w puli mają taki sam rozmiar.
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://docs.microsoft.com/azure/batch/batch-pool-vm-sizes).

PublicIPAddressConfiguration

Konfiguracja publicznego adresu IP konfiguracji sieci puli.

Name Type Description
ipAddressIds
  • string[]

Lista publicznych adresów IP, których usługa Batch będzie używać podczas aprowizacji węzłów obliczeniowych.
Liczba adresów IP określonych w tym miejscu ogranicza maksymalny rozmiar puli — 100 dedykowanych węzłów lub 100 węzłów typu spot/low-priority można przydzielić dla każdego publicznego adresu IP. Na przykład pula wymagając 250 dedykowanych maszyn wirtualnych wymaga co najmniej 3 publicznych adresów IP. Każdy element tej kolekcji ma postać: /subscriptions/{subscription}/resourceGroups/{group}/providers/Microsoft.Network/publicIPAddresses/{ip}.

provision

Typ inicjowania obsługi administracyjnej dla publicznych adresów IP dla puli.
Wartość domyślna to BatchManaged.

RecentJob

Informacje o najnowszym zadaniu do uruchomienia w harmonogramie zadań.

Name Type Description
id
  • string

Identyfikator zadania.

url
  • string

Adres URL zadania.

ResourceFile

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

Name Type Description
autoStorageContainerName
  • string

Nazwa kontenera magazynu na koncie magazynu automatycznego.
Właściwości autoStorageContainerName, storageContainerUrl i httpUrl wzajemnie się wykluczają i należy określić jedną z nich.

blobPrefix
  • string

Prefiks obiektu blob używany podczas pobierania obiektów blob z kontenera usługi Azure Storage. Zostaną pobrane tylko obiekty blob, których nazwy zaczynają się od określonego prefiksu.
Właściwość jest prawidłowa tylko wtedy, gdy jest używana właściwość autoStorageContainerName lub storageContainerUrl. Ten prefiks może być częściową nazwą pliku lub podkatalogem. Jeśli prefiks nie zostanie określony, wszystkie pliki w kontenerze zostaną pobrane.

fileMode
  • string

Atrybut trybu uprawnień pliku w formacie ósemkowym.
Ta właściwość ma zastosowanie tylko do plików pobieranych do węzłów obliczeniowych systemu Linux. Zostanie on zignorowany, jeśli zostanie określony dla pliku resourceFile, który zostanie pobrany do węzła obliczeniowego Windows. Jeśli ta właściwość nie zostanie określona dla węzła obliczeniowego systemu Linux, do pliku zostanie zastosowana wartość domyślna 0770.

filePath
  • string

Lokalizacja węzła obliczeniowego, do którego mają być pobierane pliki względem katalogu roboczego zadania.
Jeśli właściwość httpUrl jest określona, parametr filePath jest wymagany i opisuje ścieżkę, do której zostanie pobrany plik, w tym nazwę pliku. W przeciwnym razie, jeśli określono właściwość autoStorageContainerName lub storageContainerUrl, parametr filePath jest opcjonalny i jest katalogem do pobrania plików. W przypadku, gdy plikPath jest używany jako katalog, każda struktura katalogów już skojarzona z danymi wejściowymi zostanie zachowana w całości i dołączona do określonego katalogu filePath. Określona ścieżka względna nie może wyprzeć katalogu roboczego zadania (na przykład przy użyciu polecenia ".".

httpUrl
  • string

Adres URL pliku do pobrania.
Właściwości autoStorageContainerName, storageContainerUrl i httpUrl wzajemnie się wykluczają i należy określić jedną z nich. Jeśli adres URL wskazuje Azure Blob Storage, musi być czytelny z węzłów obliczeniowych. Istnieją trzy sposoby uzyskania takiego adresu URL dla obiektu blob w usłudze Azure Storage: obejmują sygnaturę dostępu współdzielonego udzielając uprawnień do odczytu w obiekcie blob, użyć tożsamości zarządzanej z uprawnieniem do odczytu lub ustawić listę ACL dla obiektu blob lub kontenera, aby zezwolić na dostęp publiczny.

identityReference

Odwołanie do tożsamości przypisanej przez użytkownika do użycia w celu uzyskania dostępu do Azure Blob Storage określonego przez storageContainerUrl lub httpUrl
Odwołanie do tożsamości przypisanej przez użytkownika skojarzonej z pulą usługi Batch, której będzie używać węzeł obliczeniowy.

storageContainerUrl
  • string

Adres URL kontenera obiektów blob w Azure Blob Storage.
Właściwości autoStorageContainerName, storageContainerUrl i httpUrl wzajemnie się wykluczają i należy określić jedną z nich. Ten adres URL musi być czytelny i możliwy do wyświetlenia z węzłów obliczeniowych. Istnieją trzy sposoby uzyskiwania takiego adresu URL dla kontenera w usłudze Azure Storage: obejmują sygnaturę dostępu współdzielonego udzielając uprawnień do odczytu i listy w kontenerze, używanie tożsamości zarządzanej z uprawnieniami do odczytu i listy lub ustawienie listy ACL dla kontenera w celu zezwolenia na dostęp publiczny.

Schedule

Harmonogram, zgodnie z którym zadania zostaną utworzone. Wszystkie czasy są stałe w formacie UTC i nie mają wpływu na czas letni.

Name Type Description
doNotRunAfter
  • string

Czas, po którym żadne zadanie nie zostanie utworzone w ramach tego harmonogramu zadań. Harmonogram zostanie przeniesiony do stanu ukończonego zaraz po upływie tego terminu i nie ma aktywnego zadania w ramach tego harmonogramu zadań.
Jeśli nie określisz czasu doNotRunAfter i tworzysz cykliczny harmonogram zadań, harmonogram zadań pozostanie aktywny do momentu jawnego zakończenia.

doNotRunUntil
  • string

Najwcześniejsza godzina utworzenia dowolnego zadania w ramach tego harmonogramu zadań.
Jeśli nie określisz godziny doNotRunUntil, harmonogram stanie się gotowy do natychmiastowego utworzenia zadań.

recurrenceInterval
  • string

Interwał czasu między godzinami rozpoczęcia dwóch kolejnych zadań w ramach harmonogramu zadań. Harmonogram zadań może zawierać co najwyżej jedno aktywne zadanie w danym momencie.
Ponieważ harmonogram zadań może mieć co najwyżej jedno aktywne zadanie w danym momencie, jeśli nadszedł czas na utworzenie nowego zadania zgodnie z harmonogramem zadań, ale poprzednie zadanie jest nadal uruchomione, usługa Batch nie utworzy nowego zadania do momentu zakończenia poprzedniego zadania. Jeśli poprzednie zadanie nie zostanie zakończone w przedziale startowymWindow nowej cykluInterval, żadne nowe zadanie nie zostanie zaplanowane dla tego interwału. W przypadku zadań cyklicznych zwykle należy określić zadanieManagerTask w zadaniuSpecification. Jeśli nie używasz funkcji jobManagerTask, potrzebny będzie zewnętrzny proces monitorowania podczas tworzenia zadań, dodawanie zadań do zadań i kończenie zadań gotowych do następnego cyklu. Domyślnym ustawieniem jest to, że harmonogram nie jest powtarzany: jedno zadanie jest tworzone, w obszarze startWindow po godzinie doNotRunUntil, a harmonogram zostanie ukończony zaraz po zakończeniu tego zadania. Minimalna wartość to 1 minuta. Jeśli określisz niższą wartość, usługa Batch odrzuca harmonogram z błędem; jeśli bezpośrednio wywołujesz interfejs API REST, kod stanu HTTP to 400 (nieprawidłowe żądanie).

startWindow
  • string

Interwał czasu rozpoczynający się od momentu, w którym harmonogram wskazuje, że zadanie powinno zostać utworzone, w ramach którego należy utworzyć zadanie.
Jeśli zadanie nie zostanie utworzone w interwale startWindow, "szansa" zostanie utracona; Żadne zadanie nie zostanie utworzone do następnego cyklu harmonogramu. Jeśli harmonogram jest cykliczny, a wartość startWindow jest dłuższa niż interwał cyklu, jest to równoważne nieskończonej wartości startWindow, ponieważ zadanie, które jest "należne" w jednym cykluInterval, nie jest przenoszone do następnego interwału cyklu. Wartość domyślna to nieskończoność. Minimalna wartość to 1 minuta. Jeśli określisz niższą wartość, usługa Batch odrzuca harmonogram z błędem; jeśli bezpośrednio wywołujesz interfejs API REST, kod stanu HTTP to 400 (nieprawidłowe żądanie).

StartTask

Zadanie uruchamiane po dołączeniu węzła do puli w usłudze Azure Batch lub po ponownym uruchomieniu lub ponownym uruchomieniu węzła obliczeniowego lub ponownym obrazie.

Name Type Description
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 rozszerzanie zmiennych środowiskowych. Jeśli chcesz korzystać z takich funkcji, należy wywołać powłokę w wierszu polecenia, na przykład za pomocą polecenia "cmd /c MyCommand" w Windows lub "/bin/sh -c MyCommand" w systemie Linux. Jeśli wiersz polecenia odwołuje się do ścieżek plików, powinien użyć ścieżki względnej (względnej względem katalogu roboczego zadania) lub użyć zmiennej środowiskowej udostępnionej w usłudze Batch (https://docs.microsoft.com/en-us/azure/batch/batch-compute-node-environment-variables).

containerSettings

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

environmentSettings

Lista ustawień zmiennych środowiskowych dla elementu StartTask.

maxTaskRetryCount
  • integer

Maksymalna liczba ponownych prób wykonania zadania.
Usługa Batch ponawia próbę zadania, jeśli jego kod zakończenia jest niezerowy. Należy pamiętać, że ta wartość określa w szczególności 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 maksymalnie 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 (brak 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 ResourceFiles. Można to osiągnąć przy użyciu plików .zip, pakietów aplikacji lub kontenerów platformy Docker.
Pliki wymienione w tym elemecie znajdują się w katalogu roboczym zadania.

userIdentity

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

waitForSuccess
  • boolean

Określa, czy usługa Batch powinna czekać na pomyślne zakończenie zadania StartTask (czyli zakończenie pracy z kodem zakończenia 0) przed zaplanowaniem jakichkolwiek zadań w węźle obliczeniowym.
Jeśli wartość true i zadanie StartTask zakończy się niepowodzeniem w węźle, usługa Batch ponawia próbę uruchomienia do maksymalnej liczby ponownych prób (maxTaskRetryCount). Jeśli zadanie nadal nie zostało ukończone pomyślnie po wszystkich 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 informacji o stanie węzła obliczeniowego i 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 zadanie StartTask jest nadal uruchomione; 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.

StorageAccountType

Typ konta magazynu do użycia w tworzeniu dysków danych.

Name Type Description
premium_lrs
  • string

Dysk danych powinien używać magazynu lokalnie nadmiarowego w warstwie Premium.

standard_lrs
  • string

Dysk danych powinien używać standardowego magazynu lokalnie nadmiarowego.

TaskConstraints

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

Name Type Description
maxTaskRetryCount
  • integer

Maksymalna liczba ponownych prób zadania. Usługa Batch ponawia próbę zadania, jeśli jego kod zakończenia jest niezerowy.
Należy pamiętać, że ta wartość w szczególności kontroluje liczbę ponownych prób dla pliku wykonywalnego zadania z powodu kodu zakończenia niezerowego. Usługa Batch spróbuje raz zadanie, a następnie może ponowić próbę do tego limitu. Jeśli na przykład maksymalna liczba ponownych prób wynosi 3, usługa Batch 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 po pierwszej próbie. Jeśli maksymalna liczba ponownych prób to -1, usługa Batch ponawia próbę zadania bez limitu, jednak nie jest to zalecane w przypadku zadania uruchamiania ani żadnego zadania. Wartość domyślna to 0 (bez ponownych prób)

maxWallClockTime
  • string

Maksymalny czas, który upłynął do uruchomienia zadania, mierzony od momentu uruchomienia zadania. Jeśli zadanie nie zostanie ukończone w ramach limitu czasu, usługa Batch go zakończy.
Jeśli ta wartość nie jest określona, nie ma limitu czasu na czas uruchomienia zadania.

retentionTime
  • string

Minimalny czas przechowywania katalogu zadań w węźle obliczeniowym, w którym został uruchomiony, od momentu ukończenia wykonywania. Po tym czasie usługa Batch może usunąć katalog Zadań i całą jego zawartość.
Wartość domyślna to 7 dni, tj. katalog zadań zostanie zachowany przez 7 dni, chyba że węzeł obliczeniowy zostanie usunięty lub zadanie zostanie usunięte.

TaskContainerSettings

Ustawienia kontenera dla zadania.

Name Type Description
containerRunOptions
  • string

Dodatkowe opcje polecenia tworzenia kontenera.
Te dodatkowe opcje są dostarczane jako argumenty polecenia "docker create" oprócz tych kontrolowanych przez usługę Batch.

imageName
  • string

Obraz używany do utworzenia kontenera, w którym zostanie uruchomione zadanie.
Jest to pełne odwołanie do obrazu, które zostanie określone jako "ściąganie platformy Docker". Jeśli żaden tag nie zostanie podany jako część nazwy obrazu, tag ":latest" jest używany jako domyślny.

registry

Rejestr prywatny zawierający obraz kontenera.
To ustawienie można pominąć, jeśli zostało już udostępnione podczas tworzenia puli.

workingDirectory

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

TaskSchedulingPolicy

Określa sposób dystrybucji zadań w węzłach obliczeniowych.

Name Type Description
nodeFillType

Jak zadania są dystrybuowane między węzłami obliczeniowymi w puli.
Jeśli nie zostanie określony, wartość domyślna zostanie rozłożona.

UserAccount

Właściwości używane do tworzenia użytkownika używanego do wykonywania zadań w węźle obliczeniowym Azure Batch.

Name Type Description
elevationLevel

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

linuxUserConfiguration

Konfiguracja użytkownika specyficzna dla systemu Linux dla konta użytkownika.
Ta właściwość jest ignorowana, jeśli została określona w puli Windows. Jeśli nie zostanie określony, użytkownik zostanie utworzony przy użyciu opcji domyślnych.

name
  • string

Nazwa konta użytkownika.

password
  • string

Hasło do konta użytkownika.

windowsUserConfiguration

Konfiguracja użytkownika specyficznego dla Windows dla konta użytkownika.
Tę właściwość można określić tylko wtedy, gdy użytkownik znajduje się w puli Windows. Jeśli nie określono wartości i w puli Windows, użytkownik zostanie utworzony przy użyciu opcji domyślnych.

UserIdentity

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

Name Type Description
autoUser

Użytkownik automatyczny, w ramach którego jest uruchamiane zadanie.
Właściwości userName i autoUser wzajemnie się wykluczają; Musisz określić jeden, ale nie oba.

username
  • string

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

VirtualMachineConfiguration

Konfiguracja węzłów obliczeniowych w puli na podstawie infrastruktury usługi Azure Virtual Machines.

Name Type Description
containerConfiguration

Konfiguracja kontenera dla puli.
Jeśli zostanie określony, konfiguracja jest wykonywana na każdym węźle obliczeniowym w puli, aby umożliwić uruchamianie zadań w kontenerach. Wszystkie zwykłe zadania i zadania podrzędne menedżera zadań są uruchamiane w tej puli, muszą określać właściwość containerSettings, a wszystkie inne zadania mogą je określać.

dataDisks

Konfiguracja dysków danych dołączonych do węzłów obliczeniowych w puli.
Tę właściwość należy określić, jeśli węzły obliczeniowe w puli muszą mieć dołączone do nich puste dyski danych. Nie można tego zaktualizować. Każdy węzeł obliczeniowy pobiera własny dysk (dysk nie jest udziałem plików). Nie można dołączyć istniejących dysków. Każdy dołączony dysk jest pusty. Po usunięciu węzła obliczeniowego z puli dysk i wszystkie skojarzone z nim dane również zostaną usunięte. Dysk nie jest sformatowany po dołączeniu, należy go sformatować przed użyciem — aby uzyskać więcej informacji, zobacz https://docs.microsoft.com/en-us/azure/virtual-machines/linux/classic/attach-disk#initialize-a-new-data-disk-in-linux i https://docs.microsoft.com/en-us/azure/virtual-machines/windows/attach-disk-ps#add-an-empty-data-disk-to-a-virtual-machine.

diskEncryptionConfiguration

Konfiguracja szyfrowania dysków dla puli.
W przypadku określenia szyfrowanie jest wykonywane na każdym węźle w puli podczas aprowizacji węzła.

extensions

Rozszerzenie maszyny wirtualnej dla puli.
Jeśli zostanie określony, rozszerzenia wymienione w tej konfiguracji zostaną zainstalowane na każdym węźle.

imageReference

Odwołanie do obrazu witryny Azure Virtual Machines Marketplace lub niestandardowego obrazu maszyny wirtualnej do użycia.

licenseType
  • string

Typ licencji lokalnej, która ma być używana podczas wdrażania systemu operacyjnego.
Dotyczy to tylko obrazów, które zawierają Windows systemu operacyjnego i powinny być używane tylko w przypadku przechowywania prawidłowych licencji lokalnych dla węzłów obliczeniowych, które zostaną wdrożone. W przypadku pominięcia nie zastosowano rabatu na licencjonowanie lokalne. Wartości to:

Windows_Server — licencja lokalna dotyczy serwera Windows. Windows_Client — licencja lokalna jest przeznaczony dla klienta Windows.

nodeAgentSKUId
  • string

Jednostka SKU agenta węzła obliczeniowego usługi Batch, która ma być aprowizowana w węzłach obliczeniowych w puli.
Agent węzła obliczeniowego usługi Batch to program, który działa w każdym węźle obliczeniowym w puli i udostępnia interfejs sterowania między węzłem obliczeniowym a usługą Batch. Istnieją różne implementacje agenta węzła obliczeniowego, nazywanego jednostkami SKU, dla różnych systemów operacyjnych. Należy określić jednostkę SKU agenta węzła obliczeniowego zgodną z wybranym odwołaniem do obrazu. Aby uzyskać listę obsługiwanych jednostek SKU agenta węzła obliczeniowego wraz z listą zweryfikowanych odwołań do obrazów, zobacz operację "Lista obsługiwanych jednostek SKU agenta węzła obliczeniowego".

nodePlacementConfiguration

Konfiguracja umieszczania węzłów dla puli.
Ta konfiguracja określi reguły dotyczące fizycznego przydzielania węzłów w puli.

osDisk

Ustawienia dla dysku systemu operacyjnego maszyny wirtualnej.

windowsConfiguration

Windows ustawienia systemu operacyjnego na maszynie wirtualnej.
Nie można określić tej właściwości, jeśli właściwość imageReference określa obraz systemu operacyjnego Linux.

VMExtension

Konfiguracja rozszerzeń maszyn wirtualnych.

Name Type Description
autoUpgradeMinorVersion
  • boolean

Wskazuje, czy rozszerzenie powinno używać nowszej wersji pomocniczej, jeśli jest ona dostępna w czasie wdrażania. Po wdrożeniu rozszerzenie nie uaktualni wersji pomocniczych, chyba że zostanie ponownie wdrożone, nawet jeśli ta właściwość ma wartość true.

name
  • string

Nazwa rozszerzenia maszyny wirtualnej.

protectedSettings
  • object

Rozszerzenie może zawierać ustawienia protectedSettings lub protectedSettingsFromKeyVault lub w ogóle nie są chronione.

provisionAfterExtensions
  • string[]

Kolekcja nazw rozszerzeń.
Kolekcja nazw rozszerzeń, po których należy aprowizować to rozszerzenie.

publisher
  • string

Nazwa wydawcy programu obsługi rozszerzeń.

settings
  • object

Ustawienia publiczne w formacie JSON dla rozszerzenia.

type
  • string

Typ rozszerzenia.

typeHandlerVersion
  • string

Wersja programu obsługi skryptów.

WindowsConfiguration

Windows ustawienia systemu operacyjnego, które mają być stosowane do maszyny wirtualnej.

Name Type Description
enableAutomaticUpdates
  • boolean

Określa, czy aktualizacje automatyczne są włączone na maszynie wirtualnej.
W przypadku pominięcia wartość domyślna to true.

WindowsUserConfiguration

Właściwości używane do tworzenia konta użytkownika w węźle obliczeniowym Windows.

Name Type Description
loginMode

Tryb logowania użytkownika
Wartość domyślna dla pul VirtualMachineConfiguration to "batch", a w przypadku pul CloudServiceConfiguration to "interactive".