Udostępnij za pośrednictwem


Microsoft.Batch batchAccounts/pools 2020-09-01

Definicja zasobu Bicep

Typ zasobu batchAccounts/pools można wdrożyć z operacjami docelowymi:

Aby uzyskać listę zmienionych właściwości w każdej wersji interfejsu API, zobacz dziennik 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@2020-09-01' = {
  name: 'string'
  parent: resourceSymbolicName
  properties: {
    applicationLicenses: [
      'string'
    ]
    applicationPackages: [
      {
        id: 'string'
        version: 'string'
      }
    ]
    certificates: [
      {
        id: 'string'
        storeLocation: 'string'
        storeName: 'string'
        visibility: [
          'string'
        ]
      }
    ]
    deploymentConfiguration: {
      cloudServiceConfiguration: {
        osFamily: 'string'
        osVersion: 'string'
      }
      virtualMachineConfiguration: {
        containerConfiguration: {
          containerImageNames: [
            'string'
          ]
          containerRegistries: [
            {
              password: 'string'
              registryServer: 'string'
              username: 'string'
            }
          ]
          type: 'DockerCompatible'
        }
        dataDisks: [
          {
            caching: 'string'
            diskSizeGB: int
            lun: int
            storageAccountType: 'string'
          }
        ]
        diskEncryptionConfiguration: {
          targets: [
            'string'
          ]
        }
        imageReference: {
          id: 'string'
          offer: 'string'
          publisher: 'string'
          sku: 'string'
          version: 'string'
        }
        licenseType: 'string'
        nodeAgentSkuId: 'string'
        windowsConfiguration: {
          enableAutomaticUpdates: bool
        }
      }
    }
    displayName: 'string'
    interNodeCommunication: 'string'
    metadata: [
      {
        name: 'string'
        value: 'string'
      }
    ]
    mountConfiguration: [
      {
        azureBlobFileSystemConfiguration: {
          accountKey: 'string'
          accountName: 'string'
          blobfuseOptions: 'string'
          containerName: 'string'
          relativeMountPath: 'string'
          sasKey: 'string'
        }
        azureFileShareConfiguration: {
          accountKey: 'string'
          accountName: 'string'
          azureFileUrl: 'string'
          mountOptions: 'string'
          relativeMountPath: 'string'
        }
        cifsMountConfiguration: {
          mountOptions: 'string'
          password: 'string'
          relativeMountPath: 'string'
          source: 'string'
          username: 'string'
        }
        nfsMountConfiguration: {
          mountOptions: 'string'
          relativeMountPath: 'string'
          source: 'string'
        }
      }
    ]
    networkConfiguration: {
      endpointConfiguration: {
        inboundNatPools: [
          {
            backendPort: int
            frontendPortRangeEnd: int
            frontendPortRangeStart: int
            name: 'string'
            networkSecurityGroupRules: [
              {
                access: 'string'
                priority: int
                sourceAddressPrefix: 'string'
                sourcePortRanges: [
                  'string'
                ]
              }
            ]
            protocol: 'string'
          }
        ]
      }
      publicIPAddressConfiguration: {
        ipAddressIds: [
          'string'
        ]
        provision: 'string'
      }
      subnetId: 'string'
    }
    scaleSettings: {
      autoScale: {
        evaluationInterval: 'string'
        formula: 'string'
      }
      fixedScale: {
        nodeDeallocationOption: 'string'
        resizeTimeout: 'string'
        targetDedicatedNodes: int
        targetLowPriorityNodes: int
      }
    }
    startTask: {
      commandLine: 'string'
      containerSettings: {
        containerRunOptions: 'string'
        imageName: 'string'
        registry: {
          password: 'string'
          registryServer: 'string'
          username: 'string'
        }
        workingDirectory: 'string'
      }
      environmentSettings: [
        {
          name: 'string'
          value: 'string'
        }
      ]
      maxTaskRetryCount: int
      resourceFiles: [
        {
          autoStorageContainerName: 'string'
          blobPrefix: 'string'
          fileMode: 'string'
          filePath: 'string'
          httpUrl: 'string'
          storageContainerUrl: 'string'
        }
      ]
      userIdentity: {
        autoUser: {
          elevationLevel: 'string'
          scope: 'string'
        }
        userName: 'string'
      }
      waitForSuccess: bool
    }
    taskSchedulingPolicy: {
      nodeFillType: 'string'
    }
    taskSlotsPerNode: int
    userAccounts: [
      {
        elevationLevel: 'string'
        linuxUserConfiguration: {
          gid: int
          sshPrivateKey: 'string'
          uid: int
        }
        name: 'string'
        password: 'string'
        windowsUserConfiguration: {
          loginMode: 'string'
        }
      }
    ]
    vmSize: 'string'
  }
}

Wartości właściwości

batchAccounts/pools

Nazwa Opis Wartość
name Nazwa zasobu

Zobacz, jak ustawić nazwy i typy dla zasobów podrzędnych w aplikacji Bicep.
ciąg (wymagany)

Limit znaków: 1–64

Prawidłowe znaki:
Alfanumeryczne, podkreślenia i łączniki.
Nadrzędny 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
properties Właściwości skojarzone z pulą. Właściwości puli

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. ciąg[]
applicationPackages Zmiany odwołań do pakietu 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 z obrazu. W dowolnej puli istnieje maksymalnie 10 odwołań do pakietu aplikacji. 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 podrzędnego, 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 polecenia CloudServiceConfiguration określa, że węzły powinny tworzyć przy użyciu usługi Azure Cloud Services (PaaS), podczas gdy funkcja VirtualMachineConfiguration używa usługi Azure Virtual Machines (IaaS). Konfiguracja wdrożenia
displayName Nazwa wyświetlana nie musi być unikatowa i może zawierać znaki Unicode o maksymalnej długości 1024. ciąg
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"
metadane Usługa Batch nie przypisuje żadnego znaczenia do metadanych; jest on przeznaczony wyłącznie do korzystania z kodu użytkownika. MetadataItem[]
mountConfiguration Obsługuje to Azure Files, NFS, CIFS/SMB i Blobfuse. MountConfiguration[]
networkConfiguration Konfiguracja sieci dla puli. Konfiguracja sieci
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 Jeśli nie zostanie określony, wartość domyślna zostanie rozłożona. TaskSchedulingPolicy
taskSlotsPerNode Wartość domyślna to 1. Wartość maksymalna jest mniejsza niż 4 razy mniejsza niż liczba rdzeni vmSize puli lub 256. int
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 Cloud Services (pul utworzonych za pomocą funkcji cloudServiceConfiguration), zobacz Rozmiary dla Cloud Services (https://azure.microsoft.com/documentation/articles/cloud-services-sizes-specs/). Usługa Batch obsługuje wszystkie Cloud Services rozmiary maszyn wirtualnych z wyjątkiem ExtraSmall. Aby uzyskać informacje o dostępnych rozmiarach maszyn wirtualnych dla pul korzystających z obrazów z witryny Virtual Machines Marketplace (pule utworzone za pomocą polecenia virtualMachineConfiguration), zobacz Rozmiary dla Virtual Machines (Linux) (/azure/virtual-machines/sizes-general) lub Sizes for Virtual Machines (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 tych z magazynem w warstwie Premium (STANDARD_GS, STANDARD_DS i serii STANDARD_DSV2). ciąg

ApplicationPackageReference

Nazwa Opis Wartość
identyfikator Identyfikator pakietu aplikacji do zainstalowania. Musi to być wewnątrz tego samego konta usługi Batch co pula. Może to być odwołanie do określonej wersji lub wersji domyślnej, jeśli taka istnieje. ciąg (wymagany)
Wersja Jeśli zostanie to pominięte i 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. ciąg

CertificateReference (Odwołanie certyfikatu)

Nazwa Opis Wartość
identyfikator W pełni kwalifikowany identyfikator certyfikatu do zainstalowania w puli. Musi to być wewnątrz tego samego konta usługi Batch 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 podrzędnego, 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 Mój. ciąg
widoczność Które konta użytkowników w węźle obliczeniowym powinny mieć dostęp do prywatnych danych certyfikatu. Tablica ciągów zawierająca dowolną z:
"RemoteUser"
"StartTask"
"Zadanie"

Konfiguracja wdrożenia

Nazwa Opis Wartość
cloudServiceConfiguration Ta właściwość i element virtualMachineConfiguration wykluczają się wzajemnie 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

CloudServiceConfiguration

Nazwa Opis Wartość
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, 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 systemu operacyjnego 6, co odpowiada systemowi 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). ciąg (wymagany)
osVersion Wartość domyślna to * określająca najnowszą wersję systemu operacyjnego dla określonej rodziny systemu operacyjnego. ciąg

VirtualMachineConfiguration

