Microsoft.Batch BatchAccounts/pools 2017-09-01

• najnowsze
• 2024-07-01
• 2024-02-01
• 2023-11-01
• 2023-05-01
• 2022-10-01
• 2022-06-01
• 2022-01-01
• 2021-06-01
• 2021-01-01
• 2020-09-01
• 2020-05-01
• 2020-03-01
• 2019-08-01
• 2019-04-01
• 2018-12-01
• 2017-09-01

Definicja zasobu Bicep

Typ zasobu batchAccounts/pools można wdrożyć przy użyciu operacji docelowych:

• grupy zasobów — zobacz polecenia wdrażania grupy zasobów

Aby uzyskać listę zmienionych właściwości w każdej wersji interfejsu API, zobacz dziennika zmian.

Format zasobu

Aby utworzyć zasób Microsoft.Batch/batchAccounts/pools, dodaj następujący kod Bicep do szablonu.

resource symbolicname 'Microsoft.Batch/batchAccounts/pools@2017-09-01' = {
  parent: resourceSymbolicName
  name: 'string'
  properties: {
    applicationLicenses: [
      'string'
    ]
    applicationPackages: [
      {
        id: 'string'
        version: 'string'
      }
    ]
    certificates: [
      {
        id: 'string'
        storeLocation: 'string'
        storeName: 'string'
        visibility: [
          'string'
        ]
      }
    ]
    deploymentConfiguration: {
      cloudServiceConfiguration: {
        currentOSVersion: 'string'
        osFamily: 'string'
        targetOSVersion: 'string'
      }
      virtualMachineConfiguration: {
        dataDisks: [
          {
            caching: 'string'
            diskSizeGB: int
            lun: int
            storageAccountType: 'string'
          }
        ]
        imageReference: {
          id: 'string'
          offer: 'string'
          publisher: 'string'
          sku: 'string'
          version: 'string'
        }
        licenseType: 'string'
        nodeAgentSkuId: 'string'
        osDisk: {
          caching: 'string'
        }
        windowsConfiguration: {
          enableAutomaticUpdates: bool
        }
      }
    }
    displayName: 'string'
    interNodeCommunication: 'string'
    maxTasksPerNode: int
    metadata: [
      {
        name: 'string'
        value: 'string'
      }
    ]
    networkConfiguration: {
      endpointConfiguration: {
        inboundNatPools: [
          {
            backendPort: int
            frontendPortRangeEnd: int
            frontendPortRangeStart: int
            name: 'string'
            networkSecurityGroupRules: [
              {
                access: 'string'
                priority: int
                sourceAddressPrefix: 'string'
              }
            ]
            protocol: 'string'
          }
        ]
      }
      subnetId: 'string'
    }
    scaleSettings: {
      autoScale: {
        evaluationInterval: 'string'
        formula: 'string'
      }
      fixedScale: {
        nodeDeallocationOption: 'string'
        resizeTimeout: 'string'
        targetDedicatedNodes: int
        targetLowPriorityNodes: int
      }
    }
    startTask: {
      commandLine: 'string'
      environmentSettings: [
        {
          name: 'string'
          value: 'string'
        }
      ]
      maxTaskRetryCount: int
      resourceFiles: [
        {
          blobSource: 'string'
          fileMode: 'string'
          filePath: 'string'
        }
      ]
      userIdentity: {
        autoUser: {
          elevationLevel: 'string'
          scope: 'string'
        }
        userName: 'string'
      }
      waitForSuccess: bool
    }
    taskSchedulingPolicy: {
      nodeFillType: 'string'
    }
    userAccounts: [
      {
        elevationLevel: 'string'
        linuxUserConfiguration: {
          gid: int
          sshPrivateKey: 'string'
          uid: int
        }
        name: 'string'
        password: 'string'
      }
    ]
    vmSize: 'string'
  }
}

Wartości właściwości

ApplicationPackageReference

Nazwa	Opis	Wartość
id	Identyfikator pakietu aplikacji do zainstalowania. Musi to być wewnątrz tego samego konta wsadowego co pula. Może to być odwołanie do określonej wersji lub wersji domyślnej, jeśli istnieje.	ciąg (wymagany)
Wersja	Jeśli zostanie pominięta, a dla tej aplikacji nie zostanie określona żadna domyślna wersja, żądanie zakończy się niepowodzeniem z kodem błędu InvalidApplicationPackageReferences. Jeśli bezpośrednio wywołujesz interfejs API REST, kod stanu HTTP to 409.	struna

AutoskalowanieUstawienia

Nazwa	Opis	Wartość
evaluationInterval	W przypadku pominięcia wartość domyślna to 15 minut (PT15M).	struna
formuła	Formuła dla żądanej liczby węzłów obliczeniowych w puli.	ciąg (wymagany)

AutoUserSpecification

Nazwa	Opis	Wartość
elevationLevel	nonAdmin — użytkownik automatyczny jest użytkownikiem standardowym bez podwyższonego poziomu dostępu. administrator — użytkownik automatyczny jest użytkownikiem z podwyższonym poziomem dostępu i działa z pełnymi uprawnieniami administratora. Wartość domyślna to nonAdmin.	"Administrator" "NonAdmin"
zakres	pool — określa, że zadanie jest uruchamiane jako wspólne konto użytkownika automatycznego, które jest tworzone w każdym węźle w puli. task — określa, że usługa powinna utworzyć nowego użytkownika dla zadania. Wartość domyślna to zadanie.	"Pula" "Zadanie"

CertificateReference

