Dela via


Microsoft.Batch batchAccounts/pools 2020-09-01

Bicep-resursdefinition

Resurstypen batchAccounts/pooler kan distribueras med åtgärder som mål:

En lista över ändrade egenskaper i varje API-version finns i ändringsloggen.

Resursformat

Om du vill skapa en Microsoft.Batch/batchAccounts/poolresurs lägger du till följande Bicep i mallen.

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

Egenskapsvärden

batchAccounts/pooler

Namn Beskrivning Värde
Namn Resursnamnet

Se hur du anger namn och typer för underordnade resurser i Bicep.
sträng (krävs)

Teckengräns: 1–64

Giltiga tecken:
Alfanumeriska tecken, understreck och bindestreck.
förälder I Bicep kan du ange den överordnade resursen för en underordnad resurs. Du behöver bara lägga till den här egenskapen när den underordnade resursen deklareras utanför den överordnade resursen.

Mer information finns i Underordnad resurs utanför den överordnade resursen.
Symboliskt namn för resurs av typen: batchAccounts
Egenskaper Egenskaperna som är associerade med poolen. PoolEgenskaper

PoolEgenskaper

Namn Beskrivning Värde
applicationLicenses Listan över programlicenser måste vara en delmängd av tillgängliga Batch-tjänstprogramlicenser. Om en licens begärs som inte stöds misslyckas skapandet av poolen. string[]
applicationPackages Ändringar i programpaketreferenser påverkar alla nya beräkningsnoder som ansluter till poolen, men påverkar inte beräkningsnoder som redan finns i poolen förrän de startas om eller omskapas. Det finns högst 10 programpaketreferenser i en viss pool. ApplicationPackageReference[]
certifikaten För Windows-beräkningsnoder installerar Batch-tjänsten certifikaten till det angivna certifikatarkivet och platsen. För Linux-beräkningsnoder lagras certifikaten i en katalog i aktivitetsarbetskatalogen och en miljövariabel AZ_BATCH_CERTIFICATES_DIR skickas till uppgiften för att fråga efter den här platsen. För certifikat med synlighet för "remoteUser" skapas en certs-katalog i användarens hemkatalog (t.ex. /home/{user-name}/certs) och certifikat placeras i den katalogen. CertificateReference[]
deploymentConfiguration Med CloudServiceConfiguration anges att noderna ska skapas med Hjälp av Azure Cloud Services (PaaS), medan VirtualMachineConfiguration använder Azure Virtual Machines (IaaS). DeploymentConfiguration
displayName Visningsnamnet behöver inte vara unikt och kan innehålla unicode-tecken upp till en maximal längd på 1024. sträng
interNodeCommunication Detta medför begränsningar för vilka noder som kan tilldelas till poolen. Om du aktiverar det här värdet kan du minska risken för att det begärda antalet noder allokeras i poolen. Om det inte anges är det här värdet som standard inaktiverat. "Inaktiverad"
"Aktiverad"
metadata Batch-tjänsten tilldelar ingen betydelse för metadata. det är endast för användning av användarkod. MetadataItem[]
mountConfiguration Detta stöder Azure Files, NFS, CIFS/SMB och Blobfuse. MountConfiguration[]
networkConfiguration Nätverkskonfigurationen för en pool. NetworkConfiguration
scaleSettings Definierar poolens önskade storlek. Detta kan antingen vara "fixedScale" där det begärda targetDedicatedNodes har angetts, eller "autoskala" som definierar en formel som regelbundet omvärderas. Om den här egenskapen inte anges har poolen en fast skalning med 0 targetDedicatedNodes. ScaleSettings
startTask I en PATCH-åtgärd (uppdatering) kan den här egenskapen anges till ett tomt objekt för att ta bort startaktiviteten från poolen. StartTask
taskSchedulingPolicy Om det inte anges är standardvärdet utspritt. TaskSchedulingPolicy
taskSlotsPerNode Standardvärdet är 1. Det maximala värdet är mindre än 4 gånger antalet kärnor i vmSize för poolen eller 256. Int
userAccounts Listan över användarkonton som ska skapas på varje nod i poolen. UserAccount[]
vmSize Information om tillgängliga storlekar på virtuella datorer för Cloud Services-pooler (pooler som skapats med cloudServiceConfiguration) finns i Storlekar för Cloud Services (https://azure.microsoft.com/documentation/articles/cloud-services-sizes-specs/). Batch stöder alla vm-storlekar för Cloud Services utom ExtraSmall. Information om tillgängliga VM-storlekar för pooler med avbildningar från Virtual Machines Marketplace (pooler som skapats med virtualMachineConfiguration) finns i Storlekar för virtuella datorer (Linux) (/azure/virtual-machines/sizes-general) eller Sizes for Virtual Machines (Windows) (https://azure.microsoft.com/documentation/articles/virtual-machines-windows-sizes/). Batch har stöd för alla storlekar på virtuella Azure-datorer förutom STANDARD_A0 och de med premiumlagring (STANDARD_GS, STANDARD_DS och STANDARD_DSV2-serien). sträng

ApplicationPackageReference

Namn Beskrivning Värde
Id ID:t för programpaketet som ska installeras. Detta måste finnas i samma batchkonto som poolen. Detta kan antingen vara en referens till en viss version eller standardversionen om det finns en sådan. sträng (krävs)
version Om detta utelämnas och ingen standardversion har angetts för det här programmet misslyckas begäran med felkoden InvalidApplicationPackageReferences. Om du anropar REST-API:et direkt är HTTP-statuskoden 409. sträng

CertificateReference

Namn Beskrivning Värde
Id Det fullständigt kvalificerade ID för certifikatet som ska installeras i poolen. Detta måste finnas i samma batchkonto som poolen. sträng (krävs)
storeLocation Standardvärdet är currentUser. Den här egenskapen gäller endast för pooler som konfigurerats med Windows-noder (dvs. skapas med cloudServiceConfiguration eller med virtualMachineConfiguration med hjälp av en Windows-avbildningsreferens). För Linux-beräkningsnoder lagras certifikaten i en katalog i aktivitetsarbetskatalogen och en miljövariabel AZ_BATCH_CERTIFICATES_DIR skickas till uppgiften för att fråga efter den här platsen. För certifikat med synlighet för "remoteUser" skapas en certs-katalog i användarens hemkatalog (t.ex. /home/{user-name}/certs) och certifikat placeras i den katalogen. "CurrentUser"
"LocalMachine"
storeName Den här egenskapen gäller endast för pooler som konfigurerats med Windows-noder (dvs. skapas med cloudServiceConfiguration eller med virtualMachineConfiguration med hjälp av en Windows-avbildningsreferens). Vanliga butiksnamn är: My, Root, CA, Trust, Disallowed, TrustedPeople, TrustedPublisher, AuthRoot, AddressBook, men alla anpassade butiksnamn kan också användas. Standardvärdet är Min. sträng
synlighet Vilka användarkonton på beräkningsnoden ska ha åtkomst till certifikatets privata data. Strängmatris som innehåller något av:
"RemoteUser"
"StartTask"
"Uppgift"

DeploymentConfiguration

Namn Beskrivning Värde
cloudServiceConfiguration Den här egenskapen och virtualMachineConfiguration är ömsesidigt uteslutande och en av egenskaperna måste anges. Det går inte att ange den här egenskapen om Batch-kontot skapades med dess poolAllocationMode-egenskap inställd på "UserSubscription". CloudServiceConfiguration
virtualMachineConfiguration Den här egenskapen och cloudServiceConfiguration är ömsesidigt uteslutande och en av egenskaperna måste anges. VirtualMachineConfiguration

CloudServiceConfiguration

Namn Beskrivning Värde
osFamily Möjliga värden är: 2 – OS Family 2, motsvarande Windows Server 2008 R2 SP1. 3 – OS Family 3, motsvarande Windows Server 2012. 4 – OS Family 4, motsvarande Windows Server 2012 R2. 5 – OS Family 5, motsvarande Windows Server 2016. 6 – OS Family 6, motsvarande Windows Server 2019. Mer information finns i Azure Guest OS Releases (https://azure.microsoft.com/documentation/articles/cloud-services-guestos-update-matrix/#releases). sträng (krävs)
osVersion Standardvärdet är * som anger den senaste operativsystemversionen för den angivna operativsystemfamiljen. sträng

VirtualMachineConfiguration

Namn Beskrivning Värde
containerConfiguration Om det anges utförs konfigurationen på varje nod i poolen så att aktiviteter kan köras i containrar. Alla vanliga uppgifter och jobbhanteraraktiviteter som körs i den här poolen måste ange egenskapen containerSettings och alla andra uppgifter kan ange den. ContainerConfiguration
dataDiskar Den här egenskapen måste anges om beräkningsnoderna i poolen måste ha tomma datadiskar kopplade till sig. DataDisk[]
diskEncryptionConfiguration Om det anges utförs kryptering på varje nod i poolen under nodetablering. DiskEncryptionConfiguration
imageReference En referens till en Azure Virtual Machines Marketplace-avbildning eller Azure Image-resursen för en anpassad virtuell dator. Information om hur du hämtar listan över alla imageReferences som verifierats av Azure Batch finns i åtgärden "List supported node agent SKU:er". ImageReference (krävs)
licenseType Detta gäller endast för avbildningar som innehåller Windows-operativsystemet och bör endast användas när du har giltiga lokala licenser för noderna som ska distribueras. Om det utelämnas tillämpas ingen lokal licensrabatt. Värden är:

Windows_Server – Den lokala licensen gäller för Windows Server.
Windows_Client – Den lokala licensen gäller för Windows-klienten.
sträng
nodeAgentSkuId Batch-nodagenten är ett program som körs på varje nod i poolen och tillhandahåller kommando- och kontrollgränssnittet mellan noden och Batch-tjänsten. Det finns olika implementeringar av nodagenten, så kallade SKU:er, för olika operativsystem. Du måste ange en nodagent-SKU som matchar den valda bildreferensen. Information om hur du hämtar listan över nodagent-SKU:er som stöds tillsammans med deras lista över verifierade bildreferenser finns i åtgärden "List supported node agent SKU:er". sträng (krävs)
windowsConfiguration Den här egenskapen får inte anges om imageReference anger en Linux OS-avbildning. WindowsConfiguration

ContainerConfiguration

Namn Beskrivning Värde
containerImageNames Det här är den fullständiga avbildningsreferensen, som skulle anges till "docker pull". En avbildning kommer att hämtas från Docker-standardregistret om inte avbildningen är fullständigt kvalificerad med ett alternativt register. string[]
containerRegister Om några avbildningar måste laddas ned från ett privat register som kräver autentiseringsuppgifter måste dessa autentiseringsuppgifter anges här. ContainerRegistry[]
typ Den containerteknik som ska användas. "DockerCompatible" (krävs)

ContainerRegistry

Namn Beskrivning Värde
lösenord Lösenordet för att logga in på registerservern. sträng (krävs)
registryServer Om det utelämnas är standardvärdet "docker.io". sträng
användarnamn Användarnamnet för att logga in på registerservern. sträng (krävs)

DataDisk

Namn Beskrivning Värde
Cachelagring Värden är:

none – Cachelagringsläget för disken är inte aktiverat.
readOnly – Cachelagringsläget för disken är skrivskyddat.
readWrite – Cachelagringsläget för disken är läs- och skrivläge.

Standardvärdet för cachelagring är inget. Information om cachelagringsalternativen finns i: https://blogs.msdn.microsoft.com/windowsazurestorage/2012/06/27/exploring-windows-azure-drives-disks-and-images/.
"Ingen"
"ReadOnly"
"Skriv upp"
diskSizeGB Den ursprungliga diskstorleken i GB när du skapar en ny datadisk. int (krävs)
Lun Lun används för att unikt identifiera varje datadisk. Om du ansluter flera diskar bör var och en ha ett distinkt lun. Värdet måste vara mellan 0 och 63, inklusive. int (krävs)
storageAccountType Om det utelämnas är standardvärdet "Standard_LRS". Värden är:

Standard_LRS – Datadisken bör använda lokalt redundant standardlagring.
Premium_LRS – Datadisken bör använda premium lokalt redundant lagring.
"Premium_LRS"
"Standard_LRS"

DiskEncryptionConfiguration

Namn Beskrivning Värde
Mål I Linux-poolen stöds endast "TemporaryDisk". i Windows-poolen måste "OsDisk" och "TemporaryDisk" anges. Strängmatris som innehåller något av:
"OsDisk"
"TemporaryDisk"

ImageReference

Namn Beskrivning Värde
Id Den här egenskapen är ömsesidigt uteslutande med andra egenskaper. Avbildningen för delat bildgalleri måste ha repliker i samma region som Azure Batch-kontot. Information om brandväggsinställningarna för Batch-nodagenten för kommunikation med Batch-tjänsten finns i /azure/batch/batch-api-basics#virtual-network-vnet-and-firewall-configuration. sträng
erbjudande Till exempel UbuntuServer eller WindowsServer. sträng
förläggare Till exempel Canonical eller MicrosoftWindowsServer. sträng
Sku Till exempel 18.04-LTS eller 2019-Datacenter. sträng
version Du kan ange värdet "senaste" för att välja den senaste versionen av en bild. Om det utelämnas är standardvärdet "senaste". sträng

WindowsConfiguration

Namn Beskrivning Värde
enableAutomaticUpdates Om det utelämnas är standardvärdet sant. Bool

MetadataItem

Namn Beskrivning Värde
Namn Namnet på metadataobjektet. sträng (krävs)
värde Värdet för metadataobjektet. sträng (krävs)

MountConfiguration

Namn Beskrivning Värde
azureBlobFileSystemConfiguration Den här egenskapen är ömsesidigt uteslutande med alla andra egenskaper. AzureBlobFileSystemConfiguration
azureFileShareConfiguration Den här egenskapen är ömsesidigt uteslutande med alla andra egenskaper. AzureFileShareConfiguration
cifsMountConfiguration Den här egenskapen är ömsesidigt uteslutande med alla andra egenskaper. CifsMountConfiguration
nfsMountConfiguration Den här egenskapen är ömsesidigt uteslutande med alla andra egenskaper. NFSMountConfiguration

AzureBlobFileSystemConfiguration

Namn Beskrivning Värde
accountKey Den här egenskapen är ömsesidigt uteslutande med sasKey och en måste anges. sträng
accountName Namnet på Azure Storage-kontot. sträng (krävs)
blobfuseOptions Det här är alternativ för "net use" i Windows och "monteringsalternativ" i Linux. sträng
containerName Namnet på Azure Blob Storage-containern. sträng (krävs)
relativeMountPath Alla filsystem monteras i förhållande till katalogen Batch-monteringar, som är tillgängliga via AZ_BATCH_NODE_MOUNTS_DIR miljövariabeln. sträng (krävs)
sasKey Den här egenskapen är ömsesidigt uteslutande med accountKey och en måste anges. sträng

AzureFileShareConfiguration

Namn Beskrivning Värde
accountKey Azure Storage-kontonyckeln. sträng (krävs)
accountName Namnet på Azure Storage-kontot. sträng (krävs)
azureFileUrl Det här är formuläret "https://{account}.file.core.windows.net/". sträng (krävs)
mountOptions Det här är alternativ för "net use" i Windows och "monteringsalternativ" i Linux. sträng
relativeMountPath Alla filsystem monteras i förhållande till katalogen Batch-monteringar, som är tillgängliga via AZ_BATCH_NODE_MOUNTS_DIR miljövariabeln. sträng (krävs)

CifsMountConfiguration

Namn Beskrivning Värde
mountOptions Det här är alternativ för "net use" i Windows och "monteringsalternativ" i Linux. sträng
lösenord Lösenordet som ska användas för autentisering mot CIFS-filsystemet. sträng (krävs)
relativeMountPath Alla filsystem monteras i förhållande till katalogen Batch-monteringar, som är tillgängliga via AZ_BATCH_NODE_MOUNTS_DIR miljövariabeln. sträng (krävs)
källa URI:n för filsystemet som ska monteras. sträng (krävs)
användarnamn Användaren som ska användas för autentisering mot CIFS-filsystemet. sträng (krävs)

NFSMountConfiguration

Namn Beskrivning Värde
mountOptions Det här är alternativ för "net use" i Windows och "monteringsalternativ" i Linux. sträng
relativeMountPath Alla filsystem monteras i förhållande till katalogen Batch-monteringar, som är tillgängliga via AZ_BATCH_NODE_MOUNTS_DIR miljövariabeln. sträng (krävs)
källa URI:n för filsystemet som ska monteras. sträng (krävs)

NetworkConfiguration

Namn Beskrivning Värde
endpointConfiguration Poolslutpunktskonfiguration stöds endast i pooler med egenskapen virtualMachineConfiguration. PoolEndpointConfiguration
publicIPAddressConfiguration Den här egenskapen stöds endast i Pooler med egenskapen virtualMachineConfiguration. PublicIPAddressConfiguration
subnetId Det virtuella nätverket måste finnas i samma region och prenumeration som Azure Batch-kontot. Det angivna undernätet bör ha tillräckligt med kostnadsfria IP-adresser för att hantera antalet noder i poolen. Om undernätet inte har tillräckligt med kostnadsfria IP-adresser allokerar poolen delvis beräkningsnoder och ett storleksändringsfel uppstår. Tjänstens huvudnamn för MicrosoftAzureBatch måste ha rollen "Klassisk virtuell datordeltagare" Role-Based åtkomstkontroll (RBAC) för det angivna virtuella nätverket. Det angivna undernätet måste tillåta kommunikation från Azure Batch-tjänsten för att kunna schemalägga uppgifter på beräkningsnoderna. Detta kan verifieras genom att kontrollera om det angivna virtuella nätverket har några associerade nätverkssäkerhetsgrupper (NSG). Om kommunikationen till beräkningsnoderna i det angivna undernätet nekas av en NSG anger Batch-tjänsten tillståndet för beräkningsnoderna till oanvändbar. Om det angivna virtuella nätverket har några associerade nätverkssäkerhetsgrupper (NSG) måste några reserverade systemportar aktiveras för inkommande kommunikation. För pooler som skapats med en konfiguration av virtuella datorer aktiverar du portarna 29876 och 29877 samt port 22 för Linux och port 3389 för Windows. För pooler som skapats med en molntjänstkonfiguration aktiverar du portarna 10100, 20100 och 30100. Aktivera även utgående anslutningar till Azure Storage på port 443. För cloudServiceConfiguration-pooler stöds endast "klassiska" virtuella nätverk. Mer information finns i: /azure/batch/batch-api-basics#virtual-network-vnet-and-firewall-configuration sträng

PoolEndpointConfiguration

Namn Beskrivning Värde
inboundNatPools Det maximala antalet inkommande NAT-pooler per Batch-pool är 5. Om det maximala antalet inkommande NAT-pooler överskrids misslyckas begäran med HTTP-statuskod 400. Detta kan inte anges om IPAddressProvisioningType är NoPublicIPAddresses. InboundNatPool[] (krävs)

InboundNatPool

Namn Beskrivning Värde
backendPort Detta måste vara unikt i en Batch-pool. Godtagbara värden är mellan 1 och 65535 förutom för 22, 3389, 29876 och 29877 eftersom dessa är reserverade. Om några reserverade värden anges misslyckas begäran med HTTP-statuskod 400. int (krävs)
frontendPortRangeEnd Acceptabla värden varierar mellan 1 och 65534 förutom portar från 50000 till 55000 som reserveras av Batch-tjänsten. Alla intervall i en pool måste vara distinkta och får inte överlappa varandra. Om några reserverade eller överlappande värden anges misslyckas begäran med HTTP-statuskod 400. int (krävs)
frontendPortRangeStart Godtagbara värden varierar mellan 1 och 65534 förutom portar från 50000 till 55000 som är reserverade. Alla intervall i en pool måste vara distinkta och får inte överlappa varandra. Om några reserverade eller överlappande värden anges misslyckas begäran med HTTP-statuskod 400. int (krävs)
Namn Namnet måste vara unikt i en Batch-pool, kan innehålla bokstäver, siffror, understreck, punkter och bindestreck. Namn måste börja med en bokstav eller siffra, måste sluta med en bokstav, ett tal eller understreck och får inte överstiga 77 tecken. Om ogiltiga värden anges misslyckas begäran med HTTP-statuskod 400. sträng (krävs)
networkSecurityGroupRules Det maximala antalet regler som kan anges för alla slutpunkter i en Batch-pool är 25. Om inga regler för nätverkssäkerhetsgrupper har angetts skapas en standardregel för att tillåta inkommande åtkomst till den angivna backendPort. Om det maximala antalet regler för nätverkssäkerhetsgrupper överskrids misslyckas begäran med HTTP-statuskod 400. NetworkSecurityGroupRule[]
protokoll Slutpunktens protokoll. "TCP"
"UDP" (krävs)

NetworkSecurityGroupRule

Namn Beskrivning Värde
tillträde Den åtgärd som ska vidtas för en angiven IP-adress, undernätsintervall eller tagg. "Tillåt"
"Neka" (krävs)
prioritering Prioriteringar i en pool måste vara unika och utvärderas i prioritetsordning. Desto lägre är talet, desto högre prioritet. Regler kan till exempel anges med ordernummer 150, 250 och 350. Regeln med ordernumret 150 har företräde framför regeln som har en ordning på 250. Tillåtna prioriteringar är mellan 150 och 4 096. Om några reserverade eller duplicerade värden anges misslyckas begäran med HTTP-statuskod 400. int (krävs)
sourceAddressPrefix Giltiga värden är en enskild IP-adress (dvs. 10.10.10.10), IP-undernät (dvs. 192.168.1.0/24), standardtagg eller * (för alla adresser). Om andra värden anges misslyckas begäran med HTTP-statuskod 400. sträng (krävs)
sourcePortRanges Giltiga värden är *( för alla portar 0–65535) eller matriser med portar eller portintervall (dvs. 100–200). Portarna ska ligga mellan 0 och 65535 och portintervallen eller portarna får inte överlappa varandra. Om andra värden anges misslyckas begäran med HTTP-statuskod 400. Standardvärdet är *. string[]

PublicIPAddressConfiguration

Namn Beskrivning Värde
ipAddressIds Antalet IP-adresser som anges här begränsar den maximala storleken på poolen – 100 dedikerade noder eller 100 noder med låg prioritet kan allokeras för varje offentlig IP-adress. En pool som behöver 250 dedikerade virtuella datorer skulle till exempel behöva minst 3 offentliga IP-adresser angivna. Varje element i den här samlingen är av formuläret : /subscriptions/{subscription}/resourceGroups/{group}/providers/Microsoft.Network/publicIPAddresses/{ip}. string[]
bestämmelse Standardvärdet är BatchManaged "BatchManaged"
"NoPublicIPAddresses"
"UserManaged"

ScaleSettings

Namn Beskrivning Värde
autoskalning Den här egenskapen och fixedScale är ömsesidigt uteslutande och en av egenskaperna måste anges. AutoscaleSettings
fixedScale Den här egenskapen och autoskalan är ömsesidigt uteslutande och en av egenskaperna måste anges. FixedScaleSettings

AutoskalningInställningar

Namn Beskrivning Värde
evaluationInterval Om det utelämnas är standardvärdet 15 minuter (PT15M). sträng
formel En formel för önskat antal beräkningsnoder i poolen. sträng (krävs)

FixedScaleSettings

Namn Beskrivning Värde
nodeDeallocationOption Om det utelämnas är standardvärdet Requeue. "Fråga igen"
"RetainedData"
"TaskCompletion"
"Avsluta"
resizeTimeout Standardvärdet är 15 minuter. Tidsgränsvärden använder ISO 8601-format. Använd till exempel PT10M i 10 minuter. Minimivärdet är 5 minuter. Om du anger ett värde som är mindre än 5 minuter avvisar Batch-tjänsten begäran med ett fel. Om du anropar REST-API:et direkt är HTTP-statuskoden 400 (felaktig begäran). sträng
targetDedicatedNodes Minst en av targetDedicatedNodes, targetLowPriorityNodes måste anges. Int
targetLowPriorityNodes Minst en av targetDedicatedNodes, targetLowPriorityNodes måste anges. Int

StartTask

Namn Beskrivning Värde
commandLine Kommandoraden körs inte under ett gränssnitt och kan därför inte dra nytta av gränssnittsfunktioner som miljövariabelexpansion. Om du vill dra nytta av sådana funktioner bör du anropa gränssnittet på kommandoraden, till exempel med hjälp av "cmd /c MyCommand" i Windows eller "/bin/sh -c MyCommand" i Linux. Krävs om några andra egenskaper för startTask anges. sträng
containerSettings När detta anges mappas alla kataloger rekursivt under AZ_BATCH_NODE_ROOT_DIR (roten för Azure Batch-kataloger på noden) till containern, alla aktivitetsmiljövariabler mappas till containern och aktivitetskommandoraden körs i containern. TaskContainerSettings
environmentSettings En lista över miljövariabelinställningar för startaktiviteten. EnvironmentSetting[]
maxTaskRetryCount Batch-tjänsten försöker utföra en aktivitet igen om dess slutkod inte är noll. Observera att det här värdet specifikt styr antalet återförsök. Batch-tjänsten provar uppgiften en gång och kan sedan försöka upp till den här gränsen igen. Om det maximala antalet återförsök till exempel är 3, försöker Batch aktiviteten upp till 4 gånger (ett första försök och 3 återförsök). Om det maximala antalet återförsök är 0 försöker inte Batch-tjänsten uppgiften igen. Om det maximala antalet återförsök är -1, försöker Batch-tjänsten uppgiften utan begränsning. Int
resourceFiles En lista över filer som Batch-tjänsten laddar ned till beräkningsnoden innan kommandoraden körs. ResourceFile[]
userIdentity Om den utelämnas körs aktiviteten som en icke-administrativ användare som är unik för aktiviteten. UserIdentity
waitForSuccess Om sant och startaktiviteten misslyckas på en beräkningsnod, försöker Batch-tjänsten starta aktiviteten igen upp till maximalt antal återförsök (maxTaskRetryCount). Om aktiviteten fortfarande inte har slutförts efter alla återförsök markerar Batch-tjänsten beräkningsnoden oanvändbar och schemalägger inte aktiviteter till den. Det här villkoret kan identifieras via nodtillståndet och schemaläggningsfelinformationen. Om det är falskt väntar inte Batch-tjänsten på att startaktiviteten ska slutföras. I det här fallet kan andra aktiviteter börja köras på beräkningsnoden medan startaktiviteten fortfarande körs. och även om startaktiviteten misslyckas fortsätter nya aktiviteter att schemaläggas på noden. Standardvärdet är sant. Bool

TaskContainerSettings

Namn Beskrivning Värde
containerRunOptions Dessa ytterligare alternativ anges som argument till kommandot "docker create", utöver de som styrs av Batch-tjänsten. sträng
imageName Det här är den fullständiga avbildningsreferensen, som skulle anges till "docker pull". Om ingen tagg anges som en del av avbildningsnamnet används taggen ":latest" som standard. sträng (krävs)
register Den här inställningen kan utelämnas om den redan angavs när poolen skapades. ContainerRegistry
workingDirectory En flagga som anger var containeruppgiftens arbetskatalog finns. Standardvärdet är "taskWorkingDirectory". "ContainerImageDefault"
"TaskWorkingDirectory"

MiljöerInställningar

Namn Beskrivning Värde
Namn Namnet på miljövariabeln. sträng (krävs)
värde Värdet för miljövariabeln. sträng

ResourceFile

Namn Beskrivning Värde
autoStorageContainerName Egenskaperna autoStorageContainerName, storageContainerUrl och httpUrl är ömsesidigt uteslutande och en av dem måste anges. sträng
blobPrefix Egenskapen är endast giltig när autoStorageContainerName eller storageContainerUrl används. Det här prefixet kan vara ett partiellt filnamn eller en underkatalog. Om inget prefix har angetts laddas alla filer i containern ned. sträng
fileMode Den här egenskapen gäller endast filer som laddas ned till Linux-beräkningsnoder. Den ignoreras om den har angetts för en resourceFile som laddas ned till en Windows-nod. Om den här egenskapen inte har angetts för en Linux-nod tillämpas standardvärdet 0770 på filen. sträng
filePath Om egenskapen httpUrl har angetts krävs filePath och beskriver sökvägen som filen ska laddas ned till, inklusive filnamnet. Om egenskapen autoStorageContainerName eller storageContainerUrl har angetts är filePath valfritt och är den katalog som filerna ska laddas ned till. Om filePath används som en katalog behålls alla katalogstrukturer som redan är associerade med indata i sin helhet och läggs till i den angivna filePath-katalogen. Den angivna relativa sökvägen kan inte bryta sig ut ur aktivitetens arbetskatalog (till exempel med hjälp av ..). sträng
httpUrl Egenskaperna autoStorageContainerName, storageContainerUrl och httpUrl är ömsesidigt uteslutande och en av dem måste anges. Om URL:en är Azure Blob Storage måste den vara läsbar med hjälp av anonym åtkomst. Det innebär att Batch-tjänsten inte visar några autentiseringsuppgifter när bloben laddas ned. Det finns två sätt att hämta en sådan URL för en blob i Azure Storage: inkludera en signatur för delad åtkomst (SAS) som beviljar läsbehörigheter för blobben eller ange ACL för blobben eller dess container för att tillåta offentlig åtkomst. sträng
storageContainerUrl Egenskaperna autoStorageContainerName, storageContainerUrl och httpUrl är ömsesidigt uteslutande och en av dem måste anges. Den här URL:en måste vara läsbar och listbar med hjälp av anonym åtkomst. Det innebär att Batch-tjänsten inte visar några autentiseringsuppgifter när bloben laddas ned. Det finns två sätt att hämta en sådan URL för en blob i Azure Storage: inkludera en signatur för delad åtkomst (SAS) som beviljar läs- och listbehörigheter för bloben eller anger ACL för bloben eller dess container för att tillåta offentlig åtkomst. sträng

UserIdentity

Namn Beskrivning Värde
autoAnvändare Egenskaperna userName och autoUser är ömsesidigt uteslutande. du måste ange en men inte båda. AutoUserSpecification
userName Egenskaperna userName och autoUser är ömsesidigt uteslutande. du måste ange en men inte båda. sträng

AutoUserSpecification

Namn Beskrivning Värde
elevationLevel Standardvärdet är nonAdmin. "Administratör"
"NonAdmin"
omfattning Standardvärdet är Pool. Om poolen kör Windows ska värdet Aktivitet anges om striktare isolering mellan aktiviteter krävs. Om uppgiften till exempel muterar registret på ett sätt som kan påverka andra uppgifter, eller om certifikat har angetts i poolen som inte ska vara tillgängliga för normala uppgifter men bör vara tillgängliga genom startaktiviteter. "Pool"
"Uppgift"

TaskSchedulingPolicy

Namn Beskrivning Värde
nodeFillType Hur aktiviteter ska distribueras mellan beräkningsnoder. "Pack"
"Spridning" (krävs)

UserAccount

Namn Beskrivning Värde
elevationLevel nonAdmin – Den automatiska användaren är en standardanvändare utan förhöjd åtkomst. admin – Den automatiska användaren är en användare med förhöjd åtkomst och fungerar med fullständig administratörsbehörighet. Standardvärdet är nonAdmin. "Administratör"
"NonAdmin"
linuxUserConfiguration Den här egenskapen ignoreras om den anges i en Windows-pool. Om det inte anges skapas användaren med standardalternativen. LinuxUserConfiguration
Namn Namnet på användarkontot. sträng (krävs)
lösenord Lösenordet för användarkontot. sträng (krävs)
windowsUserConfiguration Den här egenskapen kan bara anges om användaren finns i en Windows-pool. Om det inte anges och i en Windows-pool skapas användaren med standardalternativen. WindowsUserConfiguration

LinuxUserConfiguration

Namn Beskrivning Värde
Gid Egenskaperna uid och gid måste anges tillsammans eller inte alls. Om det inte anges väljer det underliggande operativsystemet gid. Int
sshPrivateKey Den privata nyckeln får inte vara lösenordsskyddad. Den privata nyckeln används för att automatiskt konfigurera asymmetrisk nyckelbaserad autentisering för SSH mellan noder i en Linux-pool när poolens enableInterNodeCommunication-egenskap är sann (den ignoreras om enableInterNodeCommunication är falskt). Det gör du genom att placera nyckelparet i användarens .ssh-katalog. Om det inte anges konfigureras inte lösenordsfri SSH mellan noder (ingen ändring av användarens .ssh-katalog görs). sträng
Uid Egenskaperna uid och gid måste anges tillsammans eller inte alls. Om det inte anges väljer det underliggande operativsystemet uid. Int

WindowsUserConfiguration

Namn Beskrivning Värde
loginMode Anger inloggningsläge för användaren. Standardvärdet för VirtualMachineConfiguration-pooler är interaktivt läge och för CloudServiceConfiguration-pooler är batchläge. "Batch"
"Interaktiv"

Snabbstartsmallar

Följande snabbstartsmallar distribuerar den här resurstypen.

Mall Beskrivning
Azure Batch-pool utan offentliga IP-adresser

Distribuera till Azure
Den här mallen skapar azure batch-förenklad nodkommunikationspool utan offentliga IP-adresser.

Resursdefinition för ARM-mall

Resurstypen batchAccounts/pooler kan distribueras med åtgärder som mål:

En lista över ändrade egenskaper i varje API-version finns i ändringsloggen.

Resursformat

Om du vill skapa en Microsoft.Batch/batchAccounts/poolresurs lägger du till följande JSON i mallen.

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

Egenskapsvärden

batchAccounts/pooler

Namn Beskrivning Värde
typ Resurstypen "Microsoft.Batch/batchAccounts/pools"
apiVersion Resurs-API-versionen '2020-09-01'
Namn Resursnamnet

Se hur du anger namn och typer för underordnade resurser i JSON ARM-mallar.
sträng (krävs)

Teckengräns: 1–64

Giltiga tecken:
Alfanumeriska tecken, understreck och bindestreck.
Egenskaper Egenskaperna som är associerade med poolen. PoolEgenskaper

PoolEgenskaper

Namn Beskrivning Värde
applicationLicenses Listan över programlicenser måste vara en delmängd av tillgängliga Batch-tjänstprogramlicenser. Om en licens begärs som inte stöds misslyckas skapandet av poolen. string[]
applicationPackages Ändringar i programpaketreferenser påverkar alla nya beräkningsnoder som ansluter till poolen, men påverkar inte beräkningsnoder som redan finns i poolen förrän de startas om eller omskapas. Det finns högst 10 programpaketreferenser i en viss pool. ApplicationPackageReference[]
certifikaten För Windows-beräkningsnoder installerar Batch-tjänsten certifikaten till det angivna certifikatarkivet och platsen. För Linux-beräkningsnoder lagras certifikaten i en katalog i aktivitetsarbetskatalogen och en miljövariabel AZ_BATCH_CERTIFICATES_DIR skickas till uppgiften för att fråga efter den här platsen. För certifikat med synlighet för "remoteUser" skapas en certs-katalog i användarens hemkatalog (t.ex. /home/{user-name}/certs) och certifikat placeras i den katalogen. CertificateReference[]
deploymentConfiguration Med CloudServiceConfiguration anges att noderna ska skapas med Hjälp av Azure Cloud Services (PaaS), medan VirtualMachineConfiguration använder Azure Virtual Machines (IaaS). DeploymentConfiguration
displayName Visningsnamnet behöver inte vara unikt och kan innehålla unicode-tecken upp till en maximal längd på 1024. sträng
interNodeCommunication Detta medför begränsningar för vilka noder som kan tilldelas till poolen. Om du aktiverar det här värdet kan du minska risken för att det begärda antalet noder allokeras i poolen. Om det inte anges är det här värdet som standard inaktiverat. "Inaktiverad"
"Aktiverad"
metadata Batch-tjänsten tilldelar ingen betydelse för metadata. det är endast för användning av användarkod. MetadataItem[]
mountConfiguration Detta stöder Azure Files, NFS, CIFS/SMB och Blobfuse. MountConfiguration[]
networkConfiguration Nätverkskonfigurationen för en pool. NetworkConfiguration
scaleSettings Definierar poolens önskade storlek. Detta kan antingen vara "fixedScale" där det begärda targetDedicatedNodes har angetts, eller "autoskala" som definierar en formel som regelbundet omvärderas. Om den här egenskapen inte anges har poolen en fast skalning med 0 targetDedicatedNodes. ScaleSettings
startTask I en PATCH-åtgärd (uppdatering) kan den här egenskapen anges till ett tomt objekt för att ta bort startaktiviteten från poolen. StartTask
taskSchedulingPolicy Om det inte anges är standardvärdet utspritt. TaskSchedulingPolicy
taskSlotsPerNode Standardvärdet är 1. Det maximala värdet är mindre än 4 gånger antalet kärnor i vmSize för poolen eller 256. Int
userAccounts Listan över användarkonton som ska skapas på varje nod i poolen. UserAccount[]
vmSize Information om tillgängliga storlekar på virtuella datorer för Cloud Services-pooler (pooler som skapats med cloudServiceConfiguration) finns i Storlekar för Cloud Services (https://azure.microsoft.com/documentation/articles/cloud-services-sizes-specs/). Batch stöder alla vm-storlekar för Cloud Services utom ExtraSmall. Information om tillgängliga VM-storlekar för pooler med avbildningar från Virtual Machines Marketplace (pooler som skapats med virtualMachineConfiguration) finns i Storlekar för virtuella datorer (Linux) (/azure/virtual-machines/sizes-general) eller Sizes for Virtual Machines (Windows) (https://azure.microsoft.com/documentation/articles/virtual-machines-windows-sizes/). Batch har stöd för alla storlekar på virtuella Azure-datorer förutom STANDARD_A0 och de med premiumlagring (STANDARD_GS, STANDARD_DS och STANDARD_DSV2-serien). sträng

ApplicationPackageReference

Namn Beskrivning Värde
Id ID:t för programpaketet som ska installeras. Detta måste finnas i samma batchkonto som poolen. Detta kan antingen vara en referens till en viss version eller standardversionen om det finns en sådan. sträng (krävs)
version Om detta utelämnas och ingen standardversion har angetts för det här programmet misslyckas begäran med felkoden InvalidApplicationPackageReferences. Om du anropar REST-API:et direkt är HTTP-statuskoden 409. sträng

CertificateReference

Namn Beskrivning Värde
Id Det fullständigt kvalificerade ID för certifikatet som ska installeras i poolen. Detta måste finnas i samma batchkonto som poolen. sträng (krävs)
storeLocation Standardvärdet är currentUser. Den här egenskapen gäller endast för pooler som konfigurerats med Windows-noder (dvs. skapas med cloudServiceConfiguration eller med virtualMachineConfiguration med hjälp av en Windows-avbildningsreferens). För Linux-beräkningsnoder lagras certifikaten i en katalog i aktivitetsarbetskatalogen och en miljövariabel AZ_BATCH_CERTIFICATES_DIR skickas till uppgiften för att fråga efter den här platsen. För certifikat med synlighet för "remoteUser" skapas en certs-katalog i användarens hemkatalog (t.ex. /home/{user-name}/certs) och certifikat placeras i den katalogen. "CurrentUser"
"LocalMachine"
storeName Den här egenskapen gäller endast för pooler som konfigurerats med Windows-noder (dvs. skapas med cloudServiceConfiguration eller med virtualMachineConfiguration med hjälp av en Windows-avbildningsreferens). Vanliga butiksnamn är: My, Root, CA, Trust, Disallowed, TrustedPeople, TrustedPublisher, AuthRoot, AddressBook, men alla anpassade butiksnamn kan också användas. Standardvärdet är Min. sträng
synlighet Vilka användarkonton på beräkningsnoden ska ha åtkomst till certifikatets privata data. Strängmatris som innehåller något av:
"RemoteUser"
"StartTask"
"Uppgift"

DeploymentConfiguration

Namn Beskrivning Värde
cloudServiceConfiguration Den här egenskapen och virtualMachineConfiguration är ömsesidigt uteslutande och en av egenskaperna måste anges. Det går inte att ange den här egenskapen om Batch-kontot skapades med dess poolAllocationMode-egenskap inställd på "UserSubscription". CloudServiceConfiguration
virtualMachineConfiguration Den här egenskapen och cloudServiceConfiguration är ömsesidigt uteslutande och en av egenskaperna måste anges. VirtualMachineConfiguration

CloudServiceConfiguration

Namn Beskrivning Värde
osFamily Möjliga värden är: 2 – OS Family 2, motsvarande Windows Server 2008 R2 SP1. 3 – OS Family 3, motsvarande Windows Server 2012. 4 – OS Family 4, motsvarande Windows Server 2012 R2. 5 – OS Family 5, motsvarande Windows Server 2016. 6 – OS Family 6, motsvarande Windows Server 2019. Mer information finns i Azure Guest OS Releases (https://azure.microsoft.com/documentation/articles/cloud-services-guestos-update-matrix/#releases). sträng (krävs)
osVersion Standardvärdet är * som anger den senaste operativsystemversionen för den angivna operativsystemfamiljen. sträng

VirtualMachineConfiguration

Namn Beskrivning Värde
containerConfiguration Om det anges utförs konfigurationen på varje nod i poolen så att aktiviteter kan köras i containrar. Alla vanliga uppgifter och jobbhanteraraktiviteter som körs i den här poolen måste ange egenskapen containerSettings och alla andra uppgifter kan ange den. ContainerConfiguration
dataDiskar Den här egenskapen måste anges om beräkningsnoderna i poolen måste ha tomma datadiskar kopplade till sig. DataDisk[]
diskEncryptionConfiguration Om det anges utförs kryptering på varje nod i poolen under nodetablering. DiskEncryptionConfiguration
imageReference En referens till en Azure Virtual Machines Marketplace-avbildning eller Azure Image-resursen för en anpassad virtuell dator. Information om hur du hämtar listan över alla imageReferences som verifierats av Azure Batch finns i åtgärden "List supported node agent SKU:er". ImageReference (krävs)
licenseType Detta gäller endast för avbildningar som innehåller Windows-operativsystemet och bör endast användas när du har giltiga lokala licenser för noderna som ska distribueras. Om det utelämnas tillämpas ingen lokal licensrabatt. Värden är:

Windows_Server – Den lokala licensen gäller för Windows Server.
Windows_Client – Den lokala licensen gäller för Windows-klienten.
sträng
nodeAgentSkuId Batch-nodagenten är ett program som körs på varje nod i poolen och tillhandahåller kommando- och kontrollgränssnittet mellan noden och Batch-tjänsten. Det finns olika implementeringar av nodagenten, så kallade SKU:er, för olika operativsystem. Du måste ange en nodagent-SKU som matchar den valda bildreferensen. Information om hur du hämtar listan över nodagent-SKU:er som stöds tillsammans med deras lista över verifierade bildreferenser finns i åtgärden "List supported node agent SKU:er". sträng (krävs)
windowsConfiguration Den här egenskapen får inte anges om imageReference anger en Linux OS-avbildning. WindowsConfiguration

ContainerConfiguration

Namn Beskrivning Värde
containerImageNames Det här är den fullständiga avbildningsreferensen, som skulle anges till "docker pull". En avbildning kommer att hämtas från Docker-standardregistret om inte avbildningen är fullständigt kvalificerad med ett alternativt register. string[]
containerRegister Om några avbildningar måste laddas ned från ett privat register som kräver autentiseringsuppgifter måste dessa autentiseringsuppgifter anges här. ContainerRegistry[]
typ Den containerteknik som ska användas. "DockerCompatible" (krävs)

ContainerRegistry

Namn Beskrivning Värde
lösenord Lösenordet för att logga in på registerservern. sträng (krävs)
registryServer Om det utelämnas är standardvärdet "docker.io". sträng
användarnamn Användarnamnet för att logga in på registerservern. sträng (krävs)

DataDisk

Namn Beskrivning Värde
Cachelagring Värden är:

none – Cachelagringsläget för disken är inte aktiverat.
readOnly – Cachelagringsläget för disken är skrivskyddat.
readWrite – Cachelagringsläget för disken är läs- och skrivläge.

Standardvärdet för cachelagring är inget. Information om cachelagringsalternativen finns i: https://blogs.msdn.microsoft.com/windowsazurestorage/2012/06/27/exploring-windows-azure-drives-disks-and-images/.
"Ingen"
"ReadOnly"
"Skriv upp"
diskSizeGB Den ursprungliga diskstorleken i GB när du skapar en ny datadisk. int (krävs)
Lun Lun används för att unikt identifiera varje datadisk. Om du ansluter flera diskar bör var och en ha ett distinkt lun. Värdet måste vara mellan 0 och 63, inklusive. int (krävs)
storageAccountType Om det utelämnas är standardvärdet "Standard_LRS". Värden är:

Standard_LRS – Datadisken bör använda lokalt redundant standardlagring.
Premium_LRS – Datadisken bör använda premium lokalt redundant lagring.
"Premium_LRS"
"Standard_LRS"

DiskEncryptionConfiguration

Namn Beskrivning Värde
Mål I Linux-poolen stöds endast "TemporaryDisk". i Windows-poolen måste "OsDisk" och "TemporaryDisk" anges. Strängmatris som innehåller något av:
"OsDisk"
"TemporaryDisk"

ImageReference

Namn Beskrivning Värde
Id Den här egenskapen är ömsesidigt uteslutande med andra egenskaper. Avbildningen för delat bildgalleri måste ha repliker i samma region som Azure Batch-kontot. Information om brandväggsinställningarna för Batch-nodagenten för kommunikation med Batch-tjänsten finns i /azure/batch/batch-api-basics#virtual-network-vnet-and-firewall-configuration. sträng
erbjudande Till exempel UbuntuServer eller WindowsServer. sträng
förläggare Till exempel Canonical eller MicrosoftWindowsServer. sträng
Sku Till exempel 18.04-LTS eller 2019-Datacenter. sträng
version Du kan ange värdet "senaste" för att välja den senaste versionen av en bild. Om det utelämnas är standardvärdet "senaste". sträng

WindowsConfiguration

Namn Beskrivning Värde
enableAutomaticUpdates Om det utelämnas är standardvärdet sant. Bool

MetadataItem

Namn Beskrivning Värde
Namn Namnet på metadataobjektet. sträng (krävs)
värde Värdet för metadataobjektet. sträng (krävs)

MountConfiguration

Namn Beskrivning Värde
azureBlobFileSystemConfiguration Den här egenskapen är ömsesidigt uteslutande med alla andra egenskaper. AzureBlobFileSystemConfiguration
azureFileShareConfiguration Den här egenskapen är ömsesidigt uteslutande med alla andra egenskaper. AzureFileShareConfiguration
cifsMountConfiguration Den här egenskapen är ömsesidigt uteslutande med alla andra egenskaper. CifsMountConfiguration
nfsMountConfiguration Den här egenskapen är ömsesidigt uteslutande med alla andra egenskaper. NFSMountConfiguration

AzureBlobFileSystemConfiguration

Namn Beskrivning Värde
accountKey Den här egenskapen är ömsesidigt uteslutande med sasKey och en måste anges. sträng
accountName Namnet på Azure Storage-kontot. sträng (krävs)
blobfuseOptions Det här är alternativ för "net use" i Windows och "monteringsalternativ" i Linux. sträng
containerName Namnet på Azure Blob Storage-containern. sträng (krävs)
relativeMountPath Alla filsystem monteras i förhållande till katalogen Batch-monteringar, som är tillgängliga via AZ_BATCH_NODE_MOUNTS_DIR miljövariabeln. sträng (krävs)
sasKey Den här egenskapen är ömsesidigt uteslutande med accountKey och en måste anges. sträng

AzureFileShareConfiguration

Namn Beskrivning Värde
accountKey Azure Storage-kontonyckeln. sträng (krävs)
accountName Namnet på Azure Storage-kontot. sträng (krävs)
azureFileUrl Det här är formuläret "https://{account}.file.core.windows.net/". sträng (krävs)
mountOptions Det här är alternativ för "net use" i Windows och "monteringsalternativ" i Linux. sträng
relativeMountPath Alla filsystem monteras i förhållande till katalogen Batch-monteringar, som är tillgängliga via AZ_BATCH_NODE_MOUNTS_DIR miljövariabeln. sträng (krävs)

CifsMountConfiguration

Namn Beskrivning Värde
mountOptions Det här är alternativ för "net use" i Windows och "monteringsalternativ" i Linux. sträng
lösenord Lösenordet som ska användas för autentisering mot CIFS-filsystemet. sträng (krävs)
relativeMountPath Alla filsystem monteras i förhållande till katalogen Batch-monteringar, som är tillgängliga via AZ_BATCH_NODE_MOUNTS_DIR miljövariabeln. sträng (krävs)
källa URI:n för filsystemet som ska monteras. sträng (krävs)
användarnamn Användaren som ska användas för autentisering mot CIFS-filsystemet. sträng (krävs)

NFSMountConfiguration

Namn Beskrivning Värde
mountOptions Det här är alternativ för "net use" i Windows och "monteringsalternativ" i Linux. sträng
relativeMountPath Alla filsystem monteras i förhållande till katalogen Batch-monteringar, som är tillgängliga via AZ_BATCH_NODE_MOUNTS_DIR miljövariabeln. sträng (krävs)
källa URI:n för filsystemet som ska monteras. sträng (krävs)

NetworkConfiguration

Namn Beskrivning Värde
endpointConfiguration Poolslutpunktskonfiguration stöds endast i pooler med egenskapen virtualMachineConfiguration. PoolEndpointConfiguration
publicIPAddressConfiguration Den här egenskapen stöds endast i Pooler med egenskapen virtualMachineConfiguration. PublicIPAddressConfiguration
subnetId Det virtuella nätverket måste finnas i samma region och prenumeration som Azure Batch-kontot. Det angivna undernätet bör ha tillräckligt med kostnadsfria IP-adresser för att hantera antalet noder i poolen. Om undernätet inte har tillräckligt med kostnadsfria IP-adresser allokerar poolen delvis beräkningsnoder och ett storleksändringsfel uppstår. Tjänstens huvudnamn för MicrosoftAzureBatch måste ha rollen "Klassisk virtuell datordeltagare" Role-Based åtkomstkontroll (RBAC) för det angivna virtuella nätverket. Det angivna undernätet måste tillåta kommunikation från Azure Batch-tjänsten för att kunna schemalägga uppgifter på beräkningsnoderna. Detta kan verifieras genom att kontrollera om det angivna virtuella nätverket har några associerade nätverkssäkerhetsgrupper (NSG). Om kommunikationen till beräkningsnoderna i det angivna undernätet nekas av en NSG anger Batch-tjänsten tillståndet för beräkningsnoderna till oanvändbar. Om det angivna virtuella nätverket har några associerade nätverkssäkerhetsgrupper (NSG) måste några reserverade systemportar aktiveras för inkommande kommunikation. För pooler som skapats med en konfiguration av virtuella datorer aktiverar du portarna 29876 och 29877 samt port 22 för Linux och port 3389 för Windows. För pooler som skapats med en molntjänstkonfiguration aktiverar du portarna 10100, 20100 och 30100. Aktivera även utgående anslutningar till Azure Storage på port 443. För cloudServiceConfiguration-pooler stöds endast "klassiska" virtuella nätverk. Mer information finns i: /azure/batch/batch-api-basics#virtual-network-vnet-and-firewall-configuration sträng

PoolEndpointConfiguration

Namn Beskrivning Värde
inboundNatPools Det maximala antalet inkommande NAT-pooler per Batch-pool är 5. Om det maximala antalet inkommande NAT-pooler överskrids misslyckas begäran med HTTP-statuskod 400. Detta kan inte anges om IPAddressProvisioningType är NoPublicIPAddresses. InboundNatPool[] (krävs)

InboundNatPool

Namn Beskrivning Värde
backendPort Detta måste vara unikt i en Batch-pool. Godtagbara värden är mellan 1 och 65535 förutom för 22, 3389, 29876 och 29877 eftersom dessa är reserverade. Om några reserverade värden anges misslyckas begäran med HTTP-statuskod 400. int (krävs)
frontendPortRangeEnd Acceptabla värden varierar mellan 1 och 65534 förutom portar från 50000 till 55000 som reserveras av Batch-tjänsten. Alla intervall i en pool måste vara distinkta och får inte överlappa varandra. Om några reserverade eller överlappande värden anges misslyckas begäran med HTTP-statuskod 400. int (krävs)
frontendPortRangeStart Godtagbara värden varierar mellan 1 och 65534 förutom portar från 50000 till 55000 som är reserverade. Alla intervall i en pool måste vara distinkta och får inte överlappa varandra. Om några reserverade eller överlappande värden anges misslyckas begäran med HTTP-statuskod 400. int (krävs)
Namn Namnet måste vara unikt i en Batch-pool, kan innehålla bokstäver, siffror, understreck, punkter och bindestreck. Namn måste börja med en bokstav eller siffra, måste sluta med en bokstav, ett tal eller understreck och får inte överstiga 77 tecken. Om ogiltiga värden anges misslyckas begäran med HTTP-statuskod 400. sträng (krävs)
networkSecurityGroupRules Det maximala antalet regler som kan anges för alla slutpunkter i en Batch-pool är 25. Om inga regler för nätverkssäkerhetsgrupper har angetts skapas en standardregel för att tillåta inkommande åtkomst till den angivna backendPort. Om det maximala antalet regler för nätverkssäkerhetsgrupper överskrids misslyckas begäran med HTTP-statuskod 400. NetworkSecurityGroupRule[]
protokoll Slutpunktens protokoll. "TCP"
"UDP" (krävs)

NetworkSecurityGroupRule

Namn Beskrivning Värde
tillträde Den åtgärd som ska vidtas för en angiven IP-adress, undernätsintervall eller tagg. "Tillåt"
"Neka" (krävs)
prioritering Prioriteringar i en pool måste vara unika och utvärderas i prioritetsordning. Desto lägre är talet, desto högre prioritet. Regler kan till exempel anges med ordernummer 150, 250 och 350. Regeln med ordernumret 150 har företräde framför regeln som har en ordning på 250. Tillåtna prioriteringar är mellan 150 och 4 096. Om några reserverade eller duplicerade värden anges misslyckas begäran med HTTP-statuskod 400. int (krävs)
sourceAddressPrefix Giltiga värden är en enskild IP-adress (dvs. 10.10.10.10), IP-undernät (dvs. 192.168.1.0/24), standardtagg eller * (för alla adresser). Om andra värden anges misslyckas begäran med HTTP-statuskod 400. sträng (krävs)
sourcePortRanges Giltiga värden är *( för alla portar 0–65535) eller matriser med portar eller portintervall (dvs. 100–200). Portarna ska ligga mellan 0 och 65535 och portintervallen eller portarna får inte överlappa varandra. Om andra värden anges misslyckas begäran med HTTP-statuskod 400. Standardvärdet är *. string[]

PublicIPAddressConfiguration

Namn Beskrivning Värde
ipAddressIds Antalet IP-adresser som anges här begränsar den maximala storleken på poolen – 100 dedikerade noder eller 100 noder med låg prioritet kan allokeras för varje offentlig IP-adress. En pool som behöver 250 dedikerade virtuella datorer skulle till exempel behöva minst 3 offentliga IP-adresser angivna. Varje element i den här samlingen är av formuläret : /subscriptions/{subscription}/resourceGroups/{group}/providers/Microsoft.Network/publicIPAddresses/{ip}. string[]
bestämmelse Standardvärdet är BatchManaged "BatchManaged"
"NoPublicIPAddresses"
"UserManaged"

ScaleSettings

Namn Beskrivning Värde
autoskalning Den här egenskapen och fixedScale är ömsesidigt uteslutande och en av egenskaperna måste anges. AutoscaleSettings
fixedScale Den här egenskapen och autoskalan är ömsesidigt uteslutande och en av egenskaperna måste anges. FixedScaleSettings

AutoskalningInställningar

Namn Beskrivning Värde
evaluationInterval Om det utelämnas är standardvärdet 15 minuter (PT15M). sträng
formel En formel för önskat antal beräkningsnoder i poolen. sträng (krävs)

FixedScaleSettings

Namn Beskrivning Värde
nodeDeallocationOption Om det utelämnas är standardvärdet Requeue. "Fråga igen"
"RetainedData"
"TaskCompletion"
"Avsluta"
resizeTimeout Standardvärdet är 15 minuter. Tidsgränsvärden använder ISO 8601-format. Använd till exempel PT10M i 10 minuter. Minimivärdet är 5 minuter. Om du anger ett värde som är mindre än 5 minuter avvisar Batch-tjänsten begäran med ett fel. Om du anropar REST-API:et direkt är HTTP-statuskoden 400 (felaktig begäran). sträng
targetDedicatedNodes Minst en av targetDedicatedNodes, targetLowPriorityNodes måste anges. Int
targetLowPriorityNodes Minst en av targetDedicatedNodes, targetLowPriorityNodes måste anges. Int

StartTask

Namn Beskrivning Värde
commandLine Kommandoraden körs inte under ett gränssnitt och kan därför inte dra nytta av gränssnittsfunktioner som miljövariabelexpansion. Om du vill dra nytta av sådana funktioner bör du anropa gränssnittet på kommandoraden, till exempel med hjälp av "cmd /c MyCommand" i Windows eller "/bin/sh -c MyCommand" i Linux. Krävs om några andra egenskaper för startTask anges. sträng
containerSettings När detta anges mappas alla kataloger rekursivt under AZ_BATCH_NODE_ROOT_DIR (roten för Azure Batch-kataloger på noden) till containern, alla aktivitetsmiljövariabler mappas till containern och aktivitetskommandoraden körs i containern. TaskContainerSettings
environmentSettings En lista över miljövariabelinställningar för startaktiviteten. EnvironmentSetting[]
maxTaskRetryCount Batch-tjänsten försöker utföra en aktivitet igen om dess slutkod inte är noll. Observera att det här värdet specifikt styr antalet återförsök. Batch-tjänsten provar uppgiften en gång och kan sedan försöka upp till den här gränsen igen. Om det maximala antalet återförsök till exempel är 3, försöker Batch aktiviteten upp till 4 gånger (ett första försök och 3 återförsök). Om det maximala antalet återförsök är 0 försöker inte Batch-tjänsten uppgiften igen. Om det maximala antalet återförsök är -1, försöker Batch-tjänsten uppgiften utan begränsning. Int
resourceFiles En lista över filer som Batch-tjänsten laddar ned till beräkningsnoden innan kommandoraden körs. ResourceFile[]
userIdentity Om den utelämnas körs aktiviteten som en icke-administrativ användare som är unik för aktiviteten. UserIdentity
waitForSuccess Om sant och startaktiviteten misslyckas på en beräkningsnod, försöker Batch-tjänsten starta aktiviteten igen upp till maximalt antal återförsök (maxTaskRetryCount). Om aktiviteten fortfarande inte har slutförts efter alla återförsök markerar Batch-tjänsten beräkningsnoden oanvändbar och schemalägger inte aktiviteter till den. Det här villkoret kan identifieras via nodtillståndet och schemaläggningsfelinformationen. Om det är falskt väntar inte Batch-tjänsten på att startaktiviteten ska slutföras. I det här fallet kan andra aktiviteter börja köras på beräkningsnoden medan startaktiviteten fortfarande körs. och även om startaktiviteten misslyckas fortsätter nya aktiviteter att schemaläggas på noden. Standardvärdet är sant. Bool

TaskContainerSettings

Namn Beskrivning Värde
containerRunOptions Dessa ytterligare alternativ anges som argument till kommandot "docker create", utöver de som styrs av Batch-tjänsten. sträng
imageName Det här är den fullständiga avbildningsreferensen, som skulle anges till "docker pull". Om ingen tagg anges som en del av avbildningsnamnet används taggen ":latest" som standard. sträng (krävs)
register Den här inställningen kan utelämnas om den redan angavs när poolen skapades. ContainerRegistry
workingDirectory En flagga som anger var containeruppgiftens arbetskatalog finns. Standardvärdet är "taskWorkingDirectory". "ContainerImageDefault"
"TaskWorkingDirectory"

MiljöerInställningar

Namn Beskrivning Värde
Namn Namnet på miljövariabeln. sträng (krävs)
värde Värdet för miljövariabeln. sträng

ResourceFile

Namn Beskrivning Värde
autoStorageContainerName Egenskaperna autoStorageContainerName, storageContainerUrl och httpUrl är ömsesidigt uteslutande och en av dem måste anges. sträng
blobPrefix Egenskapen är endast giltig när autoStorageContainerName eller storageContainerUrl används. Det här prefixet kan vara ett partiellt filnamn eller en underkatalog. Om inget prefix har angetts laddas alla filer i containern ned. sträng
fileMode Den här egenskapen gäller endast filer som laddas ned till Linux-beräkningsnoder. Den ignoreras om den har angetts för en resourceFile som laddas ned till en Windows-nod. Om den här egenskapen inte har angetts för en Linux-nod tillämpas standardvärdet 0770 på filen. sträng
filePath Om egenskapen httpUrl har angetts krävs filePath och beskriver sökvägen som filen ska laddas ned till, inklusive filnamnet. Om egenskapen autoStorageContainerName eller storageContainerUrl har angetts är filePath valfritt och är den katalog som filerna ska laddas ned till. Om filePath används som en katalog behålls alla katalogstrukturer som redan är associerade med indata i sin helhet och läggs till i den angivna filePath-katalogen. Den angivna relativa sökvägen kan inte bryta sig ut ur aktivitetens arbetskatalog (till exempel med hjälp av ..). sträng
httpUrl Egenskaperna autoStorageContainerName, storageContainerUrl och httpUrl är ömsesidigt uteslutande och en av dem måste anges. Om URL:en är Azure Blob Storage måste den vara läsbar med hjälp av anonym åtkomst. Det innebär att Batch-tjänsten inte visar några autentiseringsuppgifter när bloben laddas ned. Det finns två sätt att hämta en sådan URL för en blob i Azure Storage: inkludera en signatur för delad åtkomst (SAS) som beviljar läsbehörigheter för blobben eller ange ACL för blobben eller dess container för att tillåta offentlig åtkomst. sträng
storageContainerUrl Egenskaperna autoStorageContainerName, storageContainerUrl och httpUrl är ömsesidigt uteslutande och en av dem måste anges. Den här URL:en måste vara läsbar och listbar med hjälp av anonym åtkomst. Det innebär att Batch-tjänsten inte visar några autentiseringsuppgifter när bloben laddas ned. Det finns två sätt att hämta en sådan URL för en blob i Azure Storage: inkludera en signatur för delad åtkomst (SAS) som beviljar läs- och listbehörigheter för bloben eller anger ACL för bloben eller dess container för att tillåta offentlig åtkomst. sträng

UserIdentity

Namn Beskrivning Värde
autoAnvändare Egenskaperna userName och autoUser är ömsesidigt uteslutande. du måste ange en men inte båda. AutoUserSpecification
userName Egenskaperna userName och autoUser är ömsesidigt uteslutande. du måste ange en men inte båda. sträng

AutoUserSpecification

Namn Beskrivning Värde
elevationLevel Standardvärdet är nonAdmin. "Administratör"
"NonAdmin"
omfattning Standardvärdet är Pool. Om poolen kör Windows ska värdet Aktivitet anges om striktare isolering mellan aktiviteter krävs. Om uppgiften till exempel muterar registret på ett sätt som kan påverka andra uppgifter, eller om certifikat har angetts i poolen som inte ska vara tillgängliga för normala uppgifter men bör vara tillgängliga genom startaktiviteter. "Pool"
"Uppgift"

TaskSchedulingPolicy

Namn Beskrivning Värde
nodeFillType Hur aktiviteter ska distribueras mellan beräkningsnoder. "Pack"
"Spridning" (krävs)

UserAccount

Namn Beskrivning Värde
elevationLevel nonAdmin – Den automatiska användaren är en standardanvändare utan förhöjd åtkomst. admin – Den automatiska användaren är en användare med förhöjd åtkomst och fungerar med fullständig administratörsbehörighet. Standardvärdet är nonAdmin. "Administratör"
"NonAdmin"
linuxUserConfiguration Den här egenskapen ignoreras om den anges i en Windows-pool. Om det inte anges skapas användaren med standardalternativen. LinuxUserConfiguration
Namn Namnet på användarkontot. sträng (krävs)
lösenord Lösenordet för användarkontot. sträng (krävs)
windowsUserConfiguration Den här egenskapen kan bara anges om användaren finns i en Windows-pool. Om det inte anges och i en Windows-pool skapas användaren med standardalternativen. WindowsUserConfiguration

LinuxUserConfiguration

Namn Beskrivning Värde
Gid Egenskaperna uid och gid måste anges tillsammans eller inte alls. Om det inte anges väljer det underliggande operativsystemet gid. Int
sshPrivateKey Den privata nyckeln får inte vara lösenordsskyddad. Den privata nyckeln används för att automatiskt konfigurera asymmetrisk nyckelbaserad autentisering för SSH mellan noder i en Linux-pool när poolens enableInterNodeCommunication-egenskap är sann (den ignoreras om enableInterNodeCommunication är falskt). Det gör du genom att placera nyckelparet i användarens .ssh-katalog. Om det inte anges konfigureras inte lösenordsfri SSH mellan noder (ingen ändring av användarens .ssh-katalog görs). sträng
Uid Egenskaperna uid och gid måste anges tillsammans eller inte alls. Om det inte anges väljer det underliggande operativsystemet uid. Int

WindowsUserConfiguration

Namn Beskrivning Värde
loginMode Anger inloggningsläge för användaren. Standardvärdet för VirtualMachineConfiguration-pooler är interaktivt läge och för CloudServiceConfiguration-pooler är batchläge. "Batch"
"Interaktiv"

Snabbstartsmallar

Följande snabbstartsmallar distribuerar den här resurstypen.

Mall Beskrivning
Azure Batch-pool utan offentliga IP-adresser

Distribuera till Azure
Den här mallen skapar azure batch-förenklad nodkommunikationspool utan offentliga IP-adresser.

Resursdefinition för Terraform (AzAPI-provider)

Resurstypen batchAccounts/pooler kan distribueras med åtgärder som mål:

  • Resursgrupper

En lista över ändrade egenskaper i varje API-version finns i ändringsloggen.

Resursformat

Om du vill skapa en Resurs för Microsoft.Batch/batchAccounts/pooler lägger du till följande Terraform i mallen.

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

Egenskapsvärden

batchAccounts/pooler

Namn Beskrivning Värde
typ Resurstypen "Microsoft.Batch/batchAccounts/pools@2020-09-01"
Namn Resursnamnet sträng (krävs)

Teckengräns: 1–64

Giltiga tecken:
Alfanumeriska tecken, understreck och bindestreck.
parent_id ID för resursen som är överordnad för den här resursen. ID för resurs av typen: batchAccounts
Egenskaper Egenskaperna som är associerade med poolen. PoolEgenskaper

PoolEgenskaper

Namn Beskrivning Värde
applicationLicenses Listan över programlicenser måste vara en delmängd av tillgängliga Batch-tjänstprogramlicenser. Om en licens begärs som inte stöds misslyckas skapandet av poolen. string[]
applicationPackages Ändringar i programpaketreferenser påverkar alla nya beräkningsnoder som ansluter till poolen, men påverkar inte beräkningsnoder som redan finns i poolen förrän de startas om eller omskapas. Det finns högst 10 programpaketreferenser i en viss pool. ApplicationPackageReference[]
certifikaten För Windows-beräkningsnoder installerar Batch-tjänsten certifikaten till det angivna certifikatarkivet och platsen. För Linux-beräkningsnoder lagras certifikaten i en katalog i aktivitetsarbetskatalogen och en miljövariabel AZ_BATCH_CERTIFICATES_DIR skickas till uppgiften för att fråga efter den här platsen. För certifikat med synlighet för "remoteUser" skapas en certs-katalog i användarens hemkatalog (t.ex. /home/{user-name}/certs) och certifikat placeras i den katalogen. CertificateReference[]
deploymentConfiguration Med CloudServiceConfiguration anges att noderna ska skapas med Hjälp av Azure Cloud Services (PaaS), medan VirtualMachineConfiguration använder Azure Virtual Machines (IaaS). DeploymentConfiguration
displayName Visningsnamnet behöver inte vara unikt och kan innehålla unicode-tecken upp till en maximal längd på 1024. sträng
interNodeCommunication Detta medför begränsningar för vilka noder som kan tilldelas till poolen. Om du aktiverar det här värdet kan du minska risken för att det begärda antalet noder allokeras i poolen. Om det inte anges är det här värdet som standard inaktiverat. "Inaktiverad"
"Aktiverad"
metadata Batch-tjänsten tilldelar ingen betydelse för metadata. det är endast för användning av användarkod. MetadataItem[]
mountConfiguration Detta stöder Azure Files, NFS, CIFS/SMB och Blobfuse. MountConfiguration[]
networkConfiguration Nätverkskonfigurationen för en pool. NetworkConfiguration
scaleSettings Definierar poolens önskade storlek. Detta kan antingen vara "fixedScale" där det begärda targetDedicatedNodes har angetts, eller "autoskala" som definierar en formel som regelbundet omvärderas. Om den här egenskapen inte anges har poolen en fast skalning med 0 targetDedicatedNodes. ScaleSettings
startTask I en PATCH-åtgärd (uppdatering) kan den här egenskapen anges till ett tomt objekt för att ta bort startaktiviteten från poolen. StartTask
taskSchedulingPolicy Om det inte anges är standardvärdet utspritt. TaskSchedulingPolicy
taskSlotsPerNode Standardvärdet är 1. Det maximala värdet är mindre än 4 gånger antalet kärnor i vmSize för poolen eller 256. Int
userAccounts Listan över användarkonton som ska skapas på varje nod i poolen. UserAccount[]
vmSize Information om tillgängliga storlekar på virtuella datorer för Cloud Services-pooler (pooler som skapats med cloudServiceConfiguration) finns i Storlekar för Cloud Services (https://azure.microsoft.com/documentation/articles/cloud-services-sizes-specs/). Batch stöder alla vm-storlekar för Cloud Services utom ExtraSmall. Information om tillgängliga VM-storlekar för pooler med avbildningar från Virtual Machines Marketplace (pooler som skapats med virtualMachineConfiguration) finns i Storlekar för virtuella datorer (Linux) (/azure/virtual-machines/sizes-general) eller Sizes for Virtual Machines (Windows) (https://azure.microsoft.com/documentation/articles/virtual-machines-windows-sizes/). Batch har stöd för alla storlekar på virtuella Azure-datorer förutom STANDARD_A0 och de med premiumlagring (STANDARD_GS, STANDARD_DS och STANDARD_DSV2-serien). sträng

ApplicationPackageReference

Namn Beskrivning Värde
Id ID:t för programpaketet som ska installeras. Detta måste finnas i samma batchkonto som poolen. Detta kan antingen vara en referens till en viss version eller standardversionen om det finns en sådan. sträng (krävs)
version Om detta utelämnas och ingen standardversion har angetts för det här programmet misslyckas begäran med felkoden InvalidApplicationPackageReferences. Om du anropar REST-API:et direkt är HTTP-statuskoden 409. sträng

CertificateReference

Namn Beskrivning Värde
Id Det fullständigt kvalificerade ID för certifikatet som ska installeras i poolen. Detta måste finnas i samma batchkonto som poolen. sträng (krävs)
storeLocation Standardvärdet är currentUser. Den här egenskapen gäller endast för pooler som konfigurerats med Windows-noder (dvs. skapas med cloudServiceConfiguration eller med virtualMachineConfiguration med hjälp av en Windows-avbildningsreferens). För Linux-beräkningsnoder lagras certifikaten i en katalog i aktivitetsarbetskatalogen och en miljövariabel AZ_BATCH_CERTIFICATES_DIR skickas till uppgiften för att fråga efter den här platsen. För certifikat med synlighet för "remoteUser" skapas en certs-katalog i användarens hemkatalog (t.ex. /home/{user-name}/certs) och certifikat placeras i den katalogen. "CurrentUser"
"LocalMachine"
storeName Den här egenskapen gäller endast för pooler som konfigurerats med Windows-noder (dvs. skapas med cloudServiceConfiguration eller med virtualMachineConfiguration med hjälp av en Windows-avbildningsreferens). Vanliga butiksnamn är: My, Root, CA, Trust, Disallowed, TrustedPeople, TrustedPublisher, AuthRoot, AddressBook, men alla anpassade butiksnamn kan också användas. Standardvärdet är Min. sträng
synlighet Vilka användarkonton på beräkningsnoden ska ha åtkomst till certifikatets privata data. Strängmatris som innehåller något av:
"RemoteUser"
"StartTask"
"Uppgift"

DeploymentConfiguration

Namn Beskrivning Värde
cloudServiceConfiguration Den här egenskapen och virtualMachineConfiguration är ömsesidigt uteslutande och en av egenskaperna måste anges. Det går inte att ange den här egenskapen om Batch-kontot skapades med dess poolAllocationMode-egenskap inställd på "UserSubscription". CloudServiceConfiguration
virtualMachineConfiguration Den här egenskapen och cloudServiceConfiguration är ömsesidigt uteslutande och en av egenskaperna måste anges. VirtualMachineConfiguration

CloudServiceConfiguration

Namn Beskrivning Värde
osFamily Möjliga värden är: 2 – OS Family 2, motsvarande Windows Server 2008 R2 SP1. 3 – OS Family 3, motsvarande Windows Server 2012. 4 – OS Family 4, motsvarande Windows Server 2012 R2. 5 – OS Family 5, motsvarande Windows Server 2016. 6 – OS Family 6, motsvarande Windows Server 2019. Mer information finns i Azure Guest OS Releases (https://azure.microsoft.com/documentation/articles/cloud-services-guestos-update-matrix/#releases). sträng (krävs)
osVersion Standardvärdet är * som anger den senaste operativsystemversionen för den angivna operativsystemfamiljen. sträng

VirtualMachineConfiguration

Namn Beskrivning Värde
containerConfiguration Om det anges utförs konfigurationen på varje nod i poolen så att aktiviteter kan köras i containrar. Alla vanliga uppgifter och jobbhanteraraktiviteter som körs i den här poolen måste ange egenskapen containerSettings och alla andra uppgifter kan ange den. ContainerConfiguration
dataDiskar Den här egenskapen måste anges om beräkningsnoderna i poolen måste ha tomma datadiskar kopplade till sig. DataDisk[]
diskEncryptionConfiguration Om det anges utförs kryptering på varje nod i poolen under nodetablering. DiskEncryptionConfiguration
imageReference En referens till en Azure Virtual Machines Marketplace-avbildning eller Azure Image-resursen för en anpassad virtuell dator. Information om hur du hämtar listan över alla imageReferences som verifierats av Azure Batch finns i åtgärden "List supported node agent SKU:er". ImageReference (krävs)
licenseType Detta gäller endast för avbildningar som innehåller Windows-operativsystemet och bör endast användas när du har giltiga lokala licenser för noderna som ska distribueras. Om det utelämnas tillämpas ingen lokal licensrabatt. Värden är:

Windows_Server – Den lokala licensen gäller för Windows Server.
Windows_Client – Den lokala licensen gäller för Windows-klienten.
sträng
nodeAgentSkuId Batch-nodagenten är ett program som körs på varje nod i poolen och tillhandahåller kommando- och kontrollgränssnittet mellan noden och Batch-tjänsten. Det finns olika implementeringar av nodagenten, så kallade SKU:er, för olika operativsystem. Du måste ange en nodagent-SKU som matchar den valda bildreferensen. Information om hur du hämtar listan över nodagent-SKU:er som stöds tillsammans med deras lista över verifierade bildreferenser finns i åtgärden "List supported node agent SKU:er". sträng (krävs)
windowsConfiguration Den här egenskapen får inte anges om imageReference anger en Linux OS-avbildning. WindowsConfiguration

ContainerConfiguration

Namn Beskrivning Värde
containerImageNames Det här är den fullständiga avbildningsreferensen, som skulle anges till "docker pull". En avbildning kommer att hämtas från Docker-standardregistret om inte avbildningen är fullständigt kvalificerad med ett alternativt register. string[]
containerRegister Om några avbildningar måste laddas ned från ett privat register som kräver autentiseringsuppgifter måste dessa autentiseringsuppgifter anges här. ContainerRegistry[]
typ Den containerteknik som ska användas. "DockerCompatible" (krävs)

ContainerRegistry

Namn Beskrivning Värde
lösenord Lösenordet för att logga in på registerservern. sträng (krävs)
registryServer Om det utelämnas är standardvärdet "docker.io". sträng
användarnamn Användarnamnet för att logga in på registerservern. sträng (krävs)

DataDisk

Namn Beskrivning Värde
Cachelagring Värden är:

none – Cachelagringsläget för disken är inte aktiverat.
readOnly – Cachelagringsläget för disken är skrivskyddat.
readWrite – Cachelagringsläget för disken är läs- och skrivläge.

Standardvärdet för cachelagring är inget. Information om cachelagringsalternativen finns i: https://blogs.msdn.microsoft.com/windowsazurestorage/2012/06/27/exploring-windows-azure-drives-disks-and-images/.
"Ingen"
"ReadOnly"
"Skriv upp"
diskSizeGB Den ursprungliga diskstorleken i GB när du skapar en ny datadisk. int (krävs)
Lun Lun används för att unikt identifiera varje datadisk. Om du ansluter flera diskar bör var och en ha ett distinkt lun. Värdet måste vara mellan 0 och 63, inklusive. int (krävs)
storageAccountType Om det utelämnas är standardvärdet "Standard_LRS". Värden är:

Standard_LRS – Datadisken bör använda lokalt redundant standardlagring.
Premium_LRS – Datadisken bör använda premium lokalt redundant lagring.
"Premium_LRS"
"Standard_LRS"

DiskEncryptionConfiguration

Namn Beskrivning Värde
Mål I Linux-poolen stöds endast "TemporaryDisk". i Windows-poolen måste "OsDisk" och "TemporaryDisk" anges. Strängmatris som innehåller något av:
"OsDisk"
"TemporaryDisk"

ImageReference

Namn Beskrivning Värde
Id Den här egenskapen är ömsesidigt uteslutande med andra egenskaper. Avbildningen för delat bildgalleri måste ha repliker i samma region som Azure Batch-kontot. Information om brandväggsinställningarna för Batch-nodagenten för kommunikation med Batch-tjänsten finns i /azure/batch/batch-api-basics#virtual-network-vnet-and-firewall-configuration. sträng
erbjudande Till exempel UbuntuServer eller WindowsServer. sträng
förläggare Till exempel Canonical eller MicrosoftWindowsServer. sträng
Sku Till exempel 18.04-LTS eller 2019-Datacenter. sträng
version Du kan ange värdet "senaste" för att välja den senaste versionen av en bild. Om det utelämnas är standardvärdet "senaste". sträng

WindowsConfiguration

Namn Beskrivning Värde
enableAutomaticUpdates Om det utelämnas är standardvärdet sant. Bool

MetadataItem

Namn Beskrivning Värde
Namn Namnet på metadataobjektet. sträng (krävs)
värde Värdet för metadataobjektet. sträng (krävs)

MountConfiguration

Namn Beskrivning Värde
azureBlobFileSystemConfiguration Den här egenskapen är ömsesidigt uteslutande med alla andra egenskaper. AzureBlobFileSystemConfiguration
azureFileShareConfiguration Den här egenskapen är ömsesidigt uteslutande med alla andra egenskaper. AzureFileShareConfiguration
cifsMountConfiguration Den här egenskapen är ömsesidigt uteslutande med alla andra egenskaper. CifsMountConfiguration
nfsMountConfiguration Den här egenskapen är ömsesidigt uteslutande med alla andra egenskaper. NFSMountConfiguration

AzureBlobFileSystemConfiguration

Namn Beskrivning Värde
accountKey Den här egenskapen är ömsesidigt uteslutande med sasKey och en måste anges. sträng
accountName Namnet på Azure Storage-kontot. sträng (krävs)
blobfuseOptions Det här är alternativ för "net use" i Windows och "monteringsalternativ" i Linux. sträng
containerName Namnet på Azure Blob Storage-containern. sträng (krävs)
relativeMountPath Alla filsystem monteras i förhållande till katalogen Batch-monteringar, som är tillgängliga via AZ_BATCH_NODE_MOUNTS_DIR miljövariabeln. sträng (krävs)
sasKey Den här egenskapen är ömsesidigt uteslutande med accountKey och en måste anges. sträng

AzureFileShareConfiguration

Namn Beskrivning Värde
accountKey Azure Storage-kontonyckeln. sträng (krävs)
accountName Namnet på Azure Storage-kontot. sträng (krävs)
azureFileUrl Det här är formuläret "https://{account}.file.core.windows.net/". sträng (krävs)
mountOptions Det här är alternativ för "net use" i Windows och "monteringsalternativ" i Linux. sträng
relativeMountPath Alla filsystem monteras i förhållande till katalogen Batch-monteringar, som är tillgängliga via AZ_BATCH_NODE_MOUNTS_DIR miljövariabeln. sträng (krävs)

CifsMountConfiguration

Namn Beskrivning Värde
mountOptions Det här är alternativ för "net use" i Windows och "monteringsalternativ" i Linux. sträng
lösenord Lösenordet som ska användas för autentisering mot CIFS-filsystemet. sträng (krävs)
relativeMountPath Alla filsystem monteras i förhållande till katalogen Batch-monteringar, som är tillgängliga via AZ_BATCH_NODE_MOUNTS_DIR miljövariabeln. sträng (krävs)
källa URI:n för filsystemet som ska monteras. sträng (krävs)
användarnamn Användaren som ska användas för autentisering mot CIFS-filsystemet. sträng (krävs)

NFSMountConfiguration

Namn Beskrivning Värde
mountOptions Det här är alternativ för "net use" i Windows och "monteringsalternativ" i Linux. sträng
relativeMountPath Alla filsystem monteras i förhållande till katalogen Batch-monteringar, som är tillgängliga via AZ_BATCH_NODE_MOUNTS_DIR miljövariabeln. sträng (krävs)
källa URI:n för filsystemet som ska monteras. sträng (krävs)

NetworkConfiguration

Namn Beskrivning Värde
endpointConfiguration Poolslutpunktskonfiguration stöds endast i pooler med egenskapen virtualMachineConfiguration. PoolEndpointConfiguration
publicIPAddressConfiguration Den här egenskapen stöds endast i Pooler med egenskapen virtualMachineConfiguration. PublicIPAddressConfiguration
subnetId Det virtuella nätverket måste finnas i samma region och prenumeration som Azure Batch-kontot. Det angivna undernätet bör ha tillräckligt med kostnadsfria IP-adresser för att hantera antalet noder i poolen. Om undernätet inte har tillräckligt med kostnadsfria IP-adresser allokerar poolen delvis beräkningsnoder och ett storleksändringsfel uppstår. Tjänstens huvudnamn för MicrosoftAzureBatch måste ha rollen "Klassisk virtuell datordeltagare" Role-Based åtkomstkontroll (RBAC) för det angivna virtuella nätverket. Det angivna undernätet måste tillåta kommunikation från Azure Batch-tjänsten för att kunna schemalägga uppgifter på beräkningsnoderna. Detta kan verifieras genom att kontrollera om det angivna virtuella nätverket har några associerade nätverkssäkerhetsgrupper (NSG). Om kommunikationen till beräkningsnoderna i det angivna undernätet nekas av en NSG anger Batch-tjänsten tillståndet för beräkningsnoderna till oanvändbar. Om det angivna virtuella nätverket har några associerade nätverkssäkerhetsgrupper (NSG) måste några reserverade systemportar aktiveras för inkommande kommunikation. För pooler som skapats med en konfiguration av virtuella datorer aktiverar du portarna 29876 och 29877 samt port 22 för Linux och port 3389 för Windows. För pooler som skapats med en molntjänstkonfiguration aktiverar du portarna 10100, 20100 och 30100. Aktivera även utgående anslutningar till Azure Storage på port 443. För cloudServiceConfiguration-pooler stöds endast "klassiska" virtuella nätverk. Mer information finns i: /azure/batch/batch-api-basics#virtual-network-vnet-and-firewall-configuration sträng

PoolEndpointConfiguration

Namn Beskrivning Värde
inboundNatPools Det maximala antalet inkommande NAT-pooler per Batch-pool är 5. Om det maximala antalet inkommande NAT-pooler överskrids misslyckas begäran med HTTP-statuskod 400. Detta kan inte anges om IPAddressProvisioningType är NoPublicIPAddresses. InboundNatPool[] (krävs)

InboundNatPool

Namn Beskrivning Värde
backendPort Detta måste vara unikt i en Batch-pool. Godtagbara värden är mellan 1 och 65535 förutom för 22, 3389, 29876 och 29877 eftersom dessa är reserverade. Om några reserverade värden anges misslyckas begäran med HTTP-statuskod 400. int (krävs)
frontendPortRangeEnd Acceptabla värden varierar mellan 1 och 65534 förutom portar från 50000 till 55000 som reserveras av Batch-tjänsten. Alla intervall i en pool måste vara distinkta och får inte överlappa varandra. Om några reserverade eller överlappande värden anges misslyckas begäran med HTTP-statuskod 400. int (krävs)
frontendPortRangeStart Godtagbara värden varierar mellan 1 och 65534 förutom portar från 50000 till 55000 som är reserverade. Alla intervall i en pool måste vara distinkta och får inte överlappa varandra. Om några reserverade eller överlappande värden anges misslyckas begäran med HTTP-statuskod 400. int (krävs)
Namn Namnet måste vara unikt i en Batch-pool, kan innehålla bokstäver, siffror, understreck, punkter och bindestreck. Namn måste börja med en bokstav eller siffra, måste sluta med en bokstav, ett tal eller understreck och får inte överstiga 77 tecken. Om ogiltiga värden anges misslyckas begäran med HTTP-statuskod 400. sträng (krävs)
networkSecurityGroupRules Det maximala antalet regler som kan anges för alla slutpunkter i en Batch-pool är 25. Om inga regler för nätverkssäkerhetsgrupper har angetts skapas en standardregel för att tillåta inkommande åtkomst till den angivna backendPort. Om det maximala antalet regler för nätverkssäkerhetsgrupper överskrids misslyckas begäran med HTTP-statuskod 400. NetworkSecurityGroupRule[]
protokoll Slutpunktens protokoll. "TCP"
"UDP" (krävs)

NetworkSecurityGroupRule

Namn Beskrivning Värde
tillträde Den åtgärd som ska vidtas för en angiven IP-adress, undernätsintervall eller tagg. "Tillåt"
"Neka" (krävs)
prioritering Prioriteringar i en pool måste vara unika och utvärderas i prioritetsordning. Desto lägre är talet, desto högre prioritet. Regler kan till exempel anges med ordernummer 150, 250 och 350. Regeln med ordernumret 150 har företräde framför regeln som har en ordning på 250. Tillåtna prioriteringar är mellan 150 och 4 096. Om några reserverade eller duplicerade värden anges misslyckas begäran med HTTP-statuskod 400. int (krävs)
sourceAddressPrefix Giltiga värden är en enskild IP-adress (dvs. 10.10.10.10), IP-undernät (dvs. 192.168.1.0/24), standardtagg eller * (för alla adresser). Om andra värden anges misslyckas begäran med HTTP-statuskod 400. sträng (krävs)
sourcePortRanges Giltiga värden är *( för alla portar 0–65535) eller matriser med portar eller portintervall (dvs. 100–200). Portarna ska ligga mellan 0 och 65535 och portintervallen eller portarna får inte överlappa varandra. Om andra värden anges misslyckas begäran med HTTP-statuskod 400. Standardvärdet är *. string[]

PublicIPAddressConfiguration

Namn Beskrivning Värde
ipAddressIds Antalet IP-adresser som anges här begränsar den maximala storleken på poolen – 100 dedikerade noder eller 100 noder med låg prioritet kan allokeras för varje offentlig IP-adress. En pool som behöver 250 dedikerade virtuella datorer skulle till exempel behöva minst 3 offentliga IP-adresser angivna. Varje element i den här samlingen är av formuläret : /subscriptions/{subscription}/resourceGroups/{group}/providers/Microsoft.Network/publicIPAddresses/{ip}. string[]
bestämmelse Standardvärdet är BatchManaged "BatchManaged"
"NoPublicIPAddresses"
"UserManaged"

ScaleSettings

Namn Beskrivning Värde
autoskalning Den här egenskapen och fixedScale är ömsesidigt uteslutande och en av egenskaperna måste anges. AutoscaleSettings
fixedScale Den här egenskapen och autoskalan är ömsesidigt uteslutande och en av egenskaperna måste anges. FixedScaleSettings

AutoskalningInställningar

Namn Beskrivning Värde
evaluationInterval Om det utelämnas är standardvärdet 15 minuter (PT15M). sträng
formel En formel för önskat antal beräkningsnoder i poolen. sträng (krävs)

FixedScaleSettings

Namn Beskrivning Värde
nodeDeallocationOption Om det utelämnas är standardvärdet Requeue. "Fråga igen"
"RetainedData"
"TaskCompletion"
"Avsluta"
resizeTimeout Standardvärdet är 15 minuter. Tidsgränsvärden använder ISO 8601-format. Använd till exempel PT10M i 10 minuter. Minimivärdet är 5 minuter. Om du anger ett värde som är mindre än 5 minuter avvisar Batch-tjänsten begäran med ett fel. Om du anropar REST-API:et direkt är HTTP-statuskoden 400 (felaktig begäran). sträng
targetDedicatedNodes Minst en av targetDedicatedNodes, targetLowPriorityNodes måste anges. Int
targetLowPriorityNodes Minst en av targetDedicatedNodes, targetLowPriorityNodes måste anges. Int

StartTask

Namn Beskrivning Värde
commandLine Kommandoraden körs inte under ett gränssnitt och kan därför inte dra nytta av gränssnittsfunktioner som miljövariabelexpansion. Om du vill dra nytta av sådana funktioner bör du anropa gränssnittet på kommandoraden, till exempel med hjälp av "cmd /c MyCommand" i Windows eller "/bin/sh -c MyCommand" i Linux. Krävs om några andra egenskaper för startTask anges. sträng
containerSettings När detta anges mappas alla kataloger rekursivt under AZ_BATCH_NODE_ROOT_DIR (roten för Azure Batch-kataloger på noden) till containern, alla aktivitetsmiljövariabler mappas till containern och aktivitetskommandoraden körs i containern. TaskContainerSettings
environmentSettings En lista över miljövariabelinställningar för startaktiviteten. EnvironmentSetting[]
maxTaskRetryCount Batch-tjänsten försöker utföra en aktivitet igen om dess slutkod inte är noll. Observera att det här värdet specifikt styr antalet återförsök. Batch-tjänsten provar uppgiften en gång och kan sedan försöka upp till den här gränsen igen. Om det maximala antalet återförsök till exempel är 3, försöker Batch aktiviteten upp till 4 gånger (ett första försök och 3 återförsök). Om det maximala antalet återförsök är 0 försöker inte Batch-tjänsten uppgiften igen. Om det maximala antalet återförsök är -1, försöker Batch-tjänsten uppgiften utan begränsning. Int
resourceFiles En lista över filer som Batch-tjänsten laddar ned till beräkningsnoden innan kommandoraden körs. ResourceFile[]
userIdentity Om den utelämnas körs aktiviteten som en icke-administrativ användare som är unik för aktiviteten. UserIdentity
waitForSuccess Om sant och startaktiviteten misslyckas på en beräkningsnod, försöker Batch-tjänsten starta aktiviteten igen upp till maximalt antal återförsök (maxTaskRetryCount). Om aktiviteten fortfarande inte har slutförts efter alla återförsök markerar Batch-tjänsten beräkningsnoden oanvändbar och schemalägger inte aktiviteter till den. Det här villkoret kan identifieras via nodtillståndet och schemaläggningsfelinformationen. Om det är falskt väntar inte Batch-tjänsten på att startaktiviteten ska slutföras. I det här fallet kan andra aktiviteter börja köras på beräkningsnoden medan startaktiviteten fortfarande körs. och även om startaktiviteten misslyckas fortsätter nya aktiviteter att schemaläggas på noden. Standardvärdet är sant. Bool

TaskContainerSettings

Namn Beskrivning Värde
containerRunOptions Dessa ytterligare alternativ anges som argument till kommandot "docker create", utöver de som styrs av Batch-tjänsten. sträng
imageName Det här är den fullständiga avbildningsreferensen, som skulle anges till "docker pull". Om ingen tagg anges som en del av avbildningsnamnet används taggen ":latest" som standard. sträng (krävs)
register Den här inställningen kan utelämnas om den redan angavs när poolen skapades. ContainerRegistry
workingDirectory En flagga som anger var containeruppgiftens arbetskatalog finns. Standardvärdet är "taskWorkingDirectory". "ContainerImageDefault"
"TaskWorkingDirectory"

MiljöerInställningar

Namn Beskrivning Värde
Namn Namnet på miljövariabeln. sträng (krävs)
värde Värdet för miljövariabeln. sträng

ResourceFile

Namn Beskrivning Värde
autoStorageContainerName Egenskaperna autoStorageContainerName, storageContainerUrl och httpUrl är ömsesidigt uteslutande och en av dem måste anges. sträng
blobPrefix Egenskapen är endast giltig när autoStorageContainerName eller storageContainerUrl används. Det här prefixet kan vara ett partiellt filnamn eller en underkatalog. Om inget prefix har angetts laddas alla filer i containern ned. sträng
fileMode Den här egenskapen gäller endast filer som laddas ned till Linux-beräkningsnoder. Den ignoreras om den har angetts för en resourceFile som laddas ned till en Windows-nod. Om den här egenskapen inte har angetts för en Linux-nod tillämpas standardvärdet 0770 på filen. sträng
filePath Om egenskapen httpUrl har angetts krävs filePath och beskriver sökvägen som filen ska laddas ned till, inklusive filnamnet. Om egenskapen autoStorageContainerName eller storageContainerUrl har angetts är filePath valfritt och är den katalog som filerna ska laddas ned till. Om filePath används som en katalog behålls alla katalogstrukturer som redan är associerade med indata i sin helhet och läggs till i den angivna filePath-katalogen. Den angivna relativa sökvägen kan inte bryta sig ut ur aktivitetens arbetskatalog (till exempel med hjälp av ..). sträng
httpUrl Egenskaperna autoStorageContainerName, storageContainerUrl och httpUrl är ömsesidigt uteslutande och en av dem måste anges. Om URL:en är Azure Blob Storage måste den vara läsbar med hjälp av anonym åtkomst. Det innebär att Batch-tjänsten inte visar några autentiseringsuppgifter när bloben laddas ned. Det finns två sätt att hämta en sådan URL för en blob i Azure Storage: inkludera en signatur för delad åtkomst (SAS) som beviljar läsbehörigheter för blobben eller ange ACL för blobben eller dess container för att tillåta offentlig åtkomst. sträng
storageContainerUrl Egenskaperna autoStorageContainerName, storageContainerUrl och httpUrl är ömsesidigt uteslutande och en av dem måste anges. Den här URL:en måste vara läsbar och listbar med hjälp av anonym åtkomst. Det innebär att Batch-tjänsten inte visar några autentiseringsuppgifter när bloben laddas ned. Det finns två sätt att hämta en sådan URL för en blob i Azure Storage: inkludera en signatur för delad åtkomst (SAS) som beviljar läs- och listbehörigheter för bloben eller anger ACL för bloben eller dess container för att tillåta offentlig åtkomst. sträng

UserIdentity

Namn Beskrivning Värde
autoAnvändare Egenskaperna userName och autoUser är ömsesidigt uteslutande. du måste ange en men inte båda. AutoUserSpecification
userName Egenskaperna userName och autoUser är ömsesidigt uteslutande. du måste ange en men inte båda. sträng

AutoUserSpecification

Namn Beskrivning Värde
elevationLevel Standardvärdet är nonAdmin. "Admin"
"NonAdmin"
omfattning Standardvärdet är Pool. Om poolen kör Windows ska värdet Aktivitet anges om striktare isolering mellan aktiviteter krävs. Om uppgiften till exempel muterar registret på ett sätt som kan påverka andra uppgifter, eller om certifikat har angetts i poolen som inte ska vara tillgängliga för normala uppgifter men bör vara tillgängliga genom startaktiviteter. "Pool"
"Uppgift"

TaskSchedulingPolicy

Namn Beskrivning Värde
nodeFillType Hur aktiviteter ska distribueras mellan beräkningsnoder. "Pack"
"Spread" (krävs)

UserAccount

Namn Beskrivning Värde
elevationLevel nonAdmin – Den automatiska användaren är en standardanvändare utan förhöjd åtkomst. admin – Den automatiska användaren är en användare med förhöjd åtkomst och fungerar med fullständig administratörsbehörighet. Standardvärdet är nonAdmin. "Admin"
"NonAdmin"
linuxUserConfiguration Den här egenskapen ignoreras om den anges i en Windows-pool. Om det inte anges skapas användaren med standardalternativen. LinuxUserConfiguration
Namn Namnet på användarkontot. sträng (krävs)
lösenord Lösenordet för användarkontot. sträng (krävs)
windowsUserConfiguration Den här egenskapen kan bara anges om användaren finns i en Windows-pool. Om det inte anges och i en Windows-pool skapas användaren med standardalternativen. WindowsUserConfiguration

LinuxUserConfiguration

Namn Beskrivning Värde
Gid Egenskaperna uid och gid måste anges tillsammans eller inte alls. Om det inte anges väljer det underliggande operativsystemet gid. Int
sshPrivateKey Den privata nyckeln får inte vara lösenordsskyddad. Den privata nyckeln används för att automatiskt konfigurera asymmetrisk nyckelbaserad autentisering för SSH mellan noder i en Linux-pool när poolens enableInterNodeCommunication-egenskap är sann (den ignoreras om enableInterNodeCommunication är falskt). Det gör du genom att placera nyckelparet i användarens .ssh-katalog. Om det inte anges konfigureras inte lösenordsfri SSH mellan noder (ingen ändring av användarens .ssh-katalog görs). sträng
Uid Egenskaperna uid och gid måste anges tillsammans eller inte alls. Om det inte anges väljer det underliggande operativsystemet uid. Int

WindowsUserConfiguration

Namn Beskrivning Värde
loginMode Anger inloggningsläge för användaren. Standardvärdet för VirtualMachineConfiguration-pooler är interaktivt läge och för CloudServiceConfiguration-pooler är batchläge. "Batch"
"Interaktiv"