Nazwa Opis Wartość
containerConfiguration Jeśli zostanie określony, konfiguracja jest wykonywana na każdym węźle 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ć. Konfiguracja kontenera
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[]
diskEncryptionConfiguration W przypadku określenia szyfrowanie jest wykonywane na każdym węźle w puli podczas aprowizacji węzła. DiskEncryptionConfiguration
imageReference Odwołanie do obrazu z witryny Azure Virtual Machines Marketplace lub zasobu obrazu platformy Azure niestandardowej maszyny wirtualnej. Aby uzyskać listę wszystkich elementów imageReferences zweryfikowanych przez Azure Batch, zobacz operację "Wyświetlanie listy obsługiwanych jednostek SKU agenta węzła". ImageReference (wymagane)
licenseType Dotyczy to tylko obrazów, które zawierają 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.
ciąg
nodeAgentSkuId Agent węzła usługi Batch to program, który działa w każdym węźle w puli i udostępnia interfejs 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ę "Wyświetlanie listy obsługiwanych jednostek SKU agenta węzła". ciąg (wymagany)
windowsConfiguration Nie można określić tej właściwości, jeśli imageReference określa obraz systemu operacyjnego Linux. Konfiguracja systemu Windows

ContainerConfiguration

Nazwa Opis Wartość
containerImageNames Jest to pełne odwołanie do obrazu, które zostanie określone jako "ściąganie platformy Docker". Obraz zostanie uzyskany z domyślnego rejestru platformy Docker, chyba że obraz jest w pełni kwalifikowany z alternatywnym rejestrem. ciąg[]
containerRegistries Jeśli jakiekolwiek obrazy muszą zostać pobrane z rejestru prywatnego, który wymaga poświadczeń, należy podać te poświadczenia tutaj. ContainerRegistry[]
typ Technologia kontenera do użycia. "DockerCompatible" (wymagane)

ContainerRegistry

Nazwa Opis Wartość
hasło Hasło do logowania się na serwerze rejestru. ciąg (wymagany)
registryServer Jeśli pominięto, wartość domyślna to "docker.io". ciąg
nazwa użytkownika Nazwa użytkownika do logowania się na serwerze rejestru. ciąg (wymagany)

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żdy powinien mieć odrębną jednostkę lun. Wartość musi należeć do zakresu od 0 do 63 włącznie. int (wymagane)
storageAccountType Jeśli pominięto, 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"

DiskEncryptionConfiguration

Nazwa Opis Wartość
Cele W puli systemu Linux obsługiwana jest tylko opcja "TemporaryDisk"; w puli systemu Windows należy określić "OsDisk" i "TemporaryDisk". Tablica ciągów zawierająca dowolną z:
"OsDisk"
"TemporaryDisk"

ImageReference

Nazwa Opis Wartość
identyfikator Ta właściwość wzajemnie wyklucza się z innymi właściwościami. Obraz Shared Image Gallery musi mieć repliki w tym samym regionie co konto Azure Batch. Aby uzyskać informacje o ustawieniach zapory dla agenta węzła usługi Batch do komunikowania się z usługą Batch, zobacz https://docs.microsoft.com/azure/batch/batch-api-basics#virtual-network-vnet-and-firewall-configuration. ciąg
offer Na przykład UbuntuServer lub WindowsServer. ciąg
publisher Na przykład Canonical lub MicrosoftWindowsServer. ciąg
sku Na przykład 18.04-LTS lub 2019-Datacenter. ciąg
Wersja Można określić wartość "latest", aby wybrać najnowszą wersję obrazu. Jeśli pominięto, wartość domyślna to "latest". ciąg

Konfiguracja systemu Windows

Nazwa Opis Wartość
enableAutomaticUpdates Jeśli pominięto, wartość domyślna to true. bool

Metadataitem

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

InstalacjaKonfiguracja

Nazwa Opis Wartość
azureBlobFileSystemConfiguration Ta właściwość wyklucza się wzajemnie ze wszystkimi innymi właściwościami. AzureBlobFileSystemConfiguration
azureFileShareConfiguration Ta właściwość wyklucza się wzajemnie ze wszystkimi innymi właściwościami. AzureFileShareConfiguration
cifsMountConfiguration Ta właściwość wyklucza się wzajemnie ze wszystkimi innymi właściwościami. CifsMountConfiguration
nfsMountConfiguration Ta właściwość wyklucza się wzajemnie ze wszystkimi innymi właściwościami. NFSMountConfiguration

AzureBlobFileSystemConfiguration

Nazwa Opis Wartość
accountKey Ta właściwość wyklucza się wzajemnie z kluczem sasKey i należy określić jedną z nich. ciąg
accountName Nazwa konta usługi Azure Storage. ciąg (wymagany)
blobfuseOptions Są to opcje "net use" w systemach Windows i "instalowanie" w systemie Linux. ciąg
containerName Nazwa kontenera Azure Blob Storage. ciąg (wymagany)
relativeMountPath 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. ciąg (wymagany)
sasKey Ta właściwość wzajemnie wyklucza się z wartością accountKey i należy je określić. ciąg

AzureFileShareConfiguration

Nazwa Opis Wartość
accountKey Klucz konta usługi Azure Storage. ciąg (wymagany)
accountName Nazwa konta usługi Azure Storage. ciąg (wymagany)
azureFileUrl Jest to formularz "https://{account}.file.core.windows.net/". ciąg (wymagany)
mountOptions Są to opcje "net use" w systemach Windows i "instalowanie" w systemie Linux. ciąg
relativeMountPath 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. ciąg (wymagany)

CifsMountConfiguration

Nazwa Opis Wartość
mountOptions Są to opcje "net use" w systemach Windows i "instalowanie" w systemie Linux. ciąg
hasło Hasło do użycia do uwierzytelniania w systemie plików CIFS. ciąg (wymagany)
relativeMountPath 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. ciąg (wymagany)
source Identyfikator URI systemu plików do zainstalowania. ciąg (wymagany)
nazwa użytkownika Użytkownik do użycia do uwierzytelniania w systemie plików CIFS. ciąg (wymagany)

NFSMountConfiguration

Nazwa Opis Wartość
mountOptions Są to opcje "net use" w systemach Windows i "instalowanie" w systemie Linux. ciąg
relativeMountPath 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. ciąg (wymagany)
source Identyfikator URI systemu plików do zainstalowania. ciąg (wymagany)

Konfiguracja sieci

Nazwa Opis Wartość
endpointConfiguration Konfiguracja punktu końcowego puli jest obsługiwana tylko w pulach z właściwością virtualMachineConfiguration. PoolEndpointConfiguration
publicIPAddressConfiguration Ta właściwość jest obsługiwana tylko w pulach z właściwością virtualMachineConfiguration. PublicIPAddressConfiguration
subnetId 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 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ę "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 obliczeniowych. Można to zweryfikować, 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. 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 za pomocą konfiguracji maszyny wirtualnej włącz porty 29876 i 29877 oraz port 22 dla systemu Linux i port 3389 dla systemu Windows. W przypadku pul utworzonych za pomocą 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. W przypadku pul cloudServiceConfiguration obsługiwane są tylko klasyczne sieci wirtualne. Aby uzyskać więcej informacji, zobacz: https://docs.microsoft.com/azure/batch/batch-api-basics#virtual-network-vnet-and-firewall-configuration ciąg

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. Nie można go określić, jeśli parametr IPAddressProvisioningType ma wartość NoPublicIPAddresses. InboundNatPool[] (wymagane)

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 jakiekolwiek wartości zarezerwowane zostaną dostarczone, żą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 zastrzeżone lub nakładające się wartości są dostarczane żądanie koń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 zastrzeżone lub nakładające się wartości są dostarczane żądanie kończy się niepowodzeniem z kodem stanu HTTP 400. int (wymagane)
name 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 jakiekolwiek 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ć dla wszystkich punktów 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)

NetworkSecurityGroupRule

Nazwa Opis Wartość
access Akcja, która powinna zostać podjęta dla określonego adresu IP, zakresu podsieci lub tagu. "Zezwalaj"
"Odmów" (wymagane)
priority Priorytety w puli muszą być unikatowe i oceniane według priorytetu. Im niższy numer, tym wyższy priorytet. Na przykład można określić reguły z liczbami zamówień 150, 250 i 350. Reguła o kolejności 150 ma pierwszeństwo przed regułą, która ma kolejność 250. Dozwolone priorytety to od 150 do 4096. Jeśli jakiekolwiek zastrzeżone lub zduplikowane wartości 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)
sourcePortRanges Prawidłowe wartości to "*" (dla wszystkich portów 0–65535) lub tablice portów lub zakresów portów (tj. 100–200). Porty powinny mieścić się w zakresie od 0 do 65535, a zakresy portów lub porty nie mogą się nakładać. Jeśli podano inne wartości, żądanie zakończy się niepowodzeniem z kodem stanu HTTP 400. Wartość domyślna to *. ciąg[]

PublicIPAddressConfiguration

Nazwa Opis Wartość
ipAddressIds Liczba adresów IP określonych w tym miejscu ogranicza maksymalny rozmiar puli — 100 dedykowanych węzłów lub 100 węzłów o niskim priorycie 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}. ciąg[]
Przepis Wartość domyślna to BatchManaged "BatchManaged"
"NoPublicIPAddresses"
"UserManaged"

ScaleSettings

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

AutoskalowanieUstawienia

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

FixedScaleSettings

