Microsoft.Batch batchAccounts/pools 2022-10-01
Bicep-resursdefinition
Resurstypen batchAccounts/pooler kan distribueras med åtgärder som mål:
- Resursgrupper – Se resursgruppsdistributionskommandon
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@2022-10-01' = {
name: 'string'
parent: resourceSymbolicName
identity: {
type: 'string'
userAssignedIdentities: {
{customized property}: {}
}
}
properties: {
applicationLicenses: [
'string'
]
applicationPackages: [
{
id: 'string'
version: 'string'
}
]
certificates: [
{
id: 'string'
storeLocation: 'string'
storeName: 'string'
visibility: [
'string'
]
}
]
deploymentConfiguration: {
cloudServiceConfiguration: {
osFamily: 'string'
osVersion: 'string'
}
virtualMachineConfiguration: {
containerConfiguration: {
containerImageNames: [
'string'
]
containerRegistries: [
{
identityReference: {
resourceId: 'string'
}
password: 'string'
registryServer: 'string'
username: 'string'
}
]
type: 'DockerCompatible'
}
dataDisks: [
{
caching: 'string'
diskSizeGB: int
lun: int
storageAccountType: 'string'
}
]
diskEncryptionConfiguration: {
targets: [
'string'
]
}
extensions: [
{
autoUpgradeMinorVersion: bool
name: 'string'
protectedSettings: any()
provisionAfterExtensions: [
'string'
]
publisher: 'string'
settings: any()
type: 'string'
typeHandlerVersion: 'string'
}
]
imageReference: {
id: 'string'
offer: 'string'
publisher: 'string'
sku: 'string'
version: 'string'
}
licenseType: 'string'
nodeAgentSkuId: 'string'
nodePlacementConfiguration: {
policy: 'string'
}
osDisk: {
ephemeralOSDiskSettings: {
placement: 'CacheDisk'
}
}
windowsConfiguration: {
enableAutomaticUpdates: bool
}
}
}
displayName: 'string'
interNodeCommunication: 'string'
metadata: [
{
name: 'string'
value: 'string'
}
]
mountConfiguration: [
{
azureBlobFileSystemConfiguration: {
accountKey: 'string'
accountName: 'string'
blobfuseOptions: 'string'
containerName: 'string'
identityReference: {
resourceId: 'string'
}
relativeMountPath: 'string'
sasKey: 'string'
}
azureFileShareConfiguration: {
accountKey: 'string'
accountName: 'string'
azureFileUrl: 'string'
mountOptions: 'string'
relativeMountPath: 'string'
}
cifsMountConfiguration: {
mountOptions: 'string'
password: 'string'
relativeMountPath: 'string'
source: 'string'
userName: 'string'
}
nfsMountConfiguration: {
mountOptions: 'string'
relativeMountPath: 'string'
source: 'string'
}
}
]
networkConfiguration: {
dynamicVnetAssignmentScope: 'string'
endpointConfiguration: {
inboundNatPools: [
{
backendPort: int
frontendPortRangeEnd: int
frontendPortRangeStart: int
name: 'string'
networkSecurityGroupRules: [
{
access: 'string'
priority: int
sourceAddressPrefix: 'string'
sourcePortRanges: [
'string'
]
}
]
protocol: 'string'
}
]
}
publicIPAddressConfiguration: {
ipAddressIds: [
'string'
]
provision: 'string'
}
subnetId: 'string'
}
scaleSettings: {
autoScale: {
evaluationInterval: 'string'
formula: 'string'
}
fixedScale: {
nodeDeallocationOption: 'string'
resizeTimeout: 'string'
targetDedicatedNodes: int
targetLowPriorityNodes: int
}
}
startTask: {
commandLine: 'string'
containerSettings: {
containerRunOptions: 'string'
imageName: 'string'
registry: {
identityReference: {
resourceId: 'string'
}
password: 'string'
registryServer: 'string'
username: 'string'
}
workingDirectory: 'string'
}
environmentSettings: [
{
name: 'string'
value: 'string'
}
]
maxTaskRetryCount: int
resourceFiles: [
{
autoStorageContainerName: 'string'
blobPrefix: 'string'
fileMode: 'string'
filePath: 'string'
httpUrl: 'string'
identityReference: {
resourceId: 'string'
}
storageContainerUrl: 'string'
}
]
userIdentity: {
autoUser: {
elevationLevel: 'string'
scope: 'string'
}
userName: 'string'
}
waitForSuccess: bool
}
targetNodeCommunicationMode: 'string'
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 |
| identitet | Den typ av identitet som används för Batch-poolen. | BatchPoolIdentity |
| Egenskaper | Egenskaperna som är associerade med poolen. | PoolEgenskaper |
BatchPoolIdentity
| Namn | Beskrivning | Värde |
|---|---|---|
| typ | Den typ av identitet som används för Batch-poolen. | "Ingen" "UserAssigned" (krävs) |
| userAssignedIdentities | Listan över användaridentiteter som är associerade med Batch-poolen. | BatchPoolIdentityUserAssignedIdentiteter |
BatchPoolIdentityUserAssignedIdentiteter
| Namn | Beskrivning | Värde |
|---|---|---|
| {anpassad egenskap} | UserAssignedIdentiteter |
UserAssignedIdentiteter
Det här objektet innehåller inga egenskaper som ska anges under distributionen. Alla egenskaper är ReadOnly.
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. Varning! Den här egenskapen är inaktuell och tas bort efter februari 2024. Använd Azure KeyVault-tillägget i stället. |
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 |
| targetNodeCommunicationMode | Om det utelämnas är standardvärdet Standard. | "Klassisk" "Standard" "Förenklad" |
| 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 |
| Tillägg | Om det anges installeras tilläggen som nämns i den här konfigurationen på varje nod. | VMExtension[] |
| 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) |
| nodePlacementConfiguration | Den här konfigurationen anger regler för hur noder i poolen ska allokeras fysiskt. | NodePlacementConfiguration |
| osDisk | Innehåller konfiguration för tillfälliga OSDisk-inställningar. | OSDisk |
| 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 |
|---|---|---|
| identityReference | Referensen till en användartilldelad identitet som är associerad med Batch-poolen som en beräkningsnod ska använda. | ComputeNodeIdentityReference |
| lösenord | Lösenordet för att logga in på registerservern. | sträng Begränsningar: Känsligt värde. Skicka in som en säker parameter. |
| 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 |
ComputeNodeIdentityReference
| Namn | Beskrivning | Värde |
|---|---|---|
| resourceId | ARM-resurs-ID för den användartilldelade identiteten. | sträng |
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" |
VMExtension
| Namn | Beskrivning | Värde |
|---|---|---|
| autoUpgradeMinorVersion | Anger om tillägget ska använda en nyare delversion om en är tillgänglig vid distributionstillfället. När tillägget har distribuerats uppgraderas dock inte mindre versioner om de inte distribueras om, även med den här egenskapen inställd på true. | Bool |
| Namn | Namnet på tillägget för den virtuella datorn. | sträng (krävs) |
| protectedSettings | Tillägget kan innehålla antingen protectedSettings eller protectedSettingsFromKeyVault eller inga skyddade inställningar alls. | För Bicep kan du använda funktionen any(). |
| provisionAfterExtensions | Samling tilläggsnamn varefter tillägget måste etableras. | string[] |
| förläggare | Namnet på tilläggshanterarens utgivare. | sträng (krävs) |
| Inställningar | JSON-formaterade offentliga inställningar för tillägget. | För Bicep kan du använda funktionen any(). |
| typ | Typ av tillägg. | sträng (krävs) |
| typeHandlerVersion | Versionen av skripthanteraren. | sträng |
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 2022-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 |
NodePlacementConfiguration
| Namn | Beskrivning | Värde |
|---|---|---|
| politik | Allokeringsprincip som används av Batch Service för att etablera noderna. Om det inte anges använder Batch regionalprincipen. | "Regional" "Zonindelad" |
OSDisk
| Namn | Beskrivning | Värde |
|---|---|---|
| tillfälligaOSDiskSettings | Anger tillfälliga diskinställningar för den operativsystemdisk som används av den virtuella datorn. | DiffDiskSettings |
DiffDiskSettings
| Namn | Beskrivning | Värde |
|---|---|---|
| placering | Den här egenskapen kan användas av användaren i begäran för att välja vilken plats operativsystemet ska finnas på. t.ex. cachelagring av diskutrymme för tillfällig OS-disketablering. Mer information om krav för tillfällig os-diskstorlek finns i Krav för tillfälliga os-diskstorlekar för virtuella Windows-datorer på /azure/virtual-machines/windows/ephemeral-os-disks#size-requirements och virtuella Linux-datorer på /azure/virtual-machines/linux/ephemeral-os-disks#size-requirements. | "CacheDisk" |
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 både sasKey och identitet; exakt ett måste anges. | sträng Begränsningar: Känsligt värde. Skicka in som en säker parameter. |
| 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) |
| identityReference | Den här egenskapen är ömsesidigt uteslutande med både accountKey och sasKey; exakt ett måste anges. | ComputeNodeIdentityReference |
| 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 både accountKey och identitet; exakt ett måste anges. | sträng Begränsningar: Känsligt värde. Skicka in som en säker parameter. |
AzureFileShareConfiguration
| Namn | Beskrivning | Värde |
|---|---|---|
| accountKey | Azure Storage-kontonyckeln. | sträng (krävs) Begränsningar: Känsligt värde. Skicka in som en säker parameter. |
| 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) Begränsningar: Känsligt värde. Skicka in som en säker parameter. |
| 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) |
| userName | 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 |
|---|---|---|
| dynamicVnetAssignmentScope | Omfånget för dynamisk vnet-tilldelning. | "jobb" "ingen" |
| 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 oanvänd kapacitet/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 pekar på Azure Blob Storage måste den vara läsbar från beräkningsnoder. Det finns tre 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, använda en hanterad identitet med läsbehörighet eller ange ACL för blobben eller dess container för att tillåta offentlig åtkomst. | sträng |
| identityReference | Referensen till en användartilldelad identitet som är associerad med Batch-poolen som en beräkningsnod ska använda. | ComputeNodeIdentityReference |
| 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 från beräkningsnoder. Det finns tre sätt att hämta en sådan URL för en container i Azure Storage: inkludera en signatur för delad åtkomst (SAS) som beviljar läs- och listbehörigheter för containern, använder en hanterad identitet med läs- och listbehörigheter eller anger ACL för containern 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. Namn kan innehålla alla Unicode-tecken upp till en maximal längd på 20. | sträng (krävs) |
| lösenord | Lösenordet för användarkontot. | sträng (krävs) Begränsningar: Känsligt värde. Skicka in som en säker parameter. |
| 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 Begränsningar: Känsligt värde. Skicka in som en säker parameter. |
| 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
|
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:
- Resursgrupper – Se resursgruppsdistributionskommandon
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": "2022-10-01",
"name": "string",
"identity": {
"type": "string",
"userAssignedIdentities": {
"{customized property}": {}
}
},
"properties": {
"applicationLicenses": [ "string" ],
"applicationPackages": [
{
"id": "string",
"version": "string"
}
],
"certificates": [
{
"id": "string",
"storeLocation": "string",
"storeName": "string",
"visibility": [ "string" ]
}
],
"deploymentConfiguration": {
"cloudServiceConfiguration": {
"osFamily": "string",
"osVersion": "string"
},
"virtualMachineConfiguration": {
"containerConfiguration": {
"containerImageNames": [ "string" ],
"containerRegistries": [
{
"identityReference": {
"resourceId": "string"
},
"password": "string",
"registryServer": "string",
"username": "string"
}
],
"type": "DockerCompatible"
},
"dataDisks": [
{
"caching": "string",
"diskSizeGB": "int",
"lun": "int",
"storageAccountType": "string"
}
],
"diskEncryptionConfiguration": {
"targets": [ "string" ]
},
"extensions": [
{
"autoUpgradeMinorVersion": "bool",
"name": "string",
"protectedSettings": {},
"provisionAfterExtensions": [ "string" ],
"publisher": "string",
"settings": {},
"type": "string",
"typeHandlerVersion": "string"
}
],
"imageReference": {
"id": "string",
"offer": "string",
"publisher": "string",
"sku": "string",
"version": "string"
},
"licenseType": "string",
"nodeAgentSkuId": "string",
"nodePlacementConfiguration": {
"policy": "string"
},
"osDisk": {
"ephemeralOSDiskSettings": {
"placement": "CacheDisk"
}
},
"windowsConfiguration": {
"enableAutomaticUpdates": "bool"
}
}
},
"displayName": "string",
"interNodeCommunication": "string",
"metadata": [
{
"name": "string",
"value": "string"
}
],
"mountConfiguration": [
{
"azureBlobFileSystemConfiguration": {
"accountKey": "string",
"accountName": "string",
"blobfuseOptions": "string",
"containerName": "string",
"identityReference": {
"resourceId": "string"
},
"relativeMountPath": "string",
"sasKey": "string"
},
"azureFileShareConfiguration": {
"accountKey": "string",
"accountName": "string",
"azureFileUrl": "string",
"mountOptions": "string",
"relativeMountPath": "string"
},
"cifsMountConfiguration": {
"mountOptions": "string",
"password": "string",
"relativeMountPath": "string",
"source": "string",
"userName": "string"
},
"nfsMountConfiguration": {
"mountOptions": "string",
"relativeMountPath": "string",
"source": "string"
}
}
],
"networkConfiguration": {
"dynamicVnetAssignmentScope": "string",
"endpointConfiguration": {
"inboundNatPools": [
{
"backendPort": "int",
"frontendPortRangeEnd": "int",
"frontendPortRangeStart": "int",
"name": "string",
"networkSecurityGroupRules": [
{
"access": "string",
"priority": "int",
"sourceAddressPrefix": "string",
"sourcePortRanges": [ "string" ]
}
],
"protocol": "string"
}
]
},
"publicIPAddressConfiguration": {
"ipAddressIds": [ "string" ],
"provision": "string"
},
"subnetId": "string"
},
"scaleSettings": {
"autoScale": {
"evaluationInterval": "string",
"formula": "string"
},
"fixedScale": {
"nodeDeallocationOption": "string",
"resizeTimeout": "string",
"targetDedicatedNodes": "int",
"targetLowPriorityNodes": "int"
}
},
"startTask": {
"commandLine": "string",
"containerSettings": {
"containerRunOptions": "string",
"imageName": "string",
"registry": {
"identityReference": {
"resourceId": "string"
},
"password": "string",
"registryServer": "string",
"username": "string"
},
"workingDirectory": "string"
},
"environmentSettings": [
{
"name": "string",
"value": "string"
}
],
"maxTaskRetryCount": "int",
"resourceFiles": [
{
"autoStorageContainerName": "string",
"blobPrefix": "string",
"fileMode": "string",
"filePath": "string",
"httpUrl": "string",
"identityReference": {
"resourceId": "string"
},
"storageContainerUrl": "string"
}
],
"userIdentity": {
"autoUser": {
"elevationLevel": "string",
"scope": "string"
},
"userName": "string"
},
"waitForSuccess": "bool"
},
"targetNodeCommunicationMode": "string",
"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 | '2022-10-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. |
| identitet | Den typ av identitet som används för Batch-poolen. | BatchPoolIdentity |
| Egenskaper | Egenskaperna som är associerade med poolen. | PoolEgenskaper |
BatchPoolIdentity
| Namn | Beskrivning | Värde |
|---|---|---|
| typ | Den typ av identitet som används för Batch-poolen. | "Ingen" "UserAssigned" (krävs) |
| userAssignedIdentities | Listan över användaridentiteter som är associerade med Batch-poolen. | BatchPoolIdentityUserAssignedIdentiteter |
BatchPoolIdentityUserAssignedIdentiteter
| Namn | Beskrivning | Värde |
|---|---|---|
| {anpassad egenskap} | UserAssignedIdentiteter |
UserAssignedIdentiteter
Det här objektet innehåller inga egenskaper som ska anges under distributionen. Alla egenskaper är ReadOnly.
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. Varning! Den här egenskapen är inaktuell och tas bort efter februari 2024. Använd Azure KeyVault-tillägget i stället. |
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 |
| targetNodeCommunicationMode | Om det utelämnas är standardvärdet Standard. | "Klassisk" "Standard" "Förenklad" |
| 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 |
| Tillägg | Om det anges installeras tilläggen som nämns i den här konfigurationen på varje nod. | VMExtension[] |
| 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) |
| nodePlacementConfiguration | Den här konfigurationen anger regler för hur noder i poolen ska allokeras fysiskt. | NodePlacementConfiguration |
| osDisk | Innehåller konfiguration för tillfälliga OSDisk-inställningar. | OSDisk |
| 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 |
|---|---|---|
| identityReference | Referensen till en användartilldelad identitet som är associerad med Batch-poolen som en beräkningsnod ska använda. | ComputeNodeIdentityReference |
| lösenord | Lösenordet för att logga in på registerservern. | sträng Begränsningar: Känsligt värde. Skicka in som en säker parameter. |
| 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 |
ComputeNodeIdentityReference
| Namn | Beskrivning | Värde |
|---|---|---|
| resourceId | ARM-resurs-ID för den användartilldelade identiteten. | sträng |
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" |
VMExtension
| Namn | Beskrivning | Värde |
|---|---|---|
| autoUpgradeMinorVersion | Anger om tillägget ska använda en nyare delversion om en är tillgänglig vid distributionstillfället. När tillägget har distribuerats uppgraderas dock inte mindre versioner om de inte distribueras om, även med den här egenskapen inställd på true. | Bool |
| Namn | Namnet på tillägget för den virtuella datorn. | sträng (krävs) |
| protectedSettings | Tillägget kan innehålla antingen protectedSettings eller protectedSettingsFromKeyVault eller inga skyddade inställningar alls. | |
| provisionAfterExtensions | Samling tilläggsnamn varefter tillägget måste etableras. | string[] |
| förläggare | Namnet på tilläggshanterarens utgivare. | sträng (krävs) |
| Inställningar | JSON-formaterade offentliga inställningar för tillägget. | |
| typ | Typ av tillägg. | sträng (krävs) |
| typeHandlerVersion | Versionen av skripthanteraren. | sträng |
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 2022-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 |
NodePlacementConfiguration
| Namn | Beskrivning | Värde |
|---|---|---|
| politik | Allokeringsprincip som används av Batch Service för att etablera noderna. Om det inte anges använder Batch regionalprincipen. | "Regional" "Zonindelad" |
OSDisk
| Namn | Beskrivning | Värde |
|---|---|---|
| tillfälligaOSDiskSettings | Anger tillfälliga diskinställningar för den operativsystemdisk som används av den virtuella datorn. | DiffDiskSettings |
DiffDiskSettings
| Namn | Beskrivning | Värde |
|---|---|---|
| placering | Den här egenskapen kan användas av användaren i begäran för att välja vilken plats operativsystemet ska finnas på. t.ex. cachelagring av diskutrymme för tillfällig OS-disketablering. Mer information om krav för tillfällig os-diskstorlek finns i Krav för tillfälliga os-diskstorlekar för virtuella Windows-datorer på /azure/virtual-machines/windows/ephemeral-os-disks#size-requirements och virtuella Linux-datorer på /azure/virtual-machines/linux/ephemeral-os-disks#size-requirements. | "CacheDisk" |
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 både sasKey och identitet; exakt ett måste anges. | sträng Begränsningar: Känsligt värde. Skicka in som en säker parameter. |
| 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) |
| identityReference | Den här egenskapen är ömsesidigt uteslutande med både accountKey och sasKey; exakt ett måste anges. | ComputeNodeIdentityReference |
| 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 både accountKey och identitet; exakt ett måste anges. | sträng Begränsningar: Känsligt värde. Skicka in som en säker parameter. |
AzureFileShareConfiguration
| Namn | Beskrivning | Värde |
|---|---|---|
| accountKey | Azure Storage-kontonyckeln. | sträng (krävs) Begränsningar: Känsligt värde. Skicka in som en säker parameter. |
| 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) Begränsningar: Känsligt värde. Skicka in som en säker parameter. |
| 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) |
| userName | 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 |
|---|---|---|
| dynamicVnetAssignmentScope | Omfånget för dynamisk vnet-tilldelning. | "jobb" "ingen" |
| 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 oanvänd kapacitet/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 pekar på Azure Blob Storage måste den vara läsbar från beräkningsnoder. Det finns tre 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, använda en hanterad identitet med läsbehörighet eller ange ACL för blobben eller dess container för att tillåta offentlig åtkomst. | sträng |
| identityReference | Referensen till en användartilldelad identitet som är associerad med Batch-poolen som en beräkningsnod ska använda. | ComputeNodeIdentityReference |
| 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 från beräkningsnoder. Det finns tre sätt att hämta en sådan URL för en container i Azure Storage: inkludera en signatur för delad åtkomst (SAS) som beviljar läs- och listbehörigheter för containern, använder en hanterad identitet med läs- och listbehörigheter eller anger ACL för containern 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. Namn kan innehålla alla Unicode-tecken upp till en maximal längd på 20. | sträng (krävs) |
| lösenord | Lösenordet för användarkontot. | sträng (krävs) Begränsningar: Känsligt värde. Skicka in som en säker parameter. |
| 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 Begränsningar: Känsligt värde. Skicka in som en säker parameter. |
| 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
|
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@2022-10-01"
name = "string"
parent_id = "string"
identity {
type = "UserAssigned"
identity_ids = []
}
body = jsonencode({
properties = {
applicationLicenses = [
"string"
]
applicationPackages = [
{
id = "string"
version = "string"
}
]
certificates = [
{
id = "string"
storeLocation = "string"
storeName = "string"
visibility = [
"string"
]
}
]
deploymentConfiguration = {
cloudServiceConfiguration = {
osFamily = "string"
osVersion = "string"
}
virtualMachineConfiguration = {
containerConfiguration = {
containerImageNames = [
"string"
]
containerRegistries = [
{
identityReference = {
resourceId = "string"
}
password = "string"
registryServer = "string"
username = "string"
}
]
type = "DockerCompatible"
}
dataDisks = [
{
caching = "string"
diskSizeGB = int
lun = int
storageAccountType = "string"
}
]
diskEncryptionConfiguration = {
targets = [
"string"
]
}
extensions = [
{
autoUpgradeMinorVersion = bool
name = "string"
provisionAfterExtensions = [
"string"
]
publisher = "string"
type = "string"
typeHandlerVersion = "string"
}
]
imageReference = {
id = "string"
offer = "string"
publisher = "string"
sku = "string"
version = "string"
}
licenseType = "string"
nodeAgentSkuId = "string"
nodePlacementConfiguration = {
policy = "string"
}
osDisk = {
ephemeralOSDiskSettings = {
placement = "CacheDisk"
}
}
windowsConfiguration = {
enableAutomaticUpdates = bool
}
}
}
displayName = "string"
interNodeCommunication = "string"
metadata = [
{
name = "string"
value = "string"
}
]
mountConfiguration = [
{
azureBlobFileSystemConfiguration = {
accountKey = "string"
accountName = "string"
blobfuseOptions = "string"
containerName = "string"
identityReference = {
resourceId = "string"
}
relativeMountPath = "string"
sasKey = "string"
}
azureFileShareConfiguration = {
accountKey = "string"
accountName = "string"
azureFileUrl = "string"
mountOptions = "string"
relativeMountPath = "string"
}
cifsMountConfiguration = {
mountOptions = "string"
password = "string"
relativeMountPath = "string"
source = "string"
userName = "string"
}
nfsMountConfiguration = {
mountOptions = "string"
relativeMountPath = "string"
source = "string"
}
}
]
networkConfiguration = {
dynamicVnetAssignmentScope = "string"
endpointConfiguration = {
inboundNatPools = [
{
backendPort = int
frontendPortRangeEnd = int
frontendPortRangeStart = int
name = "string"
networkSecurityGroupRules = [
{
access = "string"
priority = int
sourceAddressPrefix = "string"
sourcePortRanges = [
"string"
]
}
]
protocol = "string"
}
]
}
publicIPAddressConfiguration = {
ipAddressIds = [
"string"
]
provision = "string"
}
subnetId = "string"
}
scaleSettings = {
autoScale = {
evaluationInterval = "string"
formula = "string"
}
fixedScale = {
nodeDeallocationOption = "string"
resizeTimeout = "string"
targetDedicatedNodes = int
targetLowPriorityNodes = int
}
}
startTask = {
commandLine = "string"
containerSettings = {
containerRunOptions = "string"
imageName = "string"
registry = {
identityReference = {
resourceId = "string"
}
password = "string"
registryServer = "string"
username = "string"
}
workingDirectory = "string"
}
environmentSettings = [
{
name = "string"
value = "string"
}
]
maxTaskRetryCount = int
resourceFiles = [
{
autoStorageContainerName = "string"
blobPrefix = "string"
fileMode = "string"
filePath = "string"
httpUrl = "string"
identityReference = {
resourceId = "string"
}
storageContainerUrl = "string"
}
]
userIdentity = {
autoUser = {
elevationLevel = "string"
scope = "string"
}
userName = "string"
}
waitForSuccess = bool
}
targetNodeCommunicationMode = "string"
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@2022-10-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 |
| identitet | Den typ av identitet som används för Batch-poolen. | BatchPoolIdentity |
| Egenskaper | Egenskaperna som är associerade med poolen. | PoolEgenskaper |
BatchPoolIdentity
| Namn | Beskrivning | Värde |
|---|---|---|
| typ | Den typ av identitet som används för Batch-poolen. | "UserAssigned" (krävs) |
| identity_ids | Listan över användaridentiteter som är associerade med Batch-poolen. | Matris med användaridentitets-ID:t. |
BatchPoolIdentityUserAssignedIdentiteter
| Namn | Beskrivning | Värde |
|---|---|---|
| {anpassad egenskap} | UserAssignedIdentiteter |
UserAssignedIdentiteter
Det här objektet innehåller inga egenskaper som ska anges under distributionen. Alla egenskaper är ReadOnly.
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. Varning! Den här egenskapen är inaktuell och tas bort efter februari 2024. Använd Azure KeyVault-tillägget i stället. |
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 |
| targetNodeCommunicationMode | Om det utelämnas är standardvärdet Standard. | "Klassisk" "Standard" "Förenklad" |
| 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 |
| Tillägg | Om det anges installeras tilläggen som nämns i den här konfigurationen på varje nod. | VMExtension[] |
| 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) |
| nodePlacementConfiguration | Den här konfigurationen anger regler för hur noder i poolen ska allokeras fysiskt. | NodePlacementConfiguration |
| osDisk | Innehåller konfiguration för tillfälliga OSDisk-inställningar. | OSDisk |
| 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 |
|---|---|---|
| identityReference | Referensen till en användartilldelad identitet som är associerad med Batch-poolen som en beräkningsnod ska använda. | ComputeNodeIdentityReference |
| lösenord | Lösenordet för att logga in på registerservern. | sträng Begränsningar: Känsligt värde. Skicka in som en säker parameter. |
| 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 |
ComputeNodeIdentityReference
| Namn | Beskrivning | Värde |
|---|---|---|
| resourceId | ARM-resurs-ID för den användartilldelade identiteten. | sträng |
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" |
VMExtension
| Namn | Beskrivning | Värde |
|---|---|---|
| autoUpgradeMinorVersion | Anger om tillägget ska använda en nyare delversion om en är tillgänglig vid distributionstillfället. När tillägget har distribuerats uppgraderas dock inte mindre versioner om de inte distribueras om, även med den här egenskapen inställd på true. | Bool |
| Namn | Namnet på tillägget för den virtuella datorn. | sträng (krävs) |
| protectedSettings | Tillägget kan innehålla antingen protectedSettings eller protectedSettingsFromKeyVault eller inga skyddade inställningar alls. | |
| provisionAfterExtensions | Samling tilläggsnamn varefter tillägget måste etableras. | string[] |
| förläggare | Namnet på tilläggshanterarens utgivare. | sträng (krävs) |
| Inställningar | JSON-formaterade offentliga inställningar för tillägget. | |
| typ | Typ av tillägg. | sträng (krävs) |
| typeHandlerVersion | Versionen av skripthanteraren. | sträng |
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 2022-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 |
NodePlacementConfiguration
| Namn | Beskrivning | Värde |
|---|---|---|
| politik | Allokeringsprincip som används av Batch Service för att etablera noderna. Om det inte anges använder Batch regionalprincipen. | "Regional" "Zonindelad" |
OSDisk
| Namn | Beskrivning | Värde |
|---|---|---|
| tillfälligaOSDiskSettings | Anger tillfälliga diskinställningar för den operativsystemdisk som används av den virtuella datorn. | DiffDiskSettings |
DiffDiskSettings
| Namn | Beskrivning | Värde |
|---|---|---|
| placering | Den här egenskapen kan användas av användaren i begäran för att välja vilken plats operativsystemet ska finnas på. t.ex. cachelagring av diskutrymme för tillfällig OS-disketablering. Mer information om krav för tillfällig os-diskstorlek finns i Krav för tillfälliga os-diskstorlekar för virtuella Windows-datorer på /azure/virtual-machines/windows/ephemeral-os-disks#size-requirements och virtuella Linux-datorer på /azure/virtual-machines/linux/ephemeral-os-disks#size-requirements. | "CacheDisk" |
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 både sasKey och identitet; exakt ett måste anges. | sträng Begränsningar: Känsligt värde. Skicka in som en säker parameter. |
| 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) |
| identityReference | Den här egenskapen är ömsesidigt uteslutande med både accountKey och sasKey; exakt ett måste anges. | ComputeNodeIdentityReference |
| 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 både accountKey och identitet; exakt ett måste anges. | sträng Begränsningar: Känsligt värde. Skicka in som en säker parameter. |
AzureFileShareConfiguration
| Namn | Beskrivning | Värde |
|---|---|---|
| accountKey | Azure Storage-kontonyckeln. | sträng (krävs) Begränsningar: Känsligt värde. Skicka in som en säker parameter. |
| 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) Begränsningar: Känsligt värde. Skicka in som en säker parameter. |
| 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) |
| userName | 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 |
|---|---|---|
| dynamicVnetAssignmentScope | Omfånget för dynamisk vnet-tilldelning. | "jobb" "ingen" |
| 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 oanvänd kapacitet/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 pekar på Azure Blob Storage måste den vara läsbar från beräkningsnoder. Det finns tre 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, använda en hanterad identitet med läsbehörighet eller ange ACL för blobben eller dess container för att tillåta offentlig åtkomst. | sträng |
| identityReference | Referensen till en användartilldelad identitet som är associerad med Batch-poolen som en beräkningsnod ska använda. | ComputeNodeIdentityReference |
| 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 från beräkningsnoder. Det finns tre sätt att hämta en sådan URL för en container i Azure Storage: inkludera en signatur för delad åtkomst (SAS) som beviljar läs- och listbehörigheter för containern, använder en hanterad identitet med läs- och listbehörigheter eller anger ACL för containern 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. Namn kan innehålla alla Unicode-tecken upp till en maximal längd på 20. | sträng (krävs) |
| lösenord | Lösenordet för användarkontot. | sträng (krävs) Begränsningar: Känsligt värde. Skicka in som en säker parameter. |
| 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 Begränsningar: Känsligt värde. Skicka in som en säker parameter. |
| 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" |