Microsoft.Batch batchAccounts/pools 01-01-2021
Bicep-resourcedefinitie
Het resourcetype batchAccounts/pools kan worden geïmplementeerd in:
- Resourcegroepen - Zie opdrachten voor resourcegroepimplementatie
Zie wijzigingenlogboek voor 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@2021-01-01' = {
name: 'string'
parent: resourceSymbolicName
identity: {
type: 'string'
userAssignedIdentities: {}
}
properties: {
applicationLicenses: [
'string'
]
applicationPackages: [
{
id: 'string'
version: 'string'
}
]
certificates: [
{
id: 'string'
storeLocation: 'string'
storeName: 'string'
visibility: [
'string'
]
}
]
deploymentConfiguration: {
cloudServiceConfiguration: {
osFamily: 'string'
osVersion: 'string'
}
virtualMachineConfiguration: {
containerConfiguration: {
containerImageNames: [
'string'
]
containerRegistries: [
{
password: 'string'
registryServer: 'string'
username: 'string'
}
]
type: 'DockerCompatible'
}
dataDisks: [
{
caching: 'string'
diskSizeGB: int
lun: int
storageAccountType: 'string'
}
]
diskEncryptionConfiguration: {
targets: [
'string'
]
}
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'
}
windowsConfiguration: {
enableAutomaticUpdates: bool
}
}
}
displayName: 'string'
interNodeCommunication: 'string'
metadata: [
{
name: 'string'
value: 'string'
}
]
mountConfiguration: [
{
azureBlobFileSystemConfiguration: {
accountKey: 'string'
accountName: 'string'
blobfuseOptions: 'string'
containerName: 'string'
relativeMountPath: 'string'
sasKey: 'string'
}
azureFileShareConfiguration: {
accountKey: 'string'
accountName: 'string'
azureFileUrl: 'string'
mountOptions: 'string'
relativeMountPath: 'string'
}
cifsMountConfiguration: {
mountOptions: 'string'
password: 'string'
relativeMountPath: 'string'
source: 'string'
username: 'string'
}
nfsMountConfiguration: {
mountOptions: 'string'
relativeMountPath: 'string'
source: 'string'
}
}
]
networkConfiguration: {
endpointConfiguration: {
inboundNatPools: [
{
backendPort: int
frontendPortRangeEnd: int
frontendPortRangeStart: int
name: 'string'
networkSecurityGroupRules: [
{
access: 'string'
priority: int
sourceAddressPrefix: 'string'
sourcePortRanges: [
'string'
]
}
]
protocol: 'string'
}
]
}
publicIPAddressConfiguration: {
ipAddressIds: [
'string'
]
provision: 'string'
}
subnetId: 'string'
}
scaleSettings: {
autoScale: {
evaluationInterval: 'string'
formula: 'string'
}
fixedScale: {
nodeDeallocationOption: 'string'
resizeTimeout: 'string'
targetDedicatedNodes: int
targetLowPriorityNodes: int
}
}
startTask: {
commandLine: 'string'
containerSettings: {
containerRunOptions: 'string'
imageName: 'string'
registry: {
password: 'string'
registryServer: 'string'
username: 'string'
}
workingDirectory: 'string'
}
environmentSettings: [
{
name: 'string'
value: 'string'
}
]
maxTaskRetryCount: int
resourceFiles: [
{
autoStorageContainerName: 'string'
blobPrefix: 'string'
fileMode: 'string'
filePath: 'string'
httpUrl: 'string'
storageContainerUrl: 'string'
}
]
userIdentity: {
autoUser: {
elevationLevel: 'string'
scope: 'string'
}
userName: 'string'
}
waitForSuccess: bool
}
taskSchedulingPolicy: {
nodeFillType: 'string'
}
taskSlotsPerNode: int
userAccounts: [
{
elevationLevel: 'string'
linuxUserConfiguration: {
gid: int
sshPrivateKey: 'string'
uid: int
}
name: 'string'
password: 'string'
windowsUserConfiguration: {
loginMode: 'string'
}
}
]
vmSize: 'string'
}
}
Eigenschapswaarden
batchAccounts/pools
| Naam | Description | Waarde |
|---|---|---|
| naam | De resourcenaam Meer informatie over het instellen van namen en typen voor onderliggende resources in Bicep. |
tekenreeks (vereist) Tekenlimiet: 1-64 Geldige tekens: Alfanumerieken, onderstrepingstekens en afbreekstreepjes. |
| Bovenliggende | 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 bovenliggende resource voor meer informatie. |
Symbolische naam voor resource van het type: batchAccounts |
| identity | Het type identiteit dat wordt gebruikt voor de Batch-pool. | BatchPoolIdentity |
| properties | De eigenschappen die zijn gekoppeld aan de pool. | PoolEigenschappen |
BatchPoolIdentity
| Naam | Description | 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. De sleutelverwijzingen naar de gebruikersidentiteitswoordenlijst zijn ARM-resource-id's in de vorm: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. | object |
PoolEigenschappen
| Naam | Description | Waarde |
|---|---|---|
| applicationLicenties | De lijst met toepassingslicenties moet een subset zijn van beschikbare licenties voor Batch-servicetoepassingen. Als er een licentie wordt aangevraagd die niet wordt ondersteund, mislukt het maken van de pool. | tekenreeks[] |
| applicationPackages | Wijzigingen in verwijzingen naar toepassingspakketten zijn van invloed op alle nieuwe rekenknooppunten die lid worden van de pool, maar hebben geen invloed op rekenknooppunten die zich al in de pool bevinden totdat ze opnieuw worden opgestart of opnieuw zijn geïnstalleerd. Er zijn maximaal 10 verwijzingen naar toepassingspakketten voor een bepaalde groep. | ApplicationPackageReference[] |
| certificaten | Voor Windows-rekenknooppunten installeert de Batch-service de certificaten in 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 opgegeven voor de taak om een query uit te voeren voor 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 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 kan Unicode-tekens bevatten met een maximale lengte van 1024. | tekenreeks |
| interNodeCommunication | Dit legt beperkingen op aan welke knooppunten kunnen worden toegewezen aan de pool. Als u deze waarde inschakelt, wordt de kans verkleind dat het aangevraagde aantal knooppunten in de pool wordt toegewezen. Als dit niet wordt opgegeven, wordt deze waarde standaard ingesteld op 'Uitgeschakeld'. | 'Uitgeschakeld' Ingeschakeld |
| metagegevens | De Batch-service wijst geen betekenis toe aan metagegevens; het is uitsluitend 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 | Hiermee definieert u 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, is de standaardwaarde spread. | 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 moeten worden gemaakt op elk knooppunt in de pool. | UserAccount[] |
| vmSize | Zie Grootten voor Cloud Services () voor informatie over de beschikbare grootten van virtuele machines voor Cloud Services pools (https://azure.microsoft.com/documentation/articles/cloud-services-sizes-specs/pools die zijn gemaakt met cloudServiceConfiguration). Batch ondersteunt alle Cloud Services VM-grootten, met uitzondering van ExtraSmall. Zie Grootten voor Virtual Machines (Linux) () of Grootten voor Virtual Machines (Windowshttps://azure.microsoft.com/documentation/articles/virtual-machines-windows-sizes/)https://azure.microsoft.com/documentation/articles/virtual-machines-linux-sizes/ voor informatie over beschikbare VM-grootten voor pools met behulp van installatiekopieën uit de Virtual Machines Marketplace (pools die zijn gemaakt met virtualMachineConfiguration). Batch ondersteunt alle Vm-grootten van Azure, met uitzondering van STANDARD_A0 en grootten met Premium Storage (STANDARD_GS, STANDARD_DS en STANDARD_DSV2 serie). | tekenreeks |
ApplicationPackageReference
| Naam | Description | Waarde |
|---|---|---|
| id | De id van het toepassingspakket dat moet worden geïnstalleerd. Dit moet zich in hetzelfde batchaccount bevinden als de pool. Dit kan een verwijzing zijn naar een specifieke versie 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. | tekenreeks |
CertificateReference
| Naam | Description | Waarde |
|---|---|---|
| id | De volledig gekwalificeerde id van het certificaat dat op de groep moet worden geïnstalleerd. Dit moet zich in 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 Verwijzing naar een Windows-installatiekopieën). Voor Linux-rekenknooppunten worden de certificaten opgeslagen in een map in de werkmap van de taak en wordt een omgevingsvariabele AZ_BATCH_CERTIFICATES_DIR opgegeven voor de taak om een query uit te voeren voor 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 Verwijzing naar een Windows-installatiekopieën). Algemene winkelnamen zijn: My, Root, CA, Trust, Disallowed, TrustedPeople, TrustedPublisher, AuthRoot, AddressBook, maar elke aangepaste winkelnaam kan ook worden gebruikt. De standaardwaarde is Mijn. | tekenreeks |
| Zichtbaarheid | Welke gebruikersaccounts op het rekenknooppunt moeten toegang hebben tot de persoonlijke gegevens van het certificaat. | Tekenreeksmatrix met een van de volgende waarden: 'RemoteUser' 'StartTask' 'Taak' |
DeploymentConfiguration
| Naam | Description | Waarde |
|---|---|---|
| cloudServiceConfiguration | Deze eigenschap en virtualMachineConfiguration sluiten elkaar 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 uit en een van de eigenschappen moet worden opgegeven. | VirtualMachineConfiguration |
CloudServiceConfiguration
| Naam | Description | Waarde |
|---|---|---|
| osFamily | Mogelijke waarden zijn: 2 - OS-familie 2, gelijk aan Windows Server 2008 R2 SP1. 3 - OS-familie 3, gelijk aan Windows Server 2012. 4 - OS-familie 4, gelijk aan Windows Server 2012 R2. 5 - OS-familie 5, gelijk aan Windows Server 2016. 6 - Os-familie 6, gelijk aan Windows Server 2019. Zie Azure Guest OS Releases (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. | tekenreeks |
VirtualMachineConfiguration
| Naam | Description | Waarde |
|---|---|---|
| containerConfiguration | Indien opgegeven, wordt de installatie uitgevoerd op elk knooppunt in de pool, zodat taken kunnen worden uitgevoerd in containers. Alle normale taken en taakbeheertaken 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 vermeld, 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. Als u de lijst met alle imageReferences wilt ophalen die door Azure Batch zijn geverifieerd, raadpleegt u de bewerking Ondersteunde knooppuntagent-SKU's weergeven. | 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 on-premises licentiekorting toegepast. Waarden zijn: Windows_Server: de on-premises licentie is voor Windows Server. Windows_Client: de on-premises licentie is voor Windows Client. |
tekenreeks |
| nodeAgentSkuId | De Batch-knooppuntagent is een programma dat wordt uitgevoerd op elk knooppunt in de pool en biedt de command-and-control-interface 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 verwijzing naar de geselecteerde installatiekopieën. Zie de bewerking 'Ondersteunde knooppuntagent-SKU's weergeven' voor de lijst met ondersteunde knooppuntagent-SKU's, samen met de bijbehorende lijst met geverifieerde installatiekopieën. | tekenreeks (vereist) |
| nodePlacementConfiguration | Met deze configuratie worden regels opgegeven voor de wijze waarop knooppunten in de pool fysiek worden toegewezen. | NodePlacementConfiguration |
| windowsConfiguration | Deze eigenschap moet niet worden opgegeven als de imageReference een Linux-besturingssysteeminstallatiekopie opgeeft. | WindowsConfiguration |
ContainerConfiguration
| Naam | Description | Waarde |
|---|---|---|
| containerImageNames | Dit is de volledige verwijzing naar de installatiekopie, zoals wordt opgegeven als 'docker pull'. Een installatiekopieën worden opgehaald 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 privéregister waarvoor referenties zijn vereist, moeten deze referenties hier worden opgegeven. | ContainerRegistry[] |
| type | De containertechnologie die moet worden gebruikt. | 'DockerCompatible' (vereist) |
ContainerRegistry
| Naam | Description | Waarde |
|---|---|---|
| wachtwoord | Het wachtwoord om u aan te melden bij de registerserver. | tekenreeks (vereist) |
| registryServer | Als u dit weglaat, is de standaardwaarde 'docker.io'. | tekenreeks |
| gebruikersnaam | De gebruikersnaam om u aan te melden bij de registerserver. | tekenreeks (vereist) |
DataDisk
| Naam | Description | Waarde |
|---|---|---|
| Caching | Waarden zijn: none: 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 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 gebruikmaken van premium lokaal redundante opslag. |
'Premium_LRS' 'Standard_LRS' |
DiskEncryptionConfiguration
| Naam | Description | Waarde |
|---|---|---|
| Doelstellingen | In een Linux-pool wordt alleen 'TemporaryDisk' ondersteund; in een Windows-groep moeten 'OsDisk' en 'TemporaryDisk' worden opgegeven. | Tekenreeksmatrix met een van de volgende waarden: 'OsDisk' 'TemporaryDisk' |
VMExtension
| Naam | Description | Waarde |
|---|---|---|
| autoUpgradeMinorVersion | Geeft aan of de extensie een nieuwere secundaire versie moet gebruiken als deze beschikbaar is tijdens de implementatie. Zodra de extensie 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. | booleaans |
| naam | De naam van de extensie van de virtuele machine. | tekenreeks (vereist) |
| protectedSettings | De extensie kan protectedSettings of protectedSettingsFromKeyVault bevatten of helemaal geen beveiligde instellingen. | Voor Bicep kunt u de functie any() gebruiken. |
| provisionAfterExtensions | Verzameling extensienamen waarna deze extensie moet worden ingericht. | tekenreeks[] |
| publisher | De naam van de uitgever van de extensie-handler. | tekenreeks (vereist) |
| instellingen | Met JSON opgemaakte openbare instellingen voor de extensie. | Voor Bicep kunt u de functie any() gebruiken. |
| type | Het type van de extensies. | tekenreeks (vereist) |
| typeHandlerVersion | De versie van scripthandler. | tekenreeks |
ImageReference
| Naam | Description | Waarde |
|---|---|---|
| id | Deze eigenschap is wederzijds exclusief met andere eigenschappen. De Shared Image Gallery-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. | tekenreeks |
| offer | Bijvoorbeeld UbuntuServer of WindowsServer. | tekenreeks |
| publisher | Bijvoorbeeld Canonical of MicrosoftWindowsServer. | tekenreeks |
| sku | Bijvoorbeeld 18.04-LTS of 2019-Datacenter. | tekenreeks |
| versie | De waarde 'meest recente' kan worden opgegeven om de meest recente versie van een installatiekopieën te selecteren. Als u dit weglaat, is de standaardwaarde 'nieuwste'. | tekenreeks |
NodePlacementConfiguration
| Naam | Description | Waarde |
|---|---|---|
| policy | 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' |
WindowsConfiguration
| Naam | Description | Waarde |
|---|---|---|
| enableAutomaticUpdates | Als u dit weglaat, is de standaardwaarde true. | booleaans |
MetadataItem
| Naam | Description | Waarde |
|---|---|---|
| naam | De naam van het metagegevensitem. | tekenreeks (vereist) |
| waarde | De waarde van het metagegevensitem. | tekenreeks (vereist) |
MountConfiguration
| Naam | Description | 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 | Description | Waarde |
|---|---|---|
| accountKey | Deze eigenschap is wederzijds exclusief met sasKey en er moet een worden opgegeven. | tekenreeks |
| accountName | De naam van het Azure Storage-account. | tekenreeks (vereist) |
| blobfuseOptions | Dit zijn opties voor 'net use' in Windows en 'koppelingsopties' in Linux. | tekenreeks |
| containerName | De Azure Blob Storage containernaam. | tekenreeks (vereist) |
| relativeMountPath | Alle bestandssystemen worden gekoppeld ten opzichte van de map Batch-koppels, toegankelijk via de omgevingsvariabele AZ_BATCH_NODE_MOUNTS_DIR. | tekenreeks (vereist) |
| sasKey | Deze eigenschap is wederzijds exclusief met accountKey en er moet een worden opgegeven. | tekenreeks |
AzureFileShareConfiguration
| Naam | Description | Waarde |
|---|---|---|
| accountKey | De Azure Storage-accountsleutel. | tekenreeks (vereist) |
| accountName | De naam van het Azure Storage-account. | tekenreeks (vereist) |
| azureFileUrl | Dit heeft de vorm 'https://{account}.file.core.windows.net/'. | tekenreeks (vereist) |
| mountOptions | Dit zijn opties voor 'net use' in Windows en 'koppelingsopties' in Linux. | tekenreeks |
| relativeMountPath | Alle bestandssystemen worden gekoppeld ten opzichte van de map Batch-koppels, toegankelijk via de omgevingsvariabele AZ_BATCH_NODE_MOUNTS_DIR. | tekenreeks (vereist) |
CifsMountConfiguration
| Naam | Description | Waarde |
|---|---|---|
| mountOptions | Dit zijn opties voor 'net use' in Windows en 'koppelingsopties' in Linux. | tekenreeks |
| wachtwoord | Het wachtwoord dat moet worden gebruikt voor verificatie met het CIFS-bestandssysteem. | tekenreeks (vereist) |
| relativeMountPath | Alle bestandssystemen worden gekoppeld ten opzichte van de map Batch-koppels, toegankelijk via de omgevingsvariabele AZ_BATCH_NODE_MOUNTS_DIR. | tekenreeks (vereist) |
| source | De URI van het bestandssysteem dat moet worden gekoppeld. | tekenreeks (vereist) |
| gebruikersnaam | De gebruiker die moet worden gebruikt voor verificatie met het CIFS-bestandssysteem. | tekenreeks (vereist) |
NFSMountConfiguration
| Naam | Description | Waarde |
|---|---|---|
| mountOptions | Dit zijn opties voor 'net use' in Windows en 'koppelingsopties' in Linux. | tekenreeks |
| relativeMountPath | Alle bestandssystemen worden gekoppeld ten opzichte van de map Batch-koppels, toegankelijk via de omgevingsvariabele AZ_BATCH_NODE_MOUNTS_DIR. | tekenreeks (vereist) |
| source | De URI van het bestandssysteem dat moet worden gekoppeld. | tekenreeks (vereist) |
NetworkConfiguration
| Naam | Description | Waarde |
|---|---|---|
| endpointConfiguration | Configuratie van pooleindpunten wordt alleen ondersteund voor pools met de eigenschap virtualMachineConfiguration. | PoolEndpointConfiguration |
| publicIPAddressConfiguration | Deze eigenschap wordt alleen ondersteund voor 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 voor het aantal knooppunten in de groep. Als het subnet onvoldoende vrije IP-adressen heeft, wijst de groep gedeeltelijk rekenknooppunten toe en treedt er een fout bij het wijzigen van het formaat op. De service-principal 'MicrosoftAzureBatch' moet de rol 'Inzender voor klassieke virtuele machines' Role-Based Access Control (RBAC) hebben 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's) 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 aan het opgegeven VNet NSG’s (netwerkbeveiligingsgroepen) zijn gekoppeld, moeten een paar gereserveerde poorten worden ingeschakeld voor binnenkomende communicatie. Voor pools die zijn gemaakt met een virtuele-machineconfiguratie schakelt u poort 29876 en 29877 in, evenals poort 22 voor Linux en poort 3389 voor Windows. Voor pools die zijn gemaakt met een cloudserviceconfiguratie schakelt u poort 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 | tekenreeks |
PoolEndpointConfiguration
| Naam | Description | 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 | Description | 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, omdat deze zijn gereserveerd. Als er gereserveerde waarden worden opgegeven, mislukt de aanvraag met HTTP-statuscode 400. | int (vereist) |
| frontendPortRangeEnd | Acceptabele waarden liggen tussen 1 en 65534, met uitzondering van poorten van 50000 tot 55000 die zijn gereserveerd door de Batch-service. Alle bereiken binnen een pool moeten verschillend zijn en mogen elkaar niet overlappen. Als er gereserveerde of overlappende waarden worden opgegeven, mislukt de aanvraag met HTTP-statuscode 400. | int (vereist) |
| frontendPortRangeStart | Acceptabele waarden liggen tussen 1 en 65534, met uitzondering van poorten van 50000 tot 55000 die zijn gereserveerd. Alle bereiken binnen een pool moeten verschillend zijn en mogen elkaar 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 en mag 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 | Description | Waarde |
|---|---|---|
| toegang | De actie die moet worden uitgevoerd voor een opgegeven IP-adres, subnetbereik of tag. | 'Toestaan' Weigeren (vereist) |
| priority | 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 volgnummers 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 elkaar niet overlappen. Als er andere waarden worden opgegeven, mislukt de aanvraag met HTTP-statuscode 400. De standaardwaarde is *. | tekenreeks[] |
PublicIPAddressConfiguration
| Naam | Description | Waarde |
|---|---|---|
| ipAddressIds | Het aantal IP-adressen dat hier is opgegeven, beperkt de maximale grootte van de pool. Er kunnen 100 toegewezen knooppunten of 100 knooppunten met lage prioriteit worden toegewezen voor elk openbaar IP-adres. Een pool die bijvoorbeeld 250 toegewezen VM's nodig heeft, moet ten minste drie openbare IP-adressen opgegeven hebben. 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 | Description | Waarde |
|---|---|---|
| automatisch schalen | Deze eigenschap en fixedScale sluiten elkaar uit en een van de eigenschappen moet worden opgegeven. | Instellingen voor automatisch schalen |
| fixedScale | Deze eigenschap en automatische schaalaanpassing sluiten elkaar uit en een van de eigenschappen moet worden opgegeven. | FixedScaleSettings |
Instellingen voor automatisch schalen
| Naam | Description | Waarde |
|---|---|---|
| evaluationInterval | Als u dit weglaat, is de standaardwaarde 15 minuten (PT15M). | tekenreeks |
| Formule | Een formule voor het gewenste aantal rekenknooppunten in de pool. | tekenreeks (vereist) |
FixedScaleSettings
| Naam | Description | Waarde |
|---|---|---|
| nodeDeallocationOption | Als u dit weglaat, is de standaardwaarde Opnieuw in de wachtrij plaatsen. | 'Opnieuw in de wachtrij plaatsen' 'RetainedData' 'TaskCompletion' 'Beëindigen' |
| resizeTimeout | De standaardwaarde is 15 minuten. Time-outwaarden gebruiken de ISO 8601-indeling. Gebruik bijvoorbeeld PT10M gedurende 10 minuten. De minimumwaarde is 5 minuten. Als u een waarde van minder dan 5 minuten opgeeft, weigert de Batch-service de aanvraag met een fout; Als u de REST API rechtstreeks aanroept, is de HTTP-statuscode 400 (ongeldige aanvraag). | tekenreeks |
| targetDedicatedNodes | Ten minste één van targetDedicatedNodes, targetLowPriorityNodes moet worden ingesteld. | int |
| targetLowPriorityNodes | Ten minste één van targetDedicatedNodes, targetLowPriorityNodes moet worden ingesteld. | int |
StartTask
| Naam | Description | 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 in de opdrachtregel aanroepen, bijvoorbeeld met 'cmd /c MyCommand' in Windows of '/bin/sh -c MyCommand' in Linux. Vereist als er andere eigenschappen van de startTask zijn opgegeven. | tekenreeks |
| 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 taakomgevingsvariabelen toegewezen aan de container en wordt de taakopdrachtregel uitgevoerd in de container. | TaskContainerSettings |
| environmentSettings | Een lijst met omgevingsvariabeleinstellingen voor de begintaak. | EnvironmentSetting[] |
| maxTaskRetryCount | De Batch-service voert een taak opnieuw uit als de afsluitcode een andere is dan nul. Houd er rekening mee dat deze waarde specifiek het aantal nieuwe pogingen bepaalt. De Batch-service probeert de taak eenmaal uit te voeren en kan het vervolgens opnieuw proberen tot deze limiet. Als het maximumaantal nieuwe pogingen bijvoorbeeld 3 is, probeert Batch de taak maximaal 4 keer (één eerste poging en 3 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. | int |
| resourceFiles | Een lijst met bestanden die door de Batch-service worden gedownload naar het rekenknooppunt voordat de opdrachtregel wordt uitgevoerd. | ResourceFile[] |
| userIdentity | Als u dit weglaat, wordt de taak uitgevoerd als een gebruiker zonder beheerdersrechten die uniek is voor de taak. | UserIdentity |
| waitForSuccess | Als waar is en de begintaak mislukt op een rekenknooppunt, probeert de Batch-service de starttaak opnieuw tot het maximale aantal nieuwe pogingen (maxTaskRetryCount). Als de taak na alle nieuwe pogingen nog steeds niet is voltooid, markeert de Batch-service het rekenknooppunt als onbruikbaar en worden er geen taken naar gepland. Deze voorwaarde kan worden gedetecteerd via de status van het knooppunt en de details van de planningsfout. Indien onwaar, 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 wordt uitgevoerd; en zelfs als de begintaak mislukt, worden er nog steeds nieuwe taken gepland op het knooppunt. De standaardwaarde is true. | booleaans |
TaskContainerSettings
| Naam | Description | Waarde |
|---|---|---|
| containerRunOptions | Deze extra opties worden geleverd als argumenten voor de opdracht 'docker maken', naast de opties die worden beheerd door de Batch-service. | tekenreeks |
| Afbeeldingnaam | Dit is de volledige installatiekopiereferentie, zoals wordt opgegeven bij 'docker pull'. Als er geen tag wordt opgegeven als onderdeel van de naam van de installatiekopieën, wordt de tag ':latest' standaard gebruikt. | tekenreeks (vereist) |
| registry | Deze instelling kan worden weggelaten als deze al is opgegeven bij het maken van de 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 | Description | Waarde |
|---|---|---|
| naam | De naam van de omgevingsvariabele. | tekenreeks (vereist) |
| waarde | De waarde van de omgevingsvariabele. | tekenreeks |
ResourceFile
| Naam | Description | Waarde |
|---|---|---|
| autoStorageContainerName | De eigenschappen autoStorageContainerName, storageContainerUrl en httpUrl sluiten elkaar uit en een van deze eigenschappen moet worden opgegeven. | tekenreeks |
| 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. | tekenreeks |
| fileMode | Deze eigenschap is alleen van toepassing op bestanden die worden gedownload naar Linux-rekenknooppunten. Deze wordt genegeerd als het is opgegeven voor een resourceBestand dat wordt gedownload naar een Windows-knooppunt. Als deze eigenschap niet is opgegeven voor een Linux-knooppunt, wordt de standaardwaarde 0770 toegepast op het bestand. | tekenreeks |
| 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 de eigenschap autoStorageContainerName of storageContainerUrl is opgegeven, is filePath optioneel en is het de map waar de bestanden naar moeten worden gedownload. In het geval dat filePath wordt gebruikt als een 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 verwijderd uit de werkmap van de taak (bijvoorbeeld met behulp van '..'). | tekenreeks |
| httpUrl | De eigenschappen autoStorageContainerName, storageContainerUrl en httpUrl sluiten elkaar uit en een van deze eigenschappen moet worden opgegeven. Als de URL Azure Blob Storage is, moet deze kunnen worden gelezen met anonieme toegang. Dat wil gezegd dat de Batch-service geen referenties presenteert bij het downloaden van de blob. Er zijn twee manieren om een dergelijke URL voor een blob in Azure Storage op te halen: voeg een Shared Access Signature (SAS) toe die leesmachtigingen voor de blob verleent of stel de ACL voor de blob of de container in om openbare toegang toe te staan. | tekenreeks |
| storageContainerUrl | De eigenschappen autoStorageContainerName, storageContainerUrl en httpUrl sluiten elkaar uit en een van deze eigenschappen moet worden opgegeven. Deze URL moet leesbaar en listbaar zijn met behulp van anonieme toegang; Dat wil gezegd dat de Batch-service geen referenties presenteert bij het downloaden van de blob. Er zijn twee manieren om een dergelijke URL voor een blob in Azure Storage op te halen: voeg een Shared Access Signature (SAS) toe die lees- en lijstmachtigingen verleent voor de blob, of stel de ACL voor de blob of de container in om openbare toegang toe te staan. | tekenreeks |
UserIdentity
| Naam | Description | Waarde |
|---|---|---|
| autoUser | De eigenschappen userName en autoUser sluiten elkaar uit. u moet één, maar niet beide opgeven. | AutoUserSpecification |
| userName | De eigenschappen userName en autoUser sluiten elkaar uit. u moet één, maar niet beide opgeven. | tekenreeks |
AutoUserSpecification
| Naam | Description | Waarde |
|---|---|---|
| elevationLevel | De standaardwaarde is nonAdmin. | 'Beheer' 'Niet-beheerder' |
| scope | De standaardwaarde is Pool. Als op de groep Windows wordt uitgevoerd, moet een waarde van Taak worden opgegeven als striktere isolatie tussen taken vereist is. Bijvoorbeeld als de taak het register muteert op een manier die van invloed kan zijn op andere taken, of als er certificaten zijn opgegeven in de groep die niet toegankelijk moet zijn voor normale taken, maar toegankelijk moet zijn voor starttaken. | 'Zwembad' 'Taak' |
TaskSchedulingPolicy
| Naam | Description | Waarde |
|---|---|---|
| nodeFillType | Hoe taken moeten worden verdeeld over rekenknooppunten. | 'Inpakken' 'Spread' (vereist) |
UserAccount
| Naam | Description | Waarde |
|---|---|---|
| elevationLevel | nonAdmin: de automatische gebruiker is een standaardgebruiker zonder verhoogde toegang. admin: de automatische gebruiker is een gebruiker met verhoogde toegang en werkt met volledige beheerdersmachtigingen. De standaardwaarde is nonAdmin. | 'Beheer' 'Niet-beheerder' |
| linuxUserConfiguration | Deze eigenschap wordt genegeerd als deze is opgegeven in een Windows-groep. 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-groep bevindt. Als dit niet is opgegeven en in een Windows-pool, wordt de gebruiker gemaakt met de standaardopties. | WindowsUserConfiguration |
LinuxUserConfiguration
| Naam | Description | Waarde |
|---|---|---|
| Gid | De eigenschappen uid en gid moeten samen worden opgegeven of helemaal niet. Als dit niet is opgegeven, kiest het onderliggende besturingssysteem de gid. | int |
| sshPrivateKey | De persoonlijke sleutel mag niet met een wachtwoord zijn beveiligd. De persoonlijke sleutel wordt gebruikt voor het automatisch configureren van verificatie op basis van asymmetrische sleutels 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 .ssh-map van de gebruiker te plaatsen. Als dit niet is opgegeven, wordt SSH zonder wachtwoord niet geconfigureerd tussen knooppunten (er wordt geen wijziging van de .ssh-map van de gebruiker uitgevoerd). | tekenreeks |
| uid | De eigenschappen uid en gid moeten samen worden opgegeven of helemaal niet. Als dit niet is opgegeven, kiest het onderliggende besturingssysteem de uid. | int |
WindowsUserConfiguration
| Naam | Description | Waarde |
|---|---|---|
| loginMode | Hiermee geeft u de aanmeldingsmodus voor de gebruiker op. De standaardwaarde voor VirtualMachineConfiguration-pools is de interactieve modus en voor CloudServiceConfiguration-pools is de batchmodus. | 'Batch' 'Interactief' |
Snelstartsjablonen
Met de volgende quickstart-sjablonen wordt dit resourcetype geïmplementeerd.
| Template | Beschrijving |
|---|---|
Azure Batch groep zonder openbare IP-adressen |
Met deze sjabloon maakt u Azure Batch vereenvoudigde knooppuntcommunicatiegroep zonder openbare IP-adressen. |
Resourcedefinitie van ARM-sjabloon
Het resourcetype batchAccounts/pools kan worden geïmplementeerd in:
- Resourcegroepen - Zie opdrachten voor resourcegroepimplementatie
Zie wijzigingenlogboek voor 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 JSON toe aan uw sjabloon.
{
"type": "Microsoft.Batch/batchAccounts/pools",
"apiVersion": "2021-01-01",
"name": "string",
"identity": {
"type": "string",
"userAssignedIdentities": {}
},
"properties": {
"applicationLicenses": [ "string" ],
"applicationPackages": [
{
"id": "string",
"version": "string"
}
],
"certificates": [
{
"id": "string",
"storeLocation": "string",
"storeName": "string",
"visibility": [ "string" ]
}
],
"deploymentConfiguration": {
"cloudServiceConfiguration": {
"osFamily": "string",
"osVersion": "string"
},
"virtualMachineConfiguration": {
"containerConfiguration": {
"containerImageNames": [ "string" ],
"containerRegistries": [
{
"password": "string",
"registryServer": "string",
"username": "string"
}
],
"type": "DockerCompatible"
},
"dataDisks": [
{
"caching": "string",
"diskSizeGB": "int",
"lun": "int",
"storageAccountType": "string"
}
],
"diskEncryptionConfiguration": {
"targets": [ "string" ]
},
"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"
},
"windowsConfiguration": {
"enableAutomaticUpdates": "bool"
}
}
},
"displayName": "string",
"interNodeCommunication": "string",
"metadata": [
{
"name": "string",
"value": "string"
}
],
"mountConfiguration": [
{
"azureBlobFileSystemConfiguration": {
"accountKey": "string",
"accountName": "string",
"blobfuseOptions": "string",
"containerName": "string",
"relativeMountPath": "string",
"sasKey": "string"
},
"azureFileShareConfiguration": {
"accountKey": "string",
"accountName": "string",
"azureFileUrl": "string",
"mountOptions": "string",
"relativeMountPath": "string"
},
"cifsMountConfiguration": {
"mountOptions": "string",
"password": "string",
"relativeMountPath": "string",
"source": "string",
"username": "string"
},
"nfsMountConfiguration": {
"mountOptions": "string",
"relativeMountPath": "string",
"source": "string"
}
}
],
"networkConfiguration": {
"endpointConfiguration": {
"inboundNatPools": [
{
"backendPort": "int",
"frontendPortRangeEnd": "int",
"frontendPortRangeStart": "int",
"name": "string",
"networkSecurityGroupRules": [
{
"access": "string",
"priority": "int",
"sourceAddressPrefix": "string",
"sourcePortRanges": [ "string" ]
}
],
"protocol": "string"
}
]
},
"publicIPAddressConfiguration": {
"ipAddressIds": [ "string" ],
"provision": "string"
},
"subnetId": "string"
},
"scaleSettings": {
"autoScale": {
"evaluationInterval": "string",
"formula": "string"
},
"fixedScale": {
"nodeDeallocationOption": "string",
"resizeTimeout": "string",
"targetDedicatedNodes": "int",
"targetLowPriorityNodes": "int"
}
},
"startTask": {
"commandLine": "string",
"containerSettings": {
"containerRunOptions": "string",
"imageName": "string",
"registry": {
"password": "string",
"registryServer": "string",
"username": "string"
},
"workingDirectory": "string"
},
"environmentSettings": [
{
"name": "string",
"value": "string"
}
],
"maxTaskRetryCount": "int",
"resourceFiles": [
{
"autoStorageContainerName": "string",
"blobPrefix": "string",
"fileMode": "string",
"filePath": "string",
"httpUrl": "string",
"storageContainerUrl": "string"
}
],
"userIdentity": {
"autoUser": {
"elevationLevel": "string",
"scope": "string"
},
"userName": "string"
},
"waitForSuccess": "bool"
},
"taskSchedulingPolicy": {
"nodeFillType": "string"
},
"taskSlotsPerNode": "int",
"userAccounts": [
{
"elevationLevel": "string",
"linuxUserConfiguration": {
"gid": "int",
"sshPrivateKey": "string",
"uid": "int"
},
"name": "string",
"password": "string",
"windowsUserConfiguration": {
"loginMode": "string"
}
}
],
"vmSize": "string"
}
}
Eigenschapswaarden
batchAccounts/pools
| Naam | Description | Waarde |
|---|---|---|
| type | Het resourcetype | 'Microsoft.Batch/batchAccounts/pools' |
| apiVersion | De resource-API-versie | '2021-01-01' |
| naam | De resourcenaam Meer informatie over het instellen van namen en typen voor onderliggende resources in JSON ARM-sjablonen. |
tekenreeks (vereist) Tekenlimiet: 1-64 Geldige tekens: Alfanumerieken, onderstrepingstekens en afbreekstreepjes. |
| identity | Het type identiteit dat wordt gebruikt voor de Batch-pool. | BatchPoolIdentity |
| properties | De eigenschappen die aan de pool zijn gekoppeld. | PoolEigenschappen |
BatchPoolIdentity
| Naam | Description | 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. De sleutelverwijzingen naar de gebruikersidentiteitswoordenlijst zijn ARM-resource-id's in de vorm:/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. | object |
PoolEigenschappen
| Naam | Description | Waarde |
|---|---|---|
| applicationLicenties | De lijst met toepassingslicenties moet een subset van beschikbare licenties voor Batch-servicetoepassingen zijn. Als een licentie wordt aangevraagd die niet wordt ondersteund, mislukt het maken van de pool. | tekenreeks[] |
| applicationPackages | Wijzigingen in verwijzingen naar toepassingspakketten zijn van invloed op alle nieuwe rekenknooppunten die lid worden van de pool, maar hebben geen invloed op rekenknooppunten die zich al in de pool bevinden totdat ze opnieuw worden opgestart of opnieuw worden geïnstalleerd. Er zijn maximaal 10 toepassingspakketverwijzingen voor een bepaalde pool. | ApplicationPackageReference[] |
| certificaten | Voor Windows-rekenknooppunten installeert de Batch-service de certificaten in 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 opgegeven 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 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. | tekenreeks |
| interNodeCommunication | Dit legt beperkingen op voor welke knooppunten kunnen worden toegewezen aan de pool. Als u deze waarde inschakelt, kunt u de kans verkleinen dat het aangevraagde aantal knooppunten in de pool wordt toegewezen. Als deze waarde niet wordt opgegeven, wordt deze standaard ingesteld op Uitgeschakeld. | 'Uitgeschakeld' Ingeschakeld |
| metagegevens | De Batch-service wijst geen betekenis toe aan metagegevens; het is uitsluitend 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 | Hiermee definieert u 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, is de standaardwaarde spread. | 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 moeten worden gemaakt op elk knooppunt in de pool. | UserAccount[] |
| vmSize | Zie Grootten voor Cloud Services () voor informatie over de beschikbare grootten van virtuele machines voor Cloud Services pools (https://azure.microsoft.com/documentation/articles/cloud-services-sizes-specs/pools die zijn gemaakt met cloudServiceConfiguration). Batch ondersteunt alle Cloud Services VM-grootten, met uitzondering van ExtraSmall. Zie Grootten voor Virtual Machines (Linux) () of Grootten voor Virtual Machines (Windows)https://azure.microsoft.com/documentation/articles/virtual-machines-linux-sizes/ voor informatie over beschikbare VM-grootten voor pools met behulp van installatiekopieën uit de Virtual Machines Marketplace (pools die zijn gemaakt met virtualMachineConfiguration).https://azure.microsoft.com/documentation/articles/virtual-machines-windows-sizes/ Batch ondersteunt alle azure-VM-grootten, behalve STANDARD_A0 en grootten met Premium Storage (STANDARD_GS, STANDARD_DS en STANDARD_DSV2-serie). | tekenreeks |
ApplicationPackageReference
| Naam | Description | Waarde |
|---|---|---|
| id | De id van het toepassingspakket dat moet worden geïnstalleerd. Dit moet zich in hetzelfde batchaccount bevinden als de pool. Dit kan een verwijzing zijn naar een specifieke versie 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. | tekenreeks |
CertificateReference
| Naam | Description | Waarde |
|---|---|---|
| id | De volledig gekwalificeerde id van het certificaat dat op de groep moet worden geïnstalleerd. Dit moet zich in 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 Verwijzing naar een Windows-installatiekopieën). Voor Linux-rekenknooppunten worden de certificaten opgeslagen in een map in de werkmap van de taak en wordt een omgevingsvariabele AZ_BATCH_CERTIFICATES_DIR opgegeven voor de taak om een query uit te voeren voor 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 Verwijzing naar een Windows-installatiekopieën). Algemene winkelnamen zijn: My, Root, CA, Trust, Disallowed, TrustedPeople, TrustedPublisher, AuthRoot, AddressBook, maar elke aangepaste winkelnaam kan ook worden gebruikt. De standaardwaarde is Mijn. | tekenreeks |
| Zichtbaarheid | Welke gebruikersaccounts op het rekenknooppunt moeten toegang hebben tot de persoonlijke gegevens van het certificaat. | Tekenreeksmatrix met een van de volgende waarden: 'RemoteUser' 'StartTask' 'Taak' |
DeploymentConfiguration
| Naam | Description | Waarde |
|---|---|---|
| cloudServiceConfiguration | Deze eigenschap en virtualMachineConfiguration sluiten elkaar 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 uit en een van de eigenschappen moet worden opgegeven. | VirtualMachineConfiguration |
CloudServiceConfiguration
| Naam | Description | Waarde |
|---|---|---|
| osFamily | Mogelijke waarden zijn: 2 - OS-familie 2, gelijk aan Windows Server 2008 R2 SP1. 3 - OS-familie 3, gelijk aan Windows Server 2012. 4 - OS-familie 4, gelijk aan Windows Server 2012 R2. 5 - OS-familie 5, gelijk aan Windows Server 2016. 6 - Os-familie 6, gelijk aan Windows Server 2019. Zie Azure Guest OS Releases (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. | tekenreeks |
VirtualMachineConfiguration
| Naam | Description | Waarde |
|---|---|---|
| containerConfiguration | Indien opgegeven, wordt de installatie uitgevoerd op elk knooppunt in de pool, zodat taken kunnen worden uitgevoerd in containers. Alle normale taken en taakbeheertaken 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 vermeld, 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. Als u de lijst met alle imageReferences wilt ophalen die door Azure Batch zijn geverifieerd, raadpleegt u de bewerking Ondersteunde knooppuntagent-SKU's weergeven. | 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 on-premises licentiekorting toegepast. Waarden zijn: Windows_Server: de on-premises licentie is voor Windows Server. Windows_Client: de on-premises licentie is voor Windows Client. |
tekenreeks |
| nodeAgentSkuId | De Batch-knooppuntagent is een programma dat wordt uitgevoerd op elk knooppunt in de pool en biedt de command-and-control-interface 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 verwijzing naar de geselecteerde installatiekopieën. Zie de bewerking 'Ondersteunde knooppuntagent-SKU's weergeven' voor de lijst met ondersteunde knooppuntagent-SKU's, samen met de bijbehorende lijst met geverifieerde installatiekopieën. | tekenreeks (vereist) |
| nodePlacementConfiguration | Met deze configuratie worden regels opgegeven voor de wijze waarop knooppunten in de pool fysiek worden toegewezen. | NodePlacementConfiguration |
| windowsConfiguration | Deze eigenschap moet niet worden opgegeven als de imageReference een Linux-besturingssysteeminstallatiekopie opgeeft. | WindowsConfiguration |
ContainerConfiguration
| Naam | Description | Waarde |
|---|---|---|
| containerImageNames | Dit is de volledige verwijzing naar de installatiekopie, zoals wordt opgegeven als 'docker pull'. Een installatiekopieën worden opgehaald 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 privéregister waarvoor referenties zijn vereist, moeten deze referenties hier worden opgegeven. | ContainerRegistry[] |
| type | De containertechnologie die moet worden gebruikt. | 'DockerCompatible' (vereist) |
ContainerRegistry
| Naam | Description | Waarde |
|---|---|---|
| wachtwoord | Het wachtwoord om u aan te melden bij de registerserver. | tekenreeks (vereist) |
| registryServer | Als u dit weglaat, is de standaardwaarde 'docker.io'. | tekenreeks |
| gebruikersnaam | De gebruikersnaam om u aan te melden bij de registerserver. | tekenreeks (vereist) |
DataDisk
| Naam | Description | Waarde |
|---|---|---|
| Caching | Waarden zijn: none: 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 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 gebruikmaken van premium lokaal redundante opslag. |
'Premium_LRS' 'Standard_LRS' |
DiskEncryptionConfiguration
| Naam | Description | Waarde |
|---|---|---|
| Doelstellingen | In een Linux-pool wordt alleen 'TemporaryDisk' ondersteund; in een Windows-groep moeten 'OsDisk' en 'TemporaryDisk' worden opgegeven. | Tekenreeksmatrix met een van de volgende waarden: 'OsDisk' 'TemporaryDisk' |
VMExtension
| Naam | Description | Waarde |
|---|---|---|
| autoUpgradeMinorVersion | Geeft aan of de extensie een nieuwere secundaire versie moet gebruiken als deze beschikbaar is tijdens de implementatie. Zodra de extensie 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. | booleaans |
| naam | De naam van de extensie van de virtuele machine. | tekenreeks (vereist) |
| protectedSettings | De extensie kan protectedSettings of protectedSettingsFromKeyVault bevatten of helemaal geen beveiligde instellingen. | |
| provisionAfterExtensions | Verzameling extensienamen waarna deze extensie moet worden ingericht. | tekenreeks[] |
| publisher | De naam van de uitgever van de extensie-handler. | tekenreeks (vereist) |
| instellingen | Met JSON opgemaakte openbare instellingen voor de extensie. | |
| type | Het type van de extensies. | tekenreeks (vereist) |
| typeHandlerVersion | De versie van scripthandler. | tekenreeks |
ImageReference
| Naam | Description | Waarde |
|---|---|---|
| id | Deze eigenschap is wederzijds exclusief met andere eigenschappen. De Shared Image Gallery-installatiekopieën moeten replica's hebben in dezelfde regio als het Azure Batch-account. Zie /azure/batch/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. | tekenreeks |
| offer | Bijvoorbeeld UbuntuServer of WindowsServer. | tekenreeks |
| publisher | Bijvoorbeeld Canonical of MicrosoftWindowsServer. | tekenreeks |
| sku | Bijvoorbeeld 18.04-LTS of 2019-Datacenter. | tekenreeks |
| versie | De waarde 'nieuwste' kan worden opgegeven om de meest recente versie van een installatiekopieën te selecteren. Als u dit weglaat, is de standaardwaarde 'nieuwste'. | tekenreeks |
NodePlacementConfiguration
| Naam | Description | Waarde |
|---|---|---|
| policy | 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 |
WindowsConfiguration
| Naam | Description | Waarde |
|---|---|---|
| enableAutomaticUpdates | Als u dit weglaat, is de standaardwaarde true. | booleaans |
MetadataItem
| Naam | Description | Waarde |
|---|---|---|
| naam | De naam van het metagegevensitem. | tekenreeks (vereist) |
| waarde | De waarde van het metagegevensitem. | tekenreeks (vereist) |
MountConfiguration
| Naam | Description | 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 | Description | Waarde |
|---|---|---|
| accountKey | Deze eigenschap is wederzijds exclusief met sasKey en er moet een worden opgegeven. | tekenreeks |
| accountName | De naam van het Azure Storage-account. | tekenreeks (vereist) |
| blobfuseOptions | Dit zijn opties voor 'net use' in Windows en 'koppelopties' in Linux. | tekenreeks |
| containerName | De Azure Blob Storage containernaam. | tekenreeks (vereist) |
| relativeMountPath | Alle bestandssystemen worden gekoppeld ten opzichte van de batch-koppelmap, toegankelijk via de AZ_BATCH_NODE_MOUNTS_DIR omgevingsvariabele. | tekenreeks (vereist) |
| sasKey | Deze eigenschap is wederzijds exclusief met accountKey en er moet een worden opgegeven. | tekenreeks |
AzureFileShareConfiguration
| Naam | Description | Waarde |
|---|---|---|
| accountKey | De sleutel van het Azure Storage-account. | tekenreeks (vereist) |
| accountName | De naam van het Azure Storage-account. | tekenreeks (vereist) |
| azureFileUrl | Dit heeft de vorm 'https://{account}.file.core.windows.net/'. | tekenreeks (vereist) |
| mountOptions | Dit zijn opties voor 'net use' in Windows en 'koppelopties' in Linux. | tekenreeks |
| relativeMountPath | Alle bestandssystemen worden gekoppeld ten opzichte van de batch-koppelmap, toegankelijk via de AZ_BATCH_NODE_MOUNTS_DIR omgevingsvariabele. | tekenreeks (vereist) |
CifsMountConfiguration
| Naam | Description | Waarde |
|---|---|---|
| mountOptions | Dit zijn opties voor 'net use' in Windows en 'koppelingsopties' in Linux. | tekenreeks |
| wachtwoord | Het wachtwoord dat moet worden gebruikt voor verificatie met het CIFS-bestandssysteem. | tekenreeks (vereist) |
| relativeMountPath | Alle bestandssystemen worden gekoppeld ten opzichte van de map Batch-koppels, toegankelijk via de omgevingsvariabele AZ_BATCH_NODE_MOUNTS_DIR. | tekenreeks (vereist) |
| source | De URI van het bestandssysteem dat moet worden gekoppeld. | tekenreeks (vereist) |
| gebruikersnaam | De gebruiker die moet worden gebruikt voor verificatie met het CIFS-bestandssysteem. | tekenreeks (vereist) |
NFSMountConfiguration
| Naam | Description | Waarde |
|---|---|---|
| mountOptions | Dit zijn opties voor 'net use' in Windows en 'koppelingsopties' in Linux. | tekenreeks |
| relativeMountPath | Alle bestandssystemen worden gekoppeld ten opzichte van de map Batch-koppels, toegankelijk via de omgevingsvariabele AZ_BATCH_NODE_MOUNTS_DIR. | tekenreeks (vereist) |
| source | De URI van het bestandssysteem dat moet worden gekoppeld. | tekenreeks (vereist) |
NetworkConfiguration
| Naam | Description | Waarde |
|---|---|---|
| endpointConfiguration | Configuratie van pooleindpunten wordt alleen ondersteund voor pools met de eigenschap virtualMachineConfiguration. | PoolEndpointConfiguration |
| publicIPAddressConfiguration | Deze eigenschap wordt alleen ondersteund voor 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 voor het aantal knooppunten in de groep. Als het subnet onvoldoende vrije IP-adressen heeft, wijst de groep gedeeltelijk rekenknooppunten toe en treedt er een fout bij het wijzigen van het formaat op. De service-principal 'MicrosoftAzureBatch' moet de rol 'Inzender voor klassieke virtuele machines' Role-Based Access Control (RBAC) hebben 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's) 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 aan het opgegeven VNet NSG’s (netwerkbeveiligingsgroepen) zijn gekoppeld, moeten een paar gereserveerde poorten worden ingeschakeld voor binnenkomende communicatie. Voor pools die zijn gemaakt met een virtuele-machineconfiguratie schakelt u poort 29876 en 29877 in, evenals poort 22 voor Linux en poort 3389 voor Windows. Voor pools die zijn gemaakt met een cloudserviceconfiguratie schakelt u poort 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 | tekenreeks |
PoolEndpointConfiguration
| Naam | Description | 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 | Description | 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, omdat deze zijn gereserveerd. Als er gereserveerde waarden worden opgegeven, mislukt de aanvraag met HTTP-statuscode 400. | int (vereist) |
| frontendPortRangeEnd | Acceptabele waarden liggen tussen 1 en 65534, met uitzondering van poorten van 50000 tot 55000 die zijn gereserveerd door de Batch-service. Alle bereiken binnen een pool moeten verschillend zijn en mogen elkaar niet overlappen. Als er gereserveerde of overlappende waarden worden opgegeven, mislukt de aanvraag met HTTP-statuscode 400. | int (vereist) |
| frontendPortRangeStart | Acceptabele waarden liggen tussen 1 en 65534, met uitzondering van poorten van 50000 tot 55000 die zijn gereserveerd. Alle bereiken binnen een pool moeten verschillend zijn en mogen elkaar 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 en mag 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 | Description | Waarde |
|---|---|---|
| toegang | De actie die moet worden uitgevoerd voor een opgegeven IP-adres, subnetbereik of tag. | 'Toestaan' Weigeren (vereist) |
| priority | 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 volgnummers 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 elkaar niet overlappen. Als er andere waarden worden opgegeven, mislukt de aanvraag met HTTP-statuscode 400. De standaardwaarde is *. | tekenreeks[] |
PublicIPAddressConfiguration
| Naam | Description | Waarde |
|---|---|---|
| ipAddressIds | Het aantal IP-adressen dat hier is opgegeven, beperkt de maximale grootte van de pool. Er kunnen 100 toegewezen knooppunten of 100 knooppunten met lage prioriteit worden toegewezen voor elk openbaar IP-adres. Een pool die bijvoorbeeld 250 toegewezen VM's nodig heeft, moet ten minste drie openbare IP-adressen opgegeven hebben. 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 | Description | Waarde |
|---|---|---|
| automatisch schalen | Deze eigenschap en fixedScale sluiten elkaar uit en een van de eigenschappen moet worden opgegeven. | Instellingen voor automatisch schalen |
| fixedScale | Deze eigenschap en automatische schaalaanpassing sluiten elkaar uit en een van de eigenschappen moet worden opgegeven. | FixedScaleSettings |
Instellingen voor automatisch schalen
| Naam | Description | Waarde |
|---|---|---|
| evaluationInterval | Als u dit weglaat, is de standaardwaarde 15 minuten (PT15M). | tekenreeks |
| Formule | Een formule voor het gewenste aantal rekenknooppunten in de pool. | tekenreeks (vereist) |
FixedScaleSettings
| Naam | Description | Waarde |
|---|---|---|
| nodeDeallocationOption | Als u dit weglaat, is de standaardwaarde Opnieuw in de wachtrij plaatsen. | 'Opnieuw in de wachtrij plaatsen' 'RetainedData' 'TaskCompletion' 'Beëindigen' |
| resizeTimeout | De standaardwaarde is 15 minuten. Time-outwaarden gebruiken de ISO 8601-indeling. Gebruik bijvoorbeeld PT10M gedurende 10 minuten. De minimumwaarde is 5 minuten. Als u een waarde van minder dan 5 minuten opgeeft, weigert de Batch-service de aanvraag met een fout; Als u de REST API rechtstreeks aanroept, is de HTTP-statuscode 400 (ongeldige aanvraag). | tekenreeks |
| targetDedicatedNodes | Ten minste één van targetDedicatedNodes, targetLowPriorityNodes moet worden ingesteld. | int |
| targetLowPriorityNodes | Ten minste één van targetDedicatedNodes, targetLowPriorityNodes moet worden ingesteld. | int |
StartTask
| Naam | Description | 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 in de opdrachtregel aanroepen, bijvoorbeeld met 'cmd /c MyCommand' in Windows of '/bin/sh -c MyCommand' in Linux. Vereist als er andere eigenschappen van de startTask zijn opgegeven. | tekenreeks |
| 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 taakomgevingsvariabelen toegewezen aan de container en wordt de taakopdrachtregel uitgevoerd in de container. | TaskContainerSettings |
| environmentSettings | Een lijst met omgevingsvariabeleinstellingen voor de begintaak. | EnvironmentSetting[] |
| maxTaskRetryCount | De Batch-service voert een taak opnieuw uit als de afsluitcode een andere is dan nul. Houd er rekening mee dat deze waarde specifiek het aantal nieuwe pogingen bepaalt. De Batch-service probeert de taak eenmaal uit te voeren en kan het vervolgens opnieuw proberen tot deze limiet. Als het maximumaantal nieuwe pogingen bijvoorbeeld 3 is, probeert Batch de taak maximaal 4 keer (één eerste poging en 3 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. | int |
| resourceFiles | Een lijst met bestanden die door de Batch-service worden gedownload naar het rekenknooppunt voordat de opdrachtregel wordt uitgevoerd. | ResourceFile[] |
| userIdentity | Als u dit weglaat, wordt de taak uitgevoerd als een gebruiker zonder beheerdersrechten die uniek is voor de taak. | UserIdentity |
| waitForSuccess | Als waar is en de begintaak mislukt op een rekenknooppunt, probeert de Batch-service de starttaak opnieuw tot het maximale aantal nieuwe pogingen (maxTaskRetryCount). Als de taak na alle nieuwe pogingen nog steeds niet is voltooid, markeert de Batch-service het rekenknooppunt als onbruikbaar en worden er geen taken naar gepland. Deze voorwaarde kan worden gedetecteerd via de status van het knooppunt en de details van de planningsfout. Indien onwaar, 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 wordt uitgevoerd; en zelfs als de begintaak mislukt, worden er nog steeds nieuwe taken gepland op het knooppunt. De standaardwaarde is true. | booleaans |
TaskContainerSettings
| Naam | Description | Waarde |
|---|---|---|
| containerRunOptions | Deze extra opties worden geleverd als argumenten voor de opdracht 'docker maken', naast de opties die worden beheerd door de Batch-service. | tekenreeks |
| Afbeeldingnaam | Dit is de volledige installatiekopiereferentie, zoals wordt opgegeven bij 'docker pull'. Als er geen tag wordt opgegeven als onderdeel van de naam van de installatiekopieën, wordt de tag ':latest' standaard gebruikt. | tekenreeks (vereist) |
| registry | Deze instelling kan worden weggelaten als deze al is opgegeven bij het maken van de 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 | Description | Waarde |
|---|---|---|
| naam | De naam van de omgevingsvariabele. | tekenreeks (vereist) |
| waarde | De waarde van de omgevingsvariabele. | tekenreeks |
ResourceFile
| Naam | Description | Waarde |
|---|---|---|
| autoStorageContainerName | De eigenschappen autoStorageContainerName, storageContainerUrl en httpUrl sluiten elkaar uit en een van deze eigenschappen moet worden opgegeven. | tekenreeks |
| 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. | tekenreeks |
| fileMode | Deze eigenschap is alleen van toepassing op bestanden die worden gedownload naar Linux-rekenknooppunten. Deze wordt genegeerd als het is opgegeven voor een resourceBestand dat wordt gedownload naar een Windows-knooppunt. Als deze eigenschap niet is opgegeven voor een Linux-knooppunt, wordt de standaardwaarde 0770 toegepast op het bestand. | tekenreeks |
| 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 de eigenschap autoStorageContainerName of storageContainerUrl is opgegeven, is filePath optioneel en is het de map waar de bestanden naar moeten worden gedownload. In het geval dat filePath wordt gebruikt als een 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 verwijderd uit de werkmap van de taak (bijvoorbeeld met behulp van '..'). | tekenreeks |
| httpUrl | De eigenschappen autoStorageContainerName, storageContainerUrl en httpUrl sluiten elkaar uit en een van deze eigenschappen moet worden opgegeven. Als de URL Azure Blob Storage is, moet deze kunnen worden gelezen met anonieme toegang. Dat wil gezegd dat de Batch-service geen referenties presenteert bij het downloaden van de blob. Er zijn twee manieren om een dergelijke URL voor een blob in Azure Storage op te halen: voeg een Shared Access Signature (SAS) toe die leesmachtigingen voor de blob verleent of stel de ACL voor de blob of de container in om openbare toegang toe te staan. | tekenreeks |
| storageContainerUrl | De eigenschappen autoStorageContainerName, storageContainerUrl en httpUrl sluiten elkaar uit en een van deze eigenschappen moet worden opgegeven. Deze URL moet leesbaar en listbaar zijn met behulp van anonieme toegang; Dat wil gezegd dat de Batch-service geen referenties presenteert bij het downloaden van de blob. Er zijn twee manieren om een dergelijke URL voor een blob in Azure Storage op te halen: voeg een Shared Access Signature (SAS) toe die lees- en lijstmachtigingen verleent voor de blob, of stel de ACL voor de blob of de container in om openbare toegang toe te staan. | tekenreeks |
UserIdentity
| Naam | Description | Waarde |
|---|---|---|
| autoUser | De eigenschappen userName en autoUser sluiten elkaar uit. u moet een, maar niet beide opgeven. | AutoUserSpecification |
| userName | De eigenschappen userName en autoUser sluiten elkaar uit. u moet een, maar niet beide opgeven. | tekenreeks |
AutoUserSpecification
| Naam | Description | Waarde |
|---|---|---|
| elevationLevel | De standaardwaarde is nonAdmin. | 'Beheer' 'NonAdmin' |
| scope | De standaardwaarde is Pool. Als in de groep Windows wordt uitgevoerd, moet de waarde Taak worden opgegeven als een striktere isolatie tussen taken vereist is. Bijvoorbeeld als de taak het register muteert op een manier die van invloed kan zijn op andere taken, of als er certificaten zijn opgegeven in de groep die niet toegankelijk moeten zijn voor normale taken, maar toegankelijk moeten zijn voor starttaken. | 'Zwembad' 'Taak' |
TaskSchedulingPolicy
| Naam | Description | Waarde |
|---|---|---|
| nodeFillType | Hoe taken moeten worden verdeeld over rekenknooppunten. | 'Inpakken' 'Spread' (vereist) |
UserAccount
| Naam | Description | Waarde |
|---|---|---|
| elevationLevel | nonAdmin: de automatische gebruiker is een standaardgebruiker zonder verhoogde toegang. admin: de automatische gebruiker is een gebruiker met verhoogde toegang en werkt met volledige beheerdersmachtigingen. De standaardwaarde is nonAdmin. | 'Beheer' 'Niet-beheerder' |
| linuxUserConfiguration | Deze eigenschap wordt genegeerd als deze is opgegeven in een Windows-groep. 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-groep bevindt. Als dit niet is opgegeven en in een Windows-pool, wordt de gebruiker gemaakt met de standaardopties. | WindowsUserConfiguration |
LinuxUserConfiguration
| Naam | Description | Waarde |
|---|---|---|
| Gid | De eigenschappen uid en gid moeten samen worden opgegeven of helemaal niet. Als dit niet is opgegeven, kiest het onderliggende besturingssysteem de gid. | int |
| sshPrivateKey | De persoonlijke sleutel mag niet met een wachtwoord zijn beveiligd. De persoonlijke sleutel wordt gebruikt voor het automatisch configureren van verificatie op basis van asymmetrische sleutels 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 .ssh-map van de gebruiker te plaatsen. Als dit niet is opgegeven, wordt SSH zonder wachtwoord niet geconfigureerd tussen knooppunten (er wordt geen wijziging van de .ssh-map van de gebruiker uitgevoerd). | tekenreeks |
| uid | De eigenschappen uid en gid moeten samen worden opgegeven of helemaal niet. Als dit niet is opgegeven, kiest het onderliggende besturingssysteem de uid. | int |
WindowsUserConfiguration
| Naam | Description | Waarde |
|---|---|---|
| loginMode | Hiermee geeft u de aanmeldingsmodus voor de gebruiker op. De standaardwaarde voor VirtualMachineConfiguration-pools is de interactieve modus en voor CloudServiceConfiguration-pools is de batchmodus. | 'Batch' 'Interactief' |
Snelstartsjablonen
Met de volgende quickstart-sjablonen wordt dit resourcetype geïmplementeerd.
| Template | Beschrijving |
|---|---|
| Azure Batch groep zonder openbare IP-adressen |
Met deze sjabloon maakt u Azure Batch vereenvoudigde knooppuntcommunicatiegroep zonder openbare IP-adressen. |
Resourcedefinitie van Terraform (AzAPI-provider)
Het resourcetype batchAccounts/pools kan worden geïmplementeerd in:
- Resourcegroepen
Zie wijzigingenlogboek voor 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@2021-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 = [
{
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"
}
windowsConfiguration = {
enableAutomaticUpdates = bool
}
}
}
displayName = "string"
interNodeCommunication = "string"
metadata = [
{
name = "string"
value = "string"
}
]
mountConfiguration = [
{
azureBlobFileSystemConfiguration = {
accountKey = "string"
accountName = "string"
blobfuseOptions = "string"
containerName = "string"
relativeMountPath = "string"
sasKey = "string"
}
azureFileShareConfiguration = {
accountKey = "string"
accountName = "string"
azureFileUrl = "string"
mountOptions = "string"
relativeMountPath = "string"
}
cifsMountConfiguration = {
mountOptions = "string"
password = "string"
relativeMountPath = "string"
source = "string"
username = "string"
}
nfsMountConfiguration = {
mountOptions = "string"
relativeMountPath = "string"
source = "string"
}
}
]
networkConfiguration = {
endpointConfiguration = {
inboundNatPools = [
{
backendPort = int
frontendPortRangeEnd = int
frontendPortRangeStart = int
name = "string"
networkSecurityGroupRules = [
{
access = "string"
priority = int
sourceAddressPrefix = "string"
sourcePortRanges = [
"string"
]
}
]
protocol = "string"
}
]
}
publicIPAddressConfiguration = {
ipAddressIds = [
"string"
]
provision = "string"
}
subnetId = "string"
}
scaleSettings = {
autoScale = {
evaluationInterval = "string"
formula = "string"
}
fixedScale = {
nodeDeallocationOption = "string"
resizeTimeout = "string"
targetDedicatedNodes = int
targetLowPriorityNodes = int
}
}
startTask = {
commandLine = "string"
containerSettings = {
containerRunOptions = "string"
imageName = "string"
registry = {
password = "string"
registryServer = "string"
username = "string"
}
workingDirectory = "string"
}
environmentSettings = [
{
name = "string"
value = "string"
}
]
maxTaskRetryCount = int
resourceFiles = [
{
autoStorageContainerName = "string"
blobPrefix = "string"
fileMode = "string"
filePath = "string"
httpUrl = "string"
storageContainerUrl = "string"
}
]
userIdentity = {
autoUser = {
elevationLevel = "string"
scope = "string"
}
userName = "string"
}
waitForSuccess = bool
}
taskSchedulingPolicy = {
nodeFillType = "string"
}
taskSlotsPerNode = int
userAccounts = [
{
elevationLevel = "string"
linuxUserConfiguration = {
gid = int
sshPrivateKey = "string"
uid = int
}
name = "string"
password = "string"
windowsUserConfiguration = {
loginMode = "string"
}
}
]
vmSize = "string"
}
})
}
Eigenschapswaarden
batchAccounts/pools
| Naam | Description | Waarde |
|---|---|---|
| type | Het resourcetype | "Microsoft.Batch/batchAccounts/pools@2021-01-01" |
| naam | De resourcenaam | tekenreeks (vereist) Tekenlimiet: 1-64 Geldige tekens: Alfanumerieken, 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 |
| identity | Het type identiteit dat wordt gebruikt voor de Batch-pool. | BatchPoolIdentity |
| properties | De eigenschappen die zijn gekoppeld aan de pool. | PoolEigenschappen |
BatchPoolIdentity
| Naam | Description | 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. De sleutelverwijzingen naar de gebruikersidentiteitswoordenlijst zijn ARM-resource-id's in de vorm:/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. | Matrix met gebruikersidentiteits-id's. |
PoolEigenschappen
| Naam | Description | Waarde |
|---|---|---|
| applicationLicenties | De lijst met toepassingslicenties moet een subset van beschikbare licenties voor Batch-servicetoepassingen zijn. Als een licentie wordt aangevraagd die niet wordt ondersteund, mislukt het maken van de pool. | tekenreeks[] |
| applicationPackages | Wijzigingen in verwijzingen naar toepassingspakketten zijn van invloed op alle nieuwe rekenknooppunten die lid worden van de pool, maar hebben geen invloed op rekenknooppunten die zich al in de pool bevinden totdat ze opnieuw worden opgestart of opnieuw worden geïnstalleerd. Er zijn maximaal 10 toepassingspakketverwijzingen voor een bepaalde pool. | ApplicationPackageReference[] |
| certificaten | Voor Windows-rekenknooppunten installeert de Batch-service de certificaten in 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 opgegeven 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 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. | tekenreeks |
| interNodeCommunication | Dit legt beperkingen op voor welke knooppunten kunnen worden toegewezen aan de pool. Als u deze waarde inschakelt, kunt u de kans verkleinen dat het aangevraagde aantal knooppunten in de pool wordt toegewezen. Als deze waarde niet wordt opgegeven, wordt deze standaard ingesteld op Uitgeschakeld. | "Uitgeschakeld" "Ingeschakeld" |
| metagegevens | De Batch-service wijst geen betekenis toe aan metagegevens; het is uitsluitend 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 | Hiermee definieert u 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, is de standaardwaarde spread. | 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 moeten worden gemaakt op elk knooppunt in de pool. | UserAccount[] |
| vmSize | Zie Grootten voor Cloud Services () voor informatie over de beschikbare grootten van virtuele machines voor Cloud Services pools (https://azure.microsoft.com/documentation/articles/cloud-services-sizes-specs/pools die zijn gemaakt met cloudServiceConfiguration). Batch ondersteunt alle Cloud Services VM-grootten, met uitzondering van ExtraSmall. Zie Grootten voor Virtual Machines (Linux) () of Grootten voor Virtual Machines (Windows)https://azure.microsoft.com/documentation/articles/virtual-machines-linux-sizes/ voor informatie over beschikbare VM-grootten voor pools met behulp van installatiekopieën uit de Virtual Machines Marketplace (pools die zijn gemaakt met virtualMachineConfiguration).https://azure.microsoft.com/documentation/articles/virtual-machines-windows-sizes/ Batch ondersteunt alle azure-VM-grootten, behalve STANDARD_A0 en grootten met Premium Storage (STANDARD_GS, STANDARD_DS en STANDARD_DSV2-serie). | tekenreeks |
ApplicationPackageReference
| Naam | Description | Waarde |
|---|---|---|
| id | De id van het toepassingspakket dat moet worden geïnstalleerd. Dit moet zich in hetzelfde batchaccount bevinden als de pool. Dit kan een verwijzing zijn naar een specifieke versie 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. | tekenreeks |
CertificateReference
| Naam | Description | Waarde |
|---|---|---|
| id | De volledig gekwalificeerde id van het certificaat dat in de groep moet worden geïnstalleerd. Dit moet zich in 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 Verwijzing naar een Windows-installatiekopieën). 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 opgegeven 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 Verwijzing naar een Windows-installatiekopieën). Algemene winkelnamen zijn: My, Root, CA, Trust, Disallowed, TrustedPeople, TrustedPublisher, AuthRoot, AddressBook, maar elke aangepaste winkelnaam kan ook worden gebruikt. De standaardwaarde is Mijn. | tekenreeks |
| Zichtbaarheid | Welke gebruikersaccounts op het rekenknooppunt moeten toegang hebben tot de persoonlijke gegevens van het certificaat. | Tekenreeksmatrix met een van de volgende: "RemoteUser" "StartTask" "Taak" |
DeploymentConfiguration
| Naam | Description | 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 uit en een van de eigenschappen moet worden opgegeven. | VirtualMachineConfiguration |
CloudServiceConfiguration
| Naam | Description | Waarde |
|---|---|---|
| osFamily | Mogelijke waarden zijn: 2 - OS-familie 2, gelijk aan Windows Server 2008 R2 SP1. 3 - OS-familie 3, gelijk aan Windows Server 2012. 4 - OS-familie 4, gelijk aan Windows Server 2012 R2. 5 - OS-familie 5, gelijk aan Windows Server 2016. 6 - OS-familie 6, equivalent aan Windows Server 2019. Zie 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. | tekenreeks |
VirtualMachineConfiguration
| Naam | Description | Waarde |
|---|---|---|
| containerConfiguration | Indien opgegeven, wordt de installatie uitgevoerd op elk knooppunt in de pool, zodat taken kunnen worden uitgevoerd in containers. Alle reguliere taken en taakbeheertaken 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 vermeld 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. Als u de lijst met alle imageReferences wilt ophalen die zijn geverifieerd door Azure Batch, raadpleegt u de bewerking Ondersteunde knooppuntagent-SKU's vermelden. | ImageReference (vereist) |
| licenseType | Dit geldt alleen voor installatiekopieën die het Windows-besturingssysteem bevatten en mag alleen worden gebruikt wanneer u geldige on-premises licenties hebt voor de knooppunten die worden geïmplementeerd. Als u dit weglaat, wordt er geen on-premises licentiekorting toegepast. Waarden zijn: Windows_Server: de on-premises licentie is voor Windows Server. Windows_Client: de on-premises licentie is voor Windows Client. |
tekenreeks |
| nodeAgentSkuId | De Batch-knooppuntagent is een programma dat wordt uitgevoerd op elk knooppunt in de pool en biedt de command-and-control-interface 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 knooppuntagent-SKU's weergeven voor informatie over de lijst met ondersteunde knooppuntagent-SKU's, samen met de bijbehorende lijst met geverifieerde verwijzingen naar installatiekopieën. | tekenreeks (vereist) |
| nodePlacementConfiguration | Met deze configuratie worden regels opgegeven voor de wijze waarop knooppunten in de pool fysiek worden toegewezen. | NodePlacementConfiguration |
| windowsConfiguration | Deze eigenschap mag niet worden opgegeven als de imageReference een Linux-besturingssysteeminstallatiekopie opgeeft. | WindowsConfiguration |
ContainerConfiguration
| Naam | Description | Waarde |
|---|---|---|
| containerImageNames | Dit is de volledige installatiekopiereferentie, zoals wordt opgegeven bij 'docker pull'. Een installatiekopieën worden opgehaald uit het standaard Docker-register, tenzij de installatiekopieën volledig zijn gekwalificeerd met een alternatief register. | tekenreeks[] |
| containerRegistries | Als installatiekopieën moeten worden gedownload uit een privéregister waarvoor referenties zijn vereist, moeten deze referenties hier worden opgegeven. | ContainerRegistry[] |
| type | De te gebruiken containertechnologie. | "DockerCompatible" (vereist) |
ContainerRegistry
| Naam | Description | Waarde |
|---|---|---|
| wachtwoord | Het wachtwoord om u aan te melden bij de registerserver. | tekenreeks (vereist) |
| registryServer | Als u dit weglaat, is de standaardwaarde 'docker.io'. | tekenreeks |
| gebruikersnaam | De gebruikersnaam om u aan te melden bij de registerserver. | tekenreeks (vereist) |
DataDisk
| Naam | Description | Waarde |
|---|---|---|
| Caching | Waarden zijn: none: 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 de 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" "Alleen-lezen" "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 gebruikmaken van standaard lokaal redundante opslag. Premium_LRS: de gegevensschijf moet gebruikmaken van premium lokaal redundante opslag. |
"Premium_LRS" "Standard_LRS" |
DiskEncryptionConfiguration
| Naam | Description | Waarde |
|---|---|---|
| Doelstellingen | In Een Linux-pool wordt alleen 'TemporaryDisk' ondersteund; op Windows-pool moeten 'OsDisk' en 'TemporaryDisk' worden opgegeven. | Tekenreeksmatrix met een van de volgende: "OsDisk" "TemporaryDisk" |
VMExtension
| Naam | Description | Waarde |
|---|---|---|
| autoUpgradeMinorVersion | Geeft aan of de extensie een nieuwere secundaire versie moet gebruiken als deze beschikbaar is tijdens de implementatie. Zodra de extensie is geïmplementeerd, worden secundaire versies echter niet bijgewerkt, tenzij opnieuw geïmplementeerd, zelfs als deze eigenschap is ingesteld op true. | booleaans |
| naam | De naam van de extensie van de virtuele machine. | tekenreeks (vereist) |
| protectedSettings | De extensie kan protectedSettings of protectedSettingsFromKeyVault bevatten of helemaal geen beveiligde instellingen bevatten. | |
| provisionAfterExtensions | Verzameling extensienamen waarna deze extensie moet worden ingericht. | tekenreeks[] |
| publisher | De naam van de uitgever van de extensie-handler. | tekenreeks (vereist) |
| instellingen | Met JSON opgemaakte openbare instellingen voor de extensie. | |
| type | Het type van de extensies. | tekenreeks (vereist) |
| typeHandlerVersion | De versie van scripthandler. | tekenreeks |
ImageReference
| Naam | Description | Waarde |
|---|---|---|
| id | Deze eigenschap is wederzijds exclusief met andere eigenschappen. De Shared Image Gallery-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. | tekenreeks |
| offer | Bijvoorbeeld UbuntuServer of WindowsServer. | tekenreeks |
| publisher | Bijvoorbeeld Canonical of MicrosoftWindowsServer. | tekenreeks |
| sku | Bijvoorbeeld 18.04-LTS of 2019-Datacenter. | tekenreeks |
| versie | De waarde 'meest recente' kan worden opgegeven om de meest recente versie van een installatiekopieën te selecteren. Als u dit weglaat, is de standaardwaarde 'nieuwste'. | tekenreeks |
NodePlacementConfiguration
| Naam | Description | Waarde |
|---|---|---|
| policy | 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" |
WindowsConfiguration
| Naam | Description | Waarde |
|---|---|---|
| enableAutomaticUpdates | Als u dit weglaat, is de standaardwaarde true. | booleaans |
MetadataItem
| Naam | Description | Waarde |
|---|---|---|
| naam | De naam van het metagegevensitem. | tekenreeks (vereist) |
| waarde | De waarde van het metagegevensitem. | tekenreeks (vereist) |
MountConfiguration
| Naam | Description | 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 | Description | Waarde |
|---|---|---|
| accountKey | Deze eigenschap is wederzijds exclusief met sasKey en er moet een worden opgegeven. | tekenreeks |
| accountName | De naam van het Azure Storage-account. | tekenreeks (vereist) |
| blobfuseOptions | Dit zijn opties voor 'net use' in Windows en 'koppelingsopties' in Linux. | tekenreeks |
| containerName | De Azure Blob Storage containernaam. | tekenreeks (vereist) |
| relativeMountPath | Alle bestandssystemen worden gekoppeld ten opzichte van de map Batch-koppels, toegankelijk via de omgevingsvariabele AZ_BATCH_NODE_MOUNTS_DIR. | tekenreeks (vereist) |
| sasKey | Deze eigenschap is wederzijds exclusief met accountKey en er moet een worden opgegeven. | tekenreeks |
AzureFileShareConfiguration
| Naam | Description | Waarde |
|---|---|---|
| accountKey | De Azure Storage-accountsleutel. | tekenreeks (vereist) |
| accountName | De naam van het Azure Storage-account. | tekenreeks (vereist) |
| azureFileUrl | Dit heeft de vorm 'https://{account}.file.core.windows.net/'. | tekenreeks (vereist) |
| mountOptions | Dit zijn opties voor 'net use' in Windows en 'koppelingsopties' in Linux. | tekenreeks |
| relativeMountPath | Alle bestandssystemen worden gekoppeld ten opzichte van de map Batch-koppels, toegankelijk via de omgevingsvariabele AZ_BATCH_NODE_MOUNTS_DIR. | tekenreeks (vereist) |
CifsMountConfiguration
| Naam | Description | Waarde |
|---|---|---|
| mountOptions | Dit zijn opties voor 'net use' in Windows en 'koppelingsopties' in Linux. | tekenreeks |
| wachtwoord | Het wachtwoord dat moet worden gebruikt voor verificatie met het CIFS-bestandssysteem. | tekenreeks (vereist) |
| relativeMountPath | Alle bestandssystemen worden gekoppeld ten opzichte van de map Batch-koppels, toegankelijk via de omgevingsvariabele AZ_BATCH_NODE_MOUNTS_DIR. | tekenreeks (vereist) |
| source | De URI van het bestandssysteem dat moet worden gekoppeld. | tekenreeks (vereist) |
| gebruikersnaam | De gebruiker die moet worden gebruikt voor verificatie met het CIFS-bestandssysteem. | tekenreeks (vereist) |
NFSMountConfiguration
| Naam | Description | Waarde |
|---|---|---|
| mountOptions | Dit zijn opties voor 'net use' in Windows en 'koppelingsopties' in Linux. | tekenreeks |
| relativeMountPath | Alle bestandssystemen worden gekoppeld ten opzichte van de map Batch-koppels, toegankelijk via de omgevingsvariabele AZ_BATCH_NODE_MOUNTS_DIR. | tekenreeks (vereist) |
| source | De URI van het bestandssysteem dat moet worden gekoppeld. | tekenreeks (vereist) |
NetworkConfiguration
| Naam | Description | Waarde |
|---|---|---|
| endpointConfiguration | Configuratie van pooleindpunten wordt alleen ondersteund in 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 voor het aantal knooppunten in de groep. Als het subnet onvoldoende vrije IP-adressen heeft, wijst de groep gedeeltelijk rekenknooppunten toe en treedt er een fout bij het wijzigen van het formaat op. De service-principal MicrosoftAzureBatch moet de rol Inzender voor klassieke virtuele machines Role-Based Access Control (RBAC) hebben 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's) 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 aan het opgegeven VNet NSG’s (netwerkbeveiligingsgroepen) zijn gekoppeld, moeten een paar gereserveerde poorten worden ingeschakeld voor binnenkomende communicatie. Voor pools die zijn gemaakt met een virtuele-machineconfiguratie schakelt u poort 29876 en 29877 in, evenals poort 22 voor Linux en poort 3389 voor Windows. Voor pools die zijn gemaakt met een cloudserviceconfiguratie schakelt u poort 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 | tekenreeks |
PoolEndpointConfiguration
| Naam | Description | 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 | Description | 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 gereserveerde waarden worden opgegeven, mislukt de aanvraag met HTTP-statuscode 400. | int (vereist) |
| frontendPortRangeEnd | Acceptabele waarden liggen tussen 1 en 65534, met uitzondering van poorten van 50000 tot 55000 die zijn gereserveerd door de Batch-service. Alle bereiken in een pool moeten verschillend zijn en mogen elkaar niet overlappen. Als 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 in een pool moeten verschillend zijn en mogen elkaar niet overlappen. Als 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 en 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 | Description | Waarde |
|---|---|---|
| toegang | De actie die moet worden uitgevoerd voor een opgegeven IP-adres, subnetbereik of tag. | "Toestaan" Weigeren (vereist) |
| priority | 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 gereserveerde of dubbele waarden worden opgegeven, mislukt de aanvraag met HTTP-statuscode 400. | int (vereist) |
| sourceAddressPrefix | Geldige waarden zijn één IP-adres (dat wil zeggen 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 poortmatrices of poortbereiken (dat wil zeggen 100-200). De poorten moeten tussen 0 en 65535 liggen en de poortbereiken of poorten mogen elkaar niet overlappen. Als er andere waarden worden opgegeven, mislukt de aanvraag met HTTP-statuscode 400. De standaardwaarde is *. | tekenreeks[] |
PublicIPAddressConfiguration
| Naam | Description | Waarde |
|---|---|---|
| ipAddressIds | Het aantal IP-adressen dat hier is opgegeven, beperkt de maximale grootte van de pool: er kunnen 100 toegewezen knooppunten of 100 knooppunten met lage prioriteit worden toegewezen voor elk openbaar IP-adres. Voor een pool die bijvoorbeeld 250 toegewezen VM's nodig heeft, moeten ten minste 3 openbare IP-adressen zijn opgegeven. 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 | Description | Waarde |
|---|---|---|
| automatisch schalen | Deze eigenschap en fixedScale sluiten elkaar uit en een van de eigenschappen moet worden opgegeven. | AutoScaleSettings |
| fixedScale | Deze eigenschap en automatische schaalaanpassing sluiten elkaar uit en een van de eigenschappen moet worden opgegeven. | FixedScaleSettings |
AutoScaleSettings
| Naam | Description | Waarde |
|---|---|---|
| evaluationInterval | Als u dit weglaat, is de standaardwaarde 15 minuten (PT15M). | tekenreeks |
| Formule | Een formule voor het gewenste aantal rekenknooppunten in de pool. | tekenreeks (vereist) |
FixedScaleSettings
| Naam | Description | Waarde |
|---|---|---|
| nodeDeallocationOption | Als u dit weglaat, is de standaardwaarde Opnieuw in wachtrij plaatsen. | "Opnieuw in de wachtrij plaatsen" "RetainedData" "TaskCompletion" "Beëindigen" |
| resizeTimeout | De standaardwaarde is 15 minuten. Time-outwaarden gebruiken de ISO 8601-indeling. Gebruik bijvoorbeeld PT10M gedurende 10 minuten. De minimumwaarde is 5 minuten. Als u een waarde van minder dan 5 minuten opgeeft, weigert de Batch-service de aanvraag met een fout; Als u de REST API rechtstreeks aanroept, is de HTTP-statuscode 400 (Ongeldige aanvraag). | tekenreeks |
| targetDedicatedNodes | Ten minste één van de targetDedicatedNodes, targetLowPriorityNodes moet worden ingesteld. | int |
| targetLowPriorityNodes | Ten minste één van de targetDedicatedNodes, targetLowPriorityNodes moet worden ingesteld. | int |
StartTask
| Naam | Description | Waarde |
|---|---|---|
| Commandline | De opdrachtregel wordt niet uitgevoerd onder een shell en kan daarom niet profiteren van shellfuncties zoals omgevingsvariabele-uitbreiding. Als u van dergelijke functies wilt profiteren, moet u de shell in de opdrachtregel aanroepen, bijvoorbeeld met behulp van 'cmd /c Mijnopdracht' in Windows of '/bin/sh -c MyCommand' in Linux. Vereist als er andere eigenschappen van de startTask zijn opgegeven. | tekenreeks |
| 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 taakomgevingsvariabelen toegewezen aan de container en wordt de taakopdrachtregel uitgevoerd in de container. | TaskContainerSettings |
| environmentSettings | Een lijst met omgevingsvariabele-instellingen voor de starttaak. | EnvironmentSetting[] |
| maxTaskRetryCount | De Batch-service probeert een taak opnieuw uit te voeren als de afsluitcode een andere is dan nul. Houd er rekening mee dat deze waarde specifiek het aantal nieuwe pogingen bepaalt. De Batch-service probeert de taak eenmaal uit te voeren en kan het vervolgens opnieuw proberen tot deze limiet. Als het maximumaantal nieuwe pogingen bijvoorbeeld 3 is, probeert Batch de taak maximaal 4 keer (één eerste poging en 3 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, voert de Batch-service de taak opnieuw uit zonder limiet. | int |
| resourceFiles | Een lijst met bestanden die de Batch-service naar het rekenknooppunt downloadt voordat de opdrachtregel wordt uitgevoerd. | ResourceFile[] |
| userIdentity | Als u dit weglaat, wordt de taak uitgevoerd als een gebruiker zonder beheerdersrechten die uniek is voor de taak. | UserIdentity |
| waitForSuccess | Als waar is en de starttaak mislukt op een rekenknooppunt, probeert de Batch-service de opstarttaak opnieuw tot het maximale aantal 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 op gepland. Deze voorwaarde kan worden gedetecteerd via de status van het knooppunt en de details van de planningsfout. Indien onwaar, wacht de Batch-service niet tot de starttaak is voltooid. In dit geval kunnen andere taken worden uitgevoerd op het rekenknooppunt terwijl de begintaak nog wordt uitgevoerd; en zelfs als de begintaak mislukt, worden er nog steeds nieuwe taken gepland op het knooppunt. De standaardwaarde is true. | booleaans |
TaskContainerSettings
| Naam | Description | Waarde |
|---|---|---|
| containerRunOptions | Deze extra opties worden geleverd als argumenten voor de opdracht 'docker maken', naast de opties die worden beheerd door de Batch-service. | tekenreeks |
| Afbeeldingnaam | Dit is de volledige verwijzing naar de installatiekopie, zoals wordt opgegeven als '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) |
| registry | Deze instelling kan worden weggelaten als deze al is opgegeven bij het maken van de pool. | ContainerRegistry |
| workingDirectory | Een vlag om aan te geven waar de werkmap van de containertaak zich bevindt. De standaardwaarde is 'taskWorkingDirectory'. | "ContainerImageDefault" "TaskWorkingDirectory" |
Omgevingssetting
| Naam | Description | Waarde |
|---|---|---|
| naam | De naam van de omgevingsvariabele. | tekenreeks (vereist) |
| waarde | De waarde van de omgevingsvariabele. | tekenreeks |
ResourceFile
| Naam | Description | Waarde |
|---|---|---|
| autoStorageContainerName | De eigenschappen autoStorageContainerName, storageContainerUrl en httpUrl sluiten elkaar uit en een van deze eigenschappen moet worden opgegeven. | tekenreeks |
| 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. | tekenreeks |
| fileMode | Deze eigenschap is alleen van toepassing op bestanden die worden gedownload naar Linux-rekenknooppunten. Deze wordt genegeerd als het is opgegeven voor een resourceFile dat wordt gedownload naar een Windows-knooppunt. Als deze eigenschap niet is opgegeven voor een Linux-knooppunt, wordt de standaardwaarde 0770 toegepast op het bestand. | tekenreeks |
| Filepath | Als de eigenschap httpUrl is opgegeven, is filePath vereist en wordt het pad beschreven waarnaar het bestand wordt gedownload, inclusief de bestandsnaam. Als de eigenschap autoStorageContainerName of storageContainerUrl is opgegeven, is filePath optioneel en de map waar de bestanden naar moeten worden gedownload. In het geval dat filePath wordt gebruikt als een 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 doorbroken uit de werkmap van de taak (bijvoorbeeld door '..') te gebruiken. | tekenreeks |
| httpUrl | De eigenschappen autoStorageContainerName, storageContainerUrl en httpUrl sluiten elkaar uit en een van deze eigenschappen moet worden opgegeven. Als de URL Azure Blob Storage is, moet deze leesbaar zijn via anonieme toegang. Dat wil gezegd dat de Batch-service geen referenties presenteert bij het downloaden van de blob. Er zijn twee manieren om een dergelijke URL voor een blob in Azure Storage op te halen: voeg een Shared Access Signature (SAS) toe die leesmachtigingen voor de blob verleent of stel de ACL voor de blob of de container in om openbare toegang toe te staan. | tekenreeks |
| storageContainerUrl | De eigenschappen autoStorageContainerName, storageContainerUrl en httpUrl sluiten elkaar uit en een van deze eigenschappen moet worden opgegeven. Deze URL moet leesbaar en listable zijn met behulp van anonieme toegang; dat wil gezegd dat de Batch-service geen referenties presenteert bij het downloaden van de blob. Er zijn twee manieren om een dergelijke URL voor een blob in Azure Storage op te halen: voeg een Shared Access Signature (SAS) toe die lees- en lijstmachtigingen voor de blob verleent, of stel de ACL voor de blob of de bijbehorende container in om openbare toegang toe te staan. | tekenreeks |
UserIdentity
| Naam | Description | Waarde |
|---|---|---|
| autoUser | De eigenschappen userName en autoUser sluiten elkaar uit. u moet één, maar niet beide opgeven. | AutoUserSpecification |
| userName | De eigenschappen userName en autoUser sluiten elkaar uit. u moet één, maar niet beide opgeven. | tekenreeks |
AutoUserSpecification
| Naam | Description | Waarde |
|---|---|---|
| elevationLevel | De standaardwaarde is nonAdmin. | "Beheer" "Niet-beheerder" |
| scope | De standaardwaarde is Pool. Als op de groep Windows wordt uitgevoerd, moet een waarde van Taak worden opgegeven als striktere isolatie tussen taken vereist is. Bijvoorbeeld als de taak het register muteert op een manier die van invloed kan zijn op andere taken, of als er certificaten zijn opgegeven in de groep die niet toegankelijk moet zijn voor normale taken, maar toegankelijk moet zijn voor starttaken. | "Zwembad" "Taak" |
TaskSchedulingPolicy
| Naam | Description | Waarde |
|---|---|---|
| nodeFillType | Hoe taken moeten worden verdeeld over rekenknooppunten. | "Inpakken" "Spread" (vereist) |
UserAccount
| Naam | Description | Waarde |
|---|---|---|
| elevationLevel | nonAdmin: de automatische gebruiker is een standaardgebruiker zonder verhoogde toegang. admin: de automatische gebruiker is een gebruiker met verhoogde toegang en werkt met volledige beheerdersmachtigingen. De standaardwaarde is nonAdmin. | "Beheer" "Niet-beheerder" |
| linuxUserConfiguration | Deze eigenschap wordt genegeerd als deze is opgegeven in een Windows-groep. 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-groep bevindt. Als dit niet is opgegeven en in een Windows-pool, wordt de gebruiker gemaakt met de standaardopties. | WindowsUserConfiguration |
LinuxUserConfiguration
| Naam | Description | Waarde |
|---|---|---|
| Gid | De eigenschappen uid en gid moeten samen worden opgegeven of helemaal niet. Als dit niet is opgegeven, kiest het onderliggende besturingssysteem de gid. | int |
| sshPrivateKey | De persoonlijke sleutel mag niet met een wachtwoord zijn beveiligd. De persoonlijke sleutel wordt gebruikt voor het automatisch configureren van verificatie op basis van asymmetrische sleutels 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 .ssh-map van de gebruiker te plaatsen. Als dit niet is opgegeven, wordt SSH zonder wachtwoord niet geconfigureerd tussen knooppunten (er wordt geen wijziging van de .ssh-map van de gebruiker uitgevoerd). | tekenreeks |
| uid | De eigenschappen uid en gid moeten samen worden opgegeven of helemaal niet. Als dit niet is opgegeven, kiest het onderliggende besturingssysteem de uid. | int |
WindowsUserConfiguration
| Naam | Description | Waarde |
|---|---|---|
| loginMode | Hiermee geeft u de aanmeldingsmodus voor de gebruiker op. De standaardwaarde voor VirtualMachineConfiguration-pools is de interactieve modus en voor CloudServiceConfiguration-pools is de batchmodus. | "Batch" "Interactief" |