Nazwa Opis Wartość
nodeDeallocationOption W przypadku pominięcia wartość domyślna to Requeue. "Ponowne kolejki"
"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 ciągu PT10M przez 10 minut. Wartość minimalna 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). ciąg
targetDedicatedNodes Należy ustawić co najmniej jeden z elementów targetDedicatedNodes, targetLowPriorityNodes. int
targetLowPriorityNodes Należy ustawić co najmniej jeden z elementów targetDedicatedNodes, targetLowPriorityNodes. int

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 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 systemie Windows lub "/bin/sh -c MyCommand" w systemie Linux. Wymagane, jeśli określono inne właściwości właściwości startTask. ciąg
containerSettings 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. TaskContainerSettings
environmentSettings Lista ustawień zmiennych środowiskowych dla zadania uruchamiania. EnvironmentSetting[]
maxTaskRetryCount 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 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 nie powiedzie się 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 wszystkich ponownych próbach, usługa Batch oznacza węzeł obliczeniowy jako bezużyteczny i nie będzie planować zadań podrzędnych. Ten warunek można wykryć za pośrednictwem szczegółów stanu węzła i planowania błędu. 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 podrzędne 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 true. bool

TaskContainerSettings

Nazwa Opis Wartość
containerRunOptions Te dodatkowe opcje są dostarczane jako argumenty polecenia "docker create" oprócz tych kontrolowanych przez usługę Batch. ciąg
Imagename Jest to pełne odwołanie do obrazu, które zostanie określone jako "ściąganie platformy Docker". Jeśli tag nie zostanie podany jako część nazwy obrazu, tag ":latest" jest używany jako domyślny. ciąg (wymagany)
registry To ustawienie można pominąć, jeśli zostało już udostępnione podczas tworzenia puli. ContainerRegistry
Workingdirectory Flaga wskazująca, gdzie znajduje się katalog roboczy zadania kontenera. Wartość domyślna to "taskWorkingDirectory". "ContainerImageDefault"
"TaskWorkingDirectory"

EnvironmentSetting

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

ResourceFile

Nazwa Opis Wartość
autoStorageContainerName Właściwości autoStorageContainerName, storageContainerUrl i httpUrl wzajemnie się wykluczają i należy określić jedną z nich. ciąg
BlobPrefix 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. ciąg
Filemode Ta właściwość dotyczy tylko 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 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. ciąg
Filepath 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 wyrwać się z katalogu roboczego zadania (na przykład przy użyciu polecenia ".". ciąg
httpUrl Właściwości autoStorageContainerName, storageContainerUrl i httpUrl wzajemnie się wykluczają i należy określić jedną z nich. Jeśli adres URL jest Azure Blob Storage, 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 w obiekcie blob lub ustaw listę ACL dla obiektu blob lub kontenera, aby zezwolić na dostęp publiczny. ciąg
storageContainerUrl 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 przy użyciu dostępu anonimowego; oznacza to, że usługa Batch nie przedstawia żadnych poświadczeń podczas pobierania obiektu blob. Istnieją dwa sposoby uzyskania takiego adresu URL dla obiektu blob w usłudze Azure Storage: obejmują sygnaturę dostępu współdzielonego udzielając uprawnień do odczytu i listy w obiekcie blob lub ustaw listę ACL dla obiektu blob lub kontenera, aby zezwolić na dostęp publiczny. ciąg

UserIdentity

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

AutoUserSpecification

Nazwa Opis Wartość
elevationLevel Wartość domyślna to nonAdmin. "Administracja"
"NonAdmin"
scope Wartość domyślna to Pula. Jeśli pula jest uruchomiona w systemie Windows, należy określić wartość Zadanie, jeśli wymagana jest ściślejsza izolacja między zadaniami. 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óre nie powinny być dostępne przez normalne zadania, ale powinny być dostępne przez zadania uruchamiania. "Pula"
"Zadanie"

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. "Administracja"
"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 z opcjami domyślnymi. LinuxUserConfiguration
name Nazwa konta użytkownika. ciąg (wymagany)
hasło Hasło do konta użytkownika. ciąg (wymagany)
windowsUserConfiguration Tę właściwość można określić tylko wtedy, gdy użytkownik znajduje się w puli systemu Windows. Jeśli nie określono wartości i w puli systemu Windows, użytkownik zostanie utworzony z opcjami domyślnymi. WindowsUserConfiguration

LinuxUserConfiguration

Nazwa Opis Wartość
Gid Właściwości uid i gid muszą być określone razem lub nie w ogóle. Jeśli nie określono bazowego systemu operacyjnego, wybierze 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). W tym celu należy umieścić 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 (nie jest wykonywana żadna modyfikacja katalogu .ssh użytkownika). ciąg
Identyfikator UID Właściwości uid i gid muszą być określone razem lub nie w ogóle. Jeśli nie określono bazowego systemu operacyjnego, wybierze identyfikator uid. int

WindowsUserConfiguration

Nazwa Opis Wartość
Loginmode Określa tryb logowania użytkownika. Wartość domyślna dla pul VirtualMachineConfiguration to tryb interaktywny, a w przypadku pul CloudServiceConfiguration jest tryb wsadowy. "Batch"
"Interakcyjny"

Szablony szybkiego startu

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

Template Opis
pula Azure Batch bez publicznych adresów IP

Wdróż na platformie Azure
Ten szablon tworzy Azure Batch uproszczoną pulę komunikacji węzłów bez publicznych adresów IP.

Definicja zasobu szablonu usługi ARM

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

Aby uzyskać listę zmienionych właściwości w każdej wersji interfejsu API, zobacz dziennik 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": "2020-09-01",
  "name": "string",
  "properties": {
    "applicationLicenses": [ "string" ],
    "applicationPackages": [
      {
        "id": "string",
        "version": "string"
      }
    ],
    "certificates": [
      {
        "id": "string",
        "storeLocation": "string",
        "storeName": "string",
        "visibility": [ "string" ]
      }
    ],
    "deploymentConfiguration": {
      "cloudServiceConfiguration": {
        "osFamily": "string",
        "osVersion": "string"
      },
      "virtualMachineConfiguration": {
        "containerConfiguration": {
          "containerImageNames": [ "string" ],
          "containerRegistries": [
            {
              "password": "string",
              "registryServer": "string",
              "username": "string"
            }
          ],
          "type": "DockerCompatible"
        },
        "dataDisks": [
          {
            "caching": "string",
            "diskSizeGB": "int",
            "lun": "int",
            "storageAccountType": "string"
          }
        ],
        "diskEncryptionConfiguration": {
          "targets": [ "string" ]
        },
        "imageReference": {
          "id": "string",
          "offer": "string",
          "publisher": "string",
          "sku": "string",
          "version": "string"
        },
        "licenseType": "string",
        "nodeAgentSkuId": "string",
        "windowsConfiguration": {
          "enableAutomaticUpdates": "bool"
        }
      }
    },
    "displayName": "string",
    "interNodeCommunication": "string",
    "metadata": [
      {
        "name": "string",
        "value": "string"
      }
    ],
    "mountConfiguration": [
      {
        "azureBlobFileSystemConfiguration": {
          "accountKey": "string",
          "accountName": "string",
          "blobfuseOptions": "string",
          "containerName": "string",
          "relativeMountPath": "string",
          "sasKey": "string"
        },
        "azureFileShareConfiguration": {
          "accountKey": "string",
          "accountName": "string",
          "azureFileUrl": "string",
          "mountOptions": "string",
          "relativeMountPath": "string"
        },
        "cifsMountConfiguration": {
          "mountOptions": "string",
          "password": "string",
          "relativeMountPath": "string",
          "source": "string",
          "username": "string"
        },
        "nfsMountConfiguration": {
          "mountOptions": "string",
          "relativeMountPath": "string",
          "source": "string"
        }
      }
    ],
    "networkConfiguration": {
      "endpointConfiguration": {
        "inboundNatPools": [
          {
            "backendPort": "int",
            "frontendPortRangeEnd": "int",
            "frontendPortRangeStart": "int",
            "name": "string",
            "networkSecurityGroupRules": [
              {
                "access": "string",
                "priority": "int",
                "sourceAddressPrefix": "string",
                "sourcePortRanges": [ "string" ]
              }
            ],
            "protocol": "string"
          }
        ]
      },
      "publicIPAddressConfiguration": {
        "ipAddressIds": [ "string" ],
        "provision": "string"
      },
      "subnetId": "string"
    },
    "scaleSettings": {
      "autoScale": {
        "evaluationInterval": "string",
        "formula": "string"
      },
      "fixedScale": {
        "nodeDeallocationOption": "string",
        "resizeTimeout": "string",
        "targetDedicatedNodes": "int",
        "targetLowPriorityNodes": "int"
      }
    },
    "startTask": {
      "commandLine": "string",
      "containerSettings": {
        "containerRunOptions": "string",
        "imageName": "string",
        "registry": {
          "password": "string",
          "registryServer": "string",
          "username": "string"
        },
        "workingDirectory": "string"
      },
      "environmentSettings": [
        {
          "name": "string",
          "value": "string"
        }
      ],
      "maxTaskRetryCount": "int",
      "resourceFiles": [
        {
          "autoStorageContainerName": "string",
          "blobPrefix": "string",
          "fileMode": "string",
          "filePath": "string",
          "httpUrl": "string",
          "storageContainerUrl": "string"
        }
      ],
      "userIdentity": {
        "autoUser": {
          "elevationLevel": "string",
          "scope": "string"
        },
        "userName": "string"
      },
      "waitForSuccess": "bool"
    },
    "taskSchedulingPolicy": {
      "nodeFillType": "string"
    },
    "taskSlotsPerNode": "int",
    "userAccounts": [
      {
        "elevationLevel": "string",
        "linuxUserConfiguration": {
          "gid": "int",
          "sshPrivateKey": "string",
          "uid": "int"
        },
        "name": "string",
        "password": "string",
        "windowsUserConfiguration": {
          "loginMode": "string"
        }
      }
    ],
    "vmSize": "string"
  }
}

