Delen via


Microsoft.Batch batchAccounts/pools 2022-01-01

Bicep-resourcedefinitie

Het resourcetype batchAccounts/pools kan worden geïmplementeerd met bewerkingen die zijn gericht op:

Zie logboek wijzigenvoor een lijst met gewijzigde eigenschappen in elke API-versie.

Resource-indeling

Als u een Resource Microsoft.Batch/batchAccounts/pools wilt maken, voegt u de volgende Bicep toe aan uw sjabloon.

resource symbolicname 'Microsoft.Batch/batchAccounts/pools@2022-01-01' = {
  name: 'string'
  parent: resourceSymbolicName
  identity: {
    type: 'string'
    userAssignedIdentities: {
      {customized property}: {}
    }
  }
  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: [
            {
              identityReference: {
                resourceId: 'string'
              }
              password: 'string'
              registryServer: 'string'
              username: 'string'
            }
          ]
          type: 'DockerCompatible'
        }
        dataDisks: [
          {
            caching: 'string'
            diskSizeGB: int
            lun: int
            storageAccountType: 'string'
          }
        ]
        diskEncryptionConfiguration: {
          targets: [
            'string'
          ]
        }
        extensions: [
          {
            autoUpgradeMinorVersion: bool
            name: 'string'
            protectedSettings: any()
            provisionAfterExtensions: [
              'string'
            ]
            publisher: 'string'
            settings: any()
            type: 'string'
            typeHandlerVersion: 'string'
          }
        ]
        imageReference: {
          id: 'string'
          offer: 'string'
          publisher: 'string'
          sku: 'string'
          version: 'string'
        }
        licenseType: 'string'
        nodeAgentSkuId: 'string'
        nodePlacementConfiguration: {
          policy: 'string'
        }
        osDisk: {
          ephemeralOSDiskSettings: {
            placement: 'CacheDisk'
          }
        }
        windowsConfiguration: {
          enableAutomaticUpdates: bool
        }
      }
    }
    displayName: 'string'
    interNodeCommunication: 'string'
    metadata: [
      {
        name: 'string'
        value: 'string'
      }
    ]
    mountConfiguration: [
      {
        azureBlobFileSystemConfiguration: {
          accountKey: 'string'
          accountName: 'string'
          blobfuseOptions: 'string'
          containerName: 'string'
          identityReference: {
            resourceId: '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: {
      dynamicVNetAssignmentScope: 'string'
      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: {
          identityReference: {
            resourceId: 'string'
          }
          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'
          identityReference: {
            resourceId: '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'
  }
}

Eigenschapswaarden

batchAccounts/pools

Naam Beschrijving Waarde
naam De resourcenaam

Zie hoe u namen en typen instelt voor onderliggende resources in Bicep-.
tekenreeks (vereist)

Tekenlimiet: 1-64

Geldige tekens:
Alfanumerieke tekst, onderstrepingstekens en afbreekstreepjes.
ouder In Bicep kunt u de bovenliggende resource voor een onderliggende resource opgeven. U hoeft deze eigenschap alleen toe te voegen wanneer de onderliggende resource buiten de bovenliggende resource wordt gedeclareerd.

Zie onderliggende resource buiten de bovenliggende resourcevoor meer informatie.
Symbolische naam voor resource van het type: batchAccounts
identiteit Het type identiteit dat wordt gebruikt voor de Batch-pool. BatchPoolIdentity-
Eigenschappen De eigenschappen die aan de pool zijn gekoppeld. PoolProperties-

BatchPoolIdentity

Naam Beschrijving Waarde
type Het type identiteit dat wordt gebruikt voor de Batch-pool. 'Geen'
UserAssigned (vereist)
userAssignedIdentities De lijst met gebruikersidentiteiten die zijn gekoppeld aan de Batch-pool. BatchPoolIdentityUserAssignedIdentities

BatchPoolIdentityUserAssignedIdentities

Naam Beschrijving Waarde
{aangepaste eigenschap} UserAssignedId-entiteiten

UserAssignedIdentities

Dit object bevat geen eigenschappen die tijdens de implementatie moeten worden ingesteld. Alle eigenschappen zijn ReadOnly.

PoolProperties

Naam Beschrijving Waarde
applicationLicenses De lijst met toepassingslicenties moet een subset van beschikbare Licenties voor Batch-servicetoepassingen zijn. Als er een licentie wordt aangevraagd die niet wordt ondersteund, mislukt het maken van een pool. tekenreeks[]
applicationPackages Wijzigingen in toepassingspakketverwijzingen zijn van invloed op alle nieuwe rekenknooppunten die lid zijn van de pool, maar hebben geen invloed op rekenknooppunten die al in de pool staan totdat ze opnieuw worden opgestart of opnieuw worden gemaakt. Er zijn maximaal 10 toepassingspakketverwijzingen voor een bepaalde groep. ApplicationPackageReference[]
Certificaten Voor Windows-rekenknooppunten installeert de Batch-service de certificaten naar het opgegeven certificaatarchief en de opgegeven locatie. Voor Linux-rekenknooppunten worden de certificaten opgeslagen in een map in de werkmap van de taak en wordt een omgevingsvariabele AZ_BATCH_CERTIFICATES_DIR aan de taak geleverd om een query uit te voeren op deze locatie. Voor certificaten met zichtbaarheid van remoteUser wordt een map met certificaten gemaakt in de basismap van de gebruiker (bijvoorbeeld /home/{user-name}/certs) en worden certificaten in die map geplaatst. CertificateReference[]
deploymentConfiguration Met Behulp van CloudServiceConfiguration geeft u op dat de knooppunten moeten worden gemaakt met behulp van Azure Cloud Services (PaaS), terwijl VirtualMachineConfiguration gebruikmaakt van Azure Virtual Machines (IaaS). DeploymentConfiguration-
displayName De weergavenaam hoeft niet uniek te zijn en mag unicode-tekens bevatten tot een maximale lengte van 1024. snaar
interNodeCommunication Hiermee worden beperkingen opgelegd aan welke knooppunten aan de pool kunnen worden toegewezen. Als u deze waarde inschakelt, kan de kans op het aangevraagde aantal knooppunten dat in de pool moet worden toegewezen, verminderen. Als deze waarde niet is opgegeven, wordt deze waarde standaard ingesteld op Uitgeschakeld. 'Uitgeschakeld'
'Ingeschakeld'
metagegevens De Batch-service wijst geen betekenis toe aan metagegevens; deze is uitsluitend bedoeld voor het gebruik van gebruikerscode. MetadataItem[]
mountConfiguration Dit ondersteunt Azure Files, NFS, CIFS/SMB en Blobfuse. MountConfiguration[]
networkConfiguration De netwerkconfiguratie voor een pool. NetworkConfiguration-
scaleSettings Definieert de gewenste grootte van de pool. Dit kan 'fixedScale' zijn waarbij de aangevraagde targetDedicatedNodes is opgegeven, of 'autoScale' waarmee een formule wordt gedefinieerd die periodiek opnieuw wordt geëvalueerd. Als deze eigenschap niet is opgegeven, heeft de pool een vaste schaal met 0 targetDedicatedNodes. ScaleSettings
startTask In een PATCH-bewerking (update) kan deze eigenschap worden ingesteld op een leeg object om de begintaak uit de pool te verwijderen. StartTask-
taskSchedulingPolicy Als dit niet is opgegeven, wordt de standaardwaarde verspreid. TaskSchedulingPolicy-
taskSlotsPerNode De standaardwaarde is 1. De maximumwaarde is de kleinste van 4 keer het aantal kernen van de vmSize van de pool of 256. Int
userAccounts De lijst met gebruikersaccounts die op elk knooppunt in de pool moeten worden gemaakt. UserAccount[]
vmSize Zie Grootten voor Cloud Services (https://azure.microsoft.com/documentation/articles/cloud-services-sizes-specs/) voor informatie over de beschikbare grootten van virtuele machines voor Cloud Services-pools (pools die zijn gemaakt met cloudServiceConfiguration). Batch ondersteunt alle VM-grootten van Cloud Services, met uitzondering van ExtraSmall. Zie Grootten voor virtuele machines (Linux) (/azure/virtual-machines/sizes-general) of grootten voor virtuele machines (windows) of grootten voor virtuele machines (Windows) (https://azure.microsoft.com/documentation/articles/virtual-machines-windows-sizes/) voor meer informatie over beschikbare VM-grootten voor pools met behulp van installatiekopieën van de Virtual Machines Marketplace (pools die zijn gemaakt met virtualMachineConfiguration). Batch ondersteunt alle azure-VM-grootten, behalve STANDARD_A0 en vm's met Premium Storage (STANDARD_GS, STANDARD_DS en STANDARD_DSV2 reeks). snaar

ApplicationPackageReference

Naam Beschrijving Waarde
legitimatiebewijs De id van het toepassingspakket dat moet worden geïnstalleerd. Dit moet zich binnen hetzelfde batchaccount bevinden als de pool. Dit kan een verwijzing naar een specifieke versie zijn of de standaardversie als deze bestaat. tekenreeks (vereist)
Versie Als dit wordt weggelaten en er geen standaardversie is opgegeven voor deze toepassing, mislukt de aanvraag met de foutcode InvalidApplicationPackageReferences. Als u de REST API rechtstreeks aanroept, is de HTTP-statuscode 409. snaar

CertificateReference

Naam Beschrijving Waarde
legitimatiebewijs De volledig gekwalificeerde id van het certificaat dat moet worden geïnstalleerd in de groep. Dit moet zich binnen hetzelfde batchaccount bevinden als de pool. tekenreeks (vereist)
storeLocation De standaardwaarde is currentUser. Deze eigenschap is alleen van toepassing op pools die zijn geconfigureerd met Windows-knooppunten (dat wil gezegd, gemaakt met cloudServiceConfiguration of met virtualMachineConfiguration met behulp van een Windows-installatiekopieënreferentie). Voor Linux-rekenknooppunten worden de certificaten opgeslagen in een map in de werkmap van de taak en wordt een omgevingsvariabele AZ_BATCH_CERTIFICATES_DIR aan de taak geleverd om een query uit te voeren op deze locatie. Voor certificaten met zichtbaarheid van remoteUser wordt een map met certificaten gemaakt in de basismap van de gebruiker (bijvoorbeeld /home/{user-name}/certs) en worden certificaten in die map geplaatst. 'CurrentUser'
'LocalMachine'
storeName Deze eigenschap is alleen van toepassing op pools die zijn geconfigureerd met Windows-knooppunten (dat wil gezegd, gemaakt met cloudServiceConfiguration of met virtualMachineConfiguration met behulp van een Windows-installatiekopieënreferentie). Algemene winkelnamen zijn: My, Root, CA, Trust, Disallowed, TrustedPeople, TrustedPublisher, AuthRoot, AddressBook, maar elke aangepaste winkelnaam kan ook worden gebruikt. De standaardwaarde is Mijn. snaar
zichtbaarheid Welke gebruikersaccounts op het rekenknooppunt toegang moeten hebben tot de persoonlijke gegevens van het certificaat. Tekenreeksmatrix met een van de volgende waarden:
RemoteUser
'StartTask'
'Taak'

DeploymentConfiguration

Naam Beschrijving Waarde
cloudServiceConfiguration Deze eigenschap en virtualMachineConfiguration sluiten elkaar wederzijds uit en een van de eigenschappen moet worden opgegeven. Deze eigenschap kan niet worden opgegeven als het Batch-account is gemaakt met de eigenschap poolAllocationMode ingesteld op UserSubscription. CloudServiceConfiguration-
virtualMachineConfiguration Deze eigenschap en cloudServiceConfiguration sluiten elkaar wederzijds uit en een van de eigenschappen moet worden opgegeven. VirtualMachineConfiguration-

CloudServiceConfiguration

Naam Beschrijving Waarde
osFamily Mogelijke waarden zijn: 2 - OS Family 2, gelijk aan Windows Server 2008 R2 SP1. 3 - OS Family 3, gelijk aan Windows Server 2012. 4 - OS Family 4, gelijk aan Windows Server 2012 R2. 5 - OS Family 5, gelijk aan Windows Server 2016. 6 - Os Family 6, gelijk aan Windows Server 2019. Zie Releases van Azure-gastbesturingssystemen (https://azure.microsoft.com/documentation/articles/cloud-services-guestos-update-matrix/#releases) voor meer informatie. tekenreeks (vereist)
osVersion De standaardwaarde is * waarmee de meest recente versie van het besturingssysteem voor de opgegeven besturingssysteemfamilie wordt opgegeven. snaar

VirtualMachineConfiguration

Naam Beschrijving Waarde
containerConfiguration Indien opgegeven, wordt de installatie uitgevoerd op elk knooppunt in de pool, zodat taken in containers kunnen worden uitgevoerd. Alle reguliere taken en jobbeheertaken die in deze pool worden uitgevoerd, moeten de eigenschap containerSettings opgeven en alle andere taken kunnen deze opgeven. ContainerConfiguration-
dataDisks Deze eigenschap moet worden opgegeven als aan de rekenknooppunten in de pool lege gegevensschijven moeten zijn gekoppeld. DataDisk[]
diskEncryptionConfiguration Indien opgegeven, wordt versleuteling uitgevoerd op elk knooppunt in de pool tijdens het inrichten van knooppunten. DiskEncryptionConfiguration-
Extensies Indien opgegeven, worden de extensies die in deze configuratie worden genoemd, op elk knooppunt geïnstalleerd. VMExtension[]
imageReference Een verwijzing naar een Azure Virtual Machines Marketplace-installatiekopieën of de Azure-installatiekopieënresource van een aangepaste virtuele machine. Zie de bewerking Ondersteunde knooppuntagent-SKU's weergeven om de lijst met alle imageReferences op te halen die door Azure Batch zijn geverifieerd. ImageReference (vereist)
licenseType Dit geldt alleen voor installatiekopieën die het Windows-besturingssysteem bevatten en mogen alleen worden gebruikt wanneer u geldige on-premises licenties hebt voor de knooppunten die worden geïmplementeerd. Als u dit weglaat, wordt er geen korting op on-premises licenties toegepast. Waarden zijn:

Windows_Server: de on-premises licentie is voor Windows Server.
Windows_Client: de on-premises licentie is voor Windows Client.
snaar
nodeAgentSkuId De Batch-knooppuntagent is een programma dat wordt uitgevoerd op elk knooppunt in de pool en biedt de interface voor opdracht en beheer tussen het knooppunt en de Batch-service. Er zijn verschillende implementaties van de knooppuntagent, ook wel SKU's genoemd, voor verschillende besturingssystemen. U moet een knooppuntagent-SKU opgeven die overeenkomt met de geselecteerde afbeeldingsreferentie. Zie de bewerking Ondersteunde agent-SKU's voor ondersteunde knooppunten, samen met de lijst met geverifieerde afbeeldingsverwijzingen, de bewerking Ondersteunde knooppuntagent-SKU's weergeven. tekenreeks (vereist)
nodePlacementConfiguration Met deze configuratie worden regels opgegeven voor de manier waarop knooppunten in de pool fysiek worden toegewezen. NodePlacementConfiguration-
osDisk Bevat configuratie voor tijdelijke OSDisk-instellingen. OSDisk-
windowsConfiguration Deze eigenschap mag niet worden opgegeven als de imageReference een Installatiekopie van het Linux-besturingssysteem opgeeft. WindowsConfiguration-

ContainerConfiguration

Naam Beschrijving Waarde
containerImageNames Dit is de volledige naslaginformatie over de installatiekopie, zoals wordt opgegeven voor 'docker pull'. Een installatiekopieën worden afkomstig uit het standaard-Docker-register, tenzij de installatiekopieën volledig zijn gekwalificeerd met een alternatief register. tekenreeks[]
containerregisters Als installatiekopieën moeten worden gedownload uit een persoonlijk register waarvoor referenties zijn vereist, moeten deze referenties hier worden opgegeven. ContainerRegistry-[]
type De containertechnologie die moet worden gebruikt. 'DockerCompatible' (vereist)

ContainerRegistry

Naam Beschrijving Waarde
identityReference De verwijzing naar een door de gebruiker toegewezen identiteit die is gekoppeld aan de Batch-pool die door een rekenknooppunt wordt gebruikt. ComputeNodeIdentityReference
wachtwoord Het wachtwoord om u aan te melden bij de registerserver. snaar
registryServer Als u dit weglaat, is de standaardwaarde 'docker.io'. snaar
gebruikersnaam De gebruikersnaam om u aan te melden bij de registerserver. snaar

ComputeNodeIdentityReference

Naam Beschrijving Waarde
resourceId De ARM-resource-id van de door de gebruiker toegewezen identiteit. snaar

DataDisk

Naam Beschrijving Waarde
Caching Waarden zijn:

geen: de cachemodus voor de schijf is niet ingeschakeld.
readOnly: de cachemodus voor de schijf is alleen-lezen.
readWrite: de cachemodus voor de schijf is lezen en schrijven.

De standaardwaarde voor opslaan in cache is geen. Zie voor meer informatie over de cacheopties: https://blogs.msdn.microsoft.com/windowsazurestorage/2012/06/27/exploring-windows-azure-drives-disks-and-images/.
'Geen'
'ReadOnly'
'ReadWrite'
diskSizeGB De initiële schijfgrootte in GB bij het maken van een nieuwe gegevensschijf. int (vereist)
Lun De lun wordt gebruikt om elke gegevensschijf uniek te identificeren. Als u meerdere schijven koppelt, moet elk een afzonderlijke lun hebben. De waarde moet tussen 0 en 63 liggen, inclusief. int (vereist)
storageAccountType Als u dit weglaat, is de standaardwaarde 'Standard_LRS'. Waarden zijn:

Standard_LRS: de gegevensschijf moet standaard lokaal redundante opslag gebruiken.
Premium_LRS: de gegevensschijf moet premium lokaal redundante opslag gebruiken.
'Premium_LRS'
'Standard_LRS'

DiskEncryptionConfiguration

Naam Beschrijving Waarde
Doelstellingen In linux-pool wordt alleen 'TemporaryDisk' ondersteund; in windows-pool moeten 'OsDisk' en 'TemporaryDisk' worden opgegeven. Tekenreeksmatrix met een van de volgende waarden:
'OsDisk'
'TemporaryDisk'

VMExtension

Naam Beschrijving Waarde
autoUpgradeMinorVersion Geeft aan of de extensie een nieuwere secundaire versie moet gebruiken als deze beschikbaar is tijdens de implementatie. Zodra de extensie eenmaal is geïmplementeerd, worden er echter geen secundaire versies bijgewerkt, tenzij deze opnieuw wordt geïmplementeerd, zelfs niet als deze eigenschap is ingesteld op true. Bool
naam De naam van de extensie van de virtuele machine. tekenreeks (vereist)
protectedSettings De extensie kan protectedSettings of protectedSettingsFromKeyVault of helemaal geen beveiligde instellingen bevatten. Voor Bicep kunt u de functie any() gebruiken.
provisionAfterExtensions Verzameling extensienamen waarna deze extensie moet worden ingericht. tekenreeks[]
uitgever De naam van de uitgever van de extensie-handler. tekenreeks (vereist)
Instellingen Openbare instellingen met JSON-indeling voor de extensie. Voor Bicep kunt u de functie any() gebruiken.
type Het type extensies. tekenreeks (vereist)
typeHandlerVersion De versie van de scripthandler. snaar

ImageReference

Naam Beschrijving Waarde
legitimatiebewijs Deze eigenschap is wederzijds exclusief met andere eigenschappen. De installatiekopieën van de galerie met gedeelde installatiekopieën moeten replica's hebben in dezelfde regio als het Azure Batch-account. Zie /azure/batch/batch-api-basics#virtual-network-vnet-and-firewall-configuration voor informatie over de firewallinstellingen voor de Batch-knooppuntagent om te communiceren met de Batch-service. snaar
aanbieden Bijvoorbeeld UbuntuServer of WindowsServer. snaar
uitgever Bijvoorbeeld Canonical of MicrosoftWindowsServer. snaar
Sku Bijvoorbeeld 18.04-LTS of 2022-datacenter. snaar
Versie Er kan een waarde van 'latest' worden opgegeven om de meest recente versie van een installatiekopieën te selecteren. Als u dit weglaat, is de standaardwaarde 'nieuwste'. snaar

NodePlacementConfiguration

Naam Beschrijving Waarde
beleid Toewijzingsbeleid dat door Batch Service wordt gebruikt om de knooppunten in te richten. Als dit niet is opgegeven, gebruikt Batch het regionale beleid. 'Regionaal'
'Zonegebonden'

OSDisk

Naam Beschrijving Waarde
kortstondigeOSDiskSettings Hiermee geeft u de tijdelijke schijfinstellingen voor de besturingssysteemschijf die door de virtuele machine wordt gebruikt. DiffDiskSettings

DiffDiskSettings

Naam Beschrijving Waarde
Plaatsing Deze eigenschap kan worden gebruikt door de gebruiker in de aanvraag om te kiezen op welke locatie het besturingssysteem zich moet bevinden. Bijvoorbeeld: cacheschijfruimte voor kortstondige besturingssysteemschijfinrichting. Raadpleeg voor meer informatie over tijdelijke vereisten voor besturingssysteemschijfgrootte de vereisten voor tijdelijke besturingssysteemschijfgrootte voor Windows-VM's op /azure/virtual-machines/windows/kortstondige os-schijven#groottevereisten en Linux-VM's op /azure/virtual-machines/linux/kortstondige-os-schijven#grootte-vereisten. 'CacheDisk'

WindowsConfiguration

Naam Beschrijving Waarde
enableAutomaticUpdates Als u dit weglaat, is de standaardwaarde waar. Bool

MetadataItem

Naam Beschrijving Waarde
naam De naam van het metagegevensitem. tekenreeks (vereist)
waarde De waarde van het metagegevensitem. tekenreeks (vereist)

MountConfiguration

Naam Beschrijving Waarde
azureBlobFileSystemConfiguration Deze eigenschap is wederzijds exclusief met alle andere eigenschappen. AzureBlobFileSystemConfiguration-
azureFileShareConfiguration Deze eigenschap is wederzijds exclusief met alle andere eigenschappen. AzureFileShareConfiguration-
cifsMountConfiguration Deze eigenschap is wederzijds exclusief met alle andere eigenschappen. CifsMountConfiguration-
nfsMountConfiguration Deze eigenschap is wederzijds exclusief met alle andere eigenschappen. NFSMountConfiguration-

AzureBlobFileSystemConfiguration

Naam Beschrijving Waarde
accountKey Deze eigenschap is wederzijds exclusief met zowel sasKey als identiteit; er moet precies één worden opgegeven. snaar
accountName De naam van het Azure Storage-account. tekenreeks (vereist)
blobfuseOptions Dit zijn opties voor 'net use' in Windows en opties voor koppelen in Linux. snaar
containerName De naam van de Azure Blob Storage-container. tekenreeks (vereist)
identityReference Deze eigenschap is wederzijds exclusief met zowel accountKey als sasKey; er moet precies één worden opgegeven. ComputeNodeIdentityReference
relativeMountPath Alle bestandssystemen worden gekoppeld ten opzichte van de map batchkoppelingen, die toegankelijk zijn via de omgevingsvariabele AZ_BATCH_NODE_MOUNTS_DIR. tekenreeks (vereist)
sasKey Deze eigenschap is wederzijds exclusief met zowel accountKey als identiteit; er moet precies één worden opgegeven. snaar

AzureFileShareConfiguration

Naam Beschrijving Waarde
accountKey De sleutel van het Azure Storage-account. tekenreeks (vereist)
accountName De naam van het Azure Storage-account. tekenreeks (vereist)
azureFileUrl Dit is de vorm 'https://{account}.file.core.windows.net/'. tekenreeks (vereist)
mountOptions Dit zijn opties voor 'net use' in Windows en opties voor koppelen in Linux. snaar
relativeMountPath Alle bestandssystemen worden gekoppeld ten opzichte van de map batchkoppelingen, die toegankelijk zijn via de omgevingsvariabele AZ_BATCH_NODE_MOUNTS_DIR. tekenreeks (vereist)

CifsMountConfiguration

Naam Beschrijving Waarde
mountOptions Dit zijn opties voor 'net use' in Windows en opties voor koppelen in Linux. snaar
wachtwoord Het wachtwoord dat moet worden gebruikt voor verificatie op basis van het CIFS-bestandssysteem. tekenreeks (vereist)
relativeMountPath Alle bestandssystemen worden gekoppeld ten opzichte van de map batchkoppelingen, die toegankelijk zijn via de omgevingsvariabele AZ_BATCH_NODE_MOUNTS_DIR. tekenreeks (vereist)
bron De URI van het bestandssysteem die moet worden gekoppeld. tekenreeks (vereist)
gebruikersnaam De gebruiker die moet worden gebruikt voor verificatie op basis van het CIFS-bestandssysteem. tekenreeks (vereist)

NFSMountConfiguration

Naam Beschrijving Waarde
mountOptions Dit zijn opties voor 'net use' in Windows en opties voor koppelen in Linux. snaar
relativeMountPath Alle bestandssystemen worden gekoppeld ten opzichte van de map batchkoppelingen, die toegankelijk zijn via de omgevingsvariabele AZ_BATCH_NODE_MOUNTS_DIR. tekenreeks (vereist)
bron De URI van het bestandssysteem die moet worden gekoppeld. tekenreeks (vereist)

NetworkConfiguration

Naam Beschrijving Waarde
dynamicVNetAssignmentScope Het bereik van dynamische vnet-toewijzing. 'job'
'geen'
endpointConfiguration De configuratie van het pooleindpunt wordt alleen ondersteund voor pools met de eigenschap virtualMachineConfiguration. PoolEndpointConfiguration-
publicIPAddressConfiguration Deze eigenschap wordt alleen ondersteund in Pools met de eigenschap virtualMachineConfiguration. PublicIPAddressConfiguration-
subnetId Het virtuele netwerk moet zich in dezelfde regio en hetzelfde abonnement bevinden als het Azure Batch-account. Het opgegeven subnet moet voldoende vrije IP-adressen hebben om tegemoet te komen aan het aantal knooppunten in de groep. Als het subnet niet voldoende vrije IP-adressen heeft, wijst de pool gedeeltelijk rekenknooppunten toe en treedt er een fout op bij het wijzigen van de grootte. De service-principal 'MicrosoftAzureBatch' moet de rol 'Inzender voor klassieke virtuele machines' hebben Role-Based RBAC-rol (Access Control) voor het opgegeven VNet. Het opgegeven subnet moet communicatie van de Azure Batch-service toestaan om taken op de rekenknooppunten te kunnen plannen. Dit kan worden gecontroleerd door te controleren of het opgegeven VNet gekoppelde netwerkbeveiligingsgroepen (NSG' heeft). Als communicatie met de rekenknooppunten in het opgegeven subnet wordt geweigerd door een NSG, stelt de Batch-service de status van de rekenknooppunten in op onbruikbaar. Als het opgegeven VNet gekoppelde netwerkbeveiligingsgroepen (NSG) heeft, moeten enkele gereserveerde systeempoorten zijn ingeschakeld voor binnenkomende communicatie. Schakel poorten 29876 en 29877, evenals poort 22 voor Linux en poort 3389 voor Windows in voor pools die zijn gemaakt met een configuratie van een virtuele machine. Voor pools die zijn gemaakt met een cloudserviceconfiguratie, schakelt u poorten 10100, 20100 en 30100 in. Schakel ook uitgaande verbindingen met Azure Storage in op poort 443. Voor cloudServiceConfiguration-pools worden alleen 'klassieke' VNET's ondersteund. Zie voor meer informatie: /azure/batch/batch-api-basics#virtual-network-vnet-and-firewall-configuration snaar

PoolEndpointConfiguration

Naam Beschrijving Waarde
inboundNatPools Het maximum aantal binnenkomende NAT-pools per Batch-pool is 5. Als het maximum aantal binnenkomende NAT-pools wordt overschreden, mislukt de aanvraag met HTTP-statuscode 400. Dit kan niet worden opgegeven als het IPAddressProvisioningType NoPublicIPAddresses is. InboundNatPool[] (vereist)

InboundNatPool

Naam Beschrijving Waarde
backendPort Dit moet uniek zijn binnen een Batch-pool. Acceptabele waarden liggen tussen 1 en 65535, met uitzondering van 22, 3389, 29876 en 29877, aangezien deze zijn gereserveerd. Als er gereserveerde waarden worden opgegeven, mislukt de aanvraag met HTTP-statuscode 400. int (vereist)
frontendPortRangeEnd Acceptabele waarden variëren tussen 1 en 65534, behalve poorten van 50000 tot 55000, die zijn gereserveerd door de Batch-service. Alle bereiken binnen een pool moeten uniek zijn en mogen niet overlappen. Als er gereserveerde of overlappende waarden worden opgegeven, mislukt de aanvraag met HTTP-statuscode 400. int (vereist)
frontendPortRangeStart Acceptabele waarden variëren tussen 1 en 65534, met uitzondering van poorten van 50000 tot 55000 die zijn gereserveerd. Alle bereiken binnen een pool moeten uniek zijn en mogen niet overlappen. Als er gereserveerde of overlappende waarden worden opgegeven, mislukt de aanvraag met HTTP-statuscode 400. int (vereist)
naam De naam moet uniek zijn binnen een Batch-pool, kan letters, cijfers, onderstrepingstekens, punten en afbreekstreepjes bevatten. Namen moeten beginnen met een letter of cijfer, moeten eindigen op een letter, cijfer of onderstrepingsteken en mogen niet langer zijn dan 77 tekens. Als er ongeldige waarden worden opgegeven, mislukt de aanvraag met HTTP-statuscode 400. tekenreeks (vereist)
networkSecurityGroupRules Het maximum aantal regels dat kan worden opgegeven voor alle eindpunten in een Batch-pool is 25. Als er geen regels voor netwerkbeveiligingsgroepen zijn opgegeven, wordt er een standaardregel gemaakt om binnenkomende toegang tot de opgegeven backendPort toe te staan. Als het maximum aantal regels voor netwerkbeveiligingsgroepen wordt overschreden, mislukt de aanvraag met HTTP-statuscode 400. NetworkSecurityGroupRule[]
protocol Het protocol van het eindpunt. 'TCP'
UDP (vereist)

NetworkSecurityGroupRule

Naam Beschrijving Waarde
toegang De actie die moet worden uitgevoerd voor een opgegeven IP-adres, subnetbereik of tag. 'Toestaan'
'Weigeren' (vereist)
voorrang Prioriteiten binnen een pool moeten uniek zijn en worden geëvalueerd in volgorde van prioriteit. Hoe lager het getal hoe hoger de prioriteit. Regels kunnen bijvoorbeeld worden opgegeven met ordernummers van 150, 250 en 350. De regel met het volgordenummer 150 heeft voorrang op de regel met een volgorde van 250. Toegestane prioriteiten zijn 150 tot 4096. Als er gereserveerde of dubbele waarden worden opgegeven, mislukt de aanvraag met HTTP-statuscode 400. int (vereist)
sourceAddressPrefix Geldige waarden zijn één IP-adres (bijvoorbeeld 10.10.10.10), IP-subnet (bijvoorbeeld 192.168.1.0/24), standaardtag of * (voor alle adressen). Als er andere waarden worden opgegeven, mislukt de aanvraag met HTTP-statuscode 400. tekenreeks (vereist)
sourcePortRanges Geldige waarden zijn *(voor alle poorten 0 - 65535) of matrices van poorten of poortbereiken (bijvoorbeeld 100-200). De poorten moeten tussen 0 en 65535 liggen en de poortbereiken of poorten mogen niet overlappen. Als er andere waarden worden opgegeven, mislukt de aanvraag met HTTP-statuscode 400. De standaardwaarde is *. tekenreeks[]

PublicIPAddressConfiguration

Naam Beschrijving Waarde
ipAddressIds Het aantal IP-adressen dat hier is opgegeven, beperkt de maximale grootte van de pool - 100 toegewezen knooppunten of 100 spot-/lage prioriteitsknooppunten kunnen worden toegewezen voor elk openbaar IP-adres. Een pool die bijvoorbeeld 250 toegewezen VM's nodig heeft, heeft ten minste 3 openbare IP-adressen nodig. Elk element van deze verzameling heeft de volgende vorm: /subscriptions/{subscription}/resourceGroups/{group}/providers/Microsoft.Network/publicIPAddresses/{ip}. tekenreeks[]
bepaling De standaardwaarde is BatchManaged 'BatchManaged'
'NoPublicIPAddresses'
UserManaged

ScaleSettings

Naam Beschrijving Waarde
automatisch schalen Deze eigenschap en fixedScale sluiten elkaar wederzijds uit en een van de eigenschappen moet worden opgegeven. AutoScaleSettings
fixedScale Deze eigenschap en automatische schaalaanpassing sluiten elkaar wederzijds uit en een van de eigenschappen moet worden opgegeven. FixedScaleSettings-

AutoScaleSettings

Naam Beschrijving Waarde
evaluationInterval Als u dit weglaat, is de standaardwaarde 15 minuten (PT15M). snaar
formule Een formule voor het gewenste aantal rekenknooppunten in de pool. tekenreeks (vereist)

FixedScaleSettings

Naam Beschrijving Waarde
nodeDeallocationOption Als u dit weglaat, is de standaardwaarde Requeue. 'Requeue'
'RetainedData'
'TaskCompletion'
'Beëindigen'
resizeTimeout De standaardwaarde is 15 minuten. Time-outwaarden maken gebruik van iso 8601-indeling. Gebruik bijvoorbeeld PT10M gedurende 10 minuten. De minimumwaarde is 5 minuten. Als u een waarde opgeeft die minder dan 5 minuten duurt, weigert de Batch-service de aanvraag met een fout; als u de REST API rechtstreeks aanroept, is de HTTP-statuscode 400 (Ongeldige aanvraag). snaar
targetDedicatedNodes Ten minste één van targetDedicatedNodes, targetLowPriorityNodes moet worden ingesteld. Int
targetLowPriorityNodes Ten minste één van targetDedicatedNodes, targetLowPriorityNodes moet worden ingesteld. Int

StartTask

Naam Beschrijving Waarde
commandLine De opdrachtregel wordt niet uitgevoerd onder een shell en kan daarom niet profiteren van shell-functies zoals uitbreiding van omgevingsvariabelen. Als u van dergelijke functies wilt profiteren, moet u de shell aanroepen op de opdrachtregel, bijvoorbeeld met 'cmd /c MyCommand' in Windows of '/bin/sh -c MyCommand' in Linux. Vereist als er andere eigenschappen van de startTask zijn opgegeven. snaar
containerSettings Wanneer dit is opgegeven, worden alle mappen recursief onder de AZ_BATCH_NODE_ROOT_DIR (de hoofdmap van Azure Batch-mappen op het knooppunt) toegewezen aan de container, worden alle omgevingsvariabelen voor taken toegewezen aan de container en wordt de opdrachtregel van de taak uitgevoerd in de container. TaskContainerSettings-
environmentSettings Een lijst met omgevingsvariabeleinstellingen voor de begintaak. EnvironmentSetting[]
maxTaskRetryCount De Batch-service probeert een taak opnieuw uit te voeren als de afsluitcode niet-nul is. Houd er rekening mee dat deze waarde specifiek het aantal nieuwe pogingen bepaalt. De Batch-service probeert de taak eenmaal uit en probeert vervolgens opnieuw tot deze limiet. Als het maximumaantal nieuwe pogingen bijvoorbeeld 3 is, probeert Batch de taak maximaal vier keer (één eerste poging en drie nieuwe pogingen). Als het maximumaantal nieuwe pogingen 0 is, voert de Batch-service de taak niet opnieuw uit. Als het maximumaantal nieuwe pogingen -1 is, probeert de Batch-service de taak opnieuw zonder limiet, maar dit wordt niet aanbevolen voor een begintaak of een taak. De standaardwaarde is 0 (geen nieuwe pogingen). Int
resourceFiles Een lijst met bestanden die de Batch-service naar het rekenknooppunt downloadt voordat u de opdrachtregel uitvoert. ResourceFile[]
userIdentity Als u dit weglaat, wordt de taak uitgevoerd als een niet-gebruiker met beheerdersrechten die uniek is voor de taak. UserIdentity-
waitForSuccess Als waar is en de begintaak mislukt op een rekenknooppunt, probeert de Batch-service de opstarttaak opnieuw uit te voeren tot het maximumaantal nieuwe pogingen (maxTaskRetryCount). Als de taak na alle nieuwe pogingen nog steeds niet is voltooid, markeert de Batch-service het rekenknooppunt onbruikbaar en worden er geen taken naar gepland. Deze voorwaarde kan worden gedetecteerd via de knooppuntstatus en planningsfoutdetails. Als dit onwaar is, wacht de Batch-service niet totdat de begintaak is voltooid. In dit geval kunnen andere taken worden uitgevoerd op het rekenknooppunt terwijl de begintaak nog steeds wordt uitgevoerd; en zelfs als de begintaak mislukt, blijven nieuwe taken gepland op het knooppunt. De standaardwaarde is waar. Bool

TaskContainerSettings

Naam Beschrijving Waarde
containerRunOptions Deze extra opties worden geleverd als argumenten voor de opdracht Docker create, naast de opties die worden beheerd door de Batch-service. snaar
imageName Dit is de volledige naslaginformatie over de installatiekopie, zoals wordt opgegeven voor 'docker pull'. Als er geen tag wordt opgegeven als onderdeel van de naam van de installatiekopieën, wordt de tag ':latest' als standaard gebruikt. tekenreeks (vereist)
register Deze instelling kan worden weggelaten als deze al is opgegeven bij het maken van een pool. ContainerRegistry-
workingDirectory Een vlag om aan te geven waar de werkmap van de containertaak zich bevindt. De standaardwaarde is taskWorkingDirectory. 'ContainerImageDefault'
'TaskWorkingDirectory'

EnvironmentSetting

Naam Beschrijving Waarde
naam De naam van de omgevingsvariabele. tekenreeks (vereist)
waarde De waarde van de omgevingsvariabele. snaar

ResourceFile

Naam Beschrijving Waarde
autoStorageContainerName De eigenschappen autoStorageContainerName, storageContainerUrl en httpUrl sluiten elkaar wederzijds uit en een van deze moet worden opgegeven. snaar
blobPrefix De eigenschap is alleen geldig wanneer autoStorageContainerName of storageContainerUrl wordt gebruikt. Dit voorvoegsel kan een gedeeltelijke bestandsnaam of een submap zijn. Als er geen voorvoegsel is opgegeven, worden alle bestanden in de container gedownload. snaar
fileMode Deze eigenschap is alleen van toepassing op bestanden die worden gedownload naar Linux-rekenknooppunten. Deze wordt genegeerd als deze is opgegeven voor een resourceFile die wordt gedownload naar een Windows-knooppunt. Als deze eigenschap niet is opgegeven voor een Linux-knooppunt, wordt een standaardwaarde van 0770 toegepast op het bestand. snaar
filePath Als de eigenschap httpUrl is opgegeven, is het filePath vereist en wordt het pad beschreven waarnaar het bestand wordt gedownload, inclusief de bestandsnaam. Als anders de eigenschap autoStorageContainerName of storageContainerUrl is opgegeven, is filePath optioneel en is het de map waarin de bestanden moeten worden gedownload. In het geval dat filePath wordt gebruikt als map, wordt elke mapstructuur die al aan de invoergegevens is gekoppeld, volledig bewaard en toegevoegd aan de opgegeven filePath-map. Het opgegeven relatieve pad kan niet worden uitgesplitsd uit de werkmap van de taak (bijvoorbeeld met '..'). snaar
httpUrl De eigenschappen autoStorageContainerName, storageContainerUrl en httpUrl sluiten elkaar wederzijds uit en een van deze moet worden opgegeven. Als de URL verwijst naar Azure Blob Storage, moet deze leesbaar zijn vanuit rekenknooppunten. Er zijn drie manieren om een dergelijke URL op te halen voor een blob in Azure Storage: neem een SAS (Shared Access Signature) die leesmachtigingen voor de blob verleent, gebruik een beheerde identiteit met leesmachtigingen of stel de ACL voor de blob of de container in om openbare toegang toe te staan. snaar
identityReference De verwijzing naar een door de gebruiker toegewezen identiteit die is gekoppeld aan de Batch-pool die door een rekenknooppunt wordt gebruikt. ComputeNodeIdentityReference
storageContainerUrl De eigenschappen autoStorageContainerName, storageContainerUrl en httpUrl sluiten elkaar wederzijds uit en een van deze moet worden opgegeven. Deze URL moet kunnen worden gelezen en vermeld vanuit rekenknooppunten. Er zijn drie manieren om een dergelijke URL op te halen voor een container in Azure Storage: neem een SAS (Shared Access Signature) op die lees- en lijstmachtigingen voor de container verleent, gebruik een beheerde identiteit met lees- en lijstmachtigingen of stel de ACL voor de container in om openbare toegang toe te staan. snaar

UserIdentity

Naam Beschrijving Waarde
autoUser De eigenschappen userName en autoUser sluiten elkaar wederzijds uit; u moet één, maar niet beide opgeven. AutoUserSpecification-
userName De eigenschappen userName en autoUser sluiten elkaar wederzijds uit; u moet één, maar niet beide opgeven. snaar

AutoUserSpecification

Naam Beschrijving Waarde
elevationLevel De standaardwaarde is nietAdmin. 'Beheerder'
'NonAdmin'
draagwijdte De standaardwaarde is Pool. Als de pool Windows uitvoert, moet een waarde van Taak worden opgegeven als strengere isolatie tussen taken vereist is. Als de taak bijvoorbeeld het register op een manier muteert die van invloed kan zijn op andere taken, of als certificaten zijn opgegeven in de pool die niet toegankelijk moet zijn voor normale taken, maar toegankelijk moeten zijn voor begintaken. 'Pool'
'Taak'

TaskSchedulingPolicy

Naam Beschrijving Waarde
nodeFillType Hoe taken moeten worden verdeeld over rekenknooppunten. 'Inpakken'
'Spread' (vereist)

UserAccount

Naam Beschrijving Waarde
elevationLevel nonAdmin: de automatische gebruiker is een standaardgebruiker zonder verhoogde toegang. beheerder: de automatische gebruiker is een gebruiker met verhoogde toegang en werkt met volledige beheerdersmachtigingen. De standaardwaarde is nietAdmin. 'Beheerder'
'NonAdmin'
linuxUserConfiguration Deze eigenschap wordt genegeerd als deze is opgegeven in een Windows-pool. Als dit niet is opgegeven, wordt de gebruiker gemaakt met de standaardopties. LinuxUserConfiguration-
naam De naam van het gebruikersaccount. tekenreeks (vereist)
wachtwoord Het wachtwoord voor het gebruikersaccount. tekenreeks (vereist)
windowsUserConfiguration Deze eigenschap kan alleen worden opgegeven als de gebruiker zich in een Windows-pool bevindt. Als dit niet is opgegeven en in een Windows-pool, wordt de gebruiker gemaakt met de standaardopties. WindowsUserConfiguration-

LinuxUserConfiguration

Naam Beschrijving Waarde
Gid De uid- en gid-eigenschappen moeten samen worden opgegeven of helemaal niet. Als het onderliggende besturingssysteem niet is opgegeven, kiest u de gid. Int
sshPrivateKey De persoonlijke sleutel mag niet met een wachtwoord zijn beveiligd. De persoonlijke sleutel wordt gebruikt om automatisch verificatie op basis van asymmetrische sleutels te configureren voor SSH tussen knooppunten in een Linux-pool wanneer de eigenschap enableInterNodeCommunication van de pool waar is (deze wordt genegeerd als enableInterNodeCommunication onwaar is). Dit doet u door het sleutelpaar in de map .ssh van de gebruiker te plaatsen. Als dit niet is opgegeven, is SSH zonder wachtwoord niet geconfigureerd tussen knooppunten (er wordt geen wijziging van de .ssh-map van de gebruiker uitgevoerd). snaar
Uid De uid- en gid-eigenschappen moeten samen worden opgegeven of helemaal niet. Als het onderliggende besturingssysteem niet is opgegeven, wordt de uid gekozen. Int

WindowsUserConfiguration

Naam Beschrijving Waarde
loginMode Hiermee geeft u de aanmeldingsmodus voor de gebruiker. De standaardwaarde voor VirtualMachineConfiguration-pools is de interactieve modus en voor CloudServiceConfiguration-pools is de batchmodus. 'Batch'
'Interactief'

Quickstart-sjablonen

Met de volgende quickstart-sjablonen wordt dit resourcetype geïmplementeerd.

Sjabloon Beschrijving
Azure Batch-pool zonder openbare IP-adressen

implementeren in Azure
Met deze sjabloon maakt u een vereenvoudigde knooppuntcommunicatiegroep van Azure Batch zonder openbare IP-adressen.

Resourcedefinitie van ARM-sjabloon

Het resourcetype batchAccounts/pools kan worden geïmplementeerd met bewerkingen die zijn gericht op:

Zie logboek wijzigenvoor een lijst met gewijzigde eigenschappen in elke API-versie.

Resource-indeling

Als u een resource voor Microsoft.Batch/batchAccounts/pools wilt maken, voegt u de volgende JSON toe aan uw sjabloon.

{
  "type": "Microsoft.Batch/batchAccounts/pools",
  "apiVersion": "2022-01-01",
  "name": "string",
  "identity": {
    "type": "string",
    "userAssignedIdentities": {
      "{customized property}": {}
    }
  },
  "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": [
            {
              "identityReference": {
                "resourceId": "string"
              },
              "password": "string",
              "registryServer": "string",
              "username": "string"
            }
          ],
          "type": "DockerCompatible"
        },
        "dataDisks": [
          {
            "caching": "string",
            "diskSizeGB": "int",
            "lun": "int",
            "storageAccountType": "string"
          }
        ],
        "diskEncryptionConfiguration": {
          "targets": [ "string" ]
        },
        "extensions": [
          {
            "autoUpgradeMinorVersion": "bool",
            "name": "string",
            "protectedSettings": {},
            "provisionAfterExtensions": [ "string" ],
            "publisher": "string",
            "settings": {},
            "type": "string",
            "typeHandlerVersion": "string"
          }
        ],
        "imageReference": {
          "id": "string",
          "offer": "string",
          "publisher": "string",
          "sku": "string",
          "version": "string"
        },
        "licenseType": "string",
        "nodeAgentSkuId": "string",
        "nodePlacementConfiguration": {
          "policy": "string"
        },
        "osDisk": {
          "ephemeralOSDiskSettings": {
            "placement": "CacheDisk"
          }
        },
        "windowsConfiguration": {
          "enableAutomaticUpdates": "bool"
        }
      }
    },
    "displayName": "string",
    "interNodeCommunication": "string",
    "metadata": [
      {
        "name": "string",
        "value": "string"
      }
    ],
    "mountConfiguration": [
      {
        "azureBlobFileSystemConfiguration": {
          "accountKey": "string",
          "accountName": "string",
          "blobfuseOptions": "string",
          "containerName": "string",
          "identityReference": {
            "resourceId": "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": {
      "dynamicVNetAssignmentScope": "string",
      "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": {
          "identityReference": {
            "resourceId": "string"
          },
          "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",
          "identityReference": {
            "resourceId": "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"
  }
}

Eigenschapswaarden

batchAccounts/pools

Naam Beschrijving Waarde
type Het resourcetype 'Microsoft.Batch/batchAccounts/pools'
apiVersion De versie van de resource-API '2022-01-01'
naam De resourcenaam

Zie hoe u namen en typen instelt voor onderliggende resources in JSON ARM-sjablonen.
tekenreeks (vereist)

Tekenlimiet: 1-64

Geldige tekens:
Alfanumerieke tekst, onderstrepingstekens en afbreekstreepjes.
identiteit Het type identiteit dat wordt gebruikt voor de Batch-pool. BatchPoolIdentity-
Eigenschappen De eigenschappen die aan de pool zijn gekoppeld. PoolProperties-

BatchPoolIdentity

Naam Beschrijving Waarde
type Het type identiteit dat wordt gebruikt voor de Batch-pool. 'Geen'
UserAssigned (vereist)
userAssignedIdentities De lijst met gebruikersidentiteiten die zijn gekoppeld aan de Batch-pool. BatchPoolIdentityUserAssignedIdentities

BatchPoolIdentityUserAssignedIdentities

Naam Beschrijving Waarde
{aangepaste eigenschap} UserAssignedId-entiteiten

UserAssignedIdentities

Dit object bevat geen eigenschappen die tijdens de implementatie moeten worden ingesteld. Alle eigenschappen zijn ReadOnly.

PoolProperties

Naam Beschrijving Waarde
applicationLicenses De lijst met toepassingslicenties moet een subset van beschikbare Licenties voor Batch-servicetoepassingen zijn. Als er een licentie wordt aangevraagd die niet wordt ondersteund, mislukt het maken van een pool. tekenreeks[]
applicationPackages Wijzigingen in toepassingspakketverwijzingen zijn van invloed op alle nieuwe rekenknooppunten die lid zijn van de pool, maar hebben geen invloed op rekenknooppunten die al in de pool staan totdat ze opnieuw worden opgestart of opnieuw worden gemaakt. Er zijn maximaal 10 toepassingspakketverwijzingen voor een bepaalde groep. ApplicationPackageReference[]
Certificaten Voor Windows-rekenknooppunten installeert de Batch-service de certificaten naar het opgegeven certificaatarchief en de opgegeven locatie. Voor Linux-rekenknooppunten worden de certificaten opgeslagen in een map in de werkmap van de taak en wordt een omgevingsvariabele AZ_BATCH_CERTIFICATES_DIR aan de taak geleverd om een query uit te voeren op deze locatie. Voor certificaten met zichtbaarheid van remoteUser wordt een map met certificaten gemaakt in de basismap van de gebruiker (bijvoorbeeld /home/{user-name}/certs) en worden certificaten in die map geplaatst. CertificateReference[]
deploymentConfiguration Met Behulp van CloudServiceConfiguration geeft u op dat de knooppunten moeten worden gemaakt met behulp van Azure Cloud Services (PaaS), terwijl VirtualMachineConfiguration gebruikmaakt van Azure Virtual Machines (IaaS). DeploymentConfiguration-
displayName De weergavenaam hoeft niet uniek te zijn en mag unicode-tekens bevatten tot een maximale lengte van 1024. snaar
interNodeCommunication Hiermee worden beperkingen opgelegd aan welke knooppunten aan de pool kunnen worden toegewezen. Als u deze waarde inschakelt, kan de kans op het aangevraagde aantal knooppunten dat in de pool moet worden toegewezen, verminderen. Als deze waarde niet is opgegeven, wordt deze waarde standaard ingesteld op Uitgeschakeld. 'Uitgeschakeld'
'Ingeschakeld'
metagegevens De Batch-service wijst geen betekenis toe aan metagegevens; deze is uitsluitend bedoeld voor het gebruik van gebruikerscode. MetadataItem[]
mountConfiguration Dit ondersteunt Azure Files, NFS, CIFS/SMB en Blobfuse. MountConfiguration[]
networkConfiguration De netwerkconfiguratie voor een pool. NetworkConfiguration-
scaleSettings Definieert de gewenste grootte van de pool. Dit kan 'fixedScale' zijn waarbij de aangevraagde targetDedicatedNodes is opgegeven, of 'autoScale' waarmee een formule wordt gedefinieerd die periodiek opnieuw wordt geëvalueerd. Als deze eigenschap niet is opgegeven, heeft de pool een vaste schaal met 0 targetDedicatedNodes. ScaleSettings
startTask In een PATCH-bewerking (update) kan deze eigenschap worden ingesteld op een leeg object om de begintaak uit de pool te verwijderen. StartTask-
taskSchedulingPolicy Als dit niet is opgegeven, wordt de standaardwaarde verspreid. TaskSchedulingPolicy-
taskSlotsPerNode De standaardwaarde is 1. De maximumwaarde is de kleinste van 4 keer het aantal kernen van de vmSize van de pool of 256. Int
userAccounts De lijst met gebruikersaccounts die op elk knooppunt in de pool moeten worden gemaakt. UserAccount[]
vmSize Zie Grootten voor Cloud Services (https://azure.microsoft.com/documentation/articles/cloud-services-sizes-specs/) voor informatie over de beschikbare grootten van virtuele machines voor Cloud Services-pools (pools die zijn gemaakt met cloudServiceConfiguration). Batch ondersteunt alle VM-grootten van Cloud Services, met uitzondering van ExtraSmall. Zie Grootten voor virtuele machines (Linux) (/azure/virtual-machines/sizes-general) of grootten voor virtuele machines (windows) of grootten voor virtuele machines (Windows) (https://azure.microsoft.com/documentation/articles/virtual-machines-windows-sizes/) voor meer informatie over beschikbare VM-grootten voor pools met behulp van installatiekopieën van de Virtual Machines Marketplace (pools die zijn gemaakt met virtualMachineConfiguration). Batch ondersteunt alle azure-VM-grootten, behalve STANDARD_A0 en vm's met Premium Storage (STANDARD_GS, STANDARD_DS en STANDARD_DSV2 reeks). snaar

ApplicationPackageReference

Naam Beschrijving Waarde
legitimatiebewijs De id van het toepassingspakket dat moet worden geïnstalleerd. Dit moet zich binnen hetzelfde batchaccount bevinden als de pool. Dit kan een verwijzing naar een specifieke versie zijn of de standaardversie als deze bestaat. tekenreeks (vereist)
Versie Als dit wordt weggelaten en er geen standaardversie is opgegeven voor deze toepassing, mislukt de aanvraag met de foutcode InvalidApplicationPackageReferences. Als u de REST API rechtstreeks aanroept, is de HTTP-statuscode 409. snaar

CertificateReference

Naam Beschrijving Waarde
legitimatiebewijs De volledig gekwalificeerde id van het certificaat dat moet worden geïnstalleerd in de groep. Dit moet zich binnen hetzelfde batchaccount bevinden als de pool. tekenreeks (vereist)
storeLocation De standaardwaarde is currentUser. Deze eigenschap is alleen van toepassing op pools die zijn geconfigureerd met Windows-knooppunten (dat wil gezegd, gemaakt met cloudServiceConfiguration of met virtualMachineConfiguration met behulp van een Windows-installatiekopieënreferentie). Voor Linux-rekenknooppunten worden de certificaten opgeslagen in een map in de werkmap van de taak en wordt een omgevingsvariabele AZ_BATCH_CERTIFICATES_DIR aan de taak geleverd om een query uit te voeren op deze locatie. Voor certificaten met zichtbaarheid van remoteUser wordt een map met certificaten gemaakt in de basismap van de gebruiker (bijvoorbeeld /home/{user-name}/certs) en worden certificaten in die map geplaatst. 'CurrentUser'
'LocalMachine'
storeName Deze eigenschap is alleen van toepassing op pools die zijn geconfigureerd met Windows-knooppunten (dat wil gezegd, gemaakt met cloudServiceConfiguration of met virtualMachineConfiguration met behulp van een Windows-installatiekopieënreferentie). Algemene winkelnamen zijn: My, Root, CA, Trust, Disallowed, TrustedPeople, TrustedPublisher, AuthRoot, AddressBook, maar elke aangepaste winkelnaam kan ook worden gebruikt. De standaardwaarde is Mijn. snaar
zichtbaarheid Welke gebruikersaccounts op het rekenknooppunt toegang moeten hebben tot de persoonlijke gegevens van het certificaat. Tekenreeksmatrix met een van de volgende waarden:
RemoteUser
'StartTask'
'Taak'

DeploymentConfiguration

Naam Beschrijving Waarde
cloudServiceConfiguration Deze eigenschap en virtualMachineConfiguration sluiten elkaar wederzijds uit en een van de eigenschappen moet worden opgegeven. Deze eigenschap kan niet worden opgegeven als het Batch-account is gemaakt met de eigenschap poolAllocationMode ingesteld op UserSubscription. CloudServiceConfiguration-
virtualMachineConfiguration Deze eigenschap en cloudServiceConfiguration sluiten elkaar wederzijds uit en een van de eigenschappen moet worden opgegeven. VirtualMachineConfiguration-

CloudServiceConfiguration

Naam Beschrijving Waarde
osFamily Mogelijke waarden zijn: 2 - OS Family 2, gelijk aan Windows Server 2008 R2 SP1. 3 - OS Family 3, gelijk aan Windows Server 2012. 4 - OS Family 4, gelijk aan Windows Server 2012 R2. 5 - OS Family 5, gelijk aan Windows Server 2016. 6 - Os Family 6, gelijk aan Windows Server 2019. Zie Releases van Azure-gastbesturingssystemen (https://azure.microsoft.com/documentation/articles/cloud-services-guestos-update-matrix/#releases) voor meer informatie. tekenreeks (vereist)
osVersion De standaardwaarde is * waarmee de meest recente versie van het besturingssysteem voor de opgegeven besturingssysteemfamilie wordt opgegeven. snaar

VirtualMachineConfiguration

Naam Beschrijving Waarde
containerConfiguration Indien opgegeven, wordt de installatie uitgevoerd op elk knooppunt in de pool, zodat taken in containers kunnen worden uitgevoerd. Alle reguliere taken en jobbeheertaken die in deze pool worden uitgevoerd, moeten de eigenschap containerSettings opgeven en alle andere taken kunnen deze opgeven. ContainerConfiguration-
dataDisks Deze eigenschap moet worden opgegeven als aan de rekenknooppunten in de pool lege gegevensschijven moeten zijn gekoppeld. DataDisk[]
diskEncryptionConfiguration Indien opgegeven, wordt versleuteling uitgevoerd op elk knooppunt in de pool tijdens het inrichten van knooppunten. DiskEncryptionConfiguration-
Extensies Indien opgegeven, worden de extensies die in deze configuratie worden genoemd, op elk knooppunt geïnstalleerd. VMExtension[]
imageReference Een verwijzing naar een Azure Virtual Machines Marketplace-installatiekopieën of de Azure-installatiekopieënresource van een aangepaste virtuele machine. Zie de bewerking Ondersteunde knooppuntagent-SKU's weergeven om de lijst met alle imageReferences op te halen die door Azure Batch zijn geverifieerd. ImageReference (vereist)
licenseType Dit geldt alleen voor installatiekopieën die het Windows-besturingssysteem bevatten en mogen alleen worden gebruikt wanneer u geldige on-premises licenties hebt voor de knooppunten die worden geïmplementeerd. Als u dit weglaat, wordt er geen korting op on-premises licenties toegepast. Waarden zijn:

Windows_Server: de on-premises licentie is voor Windows Server.
Windows_Client: de on-premises licentie is voor Windows Client.
snaar
nodeAgentSkuId De Batch-knooppuntagent is een programma dat wordt uitgevoerd op elk knooppunt in de pool en biedt de interface voor opdracht en beheer tussen het knooppunt en de Batch-service. Er zijn verschillende implementaties van de knooppuntagent, ook wel SKU's genoemd, voor verschillende besturingssystemen. U moet een knooppuntagent-SKU opgeven die overeenkomt met de geselecteerde afbeeldingsreferentie. Zie de bewerking Ondersteunde agent-SKU's voor ondersteunde knooppunten, samen met de lijst met geverifieerde afbeeldingsverwijzingen, de bewerking Ondersteunde knooppuntagent-SKU's weergeven. tekenreeks (vereist)
nodePlacementConfiguration Met deze configuratie worden regels opgegeven voor de manier waarop knooppunten in de pool fysiek worden toegewezen. NodePlacementConfiguration-
osDisk Bevat configuratie voor tijdelijke OSDisk-instellingen. OSDisk-
windowsConfiguration Deze eigenschap mag niet worden opgegeven als de imageReference een Installatiekopie van het Linux-besturingssysteem opgeeft. WindowsConfiguration-

ContainerConfiguration

Naam Beschrijving Waarde
containerImageNames Dit is de volledige naslaginformatie over de installatiekopie, zoals wordt opgegeven voor 'docker pull'. Een installatiekopieën worden afkomstig uit het standaard-Docker-register, tenzij de installatiekopieën volledig zijn gekwalificeerd met een alternatief register. tekenreeks[]
containerregisters Als installatiekopieën moeten worden gedownload uit een persoonlijk register waarvoor referenties zijn vereist, moeten deze referenties hier worden opgegeven. ContainerRegistry-[]
type De containertechnologie die moet worden gebruikt. 'DockerCompatible' (vereist)

ContainerRegistry

Naam Beschrijving Waarde
identityReference De verwijzing naar een door de gebruiker toegewezen identiteit die is gekoppeld aan de Batch-pool die door een rekenknooppunt wordt gebruikt. ComputeNodeIdentityReference
wachtwoord Het wachtwoord om u aan te melden bij de registerserver. snaar
registryServer Als u dit weglaat, is de standaardwaarde 'docker.io'. snaar
gebruikersnaam De gebruikersnaam om u aan te melden bij de registerserver. snaar

ComputeNodeIdentityReference

Naam Beschrijving Waarde
resourceId De ARM-resource-id van de door de gebruiker toegewezen identiteit. snaar

DataDisk

Naam Beschrijving Waarde
Caching Waarden zijn:

geen: de cachemodus voor de schijf is niet ingeschakeld.
readOnly: de cachemodus voor de schijf is alleen-lezen.
readWrite: de cachemodus voor de schijf is lezen en schrijven.

De standaardwaarde voor opslaan in cache is geen. Zie voor meer informatie over de cacheopties: https://blogs.msdn.microsoft.com/windowsazurestorage/2012/06/27/exploring-windows-azure-drives-disks-and-images/.
'Geen'
'ReadOnly'
'ReadWrite'
diskSizeGB De initiële schijfgrootte in GB bij het maken van een nieuwe gegevensschijf. int (vereist)
Lun De lun wordt gebruikt om elke gegevensschijf uniek te identificeren. Als u meerdere schijven koppelt, moet elk een afzonderlijke lun hebben. De waarde moet tussen 0 en 63 liggen, inclusief. int (vereist)
storageAccountType Als u dit weglaat, is de standaardwaarde 'Standard_LRS'. Waarden zijn:

Standard_LRS: de gegevensschijf moet standaard lokaal redundante opslag gebruiken.
Premium_LRS: de gegevensschijf moet premium lokaal redundante opslag gebruiken.
'Premium_LRS'
'Standard_LRS'

DiskEncryptionConfiguration

Naam Beschrijving Waarde
Doelstellingen In linux-pool wordt alleen 'TemporaryDisk' ondersteund; in windows-pool moeten 'OsDisk' en 'TemporaryDisk' worden opgegeven. Tekenreeksmatrix met een van de volgende waarden:
'OsDisk'
'TemporaryDisk'

VMExtension

Naam Beschrijving Waarde
autoUpgradeMinorVersion Geeft aan of de extensie een nieuwere secundaire versie moet gebruiken als deze beschikbaar is tijdens de implementatie. Zodra de extensie eenmaal is geïmplementeerd, worden er echter geen secundaire versies bijgewerkt, tenzij deze opnieuw wordt geïmplementeerd, zelfs niet als deze eigenschap is ingesteld op true. Bool
naam De naam van de extensie van de virtuele machine. tekenreeks (vereist)
protectedSettings De extensie kan protectedSettings of protectedSettingsFromKeyVault of helemaal geen beveiligde instellingen bevatten.
provisionAfterExtensions Verzameling extensienamen waarna deze extensie moet worden ingericht. tekenreeks[]
uitgever De naam van de uitgever van de extensie-handler. tekenreeks (vereist)
Instellingen Openbare instellingen met JSON-indeling voor de extensie.
type Het type extensies. tekenreeks (vereist)
typeHandlerVersion De versie van de scripthandler. snaar

ImageReference

Naam Beschrijving Waarde
legitimatiebewijs Deze eigenschap is wederzijds exclusief met andere eigenschappen. De installatiekopieën van de galerie met gedeelde installatiekopieën moeten replica's hebben in dezelfde regio als het Azure Batch-account. Zie /azure/batch/batch-api-basics#virtual-network-vnet-and-firewall-configuration voor informatie over de firewallinstellingen voor de Batch-knooppuntagent om te communiceren met de Batch-service. snaar
aanbieden Bijvoorbeeld UbuntuServer of WindowsServer. snaar
uitgever Bijvoorbeeld Canonical of MicrosoftWindowsServer. snaar
Sku Bijvoorbeeld 18.04-LTS of 2022-datacenter. snaar
Versie Er kan een waarde van 'latest' worden opgegeven om de meest recente versie van een installatiekopieën te selecteren. Als u dit weglaat, is de standaardwaarde 'nieuwste'. snaar

NodePlacementConfiguration

Naam Beschrijving Waarde
beleid Toewijzingsbeleid dat door Batch Service wordt gebruikt om de knooppunten in te richten. Als dit niet is opgegeven, gebruikt Batch het regionale beleid. 'Regionaal'
'Zonegebonden'

OSDisk

Naam Beschrijving Waarde
kortstondigeOSDiskSettings Hiermee geeft u de tijdelijke schijfinstellingen voor de besturingssysteemschijf die door de virtuele machine wordt gebruikt. DiffDiskSettings

DiffDiskSettings

Naam Beschrijving Waarde
Plaatsing Deze eigenschap kan worden gebruikt door de gebruiker in de aanvraag om te kiezen op welke locatie het besturingssysteem zich moet bevinden. Bijvoorbeeld: cacheschijfruimte voor kortstondige besturingssysteemschijfinrichting. Raadpleeg voor meer informatie over tijdelijke vereisten voor besturingssysteemschijfgrootte de vereisten voor tijdelijke besturingssysteemschijfgrootte voor Windows-VM's op /azure/virtual-machines/windows/kortstondige os-schijven#groottevereisten en Linux-VM's op /azure/virtual-machines/linux/kortstondige-os-schijven#grootte-vereisten. 'CacheDisk'

WindowsConfiguration

Naam Beschrijving Waarde
enableAutomaticUpdates Als u dit weglaat, is de standaardwaarde waar. Bool

MetadataItem

Naam Beschrijving Waarde
naam De naam van het metagegevensitem. tekenreeks (vereist)
waarde De waarde van het metagegevensitem. tekenreeks (vereist)

MountConfiguration

Naam Beschrijving Waarde
azureBlobFileSystemConfiguration Deze eigenschap is wederzijds exclusief met alle andere eigenschappen. AzureBlobFileSystemConfiguration-
azureFileShareConfiguration Deze eigenschap is wederzijds exclusief met alle andere eigenschappen. AzureFileShareConfiguration-
cifsMountConfiguration Deze eigenschap is wederzijds exclusief met alle andere eigenschappen. CifsMountConfiguration-
nfsMountConfiguration Deze eigenschap is wederzijds exclusief met alle andere eigenschappen. NFSMountConfiguration-

AzureBlobFileSystemConfiguration

Naam Beschrijving Waarde
accountKey Deze eigenschap is wederzijds exclusief met zowel sasKey als identiteit; er moet precies één worden opgegeven. snaar
accountName De naam van het Azure Storage-account. tekenreeks (vereist)
blobfuseOptions Dit zijn opties voor 'net use' in Windows en opties voor koppelen in Linux. snaar
containerName De naam van de Azure Blob Storage-container. tekenreeks (vereist)
identityReference Deze eigenschap is wederzijds exclusief met zowel accountKey als sasKey; er moet precies één worden opgegeven. ComputeNodeIdentityReference
relativeMountPath Alle bestandssystemen worden gekoppeld ten opzichte van de map batchkoppelingen, die toegankelijk zijn via de omgevingsvariabele AZ_BATCH_NODE_MOUNTS_DIR. tekenreeks (vereist)
sasKey Deze eigenschap is wederzijds exclusief met zowel accountKey als identiteit; er moet precies één worden opgegeven. snaar

AzureFileShareConfiguration

Naam Beschrijving Waarde
accountKey De sleutel van het Azure Storage-account. tekenreeks (vereist)
accountName De naam van het Azure Storage-account. tekenreeks (vereist)
azureFileUrl Dit is de vorm 'https://{account}.file.core.windows.net/'. tekenreeks (vereist)
mountOptions Dit zijn opties voor 'net use' in Windows en opties voor koppelen in Linux. snaar
relativeMountPath Alle bestandssystemen worden gekoppeld ten opzichte van de map batchkoppelingen, die toegankelijk zijn via de omgevingsvariabele AZ_BATCH_NODE_MOUNTS_DIR. tekenreeks (vereist)

CifsMountConfiguration

Naam Beschrijving Waarde
mountOptions Dit zijn opties voor 'net use' in Windows en opties voor koppelen in Linux. snaar
wachtwoord Het wachtwoord dat moet worden gebruikt voor verificatie op basis van het CIFS-bestandssysteem. tekenreeks (vereist)
relativeMountPath Alle bestandssystemen worden gekoppeld ten opzichte van de map batchkoppelingen, die toegankelijk zijn via de omgevingsvariabele AZ_BATCH_NODE_MOUNTS_DIR. tekenreeks (vereist)
bron De URI van het bestandssysteem die moet worden gekoppeld. tekenreeks (vereist)
gebruikersnaam De gebruiker die moet worden gebruikt voor verificatie op basis van het CIFS-bestandssysteem. tekenreeks (vereist)

NFSMountConfiguration

Naam Beschrijving Waarde
mountOptions Dit zijn opties voor 'net use' in Windows en opties voor koppelen in Linux. snaar
relativeMountPath Alle bestandssystemen worden gekoppeld ten opzichte van de map batchkoppelingen, die toegankelijk zijn via de omgevingsvariabele AZ_BATCH_NODE_MOUNTS_DIR. tekenreeks (vereist)
bron De URI van het bestandssysteem die moet worden gekoppeld. tekenreeks (vereist)

NetworkConfiguration

Naam Beschrijving Waarde
dynamicVNetAssignmentScope Het bereik van dynamische vnet-toewijzing. 'job'
'geen'
endpointConfiguration De configuratie van het pooleindpunt wordt alleen ondersteund voor pools met de eigenschap virtualMachineConfiguration. PoolEndpointConfiguration-
publicIPAddressConfiguration Deze eigenschap wordt alleen ondersteund in Pools met de eigenschap virtualMachineConfiguration. PublicIPAddressConfiguration-
subnetId Het virtuele netwerk moet zich in dezelfde regio en hetzelfde abonnement bevinden als het Azure Batch-account. Het opgegeven subnet moet voldoende vrije IP-adressen hebben om tegemoet te komen aan het aantal knooppunten in de groep. Als het subnet niet voldoende vrije IP-adressen heeft, wijst de pool gedeeltelijk rekenknooppunten toe en treedt er een fout op bij het wijzigen van de grootte. De service-principal 'MicrosoftAzureBatch' moet de rol 'Inzender voor klassieke virtuele machines' hebben Role-Based RBAC-rol (Access Control) voor het opgegeven VNet. Het opgegeven subnet moet communicatie van de Azure Batch-service toestaan om taken op de rekenknooppunten te kunnen plannen. Dit kan worden gecontroleerd door te controleren of het opgegeven VNet gekoppelde netwerkbeveiligingsgroepen (NSG' heeft). Als communicatie met de rekenknooppunten in het opgegeven subnet wordt geweigerd door een NSG, stelt de Batch-service de status van de rekenknooppunten in op onbruikbaar. Als het opgegeven VNet gekoppelde netwerkbeveiligingsgroepen (NSG) heeft, moeten enkele gereserveerde systeempoorten zijn ingeschakeld voor binnenkomende communicatie. Schakel poorten 29876 en 29877, evenals poort 22 voor Linux en poort 3389 voor Windows in voor pools die zijn gemaakt met een configuratie van een virtuele machine. Voor pools die zijn gemaakt met een cloudserviceconfiguratie, schakelt u poorten 10100, 20100 en 30100 in. Schakel ook uitgaande verbindingen met Azure Storage in op poort 443. Voor cloudServiceConfiguration-pools worden alleen 'klassieke' VNET's ondersteund. Zie voor meer informatie: /azure/batch/batch-api-basics#virtual-network-vnet-and-firewall-configuration snaar

PoolEndpointConfiguration

Naam Beschrijving Waarde
inboundNatPools Het maximum aantal binnenkomende NAT-pools per Batch-pool is 5. Als het maximum aantal binnenkomende NAT-pools wordt overschreden, mislukt de aanvraag met HTTP-statuscode 400. Dit kan niet worden opgegeven als het IPAddressProvisioningType NoPublicIPAddresses is. InboundNatPool[] (vereist)

InboundNatPool

Naam Beschrijving Waarde
backendPort Dit moet uniek zijn binnen een Batch-pool. Acceptabele waarden liggen tussen 1 en 65535, met uitzondering van 22, 3389, 29876 en 29877, aangezien deze zijn gereserveerd. Als er gereserveerde waarden worden opgegeven, mislukt de aanvraag met HTTP-statuscode 400. int (vereist)
frontendPortRangeEnd Acceptabele waarden variëren tussen 1 en 65534, behalve poorten van 50000 tot 55000, die zijn gereserveerd door de Batch-service. Alle bereiken binnen een pool moeten uniek zijn en mogen niet overlappen. Als er gereserveerde of overlappende waarden worden opgegeven, mislukt de aanvraag met HTTP-statuscode 400. int (vereist)
frontendPortRangeStart Acceptabele waarden variëren tussen 1 en 65534, met uitzondering van poorten van 50000 tot 55000 die zijn gereserveerd. Alle bereiken binnen een pool moeten uniek zijn en mogen niet overlappen. Als er gereserveerde of overlappende waarden worden opgegeven, mislukt de aanvraag met HTTP-statuscode 400. int (vereist)
naam De naam moet uniek zijn binnen een Batch-pool, kan letters, cijfers, onderstrepingstekens, punten en afbreekstreepjes bevatten. Namen moeten beginnen met een letter of cijfer, moeten eindigen op een letter, cijfer of onderstrepingsteken en mogen niet langer zijn dan 77 tekens. Als er ongeldige waarden worden opgegeven, mislukt de aanvraag met HTTP-statuscode 400. tekenreeks (vereist)
networkSecurityGroupRules Het maximum aantal regels dat kan worden opgegeven voor alle eindpunten in een Batch-pool is 25. Als er geen regels voor netwerkbeveiligingsgroepen zijn opgegeven, wordt er een standaardregel gemaakt om binnenkomende toegang tot de opgegeven backendPort toe te staan. Als het maximum aantal regels voor netwerkbeveiligingsgroepen wordt overschreden, mislukt de aanvraag met HTTP-statuscode 400. NetworkSecurityGroupRule[]
protocol Het protocol van het eindpunt. 'TCP'
UDP (vereist)

NetworkSecurityGroupRule

Naam Beschrijving Waarde
toegang De actie die moet worden uitgevoerd voor een opgegeven IP-adres, subnetbereik of tag. 'Toestaan'
'Weigeren' (vereist)
voorrang Prioriteiten binnen een pool moeten uniek zijn en worden geëvalueerd in volgorde van prioriteit. Hoe lager het getal hoe hoger de prioriteit. Regels kunnen bijvoorbeeld worden opgegeven met ordernummers van 150, 250 en 350. De regel met het volgordenummer 150 heeft voorrang op de regel met een volgorde van 250. Toegestane prioriteiten zijn 150 tot 4096. Als er gereserveerde of dubbele waarden worden opgegeven, mislukt de aanvraag met HTTP-statuscode 400. int (vereist)
sourceAddressPrefix Geldige waarden zijn één IP-adres (bijvoorbeeld 10.10.10.10), IP-subnet (bijvoorbeeld 192.168.1.0/24), standaardtag of * (voor alle adressen). Als er andere waarden worden opgegeven, mislukt de aanvraag met HTTP-statuscode 400. tekenreeks (vereist)
sourcePortRanges Geldige waarden zijn *(voor alle poorten 0 - 65535) of matrices van poorten of poortbereiken (bijvoorbeeld 100-200). De poorten moeten tussen 0 en 65535 liggen en de poortbereiken of poorten mogen niet overlappen. Als er andere waarden worden opgegeven, mislukt de aanvraag met HTTP-statuscode 400. De standaardwaarde is *. tekenreeks[]

PublicIPAddressConfiguration

Naam Beschrijving Waarde
ipAddressIds Het aantal IP-adressen dat hier is opgegeven, beperkt de maximale grootte van de pool - 100 toegewezen knooppunten of 100 spot-/lage prioriteitsknooppunten kunnen worden toegewezen voor elk openbaar IP-adres. Een pool die bijvoorbeeld 250 toegewezen VM's nodig heeft, heeft ten minste 3 openbare IP-adressen nodig. Elk element van deze verzameling heeft de volgende vorm: /subscriptions/{subscription}/resourceGroups/{group}/providers/Microsoft.Network/publicIPAddresses/{ip}. tekenreeks[]
bepaling De standaardwaarde is BatchManaged 'BatchManaged'
'NoPublicIPAddresses'
UserManaged

ScaleSettings

Naam Beschrijving Waarde
automatisch schalen Deze eigenschap en fixedScale sluiten elkaar wederzijds uit en een van de eigenschappen moet worden opgegeven. AutoScaleSettings
fixedScale Deze eigenschap en automatische schaalaanpassing sluiten elkaar wederzijds uit en een van de eigenschappen moet worden opgegeven. FixedScaleSettings-

AutoScaleSettings

Naam Beschrijving Waarde
evaluationInterval Als u dit weglaat, is de standaardwaarde 15 minuten (PT15M). snaar
formule Een formule voor het gewenste aantal rekenknooppunten in de pool. tekenreeks (vereist)

FixedScaleSettings

Naam Beschrijving Waarde
nodeDeallocationOption Als u dit weglaat, is de standaardwaarde Requeue. 'Requeue'
'RetainedData'
'TaskCompletion'
'Beëindigen'
resizeTimeout De standaardwaarde is 15 minuten. Time-outwaarden maken gebruik van iso 8601-indeling. Gebruik bijvoorbeeld PT10M gedurende 10 minuten. De minimumwaarde is 5 minuten. Als u een waarde opgeeft die minder dan 5 minuten duurt, weigert de Batch-service de aanvraag met een fout; als u de REST API rechtstreeks aanroept, is de HTTP-statuscode 400 (Ongeldige aanvraag). snaar
targetDedicatedNodes Ten minste één van targetDedicatedNodes, targetLowPriorityNodes moet worden ingesteld. Int
targetLowPriorityNodes Ten minste één van targetDedicatedNodes, targetLowPriorityNodes moet worden ingesteld. Int

StartTask

Naam Beschrijving Waarde
commandLine De opdrachtregel wordt niet uitgevoerd onder een shell en kan daarom niet profiteren van shell-functies zoals uitbreiding van omgevingsvariabelen. Als u van dergelijke functies wilt profiteren, moet u de shell aanroepen op de opdrachtregel, bijvoorbeeld met 'cmd /c MyCommand' in Windows of '/bin/sh -c MyCommand' in Linux. Vereist als er andere eigenschappen van de startTask zijn opgegeven. snaar
containerSettings Wanneer dit is opgegeven, worden alle mappen recursief onder de AZ_BATCH_NODE_ROOT_DIR (de hoofdmap van Azure Batch-mappen op het knooppunt) toegewezen aan de container, worden alle omgevingsvariabelen voor taken toegewezen aan de container en wordt de opdrachtregel van de taak uitgevoerd in de container. TaskContainerSettings-
environmentSettings Een lijst met omgevingsvariabeleinstellingen voor de begintaak. EnvironmentSetting[]
maxTaskRetryCount De Batch-service probeert een taak opnieuw uit te voeren als de afsluitcode niet-nul is. Houd er rekening mee dat deze waarde specifiek het aantal nieuwe pogingen bepaalt. De Batch-service probeert de taak eenmaal uit en probeert vervolgens opnieuw tot deze limiet. Als het maximumaantal nieuwe pogingen bijvoorbeeld 3 is, probeert Batch de taak maximaal vier keer (één eerste poging en drie nieuwe pogingen). Als het maximumaantal nieuwe pogingen 0 is, voert de Batch-service de taak niet opnieuw uit. Als het maximumaantal nieuwe pogingen -1 is, probeert de Batch-service de taak opnieuw zonder limiet, maar dit wordt niet aanbevolen voor een begintaak of een taak. De standaardwaarde is 0 (geen nieuwe pogingen). Int
resourceFiles Een lijst met bestanden die de Batch-service naar het rekenknooppunt downloadt voordat u de opdrachtregel uitvoert. ResourceFile[]
userIdentity Als u dit weglaat, wordt de taak uitgevoerd als een niet-gebruiker met beheerdersrechten die uniek is voor de taak. UserIdentity-
waitForSuccess Als waar is en de begintaak mislukt op een rekenknooppunt, probeert de Batch-service de opstarttaak opnieuw uit te voeren tot het maximumaantal nieuwe pogingen (maxTaskRetryCount). Als de taak na alle nieuwe pogingen nog steeds niet is voltooid, markeert de Batch-service het rekenknooppunt onbruikbaar en worden er geen taken naar gepland. Deze voorwaarde kan worden gedetecteerd via de knooppuntstatus en planningsfoutdetails. Als dit onwaar is, wacht de Batch-service niet totdat de begintaak is voltooid. In dit geval kunnen andere taken worden uitgevoerd op het rekenknooppunt terwijl de begintaak nog steeds wordt uitgevoerd; en zelfs als de begintaak mislukt, blijven nieuwe taken gepland op het knooppunt. De standaardwaarde is waar. Bool

TaskContainerSettings

Naam Beschrijving Waarde
containerRunOptions Deze extra opties worden geleverd als argumenten voor de opdracht Docker create, naast de opties die worden beheerd door de Batch-service. snaar
imageName Dit is de volledige naslaginformatie over de installatiekopie, zoals wordt opgegeven voor 'docker pull'. Als er geen tag wordt opgegeven als onderdeel van de naam van de installatiekopieën, wordt de tag ':latest' als standaard gebruikt. tekenreeks (vereist)
register Deze instelling kan worden weggelaten als deze al is opgegeven bij het maken van een pool. ContainerRegistry-
workingDirectory Een vlag om aan te geven waar de werkmap van de containertaak zich bevindt. De standaardwaarde is taskWorkingDirectory. 'ContainerImageDefault'
'TaskWorkingDirectory'

EnvironmentSetting

Naam Beschrijving Waarde
naam De naam van de omgevingsvariabele. tekenreeks (vereist)
waarde De waarde van de omgevingsvariabele. snaar

ResourceFile

Naam Beschrijving Waarde
autoStorageContainerName De eigenschappen autoStorageContainerName, storageContainerUrl en httpUrl sluiten elkaar wederzijds uit en een van deze moet worden opgegeven. snaar
blobPrefix De eigenschap is alleen geldig wanneer autoStorageContainerName of storageContainerUrl wordt gebruikt. Dit voorvoegsel kan een gedeeltelijke bestandsnaam of een submap zijn. Als er geen voorvoegsel is opgegeven, worden alle bestanden in de container gedownload. snaar
fileMode Deze eigenschap is alleen van toepassing op bestanden die worden gedownload naar Linux-rekenknooppunten. Deze wordt genegeerd als deze is opgegeven voor een resourceFile die wordt gedownload naar een Windows-knooppunt. Als deze eigenschap niet is opgegeven voor een Linux-knooppunt, wordt een standaardwaarde van 0770 toegepast op het bestand. snaar
filePath Als de eigenschap httpUrl is opgegeven, is het filePath vereist en wordt het pad beschreven waarnaar het bestand wordt gedownload, inclusief de bestandsnaam. Als anders de eigenschap autoStorageContainerName of storageContainerUrl is opgegeven, is filePath optioneel en is het de map waarin de bestanden moeten worden gedownload. In het geval dat filePath wordt gebruikt als map, wordt elke mapstructuur die al aan de invoergegevens is gekoppeld, volledig bewaard en toegevoegd aan de opgegeven filePath-map. Het opgegeven relatieve pad kan niet worden uitgesplitsd uit de werkmap van de taak (bijvoorbeeld met '..'). snaar
httpUrl De eigenschappen autoStorageContainerName, storageContainerUrl en httpUrl sluiten elkaar wederzijds uit en een van deze moet worden opgegeven. Als de URL verwijst naar Azure Blob Storage, moet deze leesbaar zijn vanuit rekenknooppunten. Er zijn drie manieren om een dergelijke URL op te halen voor een blob in Azure Storage: neem een SAS (Shared Access Signature) die leesmachtigingen voor de blob verleent, gebruik een beheerde identiteit met leesmachtigingen of stel de ACL voor de blob of de container in om openbare toegang toe te staan. snaar
identityReference De verwijzing naar een door de gebruiker toegewezen identiteit die is gekoppeld aan de Batch-pool die door een rekenknooppunt wordt gebruikt. ComputeNodeIdentityReference
storageContainerUrl De eigenschappen autoStorageContainerName, storageContainerUrl en httpUrl sluiten elkaar wederzijds uit en een van deze moet worden opgegeven. Deze URL moet kunnen worden gelezen en vermeld vanuit rekenknooppunten. Er zijn drie manieren om een dergelijke URL op te halen voor een container in Azure Storage: neem een SAS (Shared Access Signature) op die lees- en lijstmachtigingen voor de container verleent, gebruik een beheerde identiteit met lees- en lijstmachtigingen of stel de ACL voor de container in om openbare toegang toe te staan. snaar

UserIdentity

Naam Beschrijving Waarde
autoUser De eigenschappen userName en autoUser sluiten elkaar wederzijds uit; u moet één, maar niet beide opgeven. AutoUserSpecification-
userName De eigenschappen userName en autoUser sluiten elkaar wederzijds uit; u moet één, maar niet beide opgeven. snaar

AutoUserSpecification

Naam Beschrijving Waarde
elevationLevel De standaardwaarde is nietAdmin. 'Beheerder'
'NonAdmin'
draagwijdte De standaardwaarde is Pool. Als de pool Windows uitvoert, moet een waarde van Taak worden opgegeven als strengere isolatie tussen taken vereist is. Als de taak bijvoorbeeld het register op een manier muteert die van invloed kan zijn op andere taken, of als certificaten zijn opgegeven in de pool die niet toegankelijk moet zijn voor normale taken, maar toegankelijk moeten zijn voor begintaken. 'Pool'
'Taak'

TaskSchedulingPolicy

Naam Beschrijving Waarde
nodeFillType Hoe taken moeten worden verdeeld over rekenknooppunten. 'Inpakken'
'Spread' (vereist)

UserAccount

Naam Beschrijving Waarde
elevationLevel nonAdmin: de automatische gebruiker is een standaardgebruiker zonder verhoogde toegang. beheerder: de automatische gebruiker is een gebruiker met verhoogde toegang en werkt met volledige beheerdersmachtigingen. De standaardwaarde is nietAdmin. 'Beheerder'
'NonAdmin'
linuxUserConfiguration Deze eigenschap wordt genegeerd als deze is opgegeven in een Windows-pool. Als dit niet is opgegeven, wordt de gebruiker gemaakt met de standaardopties. LinuxUserConfiguration-
naam De naam van het gebruikersaccount. tekenreeks (vereist)
wachtwoord Het wachtwoord voor het gebruikersaccount. tekenreeks (vereist)
windowsUserConfiguration Deze eigenschap kan alleen worden opgegeven als de gebruiker zich in een Windows-pool bevindt. Als dit niet is opgegeven en in een Windows-pool, wordt de gebruiker gemaakt met de standaardopties. WindowsUserConfiguration-

LinuxUserConfiguration

Naam Beschrijving Waarde
Gid De uid- en gid-eigenschappen moeten samen worden opgegeven of helemaal niet. Als het onderliggende besturingssysteem niet is opgegeven, kiest u de gid. Int
sshPrivateKey De persoonlijke sleutel mag niet met een wachtwoord zijn beveiligd. De persoonlijke sleutel wordt gebruikt om automatisch verificatie op basis van asymmetrische sleutels te configureren voor SSH tussen knooppunten in een Linux-pool wanneer de eigenschap enableInterNodeCommunication van de pool waar is (deze wordt genegeerd als enableInterNodeCommunication onwaar is). Dit doet u door het sleutelpaar in de map .ssh van de gebruiker te plaatsen. Als dit niet is opgegeven, is SSH zonder wachtwoord niet geconfigureerd tussen knooppunten (er wordt geen wijziging van de .ssh-map van de gebruiker uitgevoerd). snaar
Uid De uid- en gid-eigenschappen moeten samen worden opgegeven of helemaal niet. Als het onderliggende besturingssysteem niet is opgegeven, wordt de uid gekozen. Int

WindowsUserConfiguration

Naam Beschrijving Waarde
loginMode Hiermee geeft u de aanmeldingsmodus voor de gebruiker. De standaardwaarde voor VirtualMachineConfiguration-pools is de interactieve modus en voor CloudServiceConfiguration-pools is de batchmodus. 'Batch'
'Interactief'

Quickstart-sjablonen

Met de volgende quickstart-sjablonen wordt dit resourcetype geïmplementeerd.

Sjabloon Beschrijving
Azure Batch-pool zonder openbare IP-adressen

implementeren in Azure
Met deze sjabloon maakt u een vereenvoudigde knooppuntcommunicatiegroep van Azure Batch zonder openbare IP-adressen.

Resourcedefinitie van Terraform (AzAPI-provider)

Het resourcetype batchAccounts/pools kan worden geïmplementeerd met bewerkingen die zijn gericht op:

  • resourcegroepen

Zie logboek wijzigenvoor een lijst met gewijzigde eigenschappen in elke API-versie.

Resource-indeling

Als u een Resource microsoft.Batch/batchAccounts/pools wilt maken, voegt u de volgende Terraform toe aan uw sjabloon.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Batch/batchAccounts/pools@2022-01-01"
  name = "string"
  parent_id = "string"
  identity {
    type =  "UserAssigned"
    identity_ids = []
  }
  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 = [
              {
                identityReference = {
                  resourceId = "string"
                }
                password = "string"
                registryServer = "string"
                username = "string"
              }
            ]
            type = "DockerCompatible"
          }
          dataDisks = [
            {
              caching = "string"
              diskSizeGB = int
              lun = int
              storageAccountType = "string"
            }
          ]
          diskEncryptionConfiguration = {
            targets = [
              "string"
            ]
          }
          extensions = [
            {
              autoUpgradeMinorVersion = bool
              name = "string"
              provisionAfterExtensions = [
                "string"
              ]
              publisher = "string"
              type = "string"
              typeHandlerVersion = "string"
            }
          ]
          imageReference = {
            id = "string"
            offer = "string"
            publisher = "string"
            sku = "string"
            version = "string"
          }
          licenseType = "string"
          nodeAgentSkuId = "string"
          nodePlacementConfiguration = {
            policy = "string"
          }
          osDisk = {
            ephemeralOSDiskSettings = {
              placement = "CacheDisk"
            }
          }
          windowsConfiguration = {
            enableAutomaticUpdates = bool
          }
        }
      }
      displayName = "string"
      interNodeCommunication = "string"
      metadata = [
        {
          name = "string"
          value = "string"
        }
      ]
      mountConfiguration = [
        {
          azureBlobFileSystemConfiguration = {
            accountKey = "string"
            accountName = "string"
            blobfuseOptions = "string"
            containerName = "string"
            identityReference = {
              resourceId = "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 = {
        dynamicVNetAssignmentScope = "string"
        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 = {
            identityReference = {
              resourceId = "string"
            }
            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"
            identityReference = {
              resourceId = "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"
    }
  })
}

Eigenschapswaarden

batchAccounts/pools

Naam Beschrijving Waarde
type Het resourcetype "Microsoft.Batch/batchAccounts/pools@2022-01-01"
naam De resourcenaam tekenreeks (vereist)

Tekenlimiet: 1-64

Geldige tekens:
Alfanumerieke tekst, onderstrepingstekens en afbreekstreepjes.
parent_id De id van de resource die het bovenliggende item voor deze resource is. Id voor resource van het type: batchAccounts
identiteit Het type identiteit dat wordt gebruikt voor de Batch-pool. BatchPoolIdentity-
Eigenschappen De eigenschappen die aan de pool zijn gekoppeld. PoolProperties-

BatchPoolIdentity

Naam Beschrijving Waarde
type Het type identiteit dat wordt gebruikt voor de Batch-pool. UserAssigned (vereist)
identity_ids De lijst met gebruikersidentiteiten die zijn gekoppeld aan de Batch-pool. Matrix van id's van gebruikersidentiteit.

BatchPoolIdentityUserAssignedIdentities

Naam Beschrijving Waarde
{aangepaste eigenschap} UserAssignedId-entiteiten

UserAssignedIdentities

Dit object bevat geen eigenschappen die tijdens de implementatie moeten worden ingesteld. Alle eigenschappen zijn ReadOnly.

PoolProperties

Naam Beschrijving Waarde
applicationLicenses De lijst met toepassingslicenties moet een subset van beschikbare Licenties voor Batch-servicetoepassingen zijn. Als er een licentie wordt aangevraagd die niet wordt ondersteund, mislukt het maken van een pool. tekenreeks[]
applicationPackages Wijzigingen in toepassingspakketverwijzingen zijn van invloed op alle nieuwe rekenknooppunten die lid zijn van de pool, maar hebben geen invloed op rekenknooppunten die al in de pool staan totdat ze opnieuw worden opgestart of opnieuw worden gemaakt. Er zijn maximaal 10 toepassingspakketverwijzingen voor een bepaalde groep. ApplicationPackageReference[]
Certificaten Voor Windows-rekenknooppunten installeert de Batch-service de certificaten naar het opgegeven certificaatarchief en de opgegeven locatie. Voor Linux-rekenknooppunten worden de certificaten opgeslagen in een map in de werkmap van de taak en wordt een omgevingsvariabele AZ_BATCH_CERTIFICATES_DIR aan de taak geleverd om een query uit te voeren op deze locatie. Voor certificaten met zichtbaarheid van remoteUser wordt een map met certificaten gemaakt in de basismap van de gebruiker (bijvoorbeeld /home/{user-name}/certs) en worden certificaten in die map geplaatst. CertificateReference[]
deploymentConfiguration Met Behulp van CloudServiceConfiguration geeft u op dat de knooppunten moeten worden gemaakt met behulp van Azure Cloud Services (PaaS), terwijl VirtualMachineConfiguration gebruikmaakt van Azure Virtual Machines (IaaS). DeploymentConfiguration-
displayName De weergavenaam hoeft niet uniek te zijn en mag unicode-tekens bevatten tot een maximale lengte van 1024. snaar
interNodeCommunication Hiermee worden beperkingen opgelegd aan welke knooppunten aan de pool kunnen worden toegewezen. Als u deze waarde inschakelt, kan de kans op het aangevraagde aantal knooppunten dat in de pool moet worden toegewezen, verminderen. Als deze waarde niet is opgegeven, wordt deze waarde standaard ingesteld op Uitgeschakeld. "Uitgeschakeld"
"Ingeschakeld"
metagegevens De Batch-service wijst geen betekenis toe aan metagegevens; deze is uitsluitend bedoeld voor het gebruik van gebruikerscode. MetadataItem[]
mountConfiguration Dit ondersteunt Azure Files, NFS, CIFS/SMB en Blobfuse. MountConfiguration[]
networkConfiguration De netwerkconfiguratie voor een pool. NetworkConfiguration-
scaleSettings Definieert de gewenste grootte van de pool. Dit kan 'fixedScale' zijn waarbij de aangevraagde targetDedicatedNodes is opgegeven, of 'autoScale' waarmee een formule wordt gedefinieerd die periodiek opnieuw wordt geëvalueerd. Als deze eigenschap niet is opgegeven, heeft de pool een vaste schaal met 0 targetDedicatedNodes. ScaleSettings
startTask In een PATCH-bewerking (update) kan deze eigenschap worden ingesteld op een leeg object om de begintaak uit de pool te verwijderen. StartTask-
taskSchedulingPolicy Als dit niet is opgegeven, wordt de standaardwaarde verspreid. TaskSchedulingPolicy-
taskSlotsPerNode De standaardwaarde is 1. De maximumwaarde is de kleinste van 4 keer het aantal kernen van de vmSize van de pool of 256. Int
userAccounts De lijst met gebruikersaccounts die op elk knooppunt in de pool moeten worden gemaakt. UserAccount[]
vmSize Zie Grootten voor Cloud Services (https://azure.microsoft.com/documentation/articles/cloud-services-sizes-specs/) voor informatie over de beschikbare grootten van virtuele machines voor Cloud Services-pools (pools die zijn gemaakt met cloudServiceConfiguration). Batch ondersteunt alle VM-grootten van Cloud Services, met uitzondering van ExtraSmall. Zie Grootten voor virtuele machines (Linux) (/azure/virtual-machines/sizes-general) of grootten voor virtuele machines (windows) of grootten voor virtuele machines (Windows) (https://azure.microsoft.com/documentation/articles/virtual-machines-windows-sizes/) voor meer informatie over beschikbare VM-grootten voor pools met behulp van installatiekopieën van de Virtual Machines Marketplace (pools die zijn gemaakt met virtualMachineConfiguration). Batch ondersteunt alle azure-VM-grootten, behalve STANDARD_A0 en vm's met Premium Storage (STANDARD_GS, STANDARD_DS en STANDARD_DSV2 reeks). snaar

ApplicationPackageReference

Naam Beschrijving Waarde
legitimatiebewijs De id van het toepassingspakket dat moet worden geïnstalleerd. Dit moet zich binnen hetzelfde batchaccount bevinden als de pool. Dit kan een verwijzing naar een specifieke versie zijn of de standaardversie als deze bestaat. tekenreeks (vereist)
Versie Als dit wordt weggelaten en er geen standaardversie is opgegeven voor deze toepassing, mislukt de aanvraag met de foutcode InvalidApplicationPackageReferences. Als u de REST API rechtstreeks aanroept, is de HTTP-statuscode 409. snaar

CertificateReference

Naam Beschrijving Waarde
legitimatiebewijs De volledig gekwalificeerde id van het certificaat dat moet worden geïnstalleerd in de groep. Dit moet zich binnen hetzelfde batchaccount bevinden als de pool. tekenreeks (vereist)
storeLocation De standaardwaarde is currentUser. Deze eigenschap is alleen van toepassing op pools die zijn geconfigureerd met Windows-knooppunten (dat wil gezegd, gemaakt met cloudServiceConfiguration of met virtualMachineConfiguration met behulp van een Windows-installatiekopieënreferentie). Voor Linux-rekenknooppunten worden de certificaten opgeslagen in een map in de werkmap van de taak en wordt een omgevingsvariabele AZ_BATCH_CERTIFICATES_DIR aan de taak geleverd om een query uit te voeren op deze locatie. Voor certificaten met zichtbaarheid van remoteUser wordt een map met certificaten gemaakt in de basismap van de gebruiker (bijvoorbeeld /home/{user-name}/certs) en worden certificaten in die map geplaatst. "CurrentUser"
"LocalMachine"
storeName Deze eigenschap is alleen van toepassing op pools die zijn geconfigureerd met Windows-knooppunten (dat wil gezegd, gemaakt met cloudServiceConfiguration of met virtualMachineConfiguration met behulp van een Windows-installatiekopieënreferentie). Algemene winkelnamen zijn: My, Root, CA, Trust, Disallowed, TrustedPeople, TrustedPublisher, AuthRoot, AddressBook, maar elke aangepaste winkelnaam kan ook worden gebruikt. De standaardwaarde is Mijn. snaar
zichtbaarheid Welke gebruikersaccounts op het rekenknooppunt toegang moeten hebben tot de persoonlijke gegevens van het certificaat. Tekenreeksmatrix met een van de volgende waarden:
"RemoteUser"
"StartTask"
"Taak"

DeploymentConfiguration

Naam Beschrijving Waarde
cloudServiceConfiguration Deze eigenschap en virtualMachineConfiguration sluiten elkaar wederzijds uit en een van de eigenschappen moet worden opgegeven. Deze eigenschap kan niet worden opgegeven als het Batch-account is gemaakt met de eigenschap poolAllocationMode ingesteld op UserSubscription. CloudServiceConfiguration-
virtualMachineConfiguration Deze eigenschap en cloudServiceConfiguration sluiten elkaar wederzijds uit en een van de eigenschappen moet worden opgegeven. VirtualMachineConfiguration-

CloudServiceConfiguration

Naam Beschrijving Waarde
osFamily Mogelijke waarden zijn: 2 - OS Family 2, gelijk aan Windows Server 2008 R2 SP1. 3 - OS Family 3, gelijk aan Windows Server 2012. 4 - OS Family 4, gelijk aan Windows Server 2012 R2. 5 - OS Family 5, gelijk aan Windows Server 2016. 6 - Os Family 6, gelijk aan Windows Server 2019. Zie Releases van Azure-gastbesturingssystemen (https://azure.microsoft.com/documentation/articles/cloud-services-guestos-update-matrix/#releases) voor meer informatie. tekenreeks (vereist)
osVersion De standaardwaarde is * waarmee de meest recente versie van het besturingssysteem voor de opgegeven besturingssysteemfamilie wordt opgegeven. snaar

VirtualMachineConfiguration

Naam Beschrijving Waarde
containerConfiguration Indien opgegeven, wordt de installatie uitgevoerd op elk knooppunt in de pool, zodat taken in containers kunnen worden uitgevoerd. Alle reguliere taken en jobbeheertaken die in deze pool worden uitgevoerd, moeten de eigenschap containerSettings opgeven en alle andere taken kunnen deze opgeven. ContainerConfiguration-
dataDisks Deze eigenschap moet worden opgegeven als aan de rekenknooppunten in de pool lege gegevensschijven moeten zijn gekoppeld. DataDisk[]
diskEncryptionConfiguration Indien opgegeven, wordt versleuteling uitgevoerd op elk knooppunt in de pool tijdens het inrichten van knooppunten. DiskEncryptionConfiguration-
Extensies Indien opgegeven, worden de extensies die in deze configuratie worden genoemd, op elk knooppunt geïnstalleerd. VMExtension[]
imageReference Een verwijzing naar een Azure Virtual Machines Marketplace-installatiekopieën of de Azure-installatiekopieënresource van een aangepaste virtuele machine. Zie de bewerking Ondersteunde knooppuntagent-SKU's weergeven om de lijst met alle imageReferences op te halen die door Azure Batch zijn geverifieerd. ImageReference (vereist)
licenseType Dit geldt alleen voor installatiekopieën die het Windows-besturingssysteem bevatten en mogen alleen worden gebruikt wanneer u geldige on-premises licenties hebt voor de knooppunten die worden geïmplementeerd. Als u dit weglaat, wordt er geen korting op on-premises licenties toegepast. Waarden zijn:

Windows_Server: de on-premises licentie is voor Windows Server.
Windows_Client: de on-premises licentie is voor Windows Client.
snaar
nodeAgentSkuId De Batch-knooppuntagent is een programma dat wordt uitgevoerd op elk knooppunt in de pool en biedt de interface voor opdracht en beheer tussen het knooppunt en de Batch-service. Er zijn verschillende implementaties van de knooppuntagent, ook wel SKU's genoemd, voor verschillende besturingssystemen. U moet een knooppuntagent-SKU opgeven die overeenkomt met de geselecteerde afbeeldingsreferentie. Zie de bewerking Ondersteunde agent-SKU's voor ondersteunde knooppunten, samen met de lijst met geverifieerde afbeeldingsverwijzingen, de bewerking Ondersteunde knooppuntagent-SKU's weergeven. tekenreeks (vereist)
nodePlacementConfiguration Met deze configuratie worden regels opgegeven voor de manier waarop knooppunten in de pool fysiek worden toegewezen. NodePlacementConfiguration-
osDisk Bevat configuratie voor tijdelijke OSDisk-instellingen. OSDisk-
windowsConfiguration Deze eigenschap mag niet worden opgegeven als de imageReference een Installatiekopie van het Linux-besturingssysteem opgeeft. WindowsConfiguration-

ContainerConfiguration

Naam Beschrijving Waarde
containerImageNames Dit is de volledige naslaginformatie over de installatiekopie, zoals wordt opgegeven voor 'docker pull'. Een installatiekopieën worden afkomstig uit het standaard-Docker-register, tenzij de installatiekopieën volledig zijn gekwalificeerd met een alternatief register. tekenreeks[]
containerregisters Als installatiekopieën moeten worden gedownload uit een persoonlijk register waarvoor referenties zijn vereist, moeten deze referenties hier worden opgegeven. ContainerRegistry-[]
type De containertechnologie die moet worden gebruikt. "DockerCompatible" (vereist)

ContainerRegistry

Naam Beschrijving Waarde
identityReference De verwijzing naar een door de gebruiker toegewezen identiteit die is gekoppeld aan de Batch-pool die door een rekenknooppunt wordt gebruikt. ComputeNodeIdentityReference
wachtwoord Het wachtwoord om u aan te melden bij de registerserver. snaar
registryServer Als u dit weglaat, is de standaardwaarde 'docker.io'. snaar
gebruikersnaam De gebruikersnaam om u aan te melden bij de registerserver. snaar

ComputeNodeIdentityReference

Naam Beschrijving Waarde
resourceId De ARM-resource-id van de door de gebruiker toegewezen identiteit. snaar

DataDisk

Naam Beschrijving Waarde
Caching Waarden zijn:

geen: de cachemodus voor de schijf is niet ingeschakeld.
readOnly: de cachemodus voor de schijf is alleen-lezen.
readWrite: de cachemodus voor de schijf is lezen en schrijven.

De standaardwaarde voor opslaan in cache is geen. Zie voor meer informatie over de cacheopties: https://blogs.msdn.microsoft.com/windowsazurestorage/2012/06/27/exploring-windows-azure-drives-disks-and-images/.
"Geen"
"ReadOnly"
"ReadWrite"
diskSizeGB De initiële schijfgrootte in GB bij het maken van een nieuwe gegevensschijf. int (vereist)
Lun De lun wordt gebruikt om elke gegevensschijf uniek te identificeren. Als u meerdere schijven koppelt, moet elk een afzonderlijke lun hebben. De waarde moet tussen 0 en 63 liggen, inclusief. int (vereist)
storageAccountType Als u dit weglaat, is de standaardwaarde 'Standard_LRS'. Waarden zijn:

Standard_LRS: de gegevensschijf moet standaard lokaal redundante opslag gebruiken.
Premium_LRS: de gegevensschijf moet premium lokaal redundante opslag gebruiken.
"Premium_LRS"
"Standard_LRS"

DiskEncryptionConfiguration

Naam Beschrijving Waarde
Doelstellingen In linux-pool wordt alleen 'TemporaryDisk' ondersteund; in windows-pool moeten 'OsDisk' en 'TemporaryDisk' worden opgegeven. Tekenreeksmatrix met een van de volgende waarden:
"OsDisk"
"TemporaryDisk"

VMExtension

Naam Beschrijving Waarde
autoUpgradeMinorVersion Geeft aan of de extensie een nieuwere secundaire versie moet gebruiken als deze beschikbaar is tijdens de implementatie. Zodra de extensie eenmaal is geïmplementeerd, worden er echter geen secundaire versies bijgewerkt, tenzij deze opnieuw wordt geïmplementeerd, zelfs niet als deze eigenschap is ingesteld op true. Bool
naam De naam van de extensie van de virtuele machine. tekenreeks (vereist)
protectedSettings De extensie kan protectedSettings of protectedSettingsFromKeyVault of helemaal geen beveiligde instellingen bevatten.
provisionAfterExtensions Verzameling extensienamen waarna deze extensie moet worden ingericht. tekenreeks[]
uitgever De naam van de uitgever van de extensie-handler. tekenreeks (vereist)
Instellingen Openbare instellingen met JSON-indeling voor de extensie.
type Het type extensies. tekenreeks (vereist)
typeHandlerVersion De versie van de scripthandler. snaar

ImageReference

Naam Beschrijving Waarde
legitimatiebewijs Deze eigenschap is wederzijds exclusief met andere eigenschappen. De installatiekopieën van de galerie met gedeelde installatiekopieën moeten replica's hebben in dezelfde regio als het Azure Batch-account. Zie /azure/batch/batch-api-basics#virtual-network-vnet-and-firewall-configuration voor informatie over de firewallinstellingen voor de Batch-knooppuntagent om te communiceren met de Batch-service. snaar
aanbieden Bijvoorbeeld UbuntuServer of WindowsServer. snaar
uitgever Bijvoorbeeld Canonical of MicrosoftWindowsServer. snaar
Sku Bijvoorbeeld 18.04-LTS of 2022-datacenter. snaar
Versie Er kan een waarde van 'latest' worden opgegeven om de meest recente versie van een installatiekopieën te selecteren. Als u dit weglaat, is de standaardwaarde 'nieuwste'. snaar

NodePlacementConfiguration

Naam Beschrijving Waarde
beleid Toewijzingsbeleid dat door Batch Service wordt gebruikt om de knooppunten in te richten. Als dit niet is opgegeven, gebruikt Batch het regionale beleid. "Regionaal"
"Zonegebonden"

OSDisk

Naam Beschrijving Waarde
kortstondigeOSDiskSettings Hiermee geeft u de tijdelijke schijfinstellingen voor de besturingssysteemschijf die door de virtuele machine wordt gebruikt. DiffDiskSettings

DiffDiskSettings

Naam Beschrijving Waarde
Plaatsing Deze eigenschap kan worden gebruikt door de gebruiker in de aanvraag om te kiezen op welke locatie het besturingssysteem zich moet bevinden. Bijvoorbeeld: cacheschijfruimte voor kortstondige besturingssysteemschijfinrichting. Raadpleeg voor meer informatie over tijdelijke vereisten voor besturingssysteemschijfgrootte de vereisten voor tijdelijke besturingssysteemschijfgrootte voor Windows-VM's op /azure/virtual-machines/windows/kortstondige os-schijven#groottevereisten en Linux-VM's op /azure/virtual-machines/linux/kortstondige-os-schijven#grootte-vereisten. "CacheDisk"

WindowsConfiguration

Naam Beschrijving Waarde
enableAutomaticUpdates Als u dit weglaat, is de standaardwaarde waar. Bool

MetadataItem

Naam Beschrijving Waarde
naam De naam van het metagegevensitem. tekenreeks (vereist)
waarde De waarde van het metagegevensitem. tekenreeks (vereist)

MountConfiguration

Naam Beschrijving Waarde
azureBlobFileSystemConfiguration Deze eigenschap is wederzijds exclusief met alle andere eigenschappen. AzureBlobFileSystemConfiguration-
azureFileShareConfiguration Deze eigenschap is wederzijds exclusief met alle andere eigenschappen. AzureFileShareConfiguration-
cifsMountConfiguration Deze eigenschap is wederzijds exclusief met alle andere eigenschappen. CifsMountConfiguration-
nfsMountConfiguration Deze eigenschap is wederzijds exclusief met alle andere eigenschappen. NFSMountConfiguration-

AzureBlobFileSystemConfiguration

Naam Beschrijving Waarde
accountKey Deze eigenschap is wederzijds exclusief met zowel sasKey als identiteit; er moet precies één worden opgegeven. snaar
accountName De naam van het Azure Storage-account. tekenreeks (vereist)
blobfuseOptions Dit zijn opties voor 'net use' in Windows en opties voor koppelen in Linux. snaar
containerName De naam van de Azure Blob Storage-container. tekenreeks (vereist)
identityReference Deze eigenschap is wederzijds exclusief met zowel accountKey als sasKey; er moet precies één worden opgegeven. ComputeNodeIdentityReference
relativeMountPath Alle bestandssystemen worden gekoppeld ten opzichte van de map batchkoppelingen, die toegankelijk zijn via de omgevingsvariabele AZ_BATCH_NODE_MOUNTS_DIR. tekenreeks (vereist)
sasKey Deze eigenschap is wederzijds exclusief met zowel accountKey als identiteit; er moet precies één worden opgegeven. snaar

AzureFileShareConfiguration

Naam Beschrijving Waarde
accountKey De sleutel van het Azure Storage-account. tekenreeks (vereist)
accountName De naam van het Azure Storage-account. tekenreeks (vereist)
azureFileUrl Dit is de vorm 'https://{account}.file.core.windows.net/'. tekenreeks (vereist)
mountOptions Dit zijn opties voor 'net use' in Windows en opties voor koppelen in Linux. snaar
relativeMountPath Alle bestandssystemen worden gekoppeld ten opzichte van de map batchkoppelingen, die toegankelijk zijn via de omgevingsvariabele AZ_BATCH_NODE_MOUNTS_DIR. tekenreeks (vereist)

CifsMountConfiguration

Naam Beschrijving Waarde
mountOptions Dit zijn opties voor 'net use' in Windows en opties voor koppelen in Linux. snaar
wachtwoord Het wachtwoord dat moet worden gebruikt voor verificatie op basis van het CIFS-bestandssysteem. tekenreeks (vereist)
relativeMountPath Alle bestandssystemen worden gekoppeld ten opzichte van de map batchkoppelingen, die toegankelijk zijn via de omgevingsvariabele AZ_BATCH_NODE_MOUNTS_DIR. tekenreeks (vereist)
bron De URI van het bestandssysteem die moet worden gekoppeld. tekenreeks (vereist)
gebruikersnaam De gebruiker die moet worden gebruikt voor verificatie op basis van het CIFS-bestandssysteem. tekenreeks (vereist)

NFSMountConfiguration

Naam Beschrijving Waarde
mountOptions Dit zijn opties voor 'net use' in Windows en opties voor koppelen in Linux. snaar
relativeMountPath Alle bestandssystemen worden gekoppeld ten opzichte van de map batchkoppelingen, die toegankelijk zijn via de omgevingsvariabele AZ_BATCH_NODE_MOUNTS_DIR. tekenreeks (vereist)
bron De URI van het bestandssysteem die moet worden gekoppeld. tekenreeks (vereist)

NetworkConfiguration

Naam Beschrijving Waarde
dynamicVNetAssignmentScope Het bereik van dynamische vnet-toewijzing. "job"
"geen"
endpointConfiguration De configuratie van het pooleindpunt wordt alleen ondersteund voor pools met de eigenschap virtualMachineConfiguration. PoolEndpointConfiguration-
publicIPAddressConfiguration Deze eigenschap wordt alleen ondersteund in Pools met de eigenschap virtualMachineConfiguration. PublicIPAddressConfiguration-
subnetId Het virtuele netwerk moet zich in dezelfde regio en hetzelfde abonnement bevinden als het Azure Batch-account. Het opgegeven subnet moet voldoende vrije IP-adressen hebben om tegemoet te komen aan het aantal knooppunten in de groep. Als het subnet niet voldoende vrije IP-adressen heeft, wijst de pool gedeeltelijk rekenknooppunten toe en treedt er een fout op bij het wijzigen van de grootte. De service-principal 'MicrosoftAzureBatch' moet de rol 'Inzender voor klassieke virtuele machines' hebben Role-Based RBAC-rol (Access Control) voor het opgegeven VNet. Het opgegeven subnet moet communicatie van de Azure Batch-service toestaan om taken op de rekenknooppunten te kunnen plannen. Dit kan worden gecontroleerd door te controleren of het opgegeven VNet gekoppelde netwerkbeveiligingsgroepen (NSG' heeft). Als communicatie met de rekenknooppunten in het opgegeven subnet wordt geweigerd door een NSG, stelt de Batch-service de status van de rekenknooppunten in op onbruikbaar. Als het opgegeven VNet gekoppelde netwerkbeveiligingsgroepen (NSG) heeft, moeten enkele gereserveerde systeempoorten zijn ingeschakeld voor binnenkomende communicatie. Schakel poorten 29876 en 29877, evenals poort 22 voor Linux en poort 3389 voor Windows in voor pools die zijn gemaakt met een configuratie van een virtuele machine. Voor pools die zijn gemaakt met een cloudserviceconfiguratie, schakelt u poorten 10100, 20100 en 30100 in. Schakel ook uitgaande verbindingen met Azure Storage in op poort 443. Voor cloudServiceConfiguration-pools worden alleen 'klassieke' VNET's ondersteund. Zie voor meer informatie: /azure/batch/batch-api-basics#virtual-network-vnet-and-firewall-configuration snaar

PoolEndpointConfiguration

Naam Beschrijving Waarde
inboundNatPools Het maximum aantal binnenkomende NAT-pools per Batch-pool is 5. Als het maximum aantal binnenkomende NAT-pools wordt overschreden, mislukt de aanvraag met HTTP-statuscode 400. Dit kan niet worden opgegeven als het IPAddressProvisioningType NoPublicIPAddresses is. InboundNatPool[] (vereist)

InboundNatPool

Naam Beschrijving Waarde
backendPort Dit moet uniek zijn binnen een Batch-pool. Acceptabele waarden liggen tussen 1 en 65535, met uitzondering van 22, 3389, 29876 en 29877, aangezien deze zijn gereserveerd. Als er gereserveerde waarden worden opgegeven, mislukt de aanvraag met HTTP-statuscode 400. int (vereist)
frontendPortRangeEnd Acceptabele waarden variëren tussen 1 en 65534, behalve poorten van 50000 tot 55000, die zijn gereserveerd door de Batch-service. Alle bereiken binnen een pool moeten uniek zijn en mogen niet overlappen. Als er gereserveerde of overlappende waarden worden opgegeven, mislukt de aanvraag met HTTP-statuscode 400. int (vereist)
frontendPortRangeStart Acceptabele waarden variëren tussen 1 en 65534, met uitzondering van poorten van 50000 tot 55000 die zijn gereserveerd. Alle bereiken binnen een pool moeten uniek zijn en mogen niet overlappen. Als er gereserveerde of overlappende waarden worden opgegeven, mislukt de aanvraag met HTTP-statuscode 400. int (vereist)
naam De naam moet uniek zijn binnen een Batch-pool, kan letters, cijfers, onderstrepingstekens, punten en afbreekstreepjes bevatten. Namen moeten beginnen met een letter of cijfer, moeten eindigen op een letter, cijfer of onderstrepingsteken en mogen niet langer zijn dan 77 tekens. Als er ongeldige waarden worden opgegeven, mislukt de aanvraag met HTTP-statuscode 400. tekenreeks (vereist)
networkSecurityGroupRules Het maximum aantal regels dat kan worden opgegeven voor alle eindpunten in een Batch-pool is 25. Als er geen regels voor netwerkbeveiligingsgroepen zijn opgegeven, wordt er een standaardregel gemaakt om binnenkomende toegang tot de opgegeven backendPort toe te staan. Als het maximum aantal regels voor netwerkbeveiligingsgroepen wordt overschreden, mislukt de aanvraag met HTTP-statuscode 400. NetworkSecurityGroupRule[]
protocol Het protocol van het eindpunt. "TCP"
UDP (vereist)

NetworkSecurityGroupRule

Naam Beschrijving Waarde
toegang De actie die moet worden uitgevoerd voor een opgegeven IP-adres, subnetbereik of tag. "Toestaan"
'Weigeren' (vereist)
voorrang Prioriteiten binnen een pool moeten uniek zijn en worden geëvalueerd in volgorde van prioriteit. Hoe lager het getal hoe hoger de prioriteit. Regels kunnen bijvoorbeeld worden opgegeven met ordernummers van 150, 250 en 350. De regel met het volgordenummer 150 heeft voorrang op de regel met een volgorde van 250. Toegestane prioriteiten zijn 150 tot 4096. Als er gereserveerde of dubbele waarden worden opgegeven, mislukt de aanvraag met HTTP-statuscode 400. int (vereist)
sourceAddressPrefix Geldige waarden zijn één IP-adres (bijvoorbeeld 10.10.10.10), IP-subnet (bijvoorbeeld 192.168.1.0/24), standaardtag of * (voor alle adressen). Als er andere waarden worden opgegeven, mislukt de aanvraag met HTTP-statuscode 400. tekenreeks (vereist)
sourcePortRanges Geldige waarden zijn *(voor alle poorten 0 - 65535) of matrices van poorten of poortbereiken (bijvoorbeeld 100-200). De poorten moeten tussen 0 en 65535 liggen en de poortbereiken of poorten mogen niet overlappen. Als er andere waarden worden opgegeven, mislukt de aanvraag met HTTP-statuscode 400. De standaardwaarde is *. tekenreeks[]

PublicIPAddressConfiguration

Naam Beschrijving Waarde
ipAddressIds Het aantal IP-adressen dat hier is opgegeven, beperkt de maximale grootte van de pool - 100 toegewezen knooppunten of 100 spot-/lage prioriteitsknooppunten kunnen worden toegewezen voor elk openbaar IP-adres. Een pool die bijvoorbeeld 250 toegewezen VM's nodig heeft, heeft ten minste 3 openbare IP-adressen nodig. Elk element van deze verzameling heeft de volgende vorm: /subscriptions/{subscription}/resourceGroups/{group}/providers/Microsoft.Network/publicIPAddresses/{ip}. tekenreeks[]
bepaling De standaardwaarde is BatchManaged "BatchManaged"
"NoPublicIPAddresses"
"UserManaged"

ScaleSettings

Naam Beschrijving Waarde
automatisch schalen Deze eigenschap en fixedScale sluiten elkaar wederzijds uit en een van de eigenschappen moet worden opgegeven. AutoScaleSettings
fixedScale Deze eigenschap en automatische schaalaanpassing sluiten elkaar wederzijds uit en een van de eigenschappen moet worden opgegeven. FixedScaleSettings-

AutoScaleSettings

Naam Beschrijving Waarde
evaluationInterval Als u dit weglaat, is de standaardwaarde 15 minuten (PT15M). snaar
formule Een formule voor het gewenste aantal rekenknooppunten in de pool. tekenreeks (vereist)

FixedScaleSettings

Naam Beschrijving Waarde
nodeDeallocationOption Als u dit weglaat, is de standaardwaarde Requeue. "Requeue"
"RetainedData"
"TaskCompletion"
"Beëindigen"
resizeTimeout De standaardwaarde is 15 minuten. Time-outwaarden maken gebruik van iso 8601-indeling. Gebruik bijvoorbeeld PT10M gedurende 10 minuten. De minimumwaarde is 5 minuten. Als u een waarde opgeeft die minder dan 5 minuten duurt, weigert de Batch-service de aanvraag met een fout; als u de REST API rechtstreeks aanroept, is de HTTP-statuscode 400 (Ongeldige aanvraag). snaar
targetDedicatedNodes Ten minste één van targetDedicatedNodes, targetLowPriorityNodes moet worden ingesteld. Int
targetLowPriorityNodes Ten minste één van targetDedicatedNodes, targetLowPriorityNodes moet worden ingesteld. Int

StartTask

Naam Beschrijving Waarde
commandLine De opdrachtregel wordt niet uitgevoerd onder een shell en kan daarom niet profiteren van shell-functies zoals uitbreiding van omgevingsvariabelen. Als u van dergelijke functies wilt profiteren, moet u de shell aanroepen op de opdrachtregel, bijvoorbeeld met 'cmd /c MyCommand' in Windows of '/bin/sh -c MyCommand' in Linux. Vereist als er andere eigenschappen van de startTask zijn opgegeven. snaar
containerSettings Wanneer dit is opgegeven, worden alle mappen recursief onder de AZ_BATCH_NODE_ROOT_DIR (de hoofdmap van Azure Batch-mappen op het knooppunt) toegewezen aan de container, worden alle omgevingsvariabelen voor taken toegewezen aan de container en wordt de opdrachtregel van de taak uitgevoerd in de container. TaskContainerSettings-
environmentSettings Een lijst met omgevingsvariabeleinstellingen voor de begintaak. EnvironmentSetting[]
maxTaskRetryCount De Batch-service probeert een taak opnieuw uit te voeren als de afsluitcode niet-nul is. Houd er rekening mee dat deze waarde specifiek het aantal nieuwe pogingen bepaalt. De Batch-service probeert de taak eenmaal uit en probeert vervolgens opnieuw tot deze limiet. Als het maximumaantal nieuwe pogingen bijvoorbeeld 3 is, probeert Batch de taak maximaal vier keer (één eerste poging en drie nieuwe pogingen). Als het maximumaantal nieuwe pogingen 0 is, voert de Batch-service de taak niet opnieuw uit. Als het maximumaantal nieuwe pogingen -1 is, probeert de Batch-service de taak opnieuw zonder limiet, maar dit wordt niet aanbevolen voor een begintaak of een taak. De standaardwaarde is 0 (geen nieuwe pogingen). Int
resourceFiles Een lijst met bestanden die de Batch-service naar het rekenknooppunt downloadt voordat u de opdrachtregel uitvoert. ResourceFile[]
userIdentity Als u dit weglaat, wordt de taak uitgevoerd als een niet-gebruiker met beheerdersrechten die uniek is voor de taak. UserIdentity-
waitForSuccess Als waar is en de begintaak mislukt op een rekenknooppunt, probeert de Batch-service de opstarttaak opnieuw uit te voeren tot het maximumaantal nieuwe pogingen (maxTaskRetryCount). Als de taak na alle nieuwe pogingen nog steeds niet is voltooid, markeert de Batch-service het rekenknooppunt onbruikbaar en worden er geen taken naar gepland. Deze voorwaarde kan worden gedetecteerd via de knooppuntstatus en planningsfoutdetails. Als dit onwaar is, wacht de Batch-service niet totdat de begintaak is voltooid. In dit geval kunnen andere taken worden uitgevoerd op het rekenknooppunt terwijl de begintaak nog steeds wordt uitgevoerd; en zelfs als de begintaak mislukt, blijven nieuwe taken gepland op het knooppunt. De standaardwaarde is waar. Bool

TaskContainerSettings

Naam Beschrijving Waarde
containerRunOptions Deze extra opties worden geleverd als argumenten voor de opdracht Docker create, naast de opties die worden beheerd door de Batch-service. snaar
imageName Dit is de volledige naslaginformatie over de installatiekopie, zoals wordt opgegeven voor 'docker pull'. Als er geen tag wordt opgegeven als onderdeel van de naam van de installatiekopieën, wordt de tag ':latest' als standaard gebruikt. tekenreeks (vereist)
register Deze instelling kan worden weggelaten als deze al is opgegeven bij het maken van een pool. ContainerRegistry-
workingDirectory Een vlag om aan te geven waar de werkmap van de containertaak zich bevindt. De standaardwaarde is taskWorkingDirectory. "ContainerImageDefault"
"TaskWorkingDirectory"

EnvironmentSetting

Naam Beschrijving Waarde
naam De naam van de omgevingsvariabele. tekenreeks (vereist)
waarde De waarde van de omgevingsvariabele. snaar

ResourceFile

Naam Beschrijving Waarde
autoStorageContainerName De eigenschappen autoStorageContainerName, storageContainerUrl en httpUrl sluiten elkaar wederzijds uit en een van deze moet worden opgegeven. snaar
blobPrefix De eigenschap is alleen geldig wanneer autoStorageContainerName of storageContainerUrl wordt gebruikt. Dit voorvoegsel kan een gedeeltelijke bestandsnaam of een submap zijn. Als er geen voorvoegsel is opgegeven, worden alle bestanden in de container gedownload. snaar
fileMode Deze eigenschap is alleen van toepassing op bestanden die worden gedownload naar Linux-rekenknooppunten. Deze wordt genegeerd als deze is opgegeven voor een resourceFile die wordt gedownload naar een Windows-knooppunt. Als deze eigenschap niet is opgegeven voor een Linux-knooppunt, wordt een standaardwaarde van 0770 toegepast op het bestand. snaar
filePath Als de eigenschap httpUrl is opgegeven, is het filePath vereist en wordt het pad beschreven waarnaar het bestand wordt gedownload, inclusief de bestandsnaam. Als anders de eigenschap autoStorageContainerName of storageContainerUrl is opgegeven, is filePath optioneel en is het de map waarin de bestanden moeten worden gedownload. In het geval dat filePath wordt gebruikt als map, wordt elke mapstructuur die al aan de invoergegevens is gekoppeld, volledig bewaard en toegevoegd aan de opgegeven filePath-map. Het opgegeven relatieve pad kan niet worden uitgesplitsd uit de werkmap van de taak (bijvoorbeeld met '..'). snaar
httpUrl De eigenschappen autoStorageContainerName, storageContainerUrl en httpUrl sluiten elkaar wederzijds uit en een van deze moet worden opgegeven. Als de URL verwijst naar Azure Blob Storage, moet deze leesbaar zijn vanuit rekenknooppunten. Er zijn drie manieren om een dergelijke URL op te halen voor een blob in Azure Storage: neem een SAS (Shared Access Signature) die leesmachtigingen voor de blob verleent, gebruik een beheerde identiteit met leesmachtigingen of stel de ACL voor de blob of de container in om openbare toegang toe te staan. snaar
identityReference De verwijzing naar een door de gebruiker toegewezen identiteit die is gekoppeld aan de Batch-pool die door een rekenknooppunt wordt gebruikt. ComputeNodeIdentityReference
storageContainerUrl De eigenschappen autoStorageContainerName, storageContainerUrl en httpUrl sluiten elkaar wederzijds uit en een van deze moet worden opgegeven. Deze URL moet kunnen worden gelezen en vermeld vanuit rekenknooppunten. Er zijn drie manieren om een dergelijke URL op te halen voor een container in Azure Storage: neem een SAS (Shared Access Signature) op die lees- en lijstmachtigingen voor de container verleent, gebruik een beheerde identiteit met lees- en lijstmachtigingen of stel de ACL voor de container in om openbare toegang toe te staan. snaar

UserIdentity

Naam Beschrijving Waarde
autoUser De eigenschappen userName en autoUser sluiten elkaar wederzijds uit; u moet één, maar niet beide opgeven. AutoUserSpecification-
userName De eigenschappen userName en autoUser sluiten elkaar wederzijds uit; u moet één, maar niet beide opgeven. snaar

AutoUserSpecification

Naam Beschrijving Waarde
elevationLevel De standaardwaarde is nietAdmin. "Beheerder"
"NonAdmin"
draagwijdte De standaardwaarde is Pool. Als de pool Windows uitvoert, moet een waarde van Taak worden opgegeven als strengere isolatie tussen taken vereist is. Als de taak bijvoorbeeld het register op een manier muteert die van invloed kan zijn op andere taken, of als certificaten zijn opgegeven in de pool die niet toegankelijk moet zijn voor normale taken, maar toegankelijk moeten zijn voor begintaken. "Pool"
"Taak"

TaskSchedulingPolicy

Naam Beschrijving Waarde
nodeFillType Hoe taken moeten worden verdeeld over rekenknooppunten. "Pack"
"Spread" (vereist)

UserAccount

Naam Beschrijving Waarde
elevationLevel nonAdmin: de automatische gebruiker is een standaardgebruiker zonder verhoogde toegang. beheerder: de automatische gebruiker is een gebruiker met verhoogde toegang en werkt met volledige beheerdersmachtigingen. De standaardwaarde is nietAdmin. "Beheerder"
"NonAdmin"
linuxUserConfiguration Deze eigenschap wordt genegeerd als deze is opgegeven in een Windows-pool. Als dit niet is opgegeven, wordt de gebruiker gemaakt met de standaardopties. LinuxUserConfiguration-
naam De naam van het gebruikersaccount. tekenreeks (vereist)
wachtwoord Het wachtwoord voor het gebruikersaccount. tekenreeks (vereist)
windowsUserConfiguration Deze eigenschap kan alleen worden opgegeven als de gebruiker zich in een Windows-pool bevindt. Als dit niet is opgegeven en in een Windows-pool, wordt de gebruiker gemaakt met de standaardopties. WindowsUserConfiguration-

LinuxUserConfiguration

Naam Beschrijving Waarde
Gid De uid- en gid-eigenschappen moeten samen worden opgegeven of helemaal niet. Als het onderliggende besturingssysteem niet is opgegeven, kiest u de gid. Int
sshPrivateKey De persoonlijke sleutel mag niet met een wachtwoord zijn beveiligd. De persoonlijke sleutel wordt gebruikt om automatisch verificatie op basis van asymmetrische sleutels te configureren voor SSH tussen knooppunten in een Linux-pool wanneer de eigenschap enableInterNodeCommunication van de pool waar is (deze wordt genegeerd als enableInterNodeCommunication onwaar is). Dit doet u door het sleutelpaar in de map .ssh van de gebruiker te plaatsen. Als dit niet is opgegeven, is SSH zonder wachtwoord niet geconfigureerd tussen knooppunten (er wordt geen wijziging van de .ssh-map van de gebruiker uitgevoerd). snaar
Uid De uid- en gid-eigenschappen moeten samen worden opgegeven of helemaal niet. Als het onderliggende besturingssysteem niet is opgegeven, wordt de uid gekozen. Int

WindowsUserConfiguration

Naam Beschrijving Waarde
loginMode Hiermee geeft u de aanmeldingsmodus voor de gebruiker. De standaardwaarde voor VirtualMachineConfiguration-pools is de interactieve modus en voor CloudServiceConfiguration-pools is de batchmodus. "Batch"
"Interactief"