Nazwa	Opis	Wartość
id	W pełni kwalifikowany identyfikator certyfikatu do zainstalowania w puli. Musi to być wewnątrz tego samego konta wsadowego co pula.	ciąg (wymagany)
storeLocation	Wartość domyślna to currentUser. Ta właściwość ma zastosowanie tylko w przypadku pul skonfigurowanych z węzłami systemu Windows (czyli utworzonych za pomocą polecenia cloudServiceConfiguration lub virtualMachineConfiguration przy użyciu odwołania do obrazu systemu 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.	"CurrentUser" "LocalMachine"
storeName	Ta właściwość ma zastosowanie tylko w przypadku pul skonfigurowanych z węzłami systemu Windows (czyli utworzonych za pomocą polecenia cloudServiceConfiguration lub virtualMachineConfiguration przy użyciu odwołania do obrazu systemu 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 Moja.	struna
widoczność	Wartości to: starttask — konto użytkownika, w ramach którego jest uruchamiane zadanie uruchamiania. task — konta, w ramach których są uruchamiane zadania podrzędne. remoteuser — konta, w ramach których użytkownicy uzyskują zdalny dostęp do węzła. W tej kolekcji można określić więcej niż jedną widoczność. Wartość domyślna to wszystkie konta.	Tablica ciągów zawierająca dowolną z: "RemoteUser" "StartTask" "Zadanie"

CloudServiceConfiguration

Nazwa	Opis	Wartość
currentOSVersion	Może się to różnić od targetOSVersion, jeśli stan puli to Uaktualnianie. W takim przypadku niektóre maszyny wirtualne mogą znajdować się w targetOSVersion, a niektóre mogą znajdować się w bieżącej wersji systemu Windows podczas procesu uaktualniania. Po uaktualnieniu wszystkich maszyn wirtualnych currentOSVersion jest aktualizowana tak samo jak targetOSVersion.	struna
osFamily	Możliwe wartości to: 2 — Rodzina systemu operacyjnego 2, co odpowiada systemowi Windows Server 2008 R2 z dodatkiem SP1. 3 — Rodzina systemu operacyjnego 3, co odpowiada systemowi Windows Server 2012. 4 — Rodzina systemów operacyjnych 4, równoważna windows Server 2012 R2. 5 — Rodzina systemu operacyjnego 5, co odpowiada systemowi Windows Server 2016. Aby uzyskać więcej informacji, zobacz Wydania systemu operacyjnego gościa platformy Azure (https://azure.microsoft.com/documentation/articles/cloud-services-guestos-update-matrix/#releases).	ciąg (wymagany)
targetOSVersion	Wartość domyślna to * określająca najnowszą wersję systemu operacyjnego dla określonej rodziny systemów operacyjnych.	struna

DataDisk

Nazwa	Opis	Wartość
Buforowanie	Wartości to: none — tryb buforowania dysku nie jest włączony. readOnly — tryb buforowania dysku jest tylko do odczytu. readWrite — tryb buforowania dysku jest odczytywany i zapisywany. Wartość domyślna buforowania to brak. Aby uzyskać informacje o opcjach buforowania, zobacz: https://blogs.msdn.microsoft.com/windowsazurestorage/2012/06/27/exploring-windows-azure-drives-disks-and-images/.	"Brak" "ReadOnly" "ReadWrite"
diskSizeGB	Początkowy rozmiar dysku w GB podczas tworzenia nowego dysku danych.	int (wymagane)
Jednostki lun	Jednostka lun służy do unikatowego identyfikowania każdego dysku danych. W przypadku dołączania wielu dysków każda z nich powinna mieć odrębną jednostkę lun.	int (wymagane)
storageAccountType	W przypadku pominięcia wartość domyślna to "Standard_LRS". Wartości to: Standard_LRS — dysk danych powinien używać standardowego magazynu lokalnie nadmiarowego. Premium_LRS — dysk danych powinien używać magazynu lokalnie nadmiarowego w warstwie Premium.	"Premium_LRS" "Standard_LRS"

Konfiguracja wdrożenia

Nazwa	Opis	Wartość
cloudServiceConfiguration	Ta właściwość i element virtualMachineConfiguration wzajemnie się wykluczają i należy określić jedną z właściwości. 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".	CloudServiceConfiguration
virtualMachineConfiguration	Ta właściwość i właściwość cloudServiceConfiguration wzajemnie się wykluczają i należy określić jedną z właściwości.	VirtualMachineConfiguration

EnvironmentSetting

Nazwa	Opis	Wartość
nazwa	Nazwa zmiennej środowiskowej.	ciąg (wymagany)
wartość	Wartość zmiennej środowiskowej.	struna

FixedScaleSettings

Nazwa	Opis	Wartość
nodeDeallocationOption	W przypadku pominięcia wartość domyślna to Requeue.	"Requeue" "RetainedData" "TaskCompletion" "Zakończ"
resizeTimeout	Wartość domyślna to 15 minut. Wartości limitu czasu używają formatu ISO 8601. Na przykład użyj pt10M przez 10 minut. Minimalna wartość to 5 minut. Jeśli określisz wartość mniejszą niż 5 minut, usługa Batch odrzuci żądanie z błędem; Jeśli bezpośrednio wywołujesz interfejs API REST, kod stanu HTTP to 400 (Nieprawidłowe żądanie).	struna
targetDedicatedNodes	Co najmniej jeden z węzłów targetDedicatedNodes należy ustawić węzły targetLowPriority.	Int
targetLowPriorityNodes	Co najmniej jeden z węzłów targetDedicatedNodes należy ustawić węzły targetLowPriority.	Int

ImageReference

Nazwa	Opis	Wartość
id	Ta właściwość wzajemnie wyklucza się z innymi właściwościami. Obraz maszyny wirtualnej musi znajdować się w tym samym regionie i subskrypcji co konto usługi Azure Batch. Aby uzyskać informacje o ustawieniach zapory dla agenta węzła usługi Batch do komunikowania się z usługą Batch, zobacz /azure/batch-api-basics#virtual-network-vnet-and-firewall-configuration .	struna
oferta	Na przykład UbuntuServer lub WindowsServer.	struna
wydawca	Na przykład Canonical lub MicrosoftWindowsServer.	struna
Numer jednostki magazynowej	Na przykład 14.04.0-LTS lub 2012-R2-Datacenter.	struna
Wersja	Można określić wartość "latest", aby wybrać najnowszą wersję obrazu. W przypadku pominięcia wartość domyślna to "latest".	struna

InboundNatPool

Nazwa	Opis	Wartość
backendPort	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.	int (wymagane)
frontendPortRangeEnd	Dopuszczalny zakres wartości z zakresu od 1 do 65534 z wyjątkiem portów 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ć. Jeśli jakiekolwiek wartości zarezerwowane lub nakładające się zostaną dostarczone, żądanie zakończy się niepowodzeniem z kodem stanu HTTP 400.	int (wymagane)
frontendPortRangeStart	Dopuszczalny zakres wartości z zakresu od 1 do 65534 z wyjątkiem portów od 50000 do 55000, które są zarezerwowane. Wszystkie zakresy w puli muszą być odrębne i nie mogą się nakładać. Jeśli jakiekolwiek wartości zarezerwowane lub nakładające się zostaną dostarczone, żądanie zakończy się niepowodzeniem z kodem stanu HTTP 400.	int (wymagane)
nazwa	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 zakończy się niepowodzeniem z kodem stanu HTTP 400.	ciąg (wymagany)
networkSecurityGroupRules	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 żadnych 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.	NetworkSecurityGroupRule[]
protokół	Protokół punktu końcowego.	"TCP" "UDP" (wymagane)

LinuxUserConfiguration

Nazwa	Opis	Wartość
Gid	Właściwości uid i gid muszą być określone razem lub w ogóle. Jeśli nie określono bazowego systemu operacyjnego, wybiera gid.	Int
sshPrivateKey	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 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 przez umieszczenie pary 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 (nie jest wykonywana żadna modyfikacja katalogu .ssh użytkownika).	struna
Uid	Właściwości uid i gid muszą być określone razem lub w ogóle. Jeśli nie określono bazowego systemu operacyjnego, wybierze identyfikator uid.	Int

MetadataItem

Nazwa	Opis	Wartość
nazwa	Nazwa elementu metadanych.	ciąg (wymagany)
wartość	Wartość elementu metadanych.	ciąg (wymagany)

Microsoft.Batch/batchAccounts/pools

Nazwa	Opis	Wartość
nazwa	Nazwa zasobu	struna Ograniczenia: Minimalna długość = 1 Maksymalna długość = 1 Wzorzec = ^[a-zA-Z0-9_-]+$ (wymagane)
rodzic	W Bicep można określić zasób nadrzędny dla zasobu podrzędnego. Tę właściwość należy dodać tylko wtedy, gdy zasób podrzędny jest zadeklarowany poza zasobem nadrzędnym. Aby uzyskać więcej informacji, zobacz Zasób podrzędny poza zasobem nadrzędnym.	Nazwa symboliczna zasobu typu: batchAccounts
Właściwości	Właściwości skojarzone z pulą.	PoolProperties

Konfiguracja sieci

Nazwa	Opis	Wartość
endpointConfiguration	Konfiguracja punktu końcowego puli jest obsługiwana tylko w pulach z właściwością virtualMachineConfiguration.	PoolEndpointConfiguration
subnetId	Sieć wirtualna musi znajdować się w tym samym regionie i subskrypcji co konto usługi Azure Batch. Określona podsieć powinna mieć wystarczającą liczbę wolnych adresów IP, aby pomieścić liczbę węzłów w puli. Jeśli podsieć nie ma wystarczającej liczby wolnych adresów IP, pula częściowo przydzieli węzły obliczeniowe i wystąpi błąd zmiany rozmiaru. Jednostka usługi "MicrosoftAzureBatch" musi mieć rolę "Klasyczny współautor maszyny wirtualnej" Role-Based kontroli dostępu (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 obliczeniowych. Można to sprawdzić, sprawdzając, czy określona sieć wirtualna ma skojarzone sieciowe grupy zabezpieczeń. Jeśli komunikacja z węzłami obliczeniowymi 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 pośrednictwem elementu virtualMachineConfiguration konto usługi Batch musi mieć wartość poolAllocationMode userSubscription w celu użycia sieci wirtualnej. Jeśli określona sieć wirtualna ma skojarzone sieciowe grupy zabezpieczeń, należy włączyć kilka zarezerwowanych portów systemowych dla 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 systemu 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: /azure/batch/batch-api-basics#virtual-network-vnet-and-firewall-configuration	struna

NetworkSecurityGroupRule

Nazwa	Opis	Wartość
dostęp	Akcja, która powinna zostać podjęta dla określonego adresu IP, zakresu podsieci lub tagu.	"Zezwalaj" "Odmów" (wymagane)
priorytet	Priorytety w puli muszą być unikatowe i oceniane według priorytetu. Im niższa liczba, tym wyższy priorytet. Na przykład można określić reguły z liczbami zamówień 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 3500. Jeśli jakiekolwiek wartości zarezerwowane lub zduplikowane zostaną dostarczone, żądanie zakończy się niepowodzeniem z kodem stanu HTTP 400.	int (wymagane)
sourceAddressPrefix	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 zakończy się niepowodzeniem z kodem stanu HTTP 400.	ciąg (wymagany)

OSDisk

Nazwa	Opis	Wartość
Buforowanie	Wartość domyślna to brak.	"Brak" "ReadOnly" "ReadWrite"

PoolEndpointConfiguration

Nazwa	Opis	Wartość
inboundNatPools	Maksymalna liczba pul nat dla ruchu przychodzącego na pulę usługi Batch wynosi 5. Jeśli maksymalna liczba pul nat dla ruchu przychodzącego zostanie przekroczona, żądanie zakończy się niepowodzeniem z kodem stanu HTTP 400.	inboundNatPool[] (wymagane)

Właściwości puli

Nazwa	Opis	Wartość
applicationLicenses	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.	string[]
applicationPackages	Zmiany w pakietach aplikacji mają wpływ na wszystkie nowe węzły obliczeniowe łą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 zrewidowane.	ApplicationPackageReference[]
Certyfikaty	W przypadku węzłów obliczeniowych systemu Windows usługa Batch instaluje certyfikaty w określonym magazynie certyfikatów i lokalizacji. 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.	CertificateReference[]
deploymentConfiguration	Użycie funkcji CloudServiceConfiguration określa, że węzły powinny tworzyć przy użyciu usług Azure Cloud Services (PaaS), podczas gdy funkcja VirtualMachineConfiguration używa usługi Azure Virtual Machines (IaaS).	DeploymentConfiguration
displayName	Nazwa wyświetlana nie musi być unikatowa i może zawierać znaki Unicode o maksymalnej długości 1024.	struna
interNodeCommunication	Nakłada to ograniczenia dotyczące węzłów, które można przypisać do puli. Włączenie tej wartości może zmniejszyć prawdopodobieństwo przydzielenia żądanej liczby węzłów w puli. Jeśli nie zostanie określona, ta wartość jest domyślnie ustawiona na wartość "Wyłączone".	"Wyłączone" "Włączone"
maxTasksPerNode	Maksymalna liczba zadań, które mogą być uruchamiane współbieżnie w jednym węźle obliczeniowym w puli.	Int
metadane	Usługa Batch nie przypisuje żadnego znaczenia metadanym; służy wyłącznie do używania kodu użytkownika.	MetadataItem[]
networkConfiguration	Konfiguracja sieci dla puli.	NetworkConfiguration
scaleSettings	Definiuje żądany rozmiar puli. Może to być wartość "fixedScale", w której określono żądany element targetDedicatedNodes lub "autoScale", który definiuje formułę, która jest okresowo ponownie obliczana. Jeśli ta właściwość nie zostanie określona, pula będzie mieć stałą skalę z 0 targetDedicatedNodes.	ScaleSettings
startTask	W operacji PATCH (update) tę właściwość można ustawić na pusty obiekt, aby usunąć zadanie uruchamiania z puli.	StartTask
taskSchedulingPolicy	Określa sposób dystrybucji zadań między węzłami obliczeniowymi.	TaskSchedulingPolicy
userAccounts	Lista kont użytkowników do utworzenia w każdym węźle w puli.	userAccount[]
vmSize	Aby uzyskać informacje o dostępnych rozmiarach maszyn wirtualnych dla pul usług Cloud Services (pul utworzonych za pomocą funkcji cloudServiceConfiguration), zobacz Rozmiary dla usług Cloud Services (https://azure.microsoft.com/documentation/articles/cloud-services-sizes-specs/). Usługa Batch obsługuje wszystkie rozmiary maszyn wirtualnych usług Cloud Services z wyjątkiem ExtraSmall. Aby uzyskać informacje o dostępnych rozmiarach maszyn wirtualnych dla pul przy użyciu obrazów z witryny Virtual Machines Marketplace (pule utworzone za pomocą funkcji virtualMachineConfiguration), zobacz Rozmiary maszyn wirtualnych (Linux) (https://azure.microsoft.com/documentation/articles/virtual-machines-linux-sizes/) lub Rozmiary maszyn wirtualnych (Windows) (https://azure.microsoft.com/documentation/articles/virtual-machines-windows-sizes/). Usługa Batch obsługuje wszystkie rozmiary maszyn wirtualnych platformy Azure z wyjątkiem STANDARD_A0 i z magazynem w warstwie Premium (STANDARD_GS, STANDARD_DS i serii STANDARD_DSV2).	struna

Plik zasobu

Nazwa	Opis	Wartość
BlobSource	Ten adres URL musi być czytelny przy użyciu dostępu anonimowego; oznacza to, że usługa Batch nie przedstawia żadnych poświadczeń podczas pobierania obiektu blob. Istnieją dwa sposoby uzyskiwania takiego adresu URL dla obiektu blob w usłudze Azure Storage: obejmują sygnaturę dostępu współdzielonego udzielając uprawnień do odczytu dla obiektu blob lub ustaw listę ACL dla obiektu blob lub kontenera, aby zezwolić na dostęp publiczny.	ciąg (wymagany)
fileMode	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 elementu resourceFile, który zostanie pobrany do węzła systemu Windows. Jeśli ta właściwość nie zostanie określona dla węzła systemu Linux, do pliku zostanie zastosowana wartość domyślna 0770.	struna
filePath	Lokalizacja w węźle obliczeniowym, do którego ma być pobierany plik, względem katalogu roboczego zadania.	ciąg (wymagany)

ScaleSettings

Nazwa	Opis	Wartość
autoSkaluj	Ta właściwość i stałaSkala wzajemnie się wykluczają i należy określić jedną z właściwości.	autoskalowania
fixedScale	Ta właściwość i autoSkalowanie wzajemnie się wykluczają i należy określić jedną z właściwości.	FixedScaleSettings

StartTask

Nazwa	Opis	Wartość
commandLine	Wiersz polecenia nie jest uruchamiany w powłoce i dlatego nie może korzystać z funkcji powłoki, takich jak rozszerzenie zmiennej środowiskowej. Jeśli chcesz skorzystać z takich funkcji, należy wywołać powłokę w wierszu polecenia, na przykład za pomocą polecenia "cmd /c MyCommand" w systemie Windows lub "/bin/sh -c MyCommand" w systemie Linux. Wymagane, jeśli określono jakiekolwiek inne właściwości właściwości startTask.	struna
environmentSettings	Lista ustawień zmiennych środowiskowych dla zadania uruchamiania.	EnvironmentSetting[]
maxTaskRetryCount	Usługa Batch ponawia próbę zadania, jeśli jego kod zakończenia jest inny niżzer. Należy pamiętać, że ta wartość steruje liczbą ponownych prób. Usługa Batch spróbuje wykonać zadanie raz, 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.	Int
resourceFiles	Lista plików, które usługa Batch pobierze do węzła obliczeniowego przed uruchomieniem wiersza polecenia.	ResourceFile[]
userIdentity	W przypadku pominięcia zadanie jest uruchamiane jako użytkownik niebędący administratorem unikatowym dla zadania.	UserIdentity
waitForSuccess	Jeśli wartość true i zadanie uruchamiania zakończy się niepowodzeniem w węźle obliczeniowym, usługa Batch ponawia próbę zadania podrzędnego uruchamiania do maksymalnej liczby ponownych prób (maxTaskRetryCount). Jeśli zadanie nadal nie zostało ukończone pomyślnie po ponownych próbach, usługa Batch oznaczy węzeł obliczeniowy jako bezużyteczny i nie będzie planować zadań podrzędnych. Ten warunek można wykryć za pomocą stanu węzła i szczegółów błędu planowania. Jeśli wartość false, usługa Batch nie będzie czekać na ukończenie zadania uruchamiania. W takim przypadku inne zadania mogą rozpocząć wykonywanie w węźle obliczeniowym, gdy zadanie uruchamiania jest nadal uruchomione; a nawet jeśli zadanie uruchamiania zakończy się niepowodzeniem, nowe zadania będą nadal zaplanowane w węźle. Wartość domyślna to false.	Bool

TaskSchedulingPolicy

Nazwa	Opis	Wartość
nodeFillType	Sposób dystrybucji zadań między węzłami obliczeniowymi.	"Pack" "Spread" (wymagane)

UserAccount

Nazwa	Opis	Wartość
elevationLevel	nonAdmin — użytkownik automatyczny jest użytkownikiem standardowym bez podwyższonego poziomu dostępu. administrator — użytkownik automatyczny jest użytkownikiem z podwyższonym poziomem dostępu i działa z pełnymi uprawnieniami administratora. Wartość domyślna to nonAdmin.	"Administrator" "NonAdmin"
linuxUserConfiguration	Ta właściwość jest ignorowana, jeśli jest określona w puli systemu Windows. Jeśli nie zostanie określony, użytkownik zostanie utworzony przy użyciu opcji domyślnych.	LinuxUserConfiguration
nazwa	Nazwa konta użytkownika.	ciąg (wymagany)
hasło	Hasło do konta użytkownika.	ciąg (wymagany)

Identyfikator użytkownika

Nazwa	Opis	Wartość
autoużytkownik	Właściwości userName i autoUser wzajemnie się wykluczają; należy określić jeden, ale nie oba te elementy.	AutoUserSpecification
userName	Właściwości userName i autoUser wzajemnie się wykluczają; należy określić jeden, ale nie oba te elementy.	struna

VirtualMachineConfiguration

Nazwa	Opis	Wartość
dataDisks	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.	DataDisk[]
imageReference	Odwołanie do obrazu witryny Marketplace usługi Azure Virtual Machines lub zasobu obrazu platformy Azure niestandardowej maszyny wirtualnej. Aby uzyskać listę wszystkich elementów imageReferences zweryfikowanych przez usługę Azure Batch, zobacz operację "Lista obsługiwanych jednostek SKU agenta węzła".	ImageReference (wymagane)
licenseType	Dotyczy to tylko obrazów zawierających system operacyjny Windows i powinny być używane tylko w przypadku przechowywania prawidłowych licencji lokalnych dla węzłów, które zostaną wdrożone. W przypadku pominięcia nie zastosowano rabatu na licencjonowanie lokalne. Wartości to: Windows_Server — licencja lokalna dotyczy systemu Windows Server. Windows_Client — licencja lokalna jest dla klienta systemu Windows.	struna
nodeAgentSkuId	Agent węzła usługi Batch to program uruchamiany w każdym węźle w puli i udostępnia interfejs polecenia i sterowania między węzłem a usługą Batch. Istnieją różne implementacje agenta węzła, znane jako jednostki SKU, dla różnych systemów operacyjnych. Należy określić jednostkę SKU agenta węzła zgodną z wybranym odwołaniem do obrazu. Aby uzyskać listę obsługiwanych jednostek SKU agenta węzła wraz z listą zweryfikowanych odwołań do obrazów, zobacz operację "Lista obsługiwanych jednostek SKU agenta węzła".	ciąg (wymagany)
osDisk	Ustawienia dysku systemu operacyjnego maszyny wirtualnej.	OSDisk
windowsConfiguration	Nie można określić tej właściwości, jeśli imageReference określa obraz systemu operacyjnego Linux.	WindowsConfiguration

Konfiguracja systemu Windows

Nazwa	Opis	Wartość
enableAutomaticUpdates	W przypadku pominięcia wartość domyślna to true.	Bool

Przykłady z przewodnika Szybki start

W poniższych przykładach szybkiego startu wdrożono ten typ zasobu.

Plik Bicep	Opis
puli usługi Azure Batch bez publicznych adresów IP	Ten szablon tworzy uproszczoną pulę komunikacji węzłów usługi Azure Batch bez publicznych adresów IP.

Definicja zasobu szablonu usługi ARM

Typ zasobu batchAccounts/pools można wdrożyć przy użyciu operacji docelowych:

• grupy zasobów — zobacz polecenia wdrażania grupy zasobów

Aby uzyskać listę zmienionych właściwości w każdej wersji interfejsu API, zobacz dziennika zmian.

Format zasobu

Aby utworzyć zasób Microsoft.Batch/batchAccounts/pools, dodaj następujący kod JSON do szablonu.

{
  "type": "Microsoft.Batch/batchAccounts/pools",
  "apiVersion": "2017-09-01",
  "name": "string",
  "properties": {
    "applicationLicenses": [ "string" ],
    "applicationPackages": [
      {
        "id": "string",
        "version": "string"
      }
    ],
    "certificates": [
      {
        "id": "string",
        "storeLocation": "string",
        "storeName": "string",
        "visibility": [ "string" ]
      }
    ],
    "deploymentConfiguration": {
      "cloudServiceConfiguration": {
        "currentOSVersion": "string",
        "osFamily": "string",
        "targetOSVersion": "string"
      },
      "virtualMachineConfiguration": {
        "dataDisks": [
          {
            "caching": "string",
            "diskSizeGB": "int",
            "lun": "int",
            "storageAccountType": "string"
          }
        ],
        "imageReference": {
          "id": "string",
          "offer": "string",
          "publisher": "string",
          "sku": "string",
          "version": "string"
        },
        "licenseType": "string",
        "nodeAgentSkuId": "string",
        "osDisk": {
          "caching": "string"
        },
        "windowsConfiguration": {
          "enableAutomaticUpdates": "bool"
        }
      }
    },
    "displayName": "string",
    "interNodeCommunication": "string",
    "maxTasksPerNode": "int",
    "metadata": [
      {
        "name": "string",
        "value": "string"
      }
    ],
    "networkConfiguration": {
      "endpointConfiguration": {
        "inboundNatPools": [
          {
            "backendPort": "int",
            "frontendPortRangeEnd": "int",
            "frontendPortRangeStart": "int",
            "name": "string",
            "networkSecurityGroupRules": [
              {
                "access": "string",
                "priority": "int",
                "sourceAddressPrefix": "string"
              }
            ],
            "protocol": "string"
          }
        ]
      },
      "subnetId": "string"
    },
    "scaleSettings": {
      "autoScale": {
        "evaluationInterval": "string",
        "formula": "string"
      },
      "fixedScale": {
        "nodeDeallocationOption": "string",
        "resizeTimeout": "string",
        "targetDedicatedNodes": "int",
        "targetLowPriorityNodes": "int"
      }
    },
    "startTask": {
      "commandLine": "string",
      "environmentSettings": [
        {
          "name": "string",
          "value": "string"
        }
      ],
      "maxTaskRetryCount": "int",
      "resourceFiles": [
        {
          "blobSource": "string",
          "fileMode": "string",
          "filePath": "string"
        }
      ],
      "userIdentity": {
        "autoUser": {
          "elevationLevel": "string",
          "scope": "string"
        },
        "userName": "string"
      },
      "waitForSuccess": "bool"
    },
    "taskSchedulingPolicy": {
      "nodeFillType": "string"
    },
    "userAccounts": [
      {
        "elevationLevel": "string",
        "linuxUserConfiguration": {
          "gid": "int",
          "sshPrivateKey": "string",
          "uid": "int"
        },
        "name": "string",
        "password": "string"
      }
    ],
    "vmSize": "string"
  }
}

Wartości właściwości

ApplicationPackageReference

Nazwa	Opis	Wartość
id	Identyfikator pakietu aplikacji do zainstalowania. Musi to być wewnątrz tego samego konta wsadowego co pula. Może to być odwołanie do określonej wersji lub wersji domyślnej, jeśli istnieje.	ciąg (wymagany)
Wersja	Jeśli zostanie pominięta, a dla tej aplikacji nie zostanie określona żadna domyślna wersja, żądanie zakończy się niepowodzeniem z kodem błędu InvalidApplicationPackageReferences. Jeśli bezpośrednio wywołujesz interfejs API REST, kod stanu HTTP to 409.	struna

AutoskalowanieUstawienia

Nazwa	Opis	Wartość
evaluationInterval	W przypadku pominięcia wartość domyślna to 15 minut (PT15M).	struna
formuła	Formuła dla żądanej liczby węzłów obliczeniowych w puli.	ciąg (wymagany)

AutoUserSpecification

Nazwa	Opis	Wartość
elevationLevel	nonAdmin — użytkownik automatyczny jest użytkownikiem standardowym bez podwyższonego poziomu dostępu. administrator — użytkownik automatyczny jest użytkownikiem z podwyższonym poziomem dostępu i działa z pełnymi uprawnieniami administratora. Wartość domyślna to nonAdmin.	"Administrator" "NonAdmin"
zakres	pool — określa, że zadanie jest uruchamiane jako wspólne konto użytkownika automatycznego, które jest tworzone w każdym węźle w puli. task — określa, że usługa powinna utworzyć nowego użytkownika dla zadania. Wartość domyślna to zadanie.	"Pula" "Zadanie"

CertificateReference

Nazwa	Opis	Wartość
id	W pełni kwalifikowany identyfikator certyfikatu do zainstalowania w puli. Musi to być wewnątrz tego samego konta wsadowego co pula.	ciąg (wymagany)
storeLocation	Wartość domyślna to currentUser. Ta właściwość ma zastosowanie tylko w przypadku pul skonfigurowanych z węzłami systemu Windows (czyli utworzonych za pomocą polecenia cloudServiceConfiguration lub virtualMachineConfiguration przy użyciu odwołania do obrazu systemu 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.	"CurrentUser" "LocalMachine"
storeName	Ta właściwość ma zastosowanie tylko w przypadku pul skonfigurowanych z węzłami systemu Windows (czyli utworzonych za pomocą polecenia cloudServiceConfiguration lub virtualMachineConfiguration przy użyciu odwołania do obrazu systemu 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 Moja.	struna
widoczność	Wartości to: starttask — konto użytkownika, w ramach którego jest uruchamiane zadanie uruchamiania. task — konta, w ramach których są uruchamiane zadania podrzędne. remoteuser — konta, w ramach których użytkownicy uzyskują zdalny dostęp do węzła. W tej kolekcji można określić więcej niż jedną widoczność. Wartość domyślna to wszystkie konta.	Tablica ciągów zawierająca dowolną z: "RemoteUser" "StartTask" "Zadanie"

CloudServiceConfiguration

Nazwa	Opis	Wartość
currentOSVersion	Może się to różnić od targetOSVersion, jeśli stan puli to Uaktualnianie. W takim przypadku niektóre maszyny wirtualne mogą znajdować się w targetOSVersion, a niektóre mogą znajdować się w bieżącej wersji systemu Windows podczas procesu uaktualniania. Po uaktualnieniu wszystkich maszyn wirtualnych currentOSVersion jest aktualizowana tak samo jak targetOSVersion.	struna
osFamily	Możliwe wartości to: 2 — Rodzina systemu operacyjnego 2, co odpowiada systemowi Windows Server 2008 R2 z dodatkiem SP1. 3 — Rodzina systemu operacyjnego 3, co odpowiada systemowi Windows Server 2012. 4 — Rodzina systemów operacyjnych 4, równoważna windows Server 2012 R2. 5 — Rodzina systemu operacyjnego 5, co odpowiada systemowi Windows Server 2016. Aby uzyskać więcej informacji, zobacz Wydania systemu operacyjnego gościa platformy Azure (https://azure.microsoft.com/documentation/articles/cloud-services-guestos-update-matrix/#releases).	ciąg (wymagany)
targetOSVersion	Wartość domyślna to * określająca najnowszą wersję systemu operacyjnego dla określonej rodziny systemów operacyjnych.	struna

DataDisk

Nazwa	Opis	Wartość
Buforowanie	Wartości to: none — tryb buforowania dysku nie jest włączony. readOnly — tryb buforowania dysku jest tylko do odczytu. readWrite — tryb buforowania dysku jest odczytywany i zapisywany. Wartość domyślna buforowania to brak. Aby uzyskać informacje o opcjach buforowania, zobacz: https://blogs.msdn.microsoft.com/windowsazurestorage/2012/06/27/exploring-windows-azure-drives-disks-and-images/.	"Brak" "ReadOnly" "ReadWrite"
diskSizeGB	Początkowy rozmiar dysku w GB podczas tworzenia nowego dysku danych.	int (wymagane)
Jednostki lun	Jednostka lun służy do unikatowego identyfikowania każdego dysku danych. W przypadku dołączania wielu dysków każda z nich powinna mieć odrębną jednostkę lun.	int (wymagane)
storageAccountType	W przypadku pominięcia wartość domyślna to "Standard_LRS". Wartości to: Standard_LRS — dysk danych powinien używać standardowego magazynu lokalnie nadmiarowego. Premium_LRS — dysk danych powinien używać magazynu lokalnie nadmiarowego w warstwie Premium.	"Premium_LRS" "Standard_LRS"

Konfiguracja wdrożenia

Nazwa	Opis	Wartość
cloudServiceConfiguration	Ta właściwość i element virtualMachineConfiguration wzajemnie się wykluczają i należy określić jedną z właściwości. 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".	CloudServiceConfiguration
virtualMachineConfiguration	Ta właściwość i właściwość cloudServiceConfiguration wzajemnie się wykluczają i należy określić jedną z właściwości.	VirtualMachineConfiguration

EnvironmentSetting

Nazwa	Opis	Wartość
nazwa	Nazwa zmiennej środowiskowej.	ciąg (wymagany)
wartość	Wartość zmiennej środowiskowej.	struna

FixedScaleSettings

Nazwa	Opis	Wartość
nodeDeallocationOption	W przypadku pominięcia wartość domyślna to Requeue.	"Requeue" "RetainedData" "TaskCompletion" "Zakończ"
resizeTimeout	Wartość domyślna to 15 minut. Wartości limitu czasu używają formatu ISO 8601. Na przykład użyj pt10M przez 10 minut. Minimalna wartość to 5 minut. Jeśli określisz wartość mniejszą niż 5 minut, usługa Batch odrzuci żądanie z błędem; Jeśli bezpośrednio wywołujesz interfejs API REST, kod stanu HTTP to 400 (Nieprawidłowe żądanie).	struna
targetDedicatedNodes	Co najmniej jeden z węzłów targetDedicatedNodes należy ustawić węzły targetLowPriority.	Int
targetLowPriorityNodes	Co najmniej jeden z węzłów targetDedicatedNodes należy ustawić węzły targetLowPriority.	Int

ImageReference

Nazwa	Opis	Wartość
id	Ta właściwość wzajemnie wyklucza się z innymi właściwościami. Obraz maszyny wirtualnej musi znajdować się w tym samym regionie i subskrypcji co konto usługi Azure Batch. Aby uzyskać informacje o ustawieniach zapory dla agenta węzła usługi Batch do komunikowania się z usługą Batch, zobacz /azure/batch-api-basics#virtual-network-vnet-and-firewall-configuration .	struna
oferta	Na przykład UbuntuServer lub WindowsServer.	struna
wydawca	Na przykład Canonical lub MicrosoftWindowsServer.	struna
Numer jednostki magazynowej	Na przykład 14.04.0-LTS lub 2012-R2-Datacenter.	struna
Wersja	Można określić wartość "latest", aby wybrać najnowszą wersję obrazu. W przypadku pominięcia wartość domyślna to "latest".	struna

InboundNatPool

Nazwa	Opis	Wartość
backendPort	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.	int (wymagane)
frontendPortRangeEnd	Dopuszczalny zakres wartości z zakresu od 1 do 65534 z wyjątkiem portów 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ć. Jeśli jakiekolwiek wartości zarezerwowane lub nakładające się zostaną dostarczone, żądanie zakończy się niepowodzeniem z kodem stanu HTTP 400.	int (wymagane)
frontendPortRangeStart	Dopuszczalny zakres wartości z zakresu od 1 do 65534 z wyjątkiem portów od 50000 do 55000, które są zarezerwowane. Wszystkie zakresy w puli muszą być odrębne i nie mogą się nakładać. Jeśli jakiekolwiek wartości zarezerwowane lub nakładające się zostaną dostarczone, żądanie zakończy się niepowodzeniem z kodem stanu HTTP 400.	int (wymagane)
nazwa	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 zakończy się niepowodzeniem z kodem stanu HTTP 400.	ciąg (wymagany)
networkSecurityGroupRules	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 żadnych 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.	NetworkSecurityGroupRule[]
protokół	Protokół punktu końcowego.	"TCP" "UDP" (wymagane)

LinuxUserConfiguration

Nazwa	Opis	Wartość
Gid	Właściwości uid i gid muszą być określone razem lub w ogóle. Jeśli nie określono bazowego systemu operacyjnego, wybiera gid.	Int
sshPrivateKey	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 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 przez umieszczenie pary 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 (nie jest wykonywana żadna modyfikacja katalogu .ssh użytkownika).	struna
Uid	Właściwości uid i gid muszą być określone razem lub w ogóle. Jeśli nie określono bazowego systemu operacyjnego, wybierze identyfikator uid.	Int

MetadataItem

Nazwa	Opis	Wartość
nazwa	Nazwa elementu metadanych.	ciąg (wymagany)
wartość	Wartość elementu metadanych.	ciąg (wymagany)

Microsoft.Batch/batchAccounts/pools

Nazwa	Opis	Wartość
apiVersion	Wersja interfejsu API	'2017-09-01'
nazwa	Nazwa zasobu	struna Ograniczenia: Minimalna długość = 1 Maksymalna długość = 1 Wzorzec = ^[a-zA-Z0-9_-]+$ (wymagane)
Właściwości	Właściwości skojarzone z pulą.	PoolProperties
typ	Typ zasobu	"Microsoft.Batch/batchAccounts/pools"

Konfiguracja sieci

Nazwa	Opis	Wartość
endpointConfiguration	Konfiguracja punktu końcowego puli jest obsługiwana tylko w pulach z właściwością virtualMachineConfiguration.	PoolEndpointConfiguration
subnetId	Sieć wirtualna musi znajdować się w tym samym regionie i subskrypcji co konto usługi Azure Batch. Określona podsieć powinna mieć wystarczającą liczbę wolnych adresów IP, aby pomieścić liczbę węzłów w puli. Jeśli podsieć nie ma wystarczającej liczby wolnych adresów IP, pula częściowo przydzieli węzły obliczeniowe i wystąpi błąd zmiany rozmiaru. Jednostka usługi "MicrosoftAzureBatch" musi mieć rolę "Klasyczny współautor maszyny wirtualnej" Role-Based kontroli dostępu (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 obliczeniowych. Można to sprawdzić, sprawdzając, czy określona sieć wirtualna ma skojarzone sieciowe grupy zabezpieczeń. Jeśli komunikacja z węzłami obliczeniowymi 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 pośrednictwem elementu virtualMachineConfiguration konto usługi Batch musi mieć wartość poolAllocationMode userSubscription w celu użycia sieci wirtualnej. Jeśli określona sieć wirtualna ma skojarzone sieciowe grupy zabezpieczeń, należy włączyć kilka zarezerwowanych portów systemowych dla 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 systemu 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: /azure/batch/batch-api-basics#virtual-network-vnet-and-firewall-configuration	struna

NetworkSecurityGroupRule

Nazwa	Opis	Wartość
dostęp	Akcja, która powinna zostać podjęta dla określonego adresu IP, zakresu podsieci lub tagu.	"Zezwalaj" "Odmów" (wymagane)
priorytet	Priorytety w puli muszą być unikatowe i oceniane według priorytetu. Im niższa liczba, tym wyższy priorytet. Na przykład można określić reguły z liczbami zamówień 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 3500. Jeśli jakiekolwiek wartości zarezerwowane lub zduplikowane zostaną dostarczone, żądanie zakończy się niepowodzeniem z kodem stanu HTTP 400.	int (wymagane)
sourceAddressPrefix	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 zakończy się niepowodzeniem z kodem stanu HTTP 400.	ciąg (wymagany)

OSDisk

Nazwa	Opis	Wartość
Buforowanie	Wartość domyślna to brak.	"Brak" "ReadOnly" "ReadWrite"

PoolEndpointConfiguration

Nazwa	Opis	Wartość
inboundNatPools	Maksymalna liczba pul nat dla ruchu przychodzącego na pulę usługi Batch wynosi 5. Jeśli maksymalna liczba pul nat dla ruchu przychodzącego zostanie przekroczona, żądanie zakończy się niepowodzeniem z kodem stanu HTTP 400.	inboundNatPool[] (wymagane)

Właściwości puli

Nazwa	Opis	Wartość
applicationLicenses	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.	string[]
applicationPackages	Zmiany w pakietach aplikacji mają wpływ na wszystkie nowe węzły obliczeniowe łą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 zrewidowane.	ApplicationPackageReference[]
Certyfikaty	W przypadku węzłów obliczeniowych systemu Windows usługa Batch instaluje certyfikaty w określonym magazynie certyfikatów i lokalizacji. 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.	CertificateReference[]
deploymentConfiguration	Użycie funkcji CloudServiceConfiguration określa, że węzły powinny tworzyć przy użyciu usług Azure Cloud Services (PaaS), podczas gdy funkcja VirtualMachineConfiguration używa usługi Azure Virtual Machines (IaaS).	DeploymentConfiguration
displayName	Nazwa wyświetlana nie musi być unikatowa i może zawierać znaki Unicode o maksymalnej długości 1024.	struna
interNodeCommunication	Nakłada to ograniczenia dotyczące węzłów, które można przypisać do puli. Włączenie tej wartości może zmniejszyć prawdopodobieństwo przydzielenia żądanej liczby węzłów w puli. Jeśli nie zostanie określona, ta wartość jest domyślnie ustawiona na wartość "Wyłączone".	"Wyłączone" "Włączone"
maxTasksPerNode	Maksymalna liczba zadań, które mogą być uruchamiane współbieżnie w jednym węźle obliczeniowym w puli.	Int
metadane	Usługa Batch nie przypisuje żadnego znaczenia metadanym; służy wyłącznie do używania kodu użytkownika.	MetadataItem[]
networkConfiguration	Konfiguracja sieci dla puli.	NetworkConfiguration
scaleSettings	Definiuje żądany rozmiar puli. Może to być wartość "fixedScale", w której określono żądany element targetDedicatedNodes lub "autoScale", który definiuje formułę, która jest okresowo ponownie obliczana. Jeśli ta właściwość nie zostanie określona, pula będzie mieć stałą skalę z 0 targetDedicatedNodes.	ScaleSettings
startTask	W operacji PATCH (update) tę właściwość można ustawić na pusty obiekt, aby usunąć zadanie uruchamiania z puli.	StartTask
taskSchedulingPolicy	Określa sposób dystrybucji zadań między węzłami obliczeniowymi.	TaskSchedulingPolicy
userAccounts	Lista kont użytkowników do utworzenia w każdym węźle w puli.	userAccount[]
vmSize	Aby uzyskać informacje o dostępnych rozmiarach maszyn wirtualnych dla pul usług Cloud Services (pul utworzonych za pomocą funkcji cloudServiceConfiguration), zobacz Rozmiary dla usług Cloud Services (https://azure.microsoft.com/documentation/articles/cloud-services-sizes-specs/). Usługa Batch obsługuje wszystkie rozmiary maszyn wirtualnych usług Cloud Services z wyjątkiem ExtraSmall. Aby uzyskać informacje o dostępnych rozmiarach maszyn wirtualnych dla pul przy użyciu obrazów z witryny Virtual Machines Marketplace (pule utworzone za pomocą funkcji virtualMachineConfiguration), zobacz Rozmiary maszyn wirtualnych (Linux) (https://azure.microsoft.com/documentation/articles/virtual-machines-linux-sizes/) lub Rozmiary maszyn wirtualnych (Windows) (https://azure.microsoft.com/documentation/articles/virtual-machines-windows-sizes/). Usługa Batch obsługuje wszystkie rozmiary maszyn wirtualnych platformy Azure z wyjątkiem STANDARD_A0 i z magazynem w warstwie Premium (STANDARD_GS, STANDARD_DS i serii STANDARD_DSV2).	struna

Plik zasobu

Nazwa	Opis	Wartość
BlobSource	Ten adres URL musi być czytelny przy użyciu dostępu anonimowego; oznacza to, że usługa Batch nie przedstawia żadnych poświadczeń podczas pobierania obiektu blob. Istnieją dwa sposoby uzyskiwania takiego adresu URL dla obiektu blob w usłudze Azure Storage: obejmują sygnaturę dostępu współdzielonego udzielając uprawnień do odczytu dla obiektu blob lub ustaw listę ACL dla obiektu blob lub kontenera, aby zezwolić na dostęp publiczny.	ciąg (wymagany)
fileMode	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 elementu resourceFile, który zostanie pobrany do węzła systemu Windows. Jeśli ta właściwość nie zostanie określona dla węzła systemu Linux, do pliku zostanie zastosowana wartość domyślna 0770.	struna
filePath	Lokalizacja w węźle obliczeniowym, do którego ma być pobierany plik, względem katalogu roboczego zadania.	ciąg (wymagany)

ScaleSettings

Nazwa	Opis	Wartość
autoSkaluj	Ta właściwość i stałaSkala wzajemnie się wykluczają i należy określić jedną z właściwości.	autoskalowania
fixedScale	Ta właściwość i autoSkalowanie wzajemnie się wykluczają i należy określić jedną z właściwości.	FixedScaleSettings

StartTask

Nazwa	Opis	Wartość
commandLine	Wiersz polecenia nie jest uruchamiany w powłoce i dlatego nie może korzystać z funkcji powłoki, takich jak rozszerzenie zmiennej środowiskowej. Jeśli chcesz skorzystać z takich funkcji, należy wywołać powłokę w wierszu polecenia, na przykład za pomocą polecenia "cmd /c MyCommand" w systemie Windows lub "/bin/sh -c MyCommand" w systemie Linux. Wymagane, jeśli określono jakiekolwiek inne właściwości właściwości startTask.	struna
environmentSettings	Lista ustawień zmiennych środowiskowych dla zadania uruchamiania.	EnvironmentSetting[]
maxTaskRetryCount	Usługa Batch ponawia próbę zadania, jeśli jego kod zakończenia jest inny niżzer. Należy pamiętać, że ta wartość steruje liczbą ponownych prób. Usługa Batch spróbuje wykonać zadanie raz, 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.	Int
resourceFiles	Lista plików, które usługa Batch pobierze do węzła obliczeniowego przed uruchomieniem wiersza polecenia.	ResourceFile[]
userIdentity	W przypadku pominięcia zadanie jest uruchamiane jako użytkownik niebędący administratorem unikatowym dla zadania.	UserIdentity
waitForSuccess	Jeśli wartość true i zadanie uruchamiania zakończy się niepowodzeniem w węźle obliczeniowym, usługa Batch ponawia próbę zadania podrzędnego uruchamiania do maksymalnej liczby ponownych prób (maxTaskRetryCount). Jeśli zadanie nadal nie zostało ukończone pomyślnie po ponownych próbach, usługa Batch oznaczy węzeł obliczeniowy jako bezużyteczny i nie będzie planować zadań podrzędnych. Ten warunek można wykryć za pomocą stanu węzła i szczegółów błędu planowania. Jeśli wartość false, usługa Batch nie będzie czekać na ukończenie zadania uruchamiania. W takim przypadku inne zadania mogą rozpocząć wykonywanie w węźle obliczeniowym, gdy zadanie uruchamiania jest nadal uruchomione; a nawet jeśli zadanie uruchamiania zakończy się niepowodzeniem, nowe zadania będą nadal zaplanowane w węźle. Wartość domyślna to false.	Bool

TaskSchedulingPolicy

Nazwa	Opis	Wartość
nodeFillType	Sposób dystrybucji zadań między węzłami obliczeniowymi.	"Pack" "Spread" (wymagane)

UserAccount

Nazwa	Opis	Wartość
elevationLevel	nonAdmin — użytkownik automatyczny jest użytkownikiem standardowym bez podwyższonego poziomu dostępu. administrator — użytkownik automatyczny jest użytkownikiem z podwyższonym poziomem dostępu i działa z pełnymi uprawnieniami administratora. Wartość domyślna to nonAdmin.	"Administrator" "NonAdmin"
linuxUserConfiguration	Ta właściwość jest ignorowana, jeśli jest określona w puli systemu Windows. Jeśli nie zostanie określony, użytkownik zostanie utworzony przy użyciu opcji domyślnych.	LinuxUserConfiguration
nazwa	Nazwa konta użytkownika.	ciąg (wymagany)
hasło	Hasło do konta użytkownika.	ciąg (wymagany)

Identyfikator użytkownika

Nazwa	Opis	Wartość
autoużytkownik	Właściwości userName i autoUser wzajemnie się wykluczają; należy określić jeden, ale nie oba te elementy.	AutoUserSpecification
userName	Właściwości userName i autoUser wzajemnie się wykluczają; należy określić jeden, ale nie oba te elementy.	struna

VirtualMachineConfiguration

Nazwa	Opis	Wartość
dataDisks	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.	DataDisk[]
imageReference	Odwołanie do obrazu witryny Marketplace usługi Azure Virtual Machines lub zasobu obrazu platformy Azure niestandardowej maszyny wirtualnej. Aby uzyskać listę wszystkich elementów imageReferences zweryfikowanych przez usługę Azure Batch, zobacz operację "Lista obsługiwanych jednostek SKU agenta węzła".	ImageReference (wymagane)
licenseType	Dotyczy to tylko obrazów zawierających system operacyjny Windows i powinny być używane tylko w przypadku przechowywania prawidłowych licencji lokalnych dla węzłów, które zostaną wdrożone. W przypadku pominięcia nie zastosowano rabatu na licencjonowanie lokalne. Wartości to: Windows_Server — licencja lokalna dotyczy systemu Windows Server. Windows_Client — licencja lokalna jest dla klienta systemu Windows.	struna
nodeAgentSkuId	Agent węzła usługi Batch to program uruchamiany w każdym węźle w puli i udostępnia interfejs polecenia i sterowania między węzłem a usługą Batch. Istnieją różne implementacje agenta węzła, znane jako jednostki SKU, dla różnych systemów operacyjnych. Należy określić jednostkę SKU agenta węzła zgodną z wybranym odwołaniem do obrazu. Aby uzyskać listę obsługiwanych jednostek SKU agenta węzła wraz z listą zweryfikowanych odwołań do obrazów, zobacz operację "Lista obsługiwanych jednostek SKU agenta węzła".	ciąg (wymagany)
osDisk	Ustawienia dysku systemu operacyjnego maszyny wirtualnej.	OSDisk
windowsConfiguration	Nie można określić tej właściwości, jeśli imageReference określa obraz systemu operacyjnego Linux.	WindowsConfiguration

Konfiguracja systemu Windows

Nazwa	Opis	Wartość
enableAutomaticUpdates	W przypadku pominięcia wartość domyślna to true.	Bool

Szablony szybkiego startu

Następujące szablony szybkiego startu wdrażają ten typ zasobu.

Szablon	Opis
puli usługi Azure Batch bez publicznych adresów IP wdrażanie	Ten szablon tworzy uproszczoną pulę komunikacji węzłów usługi Azure Batch bez publicznych adresów IP.

Definicja zasobu narzędzia Terraform (dostawcy AzAPI)

Typ zasobu batchAccounts/pools można wdrożyć przy użyciu operacji docelowych:

• grupy zasobów

Aby uzyskać listę zmienionych właściwości w każdej wersji interfejsu API, zobacz dziennika zmian.

Format zasobu

Aby utworzyć zasób Microsoft.Batch/batchAccounts/pools, dodaj następujący program Terraform do szablonu.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Batch/batchAccounts/pools@2017-09-01"
  name = "string"
  body = jsonencode({
    properties = {
      applicationLicenses = [
        "string"
      ]
      applicationPackages = [
        {
          id = "string"
          version = "string"
        }
      ]
      certificates = [
        {
          id = "string"
          storeLocation = "string"
          storeName = "string"
          visibility = [
            "string"
          ]
        }
      ]
      deploymentConfiguration = {
        cloudServiceConfiguration = {
          currentOSVersion = "string"
          osFamily = "string"
          targetOSVersion = "string"
        }
        virtualMachineConfiguration = {
          dataDisks = [
            {
              caching = "string"
              diskSizeGB = int
              lun = int
              storageAccountType = "string"
            }
          ]
          imageReference = {
            id = "string"
            offer = "string"
            publisher = "string"
            sku = "string"
            version = "string"
          }
          licenseType = "string"
          nodeAgentSkuId = "string"
          osDisk = {
            caching = "string"
          }
          windowsConfiguration = {
            enableAutomaticUpdates = bool
          }
        }
      }
      displayName = "string"
      interNodeCommunication = "string"
      maxTasksPerNode = int
      metadata = [
        {
          name = "string"
          value = "string"
        }
      ]
      networkConfiguration = {
        endpointConfiguration = {
          inboundNatPools = [
            {
              backendPort = int
              frontendPortRangeEnd = int
              frontendPortRangeStart = int
              name = "string"
              networkSecurityGroupRules = [
                {
                  access = "string"
                  priority = int
                  sourceAddressPrefix = "string"
                }
              ]
              protocol = "string"
            }
          ]
        }
        subnetId = "string"
      }
      scaleSettings = {
        autoScale = {
          evaluationInterval = "string"
          formula = "string"
        }
        fixedScale = {
          nodeDeallocationOption = "string"
          resizeTimeout = "string"
          targetDedicatedNodes = int
          targetLowPriorityNodes = int
        }
      }
      startTask = {
        commandLine = "string"
        environmentSettings = [
          {
            name = "string"
            value = "string"
          }
        ]
        maxTaskRetryCount = int
        resourceFiles = [
          {
            blobSource = "string"
            fileMode = "string"
            filePath = "string"
          }
        ]
        userIdentity = {
          autoUser = {
            elevationLevel = "string"
            scope = "string"
          }
          userName = "string"
        }
        waitForSuccess = bool
      }
      taskSchedulingPolicy = {
        nodeFillType = "string"
      }
      userAccounts = [
        {
          elevationLevel = "string"
          linuxUserConfiguration = {
            gid = int
            sshPrivateKey = "string"
            uid = int
          }
          name = "string"
          password = "string"
        }
      ]
      vmSize = "string"
    }
  })
}

Wartości właściwości

ApplicationPackageReference

Nazwa	Opis	Wartość
id	Identyfikator pakietu aplikacji do zainstalowania. Musi to być wewnątrz tego samego konta wsadowego co pula. Może to być odwołanie do określonej wersji lub wersji domyślnej, jeśli istnieje.	ciąg (wymagany)
Wersja	Jeśli zostanie pominięta, a dla tej aplikacji nie zostanie określona żadna domyślna wersja, żądanie zakończy się niepowodzeniem z kodem błędu InvalidApplicationPackageReferences. Jeśli bezpośrednio wywołujesz interfejs API REST, kod stanu HTTP to 409.	struna

AutoskalowanieUstawienia

Nazwa	Opis	Wartość
evaluationInterval	W przypadku pominięcia wartość domyślna to 15 minut (PT15M).	struna
formuła	Formuła dla żądanej liczby węzłów obliczeniowych w puli.	ciąg (wymagany)

AutoUserSpecification

Nazwa	Opis	Wartość
elevationLevel	nonAdmin — użytkownik automatyczny jest użytkownikiem standardowym bez podwyższonego poziomu dostępu. administrator — użytkownik automatyczny jest użytkownikiem z podwyższonym poziomem dostępu i działa z pełnymi uprawnieniami administratora. Wartość domyślna to nonAdmin.	"Administrator" "NonAdmin"
zakres	pool — określa, że zadanie jest uruchamiane jako wspólne konto użytkownika automatycznego, które jest tworzone w każdym węźle w puli. task — określa, że usługa powinna utworzyć nowego użytkownika dla zadania. Wartość domyślna to zadanie.	"Pula" "Zadanie"

CertificateReference

Nazwa	Opis	Wartość
id	W pełni kwalifikowany identyfikator certyfikatu do zainstalowania w puli. Musi to być wewnątrz tego samego konta wsadowego co pula.	ciąg (wymagany)
storeLocation	Wartość domyślna to currentUser. Ta właściwość ma zastosowanie tylko w przypadku pul skonfigurowanych z węzłami systemu Windows (czyli utworzonych za pomocą polecenia cloudServiceConfiguration lub virtualMachineConfiguration przy użyciu odwołania do obrazu systemu 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.	"CurrentUser" "LocalMachine"
storeName	Ta właściwość ma zastosowanie tylko w przypadku pul skonfigurowanych z węzłami systemu Windows (czyli utworzonych za pomocą polecenia cloudServiceConfiguration lub virtualMachineConfiguration przy użyciu odwołania do obrazu systemu 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 Moja.	struna
widoczność	Wartości to: starttask — konto użytkownika, w ramach którego jest uruchamiane zadanie uruchamiania. task — konta, w ramach których są uruchamiane zadania podrzędne. remoteuser — konta, w ramach których użytkownicy uzyskują zdalny dostęp do węzła. W tej kolekcji można określić więcej niż jedną widoczność. Wartość domyślna to wszystkie konta.	Tablica ciągów zawierająca dowolną z: "RemoteUser" "StartTask" "Zadanie"

CloudServiceConfiguration

Nazwa	Opis	Wartość
currentOSVersion	Może się to różnić od targetOSVersion, jeśli stan puli to Uaktualnianie. W takim przypadku niektóre maszyny wirtualne mogą znajdować się w targetOSVersion, a niektóre mogą znajdować się w bieżącej wersji systemu Windows podczas procesu uaktualniania. Po uaktualnieniu wszystkich maszyn wirtualnych currentOSVersion jest aktualizowana tak samo jak targetOSVersion.	struna
osFamily	Możliwe wartości to: 2 — Rodzina systemu operacyjnego 2, co odpowiada systemowi Windows Server 2008 R2 z dodatkiem SP1. 3 — Rodzina systemu operacyjnego 3, co odpowiada systemowi Windows Server 2012. 4 — Rodzina systemów operacyjnych 4, równoważna windows Server 2012 R2. 5 — Rodzina systemu operacyjnego 5, co odpowiada systemowi Windows Server 2016. Aby uzyskać więcej informacji, zobacz Wydania systemu operacyjnego gościa platformy Azure (https://azure.microsoft.com/documentation/articles/cloud-services-guestos-update-matrix/#releases).	ciąg (wymagany)
targetOSVersion	Wartość domyślna to * określająca najnowszą wersję systemu operacyjnego dla określonej rodziny systemów operacyjnych.	struna

DataDisk

Nazwa	Opis	Wartość
Buforowanie	Wartości to: none — tryb buforowania dysku nie jest włączony. readOnly — tryb buforowania dysku jest tylko do odczytu. readWrite — tryb buforowania dysku jest odczytywany i zapisywany. Wartość domyślna buforowania to brak. Aby uzyskać informacje o opcjach buforowania, zobacz: https://blogs.msdn.microsoft.com/windowsazurestorage/2012/06/27/exploring-windows-azure-drives-disks-and-images/.	"Brak" "ReadOnly" "ReadWrite"
diskSizeGB	Początkowy rozmiar dysku w GB podczas tworzenia nowego dysku danych.	int (wymagane)
Jednostki lun	Jednostka lun służy do unikatowego identyfikowania każdego dysku danych. W przypadku dołączania wielu dysków każda z nich powinna mieć odrębną jednostkę lun.	int (wymagane)
storageAccountType	W przypadku pominięcia wartość domyślna to "Standard_LRS". Wartości to: Standard_LRS — dysk danych powinien używać standardowego magazynu lokalnie nadmiarowego. Premium_LRS — dysk danych powinien używać magazynu lokalnie nadmiarowego w warstwie Premium.	"Premium_LRS" "Standard_LRS"

Konfiguracja wdrożenia

Nazwa	Opis	Wartość
cloudServiceConfiguration	Ta właściwość i element virtualMachineConfiguration wzajemnie się wykluczają i należy określić jedną z właściwości. 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".	CloudServiceConfiguration
virtualMachineConfiguration	Ta właściwość i właściwość cloudServiceConfiguration wzajemnie się wykluczają i należy określić jedną z właściwości.	VirtualMachineConfiguration

EnvironmentSetting

Nazwa	Opis	Wartość
nazwa	Nazwa zmiennej środowiskowej.	ciąg (wymagany)
wartość	Wartość zmiennej środowiskowej.	struna

FixedScaleSettings

Nazwa	Opis	Wartość
nodeDeallocationOption	W przypadku pominięcia wartość domyślna to Requeue.	"Requeue" "RetainedData" "TaskCompletion" "Zakończ"
resizeTimeout	Wartość domyślna to 15 minut. Wartości limitu czasu używają formatu ISO 8601. Na przykład użyj pt10M przez 10 minut. Minimalna wartość to 5 minut. Jeśli określisz wartość mniejszą niż 5 minut, usługa Batch odrzuci żądanie z błędem; Jeśli bezpośrednio wywołujesz interfejs API REST, kod stanu HTTP to 400 (Nieprawidłowe żądanie).	struna
targetDedicatedNodes	Co najmniej jeden z węzłów targetDedicatedNodes należy ustawić węzły targetLowPriority.	Int
targetLowPriorityNodes	Co najmniej jeden z węzłów targetDedicatedNodes należy ustawić węzły targetLowPriority.	Int

ImageReference

Nazwa	Opis	Wartość
id	Ta właściwość wzajemnie wyklucza się z innymi właściwościami. Obraz maszyny wirtualnej musi znajdować się w tym samym regionie i subskrypcji co konto usługi Azure Batch. Aby uzyskać informacje o ustawieniach zapory dla agenta węzła usługi Batch do komunikowania się z usługą Batch, zobacz /azure/batch-api-basics#virtual-network-vnet-and-firewall-configuration .	struna
oferta	Na przykład UbuntuServer lub WindowsServer.	struna
wydawca	Na przykład Canonical lub MicrosoftWindowsServer.	struna
Numer jednostki magazynowej	Na przykład 14.04.0-LTS lub 2012-R2-Datacenter.	struna
Wersja	Można określić wartość "latest", aby wybrać najnowszą wersję obrazu. W przypadku pominięcia wartość domyślna to "latest".	struna

InboundNatPool

Nazwa	Opis	Wartość
backendPort	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.	int (wymagane)
frontendPortRangeEnd	Dopuszczalny zakres wartości z zakresu od 1 do 65534 z wyjątkiem portów 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ć. Jeśli jakiekolwiek wartości zarezerwowane lub nakładające się zostaną dostarczone, żądanie zakończy się niepowodzeniem z kodem stanu HTTP 400.	int (wymagane)
frontendPortRangeStart	Dopuszczalny zakres wartości z zakresu od 1 do 65534 z wyjątkiem portów od 50000 do 55000, które są zarezerwowane. Wszystkie zakresy w puli muszą być odrębne i nie mogą się nakładać. Jeśli jakiekolwiek wartości zarezerwowane lub nakładające się zostaną dostarczone, żądanie zakończy się niepowodzeniem z kodem stanu HTTP 400.	int (wymagane)
nazwa	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 zakończy się niepowodzeniem z kodem stanu HTTP 400.	ciąg (wymagany)
networkSecurityGroupRules	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 żadnych 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.	NetworkSecurityGroupRule[]
protokół	Protokół punktu końcowego.	"TCP" "UDP" (wymagane)

LinuxUserConfiguration

Nazwa	Opis	Wartość
Gid	Właściwości uid i gid muszą być określone razem lub w ogóle. Jeśli nie określono bazowego systemu operacyjnego, wybiera gid.	Int
sshPrivateKey	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 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 przez umieszczenie pary 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 (nie jest wykonywana żadna modyfikacja katalogu .ssh użytkownika).	struna
Uid	Właściwości uid i gid muszą być określone razem lub w ogóle. Jeśli nie określono bazowego systemu operacyjnego, wybierze identyfikator uid.	Int

MetadataItem

Nazwa	Opis	Wartość
nazwa	Nazwa elementu metadanych.	ciąg (wymagany)
wartość	Wartość elementu metadanych.	ciąg (wymagany)

Microsoft.Batch/batchAccounts/pools

Nazwa	Opis	Wartość
nazwa	Nazwa zasobu	struna Ograniczenia: Minimalna długość = 1 Maksymalna długość = 1 Wzorzec = ^[a-zA-Z0-9_-]+$ (wymagane)
parent_id	Identyfikator zasobu, który jest elementem nadrzędnym dla tego zasobu.	Identyfikator zasobu typu: batchAccounts
Właściwości	Właściwości skojarzone z pulą.	PoolProperties
typ	Typ zasobu	"Microsoft.Batch/batchAccounts/pools@2017-09-01"

Konfiguracja sieci

Nazwa	Opis	Wartość
endpointConfiguration	Konfiguracja punktu końcowego puli jest obsługiwana tylko w pulach z właściwością virtualMachineConfiguration.	PoolEndpointConfiguration
subnetId	Sieć wirtualna musi znajdować się w tym samym regionie i subskrypcji co konto usługi Azure Batch. Określona podsieć powinna mieć wystarczającą liczbę wolnych adresów IP, aby pomieścić liczbę węzłów w puli. Jeśli podsieć nie ma wystarczającej liczby wolnych adresów IP, pula częściowo przydzieli węzły obliczeniowe i wystąpi błąd zmiany rozmiaru. Jednostka usługi "MicrosoftAzureBatch" musi mieć rolę "Klasyczny współautor maszyny wirtualnej" Role-Based kontroli dostępu (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 obliczeniowych. Można to sprawdzić, sprawdzając, czy określona sieć wirtualna ma skojarzone sieciowe grupy zabezpieczeń. Jeśli komunikacja z węzłami obliczeniowymi 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 pośrednictwem elementu virtualMachineConfiguration konto usługi Batch musi mieć wartość poolAllocationMode userSubscription w celu użycia sieci wirtualnej. Jeśli określona sieć wirtualna ma skojarzone sieciowe grupy zabezpieczeń, należy włączyć kilka zarezerwowanych portów systemowych dla 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 systemu 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: /azure/batch/batch-api-basics#virtual-network-vnet-and-firewall-configuration	struna

NetworkSecurityGroupRule

Nazwa	Opis	Wartość
dostęp	Akcja, która powinna zostać podjęta dla określonego adresu IP, zakresu podsieci lub tagu.	"Zezwalaj" "Odmów" (wymagane)
priorytet	Priorytety w puli muszą być unikatowe i oceniane według priorytetu. Im niższa liczba, tym wyższy priorytet. Na przykład można określić reguły z liczbami zamówień 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 3500. Jeśli jakiekolwiek wartości zarezerwowane lub zduplikowane zostaną dostarczone, żądanie zakończy się niepowodzeniem z kodem stanu HTTP 400.	int (wymagane)
sourceAddressPrefix	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 zakończy się niepowodzeniem z kodem stanu HTTP 400.	ciąg (wymagany)

OSDisk

Nazwa	Opis	Wartość
Buforowanie	Wartość domyślna to brak.	"Brak" "ReadOnly" "ReadWrite"

PoolEndpointConfiguration

Nazwa	Opis	Wartość
inboundNatPools	Maksymalna liczba pul nat dla ruchu przychodzącego na pulę usługi Batch wynosi 5. Jeśli maksymalna liczba pul nat dla ruchu przychodzącego zostanie przekroczona, żądanie zakończy się niepowodzeniem z kodem stanu HTTP 400.	inboundNatPool[] (wymagane)

Właściwości puli

Nazwa	Opis	Wartość
applicationLicenses	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.	string[]
applicationPackages	Zmiany w pakietach aplikacji mają wpływ na wszystkie nowe węzły obliczeniowe łą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 zrewidowane.	ApplicationPackageReference[]
Certyfikaty	W przypadku węzłów obliczeniowych systemu Windows usługa Batch instaluje certyfikaty w określonym magazynie certyfikatów i lokalizacji. 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.	CertificateReference[]
deploymentConfiguration	Użycie funkcji CloudServiceConfiguration określa, że węzły powinny tworzyć przy użyciu usług Azure Cloud Services (PaaS), podczas gdy funkcja VirtualMachineConfiguration używa usługi Azure Virtual Machines (IaaS).	DeploymentConfiguration
displayName	Nazwa wyświetlana nie musi być unikatowa i może zawierać znaki Unicode o maksymalnej długości 1024.	struna
interNodeCommunication	Nakłada to ograniczenia dotyczące węzłów, które można przypisać do puli. Włączenie tej wartości może zmniejszyć prawdopodobieństwo przydzielenia żądanej liczby węzłów w puli. Jeśli nie zostanie określona, ta wartość jest domyślnie ustawiona na wartość "Wyłączone".	"Wyłączone" "Włączone"
maxTasksPerNode	Maksymalna liczba zadań, które mogą być uruchamiane współbieżnie w jednym węźle obliczeniowym w puli.	Int
metadane	Usługa Batch nie przypisuje żadnego znaczenia metadanym; służy wyłącznie do używania kodu użytkownika.	MetadataItem[]
networkConfiguration	Konfiguracja sieci dla puli.	NetworkConfiguration
scaleSettings	Definiuje żądany rozmiar puli. Może to być wartość "fixedScale", w której określono żądany element targetDedicatedNodes lub "autoScale", który definiuje formułę, która jest okresowo ponownie obliczana. Jeśli ta właściwość nie zostanie określona, pula będzie mieć stałą skalę z 0 targetDedicatedNodes.	ScaleSettings
startTask	W operacji PATCH (update) tę właściwość można ustawić na pusty obiekt, aby usunąć zadanie uruchamiania z puli.	StartTask
taskSchedulingPolicy	Określa sposób dystrybucji zadań między węzłami obliczeniowymi.	TaskSchedulingPolicy
userAccounts	Lista kont użytkowników do utworzenia w każdym węźle w puli.	userAccount[]
vmSize	Aby uzyskać informacje o dostępnych rozmiarach maszyn wirtualnych dla pul usług Cloud Services (pul utworzonych za pomocą funkcji cloudServiceConfiguration), zobacz Rozmiary dla usług Cloud Services (https://azure.microsoft.com/documentation/articles/cloud-services-sizes-specs/). Usługa Batch obsługuje wszystkie rozmiary maszyn wirtualnych usług Cloud Services z wyjątkiem ExtraSmall. Aby uzyskać informacje o dostępnych rozmiarach maszyn wirtualnych dla pul przy użyciu obrazów z witryny Virtual Machines Marketplace (pule utworzone za pomocą funkcji virtualMachineConfiguration), zobacz Rozmiary maszyn wirtualnych (Linux) (https://azure.microsoft.com/documentation/articles/virtual-machines-linux-sizes/) lub Rozmiary maszyn wirtualnych (Windows) (https://azure.microsoft.com/documentation/articles/virtual-machines-windows-sizes/). Usługa Batch obsługuje wszystkie rozmiary maszyn wirtualnych platformy Azure z wyjątkiem STANDARD_A0 i z magazynem w warstwie Premium (STANDARD_GS, STANDARD_DS i serii STANDARD_DSV2).	struna

Plik zasobu

Nazwa	Opis	Wartość
BlobSource	Ten adres URL musi być czytelny przy użyciu dostępu anonimowego; oznacza to, że usługa Batch nie przedstawia żadnych poświadczeń podczas pobierania obiektu blob. Istnieją dwa sposoby uzyskiwania takiego adresu URL dla obiektu blob w usłudze Azure Storage: obejmują sygnaturę dostępu współdzielonego udzielając uprawnień do odczytu dla obiektu blob lub ustaw listę ACL dla obiektu blob lub kontenera, aby zezwolić na dostęp publiczny.	ciąg (wymagany)
fileMode	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 elementu resourceFile, który zostanie pobrany do węzła systemu Windows. Jeśli ta właściwość nie zostanie określona dla węzła systemu Linux, do pliku zostanie zastosowana wartość domyślna 0770.	struna
filePath	Lokalizacja w węźle obliczeniowym, do którego ma być pobierany plik, względem katalogu roboczego zadania.	ciąg (wymagany)

ScaleSettings

Nazwa	Opis	Wartość
autoSkaluj	Ta właściwość i stałaSkala wzajemnie się wykluczają i należy określić jedną z właściwości.	autoskalowania
fixedScale	Ta właściwość i autoSkalowanie wzajemnie się wykluczają i należy określić jedną z właściwości.	FixedScaleSettings

StartTask

Nazwa	Opis	Wartość
commandLine	Wiersz polecenia nie jest uruchamiany w powłoce i dlatego nie może korzystać z funkcji powłoki, takich jak rozszerzenie zmiennej środowiskowej. Jeśli chcesz skorzystać z takich funkcji, należy wywołać powłokę w wierszu polecenia, na przykład za pomocą polecenia "cmd /c MyCommand" w systemie Windows lub "/bin/sh -c MyCommand" w systemie Linux. Wymagane, jeśli określono jakiekolwiek inne właściwości właściwości startTask.	struna
environmentSettings	Lista ustawień zmiennych środowiskowych dla zadania uruchamiania.	EnvironmentSetting[]
maxTaskRetryCount	Usługa Batch ponawia próbę zadania, jeśli jego kod zakończenia jest inny niżzer. Należy pamiętać, że ta wartość steruje liczbą ponownych prób. Usługa Batch spróbuje wykonać zadanie raz, 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.	Int
resourceFiles	Lista plików, które usługa Batch pobierze do węzła obliczeniowego przed uruchomieniem wiersza polecenia.	ResourceFile[]
userIdentity	W przypadku pominięcia zadanie jest uruchamiane jako użytkownik niebędący administratorem unikatowym dla zadania.	UserIdentity
waitForSuccess	Jeśli wartość true i zadanie uruchamiania zakończy się niepowodzeniem w węźle obliczeniowym, usługa Batch ponawia próbę zadania podrzędnego uruchamiania do maksymalnej liczby ponownych prób (maxTaskRetryCount). Jeśli zadanie nadal nie zostało ukończone pomyślnie po ponownych próbach, usługa Batch oznaczy węzeł obliczeniowy jako bezużyteczny i nie będzie planować zadań podrzędnych. Ten warunek można wykryć za pomocą stanu węzła i szczegółów błędu planowania. Jeśli wartość false, usługa Batch nie będzie czekać na ukończenie zadania uruchamiania. W takim przypadku inne zadania mogą rozpocząć wykonywanie w węźle obliczeniowym, gdy zadanie uruchamiania jest nadal uruchomione; a nawet jeśli zadanie uruchamiania zakończy się niepowodzeniem, nowe zadania będą nadal zaplanowane w węźle. Wartość domyślna to false.	Bool

TaskSchedulingPolicy

Nazwa	Opis	Wartość
nodeFillType	Sposób dystrybucji zadań między węzłami obliczeniowymi.	"Pack" "Spread" (wymagane)

UserAccount

Nazwa	Opis	Wartość
elevationLevel	nonAdmin — użytkownik automatyczny jest użytkownikiem standardowym bez podwyższonego poziomu dostępu. administrator — użytkownik automatyczny jest użytkownikiem z podwyższonym poziomem dostępu i działa z pełnymi uprawnieniami administratora. Wartość domyślna to nonAdmin.	"Administrator" "NonAdmin"
linuxUserConfiguration	Ta właściwość jest ignorowana, jeśli jest określona w puli systemu Windows. Jeśli nie zostanie określony, użytkownik zostanie utworzony przy użyciu opcji domyślnych.	LinuxUserConfiguration
nazwa	Nazwa konta użytkownika.	ciąg (wymagany)
hasło	Hasło do konta użytkownika.	ciąg (wymagany)

Identyfikator użytkownika

Nazwa	Opis	Wartość
autoużytkownik	Właściwości userName i autoUser wzajemnie się wykluczają; należy określić jeden, ale nie oba te elementy.	AutoUserSpecification
userName	Właściwości userName i autoUser wzajemnie się wykluczają; należy określić jeden, ale nie oba te elementy.	struna

VirtualMachineConfiguration

Nazwa	Opis	Wartość
dataDisks	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.	DataDisk[]
imageReference	Odwołanie do obrazu witryny Marketplace usługi Azure Virtual Machines lub zasobu obrazu platformy Azure niestandardowej maszyny wirtualnej. Aby uzyskać listę wszystkich elementów imageReferences zweryfikowanych przez usługę Azure Batch, zobacz operację "Lista obsługiwanych jednostek SKU agenta węzła".	ImageReference (wymagane)
licenseType	Dotyczy to tylko obrazów zawierających system operacyjny Windows i powinny być używane tylko w przypadku przechowywania prawidłowych licencji lokalnych dla węzłów, które zostaną wdrożone. W przypadku pominięcia nie zastosowano rabatu na licencjonowanie lokalne. Wartości to: Windows_Server — licencja lokalna dotyczy systemu Windows Server. Windows_Client — licencja lokalna jest dla klienta systemu Windows.	struna
nodeAgentSkuId	Agent węzła usługi Batch to program uruchamiany w każdym węźle w puli i udostępnia interfejs polecenia i sterowania między węzłem a usługą Batch. Istnieją różne implementacje agenta węzła, znane jako jednostki SKU, dla różnych systemów operacyjnych. Należy określić jednostkę SKU agenta węzła zgodną z wybranym odwołaniem do obrazu. Aby uzyskać listę obsługiwanych jednostek SKU agenta węzła wraz z listą zweryfikowanych odwołań do obrazów, zobacz operację "Lista obsługiwanych jednostek SKU agenta węzła".	ciąg (wymagany)
osDisk	Ustawienia dysku systemu operacyjnego maszyny wirtualnej.	OSDisk
windowsConfiguration	Nie można określić tej właściwości, jeśli imageReference określa obraz systemu operacyjnego Linux.	WindowsConfiguration

Konfiguracja systemu Windows

Nazwa	Opis	Wartość
enableAutomaticUpdates	W przypadku pominięcia wartość domyślna to true.	Bool