Wartości właściwości

batchAccounts/pule

Nazwa Opis Wartość
typ Typ zasobu "Microsoft.Batch/batchAccounts/pools"
apiVersion Wersja interfejsu API zasobów '2020-09-01'
name Nazwa zasobu

Zobacz, jak ustawiać nazwy i typy dla zasobów podrzędnych w szablonach usługi ARM JSON.
ciąg (wymagany)

Limit znaków: 1–64

Prawidłowe znaki:
Alfanumeryczne, podkreślenia i łączniki.
properties Właściwości skojarzone z pulą. PoolProperties

PoolProperties

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. ciąg[]
applicationPackages Zmiany odwołań do pakietu 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 zostaną ponownie wyświetlone. W dowolnej puli istnieje maksymalnie 10 odwołań do pakietu aplikacji. 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 do wykonywania zapytań dotyczących tej lokalizacji. 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 usługi CloudServiceConfiguration określa, że węzły powinny tworzyć przy użyciu usługi Azure Cloud Services (PaaS), podczas gdy usługa 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. ciąg
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 "Wyłączone". "Wyłączone"
"Włączone"
metadane Usługa Batch nie przypisuje żadnego znaczenia do metadanych; służy wyłącznie do używania kodu użytkownika. MetadataItem[]
mountConfiguration Obsługuje to Azure Files, NFS, CIFS/SMB i Blobfuse. MountConfiguration[]
networkConfiguration Konfiguracja sieci dla puli. Konfiguracja sieci
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 miała stałą skalę z 0 elementami 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 Jeśli nie zostanie określony, wartość domyślna zostanie rozłożona. TaskSchedulingPolicy
taskSlotsPerNode Wartość domyślna to 1. Maksymalna wartość jest mniejsza niż 4 razy mniejsza liczba rdzeni maszyny wirtualnej VmSize puli lub 256. int
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 Cloud Services (pule utworzone za pomocą usługi cloudServiceConfiguration), zobacz Rozmiary dla Cloud Services (https://azure.microsoft.com/documentation/articles/cloud-services-sizes-specs/). Usługa Batch obsługuje wszystkie rozmiary maszyn wirtualnych Cloud Services z wyjątkiem ExtraSmall. Aby uzyskać informacje o dostępnych rozmiarach maszyn wirtualnych dla pul korzystających z obrazów z witryny Virtual Machines Marketplace (pule utworzone za pomocą funkcji virtualMachineConfiguration) zobacz Rozmiary dla Virtual Machines (Linux) (/azure/virtual-machines/sizes-general) lub Sizes for Virtual Machines (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). ciąg

ApplicationPackageReference

Nazwa Opis Wartość
identyfikator Identyfikator pakietu aplikacji do zainstalowania. Musi to być na tym samym koncie wsadowym co pula. Może to być odwołanie do określonej wersji lub domyślnej wersji, 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. ciąg

CertyfikatReference

Nazwa Opis Wartość
identyfikator W pełni kwalifikowany identyfikator certyfikatu do zainstalowania w puli. Musi to być na tym samym koncie wsadowym 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 tworzonych za pomocą elementu 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 do wykonywania zapytań dotyczących tej lokalizacji. 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 tworzonych za pomocą elementu 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. ciąg
widoczność Które konta użytkowników w węźle obliczeniowym powinny mieć dostęp do prywatnych danych certyfikatu. Tablica ciągów zawierająca dowolną z:
"RemoteUser"
"StartTask"
"Zadanie"

DeploymentConfiguration

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

CloudServiceConfiguration

Nazwa Opis Wartość
osFamily Możliwe wartości to: 2 — rodzina systemu operacyjnego 2, równoważna windows Server 2008 R2 SP1. 3 — Rodzina systemu operacyjnego 3, równoważna Windows Server 2012. 4 — Rodzina systemu operacyjnego 4, równoważna Windows Server 2012 R2. 5 — Rodzina systemu operacyjnego 5, równoważna Windows Server 2016. 6 — Rodzina systemu operacyjnego 6, odpowiednik systemu Windows Server 2019. 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)
osVersion Wartość domyślna to * określająca najnowszą wersję systemu operacyjnego dla określonej rodziny systemu operacyjnego. ciąg

VirtualMachineConfiguration

Nazwa Opis Wartość
containerConfiguration Jeśli zostanie określony, konfiguracja jest wykonywana w każdym węźle w puli, aby umożliwić uruchamianie zadań w kontenerach. Wszystkie zwykłe zadania i zadania menedżera zadań są uruchamiane w tej puli, muszą określać właściwość containerSettings, a wszystkie inne zadania mogą je określać. ContainerConfiguration
dataDisks Tę właściwość należy określić, jeśli węzły obliczeniowe w puli muszą mieć dołączone puste dyski danych. DataDisk[]
diskEncryptionConfiguration Jeśli to określone, szyfrowanie jest wykonywane w każdym węźle w puli podczas aprowizacji węzła. DiskEncryptionConfiguration
imageReference Odwołanie do obrazu witryny Azure Virtual Machines Marketplace lub zasobu Obraz platformy Azure niestandardowej maszyny wirtualnej. Aby uzyskać listę wszystkich obrazówReferences zweryfikowanych przez Azure Batch, zobacz operację "Lista obsługiwanych jednostek SKU agenta węzła". ImageReference (wymagane)
licenseType Dotyczy to tylko obrazów, które zawierają 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. Jeśli pominięto, nie zastosowano rabatu na licencjonowanie lokalne. Wartości to:

Windows_Server — licencja lokalna jest przeznaczona dla systemu Windows Server.
Windows_Client — licencja lokalna jest przeznaczona dla klienta systemu Windows.
ciąg
nodeAgentSkuId Agent węzła usługi Batch to program uruchamiany w każdym węźle w puli i zapewnia interfejs poleceń 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)
windowsConfiguration Nie można określić tej właściwości, jeśli obrazReference określa obraz systemu operacyjnego Linux. Konfiguracja systemu Windows

ContainerConfiguration

Nazwa Opis Wartość
containerImageNames Jest to pełne odwołanie do obrazu, które zostanie określone jako "ściąganie platformy Docker". Obraz zostanie uzyskany z domyślnego rejestru platformy Docker, chyba że obraz jest w pełni kwalifikowany z alternatywnym rejestrem. ciąg[]
containerRegistries Jeśli jakiekolwiek obrazy muszą zostać pobrane z rejestru prywatnego, który wymaga poświadczeń, należy podać te poświadczenia tutaj. ContainerRegistry[]
typ Technologia kontenera do użycia. "DockerCompatible" (wymagane)

ContainerRegistry

Nazwa Opis Wartość
hasło Hasło do logowania się na serwerze rejestru. ciąg (wymagany)
registryServer Jeśli pominięto, wartość domyślna to "docker.io". ciąg
nazwa użytkownika Nazwa użytkownika do logowania się na serwerze rejestru. ciąg (wymagany)

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żdy powinien mieć odrębną jednostkę lun. Wartość musi należeć do zakresu od 0 do 63 włącznie. int (wymagane)
storageAccountType Jeśli pominięto, 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"

DiskEncryptionConfiguration

Nazwa Opis Wartość
Cele W puli systemu Linux obsługiwana jest tylko opcja "TemporaryDisk"; w puli systemu Windows należy określić "OsDisk" i "TemporaryDisk". Tablica ciągów zawierająca dowolną z:
"OsDisk"
"TemporaryDisk"

ImageReference

Nazwa Opis Wartość
identyfikator Ta właściwość wzajemnie wyklucza się z innymi właściwościami. Obraz Shared Image Gallery musi mieć repliki w tym samym regionie co konto Azure Batch. Aby uzyskać informacje o ustawieniach zapory dla agenta węzła usługi Batch do komunikowania się z usługą Batch, zobacz https://docs.microsoft.com/azure/batch/batch-api-basics#virtual-network-vnet-and-firewall-configuration. ciąg
offer Na przykład UbuntuServer lub WindowsServer. ciąg
publisher Na przykład Canonical lub MicrosoftWindowsServer. ciąg
sku Na przykład 18.04-LTS lub 2019-Datacenter. ciąg
Wersja Można określić wartość "latest", aby wybrać najnowszą wersję obrazu. W przypadku pominięcia wartość domyślna to "latest". ciąg

Konfiguracja systemu Windows

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

Metadataitem

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

Konfiguracja instalacji

Nazwa Opis Wartość
azureBlobFileSystemConfiguration Ta właściwość wyklucza się wzajemnie ze wszystkimi innymi właściwościami. AzureBlobFileSystemConfiguration
azureFileShareConfiguration Ta właściwość wyklucza się wzajemnie ze wszystkimi innymi właściwościami. AzureFileShareConfiguration
cifsMountConfiguration Ta właściwość wyklucza się wzajemnie ze wszystkimi innymi właściwościami. CifsMountConfiguration
nfsMountConfiguration Ta właściwość wyklucza się wzajemnie ze wszystkimi innymi właściwościami. NFSMountConfiguration

AzureBlobFileSystemConfiguration

Nazwa Opis Wartość
accountKey Ta właściwość wyklucza się wzajemnie z kluczem sasKey i należy określić jedną z nich. ciąg
accountName Nazwa konta usługi Azure Storage. ciąg (wymagany)
blobfuseOptions Są to opcje "net use" w systemie Windows i opcje instalacji w systemie Linux. ciąg
containerName Nazwa kontenera Azure Blob Storage. ciąg (wymagany)
relativeMountPath 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. ciąg (wymagany)
sasKey Ta właściwość wyklucza się wzajemnie z właściwością accountKey i należy określić jedną z nich. ciąg

AzureFileShareConfiguration

Nazwa Opis Wartość
accountKey Klucz konta usługi Azure Storage. ciąg (wymagany)
accountName Nazwa konta usługi Azure Storage. ciąg (wymagany)
azureFileUrl Jest to formularz "https://{account}.file.core.windows.net/". ciąg (wymagany)
mountOptions Są to opcje "net use" w systemie Windows i opcje instalacji w systemie Linux. ciąg
relativeMountPath 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. ciąg (wymagany)

CifsMountConfiguration

Nazwa Opis Wartość
mountOptions Są to opcje "net use" w systemie Windows i opcje instalacji w systemie Linux. ciąg
hasło Hasło używane do uwierzytelniania w systemie plików CIFS. ciąg (wymagany)
relativeMountPath 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. ciąg (wymagany)
source Identyfikator URI systemu plików do zainstalowania. ciąg (wymagany)
nazwa użytkownika Użytkownik, który ma być używany do uwierzytelniania w systemie plików CIFS. ciąg (wymagany)

NFSMountConfiguration

Nazwa Opis Wartość
mountOptions Są to opcje "net use" w systemie Windows i opcje instalacji w systemie Linux. ciąg
relativeMountPath 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. ciąg (wymagany)
source Identyfikator URI systemu plików do zainstalowania. ciąg (wymagany)

Konfiguracja sieci

Nazwa Opis Wartość
endpointConfiguration Konfiguracja punktu końcowego puli jest obsługiwana tylko w pulach z właściwością virtualMachineConfiguration. PoolEndpointConfiguration
publicIPAddressConfiguration Ta właściwość jest obsługiwana tylko w pulach z właściwością virtualMachineConfiguration. PublicIPAddressConfiguration
subnetId 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 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ę "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 obliczeniowych. Można to zweryfikować, 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. 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 za pomocą konfiguracji maszyny wirtualnej włącz porty 29876 i 29877 oraz port 22 dla systemu Linux i port 3389 dla systemu Windows. W przypadku pul utworzonych za pomocą 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. W przypadku pul cloudServiceConfiguration obsługiwane są tylko klasyczne sieci wirtualne. Aby uzyskać więcej informacji, zobacz: https://docs.microsoft.com/azure/batch/batch-api-basics#virtual-network-vnet-and-firewall-configuration ciąg

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. Nie można go określić, jeśli parametr IPAddressProvisioningType ma wartość NoPublicIPAddresses. InboundNatPool[] (wymagane)

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 jakiekolwiek wartości zarezerwowane zostaną dostarczone, żą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 zastrzeżone lub nakładające się wartości są dostarczane żądanie koń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 zastrzeżone lub nakładające się wartości są dostarczane żądanie kończy się niepowodzeniem z kodem stanu HTTP 400. int (wymagane)
name 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 jakiekolwiek 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ć dla wszystkich punktów 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)

NetworkSecurityGroupRule

Nazwa Opis Wartość
access Akcja, która powinna zostać podjęta dla określonego adresu IP, zakresu podsieci lub tagu. "Zezwalaj"
"Odmów" (wymagane)
priority Priorytety w puli muszą być unikatowe i oceniane według priorytetu. Im niższy numer, tym wyższy priorytet. Na przykład można określić reguły z liczbami zamówień 150, 250 i 350. Reguła o kolejności 150 ma pierwszeństwo przed regułą, która ma kolejność 250. Dozwolone priorytety to od 150 do 4096. Jeśli jakiekolwiek zastrzeżone lub zduplikowane wartości 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)
sourcePortRanges Prawidłowe wartości to "*" (dla wszystkich portów od 0 do 65535) lub tablice portów lub zakresów portów (tj. 100–200). Porty powinny mieścić się w zakresie od 0 do 65535, a zakresy portów lub porty nie mogą się nakładać. Jeśli podano inne wartości, żądanie kończy się niepowodzeniem z kodem stanu HTTP 400. Wartość domyślna to *. ciąg[]

PublicIPAddressConfiguration

Nazwa Opis Wartość
ipAddressIds Liczba adresów IP określonych w tym miejscu ogranicza maksymalny rozmiar puli — 100 dedykowanych węzłów lub 100 węzłów o niskim priorytetu można przydzielić dla każdego publicznego adresu IP. Na przykład pula, która potrzebuje 250 dedykowanych maszyn wirtualnych, będzie potrzebować co najmniej 3 publicznych adresów IP określonych. Każdy element tej kolekcji ma postać: /subscriptions/{subscription}/resourceGroups/{group}/providers/Microsoft.Network/publicIPAddresses/{ip}. ciąg[]
Przepis Wartość domyślna to BatchManaged "BatchManaged"
"NoPublicIPAddresses"
"UserManaged"

ScaleSettings

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

AutoSkalowanieUstawienia

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

FixedScaleSettings

Nazwa Opis Wartość
nodeDeallocationOption Jeśli pominięto, wartość domyślna to Requeue. "Ponowne kolejki"
"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 protokołu PT10M przez 10 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). ciąg
targetDedicatedNodes Należy ustawić co najmniej jeden z węzłów targetDedicatedNodes. int
targetLowPriorityNodes Należy ustawić co najmniej jeden z węzłów targetDedicatedNodes. int

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 przy użyciu polecenia "cmd /c MyCommand" w systemie Windows lub "/bin/sh -c MyCommand" w systemie Linux. Wymagane, jeśli określono inne właściwości elementu startTask. ciąg
containerSettings Po określeniu tej wartości wszystkie katalogi cyklicznie poniżej AZ_BATCH_NODE_ROOT_DIR (katalog główny katalogów Azure Batch w węźle) są mapowane na kontener, wszystkie zmienne środowiskowe zadania są mapowane do kontenera, a wiersz polecenia zadania jest wykonywany w kontenerze. TaskContainerSettings
environmentSettings Lista ustawień zmiennych środowiskowych dla zadania uruchamiania. EnvironmentSetting[]
maxTaskRetryCount 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. 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 do 4 razy (jedna początkowa próba i 3 ponownych prób). Jeśli maksymalna liczba ponownych prób wynosi 0, usługa Batch nie ponowi próby wykonania zadania. Jeśli maksymalna liczba ponownych prób to -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 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 zaplanuje zadań do wykonania. 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 true. bool

TaskContainerSettings

Nazwa Opis Wartość
containerRunOptions Te dodatkowe opcje są dostarczane jako argumenty polecenia "docker create" oprócz tych kontrolowanych przez usługę Batch. ciąg
Imagename Jest to pełne odwołanie do obrazu, które zostanie określone jako "ściąganie platformy Docker". Jeśli tag nie zostanie podany jako część nazwy obrazu, tag ":latest" jest używany jako domyślny. ciąg (wymagany)
registry To ustawienie można pominąć, jeśli zostało już udostępnione podczas tworzenia puli. ContainerRegistry
Workingdirectory Flaga wskazująca, gdzie znajduje się katalog roboczy zadania kontenera. Wartość domyślna to "taskWorkingDirectory". "ContainerImageDefault"
"TaskWorkingDirectory"

EnvironmentSetting

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

ResourceFile

Nazwa Opis Wartość
autoStorageContainerName Właściwości autoStorageContainerName, storageContainerUrl i httpUrl wzajemnie się wykluczają i należy określić jedną z nich. ciąg
blobPrefix Właściwość jest prawidłowa tylko wtedy, gdy jest używana właściwość autoStorageContainerName lub storageContainerUrl. Ten prefiks może być częściową nazwą pliku lub podkatalogem. Jeśli prefiks nie zostanie określony, zostaną pobrane wszystkie pliki w kontenerze. ciąg
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 domyślna wartość 0770. ciąg
Filepath Jeśli określono właściwość httpUrl, parametr filePath jest wymagany i opisuje ścieżkę, do której zostanie pobrany plik, w tym nazwę pliku. W przeciwnym razie, jeśli określono właściwość autoStorageContainerName lub storageContainerUrl, parametr filePath jest opcjonalny i jest katalogem do pobrania plików. W przypadku, gdy parametr filePath jest używany jako katalog, każda struktura katalogów skojarzona już 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 przerwać katalogu roboczego zadania (na przykład przy użyciu '.'). ciąg
httpUrl Właściwości autoStorageContainerName, storageContainerUrl i httpUrl wzajemnie się wykluczają i należy określić jedną z nich. Jeśli adres URL jest Azure Blob Storage, 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 uzyskania 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
storageContainerUrl 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 przy użyciu dostępu anonimowego; oznacza to, że usługa Batch nie przedstawia żadnych poświadczeń podczas pobierania obiektu blob. Istnieją dwa sposoby uzyskania takiego adresu URL dla obiektu blob w usłudze Azure Storage: obejmują sygnaturę dostępu współdzielonego udzielając uprawnień do odczytu i listy dla obiektu blob lub ustaw listę ACL dla obiektu blob lub kontenera, aby zezwolić na dostęp publiczny. ciąg

UserIdentity

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. ciąg

AutoUserSpecification

Nazwa Opis Wartość
elevationLevel Wartość domyślna to nonAdmin. "Administracja"
"NonAdmin"
scope Wartość domyślna to Pula. Jeśli pula jest uruchomiona w systemie Windows, należy określić wartość Zadanie, jeśli wymagana jest ściślejsza izolacja między zadaniami. Na przykład jeśli zadanie 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óre nie powinny być dostępne przez zwykłe zadania, ale powinny być dostępne przez zadania uruchamiania. "Pula"
"Zadanie"

TaskSchedulingPolicy

Nazwa Opis Wartość
nodeFillType Jak zadania powinny być dystrybuowane 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. "Administracja"
"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 z opcjami domyślnymi. LinuxUserConfiguration
name Nazwa konta użytkownika. ciąg (wymagany)
hasło Hasło do konta użytkownika. ciąg (wymagany)
windowsUserConfiguration Tę właściwość można określić tylko wtedy, gdy użytkownik znajduje się w puli systemu Windows. Jeśli nie określono wartości i w puli systemu Windows, użytkownik zostanie utworzony z opcjami domyślnymi. WindowsUserConfiguration

LinuxUserConfiguration

Nazwa Opis Wartość
Gid Właściwości uid i gid muszą być określone razem lub nie w ogóle. Jeśli nie określono bazowego systemu operacyjnego, wybierze 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). W tym celu należy umieścić 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 (nie jest wykonywana żadna modyfikacja katalogu .ssh użytkownika). ciąg
Identyfikator UID Właściwości uid i gid muszą być określone razem lub nie w ogóle. Jeśli nie określono bazowego systemu operacyjnego, wybierze identyfikator uid. int

WindowsUserConfiguration

Nazwa Opis Wartość
Loginmode Określa tryb logowania użytkownika. Wartość domyślna dla pul VirtualMachineConfiguration to tryb interaktywny, a w przypadku pul CloudServiceConfiguration jest tryb wsadowy. "Batch"
"Interakcyjny"

Szablony szybkiego startu

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

Template Opis
pula Azure Batch bez publicznych adresów IP

Wdróż na platformie Azure
Ten szablon tworzy Azure Batch uproszczoną pulę komunikacji węzłów bez publicznych adresów IP.

Definicja zasobu narzędzia Terraform (dostawcy AzAPI)

Typ zasobu batchAccounts/pule 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 dziennik 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@2020-09-01"
  name = "string"
  parent_id = "string"
  body = jsonencode({
    properties = {
      applicationLicenses = [
        "string"
      ]
      applicationPackages = [
        {
          id = "string"
          version = "string"
        }
      ]
      certificates = [
        {
          id = "string"
          storeLocation = "string"
          storeName = "string"
          visibility = [
            "string"
          ]
        }
      ]
      deploymentConfiguration = {
        cloudServiceConfiguration = {
          osFamily = "string"
          osVersion = "string"
        }
        virtualMachineConfiguration = {
          containerConfiguration = {
            containerImageNames = [
              "string"
            ]
            containerRegistries = [
              {
                password = "string"
                registryServer = "string"
                username = "string"
              }
            ]
            type = "DockerCompatible"
          }
          dataDisks = [
            {
              caching = "string"
              diskSizeGB = int
              lun = int
              storageAccountType = "string"
            }
          ]
          diskEncryptionConfiguration = {
            targets = [
              "string"
            ]
          }
          imageReference = {
            id = "string"
            offer = "string"
            publisher = "string"
            sku = "string"
            version = "string"
          }
          licenseType = "string"
          nodeAgentSkuId = "string"
          windowsConfiguration = {
            enableAutomaticUpdates = bool
          }
        }
      }
      displayName = "string"
      interNodeCommunication = "string"
      metadata = [
        {
          name = "string"
          value = "string"
        }
      ]
      mountConfiguration = [
        {
          azureBlobFileSystemConfiguration = {
            accountKey = "string"
            accountName = "string"
            blobfuseOptions = "string"
            containerName = "string"
            relativeMountPath = "string"
            sasKey = "string"
          }
          azureFileShareConfiguration = {
            accountKey = "string"
            accountName = "string"
            azureFileUrl = "string"
            mountOptions = "string"
            relativeMountPath = "string"
          }
          cifsMountConfiguration = {
            mountOptions = "string"
            password = "string"
            relativeMountPath = "string"
            source = "string"
            username = "string"
          }
          nfsMountConfiguration = {
            mountOptions = "string"
            relativeMountPath = "string"
            source = "string"
          }
        }
      ]
      networkConfiguration = {
        endpointConfiguration = {
          inboundNatPools = [
            {
              backendPort = int
              frontendPortRangeEnd = int
              frontendPortRangeStart = int
              name = "string"
              networkSecurityGroupRules = [
                {
                  access = "string"
                  priority = int
                  sourceAddressPrefix = "string"
                  sourcePortRanges = [
                    "string"
                  ]
                }
              ]
              protocol = "string"
            }
          ]
        }
        publicIPAddressConfiguration = {
          ipAddressIds = [
            "string"
          ]
          provision = "string"
        }
        subnetId = "string"
      }
      scaleSettings = {
        autoScale = {
          evaluationInterval = "string"
          formula = "string"
        }
        fixedScale = {
          nodeDeallocationOption = "string"
          resizeTimeout = "string"
          targetDedicatedNodes = int
          targetLowPriorityNodes = int
        }
      }
      startTask = {
        commandLine = "string"
        containerSettings = {
          containerRunOptions = "string"
          imageName = "string"
          registry = {
            password = "string"
            registryServer = "string"
            username = "string"
          }
          workingDirectory = "string"
        }
        environmentSettings = [
          {
            name = "string"
            value = "string"
          }
        ]
        maxTaskRetryCount = int
        resourceFiles = [
          {
            autoStorageContainerName = "string"
            blobPrefix = "string"
            fileMode = "string"
            filePath = "string"
            httpUrl = "string"
            storageContainerUrl = "string"
          }
        ]
        userIdentity = {
          autoUser = {
            elevationLevel = "string"
            scope = "string"
          }
          userName = "string"
        }
        waitForSuccess = bool
      }
      taskSchedulingPolicy = {
        nodeFillType = "string"
      }
      taskSlotsPerNode = int
      userAccounts = [
        {
          elevationLevel = "string"
          linuxUserConfiguration = {
            gid = int
            sshPrivateKey = "string"
            uid = int
          }
          name = "string"
          password = "string"
          windowsUserConfiguration = {
            loginMode = "string"
          }
        }
      ]
      vmSize = "string"
    }
  })
}

Wartości właściwości

batchAccounts/pule

Nazwa Opis Wartość
typ Typ zasobu "Microsoft.Batch/batchAccounts/pools@2020-09-01"
name Nazwa zasobu ciąg (wymagany)

Limit znaków: 1–64

Prawidłowe znaki:
Alfanumeryczne, podkreślenia i łączniki.
parent_id Identyfikator zasobu, który jest elementem nadrzędnym dla tego zasobu. Identyfikator zasobu typu: batchAccounts
properties Właściwości skojarzone z pulą. PoolProperties

PoolProperties

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. ciąg[]
applicationPackages Zmiany odwołań do pakietu 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 zostaną ponownie wyświetlone. W dowolnej puli istnieje maksymalnie 10 odwołań do pakietu aplikacji. 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 do wykonywania zapytań dotyczących tej lokalizacji. 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 usługi CloudServiceConfiguration określa, że węzły powinny tworzyć przy użyciu usługi Azure Cloud Services (PaaS), podczas gdy usługa 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. ciąg
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 "Wyłączone". "Wyłączone"
"Włączone"
metadane Usługa Batch nie przypisuje żadnego znaczenia do metadanych; służy wyłącznie do używania kodu użytkownika. MetadataItem[]
mountConfiguration Obsługuje to Azure Files, NFS, CIFS/SMB i Blobfuse. MountConfiguration[]
networkConfiguration Konfiguracja sieci dla puli. Konfiguracja sieci
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 miała stałą skalę z 0 elementami 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 Jeśli nie zostanie określony, wartość domyślna zostanie rozłożona. TaskSchedulingPolicy
taskSlotsPerNode Wartość domyślna to 1. Maksymalna wartość jest mniejsza niż 4 razy mniejsza liczba rdzeni maszyny wirtualnej VmSize puli lub 256. int
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 Cloud Services (pule utworzone za pomocą usługi cloudServiceConfiguration), zobacz Rozmiary dla Cloud Services (https://azure.microsoft.com/documentation/articles/cloud-services-sizes-specs/). Usługa Batch obsługuje wszystkie rozmiary maszyn wirtualnych Cloud Services z wyjątkiem ExtraSmall. Aby uzyskać informacje o dostępnych rozmiarach maszyn wirtualnych dla pul korzystających z obrazów z witryny Virtual Machines Marketplace (pule utworzone za pomocą funkcji virtualMachineConfiguration) zobacz Rozmiary dla Virtual Machines (Linux) (/azure/virtual-machines/sizes-general) lub Sizes for Virtual Machines (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). ciąg

ApplicationPackageReference

Nazwa Opis Wartość
identyfikator Identyfikator pakietu aplikacji do zainstalowania. Musi to być na tym samym koncie wsadowym co pula. Może to być odwołanie do określonej wersji lub domyślnej wersji, 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. ciąg

CertyfikatReference

Nazwa Opis Wartość
identyfikator W pełni kwalifikowany identyfikator certyfikatu do zainstalowania w puli. Musi to być na tym samym koncie wsadowym 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 tworzonych za pomocą elementu 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 do wykonywania zapytań dotyczących tej lokalizacji. 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 tworzonych za pomocą elementu 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. ciąg
widoczność Które konta użytkowników w węźle obliczeniowym powinny mieć dostęp do prywatnych danych certyfikatu. Tablica ciągów zawierająca dowolną z:
"RemoteUser"
"StartTask"
"Zadanie"

DeploymentConfiguration

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

CloudServiceConfiguration

Nazwa Opis Wartość
osFamily Możliwe wartości to: 2 — rodzina systemu operacyjnego 2, równoważna windows Server 2008 R2 SP1. 3 — Rodzina systemu operacyjnego 3, równoważna Windows Server 2012. 4 — Rodzina systemu operacyjnego 4, równoważna Windows Server 2012 R2. 5 — Rodzina systemu operacyjnego 5, równoważna Windows Server 2016. 6 — Rodzina systemu operacyjnego 6, odpowiednik systemu Windows Server 2019. 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)
osVersion Wartość domyślna to * określająca najnowszą wersję systemu operacyjnego dla określonej rodziny systemu operacyjnego. ciąg

VirtualMachineConfiguration

Nazwa Opis Wartość
containerConfiguration Jeśli zostanie określony, konfiguracja jest wykonywana w każdym węźle w puli, aby umożliwić uruchamianie zadań w kontenerach. Wszystkie zwykłe zadania i zadania menedżera zadań są uruchamiane w tej puli, muszą określać właściwość containerSettings, a wszystkie inne zadania mogą je określać. ContainerConfiguration
dataDisks Tę właściwość należy określić, jeśli węzły obliczeniowe w puli muszą mieć dołączone puste dyski danych. DataDisk[]
diskEncryptionConfiguration Jeśli to określone, szyfrowanie jest wykonywane w każdym węźle w puli podczas aprowizacji węzła. DiskEncryptionConfiguration
imageReference Odwołanie do obrazu witryny Azure Virtual Machines Marketplace lub zasobu Obraz platformy Azure niestandardowej maszyny wirtualnej. Aby uzyskać listę wszystkich obrazówReferences zweryfikowanych przez Azure Batch, zobacz operację "Lista obsługiwanych jednostek SKU agenta węzła". ImageReference (wymagane)
licenseType Dotyczy to tylko obrazów, które zawierają 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. Jeśli pominięto, nie zastosowano rabatu na licencjonowanie lokalne. Wartości to:

Windows_Server — licencja lokalna jest przeznaczona dla systemu Windows Server.
Windows_Client — licencja lokalna jest przeznaczona dla klienta systemu Windows.
ciąg
nodeAgentSkuId Agent węzła usługi Batch to program uruchamiany w każdym węźle w puli i zapewnia interfejs poleceń 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)
windowsConfiguration Nie można określić tej właściwości, jeśli obrazReference określa obraz systemu operacyjnego Linux. Konfiguracja systemu Windows

ContainerConfiguration

Nazwa Opis Wartość
containerImageNames Jest to pełne odwołanie do obrazu, które zostanie określone jako "ściąganie platformy Docker". Obraz zostanie uzyskany z domyślnego rejestru platformy Docker, chyba że obraz jest w pełni kwalifikowany z alternatywnym rejestrem. ciąg[]
containerRegistries Jeśli jakiekolwiek obrazy muszą zostać pobrane z rejestru prywatnego, który wymaga poświadczeń, należy podać te poświadczenia tutaj. ContainerRegistry[]
typ Technologia kontenera do użycia. "DockerCompatible" (wymagane)

ContainerRegistry

Nazwa Opis Wartość
hasło Hasło do logowania się na serwerze rejestru. ciąg (wymagany)
registryServer Jeśli pominięto, wartość domyślna to "docker.io". ciąg
nazwa użytkownika Nazwa użytkownika do logowania się na serwerze rejestru. ciąg (wymagany)

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żdy powinien mieć odrębną jednostkę lun. Wartość musi należeć do zakresu od 0 do 63 włącznie. int (wymagane)
storageAccountType Jeśli pominięto, 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"

DiskEncryptionConfiguration

Nazwa Opis Wartość
Cele W puli systemu Linux obsługiwana jest tylko opcja "TemporaryDisk"; w puli systemu Windows należy określić "OsDisk" i "TemporaryDisk". Tablica ciągów zawierająca dowolną z:
"OsDisk"
"TemporaryDisk"

ImageReference

Nazwa Opis Wartość
identyfikator Ta właściwość wzajemnie wyklucza się z innymi właściwościami. Obraz Shared Image Gallery musi mieć repliki w tym samym regionie co konto Azure Batch. Aby uzyskać informacje o ustawieniach zapory dla agenta węzła usługi Batch do komunikowania się z usługą Batch, zobacz https://docs.microsoft.com/azure/batch/batch-api-basics#virtual-network-vnet-and-firewall-configuration. ciąg
offer Na przykład UbuntuServer lub WindowsServer. ciąg
publisher Na przykład Canonical lub MicrosoftWindowsServer. ciąg
sku Na przykład 18.04-LTS lub 2019-Datacenter. ciąg
Wersja Można określić wartość "latest", aby wybrać najnowszą wersję obrazu. Jeśli pominięto, wartość domyślna to "latest". ciąg

Konfiguracja systemu Windows

Nazwa Opis Wartość
enableAutomaticUpdates Jeśli pominięto, wartość domyślna to true. bool

Metadataitem

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

InstalacjaKonfiguracja

Nazwa Opis Wartość
azureBlobFileSystemConfiguration Ta właściwość wyklucza się wzajemnie ze wszystkimi innymi właściwościami. AzureBlobFileSystemConfiguration
azureFileShareConfiguration Ta właściwość wyklucza się wzajemnie ze wszystkimi innymi właściwościami. AzureFileShareConfiguration
cifsMountConfiguration Ta właściwość wyklucza się wzajemnie ze wszystkimi innymi właściwościami. CifsMountConfiguration
nfsMountConfiguration Ta właściwość wyklucza się wzajemnie ze wszystkimi innymi właściwościami. NFSMountConfiguration

AzureBlobFileSystemConfiguration

Nazwa Opis Wartość
accountKey Ta właściwość wyklucza się wzajemnie z kluczem sasKey i należy określić jedną z nich. ciąg
accountName Nazwa konta usługi Azure Storage. ciąg (wymagany)
blobfuseOptions Są to opcje "net use" w systemach Windows i "instalowanie" w systemie Linux. ciąg
containerName Nazwa kontenera Azure Blob Storage. ciąg (wymagany)
relativeMountPath 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. ciąg (wymagany)
sasKey Ta właściwość wzajemnie wyklucza się z wartością accountKey i należy je określić. ciąg

AzureFileShareConfiguration

Nazwa Opis Wartość
accountKey Klucz konta usługi Azure Storage. ciąg (wymagany)
accountName Nazwa konta usługi Azure Storage. ciąg (wymagany)
azureFileUrl Jest to formularz "https://{account}.file.core.windows.net/". ciąg (wymagany)
mountOptions Są to opcje "net use" w systemach Windows i "instalowanie" w systemie Linux. ciąg
relativeMountPath 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. ciąg (wymagany)

CifsMountConfiguration

Nazwa Opis Wartość
mountOptions Są to opcje "net use" w systemach Windows i "instalowanie" w systemie Linux. ciąg
hasło Hasło do użycia do uwierzytelniania w systemie plików CIFS. ciąg (wymagany)
relativeMountPath 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. ciąg (wymagany)
source Identyfikator URI systemu plików do zainstalowania. ciąg (wymagany)
nazwa użytkownika Użytkownik do użycia do uwierzytelniania w systemie plików CIFS. ciąg (wymagany)

NFSMountConfiguration

Nazwa Opis Wartość
mountOptions Są to opcje "net use" w systemach Windows i "instalowanie" w systemie Linux. ciąg
relativeMountPath 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. ciąg (wymagany)
source Identyfikator URI systemu plików do zainstalowania. ciąg (wymagany)

Konfiguracja sieci

Nazwa Opis Wartość
endpointConfiguration Konfiguracja punktu końcowego puli jest obsługiwana tylko w pulach z właściwością virtualMachineConfiguration. PoolEndpointConfiguration
publicIPAddressConfiguration Ta właściwość jest obsługiwana tylko w pulach z właściwością virtualMachineConfiguration. PublicIPAddressConfiguration
subnetId 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 w puli. Jeśli podsieć nie ma wystarczającej liczby bezpłatnych 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ę "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 umożliwić planowanie zadań w węzłach obliczeniowych. Można to zweryfikować, 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. 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 za pomocą konfiguracji maszyny wirtualnej włącz porty 29876 i 29877 oraz port 22 dla systemu Linux i port 3389 dla systemu Windows. W przypadku pul utworzonych za pomocą 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. W przypadku pul cloudServiceConfiguration obsługiwane są tylko "klasyczne" sieci wirtualne. Aby uzyskać więcej informacji, zobacz: https://docs.microsoft.com/azure/batch/batch-api-basics#virtual-network-vnet-and-firewall-configuration ciąg

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. Nie można tego określić, jeśli parametr IPAddressProvisioningType ma wartość NoPublicIPAddresses. InboundNatPool[] (wymagane)

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 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ć. Jeśli podano jakiekolwiek wartości zarezerwowane lub nakładające się na nie, żądanie koń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 z zakresu od 50000 do 55000, które są zarezerwowane. Wszystkie zakresy w puli muszą być odrębne i nie mogą się nakładać. Jeśli podano jakiekolwiek wartości zarezerwowane lub nakładające się na nie, żądanie kończy się niepowodzeniem z kodem stanu HTTP 400. int (wymagane)
name 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. 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 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)

NetworkSecurityGroupRule

Nazwa Opis Wartość
access Akcja, która powinna zostać podjęta dla określonego adresu IP, zakresu podsieci lub tagu. "Zezwalaj"
"Odmów" (wymagane)
priority 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. 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 kończy się niepowodzeniem z kodem stanu HTTP 400. ciąg (wymagany)
sourcePortRanges Prawidłowe wartości to "*" (dla wszystkich portów od 0 do 65535) lub tablice portów lub zakresów portów (tj. 100–200). Porty powinny mieścić się w zakresie od 0 do 65535, a zakresy portów lub porty nie mogą się nakładać. Jeśli podano inne wartości, żądanie kończy się niepowodzeniem z kodem stanu HTTP 400. Wartość domyślna to *. ciąg[]

PublicIPAddressConfiguration

Nazwa Opis Wartość
ipAddressIds Liczba adresów IP określonych w tym miejscu ogranicza maksymalny rozmiar puli — 100 dedykowanych węzłów lub 100 węzłów o niskim priorytetu można przydzielić dla każdego publicznego adresu IP. Na przykład pula, która potrzebuje 250 dedykowanych maszyn wirtualnych, będzie potrzebować co najmniej 3 publicznych adresów IP określonych. Każdy element tej kolekcji ma postać: /subscriptions/{subscription}/resourceGroups/{group}/providers/Microsoft.Network/publicIPAddresses/{ip}. ciąg[]
Przepis Wartość domyślna to BatchManaged "BatchManaged"
"NoPublicIPAddresses"
"UserManaged"

ScaleSettings

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

AutoSkalowanieUstawienia

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

FixedScaleSettings

Nazwa Opis Wartość
nodeDeallocationOption Jeśli pominięto, wartość domyślna to Requeue. "Ponowne kolejki"
"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 protokołu PT10M przez 10 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). ciąg
targetDedicatedNodes Należy ustawić co najmniej jeden z węzłów targetDedicatedNodes. int
targetLowPriorityNodes Należy ustawić co najmniej jeden z węzłów targetDedicatedNodes. int

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 przy użyciu polecenia "cmd /c MyCommand" w systemie Windows lub "/bin/sh -c MyCommand" w systemie Linux. Wymagane, jeśli określono inne właściwości elementu startTask. ciąg
containerSettings Po określeniu tej wartości wszystkie katalogi cyklicznie poniżej AZ_BATCH_NODE_ROOT_DIR (katalog główny katalogów Azure Batch w węźle) są mapowane na kontener, wszystkie zmienne środowiskowe zadania są mapowane do kontenera, a wiersz polecenia zadania jest wykonywany w kontenerze. TaskContainerSettings
environmentSettings Lista ustawień zmiennych środowiskowych dla zadania uruchamiania. EnvironmentSetting[]
maxTaskRetryCount 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. 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 nie powiedzie się 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 wszystkich ponownych próbach, usługa Batch oznacza węzeł obliczeniowy jako bezużyteczny i nie będzie planować zadań podrzędnych. Ten warunek można wykryć za pośrednictwem szczegółów stanu węzła i planowania błędu. 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 podrzędne 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 true. bool

TaskContainerSettings

Nazwa Opis Wartość
containerRunOptions Te dodatkowe opcje są dostarczane jako argumenty polecenia "docker create" oprócz tych kontrolowanych przez usługę Batch. ciąg
Imagename Jest to pełne odwołanie do obrazu, które zostanie określone jako "ściąganie platformy Docker". Jeśli tag nie zostanie podany jako część nazwy obrazu, tag ":latest" jest używany jako domyślny. ciąg (wymagany)
registry To ustawienie można pominąć, jeśli zostało już udostępnione podczas tworzenia puli. ContainerRegistry
Workingdirectory Flaga wskazująca, gdzie znajduje się katalog roboczy zadania kontenera. Wartość domyślna to "taskWorkingDirectory". "ContainerImageDefault"
"TaskWorkingDirectory"

EnvironmentSetting

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

ResourceFile

Nazwa Opis Wartość
autoStorageContainerName Właściwości autoStorageContainerName, storageContainerUrl i httpUrl wzajemnie się wykluczają i należy określić jedną z nich. ciąg
blobPrefix Właściwość jest prawidłowa tylko wtedy, gdy jest używana właściwość autoStorageContainerName lub storageContainerUrl. Ten prefiks może być częściową nazwą pliku lub podkatalogem. Jeśli prefiks nie zostanie określony, zostaną pobrane wszystkie pliki w kontenerze. ciąg
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 domyślna wartość 0770. ciąg
Filepath Jeśli określono właściwość httpUrl, parametr filePath jest wymagany i opisuje ścieżkę, do której zostanie pobrany plik, w tym nazwę pliku. W przeciwnym razie, jeśli określono właściwość autoStorageContainerName lub storageContainerUrl, parametr filePath jest opcjonalny i jest katalogem do pobrania plików. W przypadku, gdy parametr filePath jest używany jako katalog, każda struktura katalogów skojarzona już 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 przerwać katalogu roboczego zadania (na przykład przy użyciu '.'). ciąg
httpUrl Właściwości autoStorageContainerName, storageContainerUrl i httpUrl wzajemnie się wykluczają i należy określić jedną z nich. Jeśli adres URL jest Azure Blob Storage, 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 uzyskania 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
storageContainerUrl 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 przy użyciu dostępu anonimowego; oznacza to, że usługa Batch nie przedstawia żadnych poświadczeń podczas pobierania obiektu blob. Istnieją dwa sposoby uzyskania takiego adresu URL dla obiektu blob w usłudze Azure Storage: obejmują sygnaturę dostępu współdzielonego udzielając uprawnień do odczytu i listy dla obiektu blob lub ustaw listę ACL dla obiektu blob lub kontenera, aby zezwolić na dostęp publiczny. ciąg

UserIdentity

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. ciąg

AutoUserSpecification

Nazwa Opis Wartość
elevationLevel Wartość domyślna to nonAdmin. "Administracja"
"NonAdmin"
scope Wartość domyślna to Pula. Jeśli pula jest uruchomiona w systemie Windows, należy określić wartość Zadanie, jeśli wymagana jest ściślejsza izolacja między zadaniami. Na przykład jeśli zadanie 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óre nie powinny być dostępne przez zwykłe zadania, ale powinny być dostępne przez zadania uruchamiania. "Pula"
"Zadanie"

TaskSchedulingPolicy

Nazwa Opis Wartość
nodeFillType Jak zadania powinny być dystrybuowane 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. "Administracja"
"NonAdmin"
linuxUserConfiguration Ta właściwość jest ignorowana, jeśli została określona w puli systemu Windows. Jeśli nie zostanie określony, użytkownik zostanie utworzony przy użyciu opcji domyślnych. LinuxUserConfiguration
name Nazwa konta użytkownika. ciąg (wymagany)
hasło Hasło do konta użytkownika. ciąg (wymagany)
windowsUserConfiguration Tę właściwość można określić tylko wtedy, gdy użytkownik znajduje się w puli systemu Windows. Jeśli nie zostanie określony i w puli systemu Windows, użytkownik zostanie utworzony przy użyciu opcji domyślnych. Konfiguracja użytkownika systemu Windows

LinuxUserConfiguration

Nazwa Opis Wartość
Gid 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. 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). W tym celu należy umieścić 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 (nie jest wykonywana żadna modyfikacja katalogu ssh użytkownika). ciąg
Identyfikator UID 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. int

Konfiguracja użytkownika systemu Windows

Nazwa Opis Wartość
Loginmode Określa tryb logowania użytkownika. Wartość domyślna dla pul VirtualMachineConfiguration to tryb interaktywny, a w przypadku pul CloudServiceConfiguration jest tryb wsadowy. "Batch"
"Interakcyjne"