Pool - Create
Skapar en ny pool i det angivna kontot.
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Batch/batchAccounts/{accountName}/pools/{poolName}?api-version=2025-06-01
URI-parametrar
| Namn | I | Krävs | Typ | Beskrivning |
|---|---|---|---|---|
|
account
|
path | True |
string minLength: 3maxLength: 24 pattern: ^[a-zA-Z0-9]+$ |
Ett namn för batchkontot som måste vara unikt inom regionen. Batchkontonamn måste vara mellan 3 och 24 tecken långa och endast använda siffror och gemener. Detta namn används som en del av DNS-namnet som används för att komma åt Batch-tjänsten i den region där kontot skapas. Till exempel: |
|
pool
|
path | True |
string minLength: 1maxLength: 64 pattern: ^[a-zA-Z0-9_-]+$ |
Poolnamnet. Detta måste vara unikt i kontot. |
|
resource
|
path | True |
string minLength: 1maxLength: 90 |
Namnet på resursgruppen. Namnet är skiftlägesokänsligt. |
|
subscription
|
path | True |
string (uuid) |
ID för målprenumerationen. Värdet måste vara ett UUID. |
|
api-version
|
query | True |
string minLength: 1 |
Den API-version som ska användas för den här åtgärden. |
Begäran-huvud
| Namn | Krävs | Typ | Beskrivning |
|---|---|---|---|
| If-Match |
string |
Den entitetstillståndsversion (ETag) av poolen som ska uppdateras. Värdet "*" kan endast användas för att tillämpa åtgärden om poolen redan finns. Om den utelämnas tillämpas alltid den här åtgärden. |
|
| If-None-Match |
string |
Ange till *för att tillåta att en ny pool skapas, men för att förhindra uppdatering av en befintlig pool. Andra värden ignoreras. |
Begäranarorgan
| Namn | Typ | Beskrivning |
|---|---|---|
| identity |
Den typ av identitet som används för Batch-poolen. |
|
| properties.applicationPackages |
Listan över programpaket som ska installeras på varje beräkningsnod i poolen. |
|
| properties.deploymentConfiguration |
Den här egenskapen beskriver de virtuella datorer som poolnoderna ska distribueras på. |
|
| properties.displayName |
string |
Visningsnamnet för poolen. |
| properties.interNodeCommunication |
Om poolen tillåter direkt kommunikation mellan noder. |
|
| properties.metadata |
En lista över namn/värde-par som är associerade med poolen som metadata. |
|
| properties.mountConfiguration |
En lista över filsystem som ska monteras på varje nod i poolen. |
|
| properties.networkConfiguration |
Nätverkskonfigurationen för poolen. |
|
| properties.scaleSettings |
Inställningar som konfigurerar antalet noder i poolen. |
|
| properties.startTask |
En uppgift som har angetts för att köras på varje beräkningsnod när den ansluter till poolen. |
|
| properties.taskSchedulingPolicy |
Hur aktiviteter distribueras mellan beräkningsnoder i en pool. |
|
| properties.taskSlotsPerNode |
integer (int32) |
Antalet aktivitetsfack som kan användas för att köra samtidiga uppgifter på en enda beräkningsnod i poolen. |
| properties.upgradePolicy |
Uppgraderingsprincipen för poolen. |
|
| properties.userAccounts |
Listan över användarkonton som ska skapas på varje nod i poolen. |
|
| properties.vmSize |
string |
Storleken på virtuella datorer i poolen. Alla virtuella datorer i en pool har samma storlek. |
| tags |
object |
Taggarna för resursen. |
Svaren
| Namn | Typ | Beskrivning |
|---|---|---|
| 200 OK |
Begäran har slutförts. Headers ETag: string |
|
| Other Status Codes |
Ett oväntat felsvar. |
Säkerhet
azure_auth
Azure Active Directory OAuth2-flöde.
Typ:
oauth2
Rinna:
implicit
Auktorisations-URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scope
| Namn | Beskrivning |
|---|---|
| user_impersonation | personifiera ditt användarkonto |
Exempel
CreatePool - accelerated networking
Exempelförfrågan
PUT https://management.azure.com/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/sampleacct/pools/testpool?api-version=2025-06-01
{
"properties": {
"deploymentConfiguration": {
"virtualMachineConfiguration": {
"imageReference": {
"offer": "WindowsServer",
"publisher": "MicrosoftWindowsServer",
"sku": "2016-datacenter-smalldisk",
"version": "latest"
},
"nodeAgentSkuId": "batch.node.windows amd64"
}
},
"networkConfiguration": {
"enableAcceleratedNetworking": true,
"subnetId": "/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/rg1234/providers/Microsoft.Network/virtualNetworks/network1234/subnets/subnet123"
},
"scaleSettings": {
"fixedScale": {
"targetDedicatedNodes": 1,
"targetLowPriorityNodes": 0
}
},
"vmSize": "STANDARD_D1_V2"
}
}
Exempelsvar
ETag: W/"0x8DB46CB72A227E2"
{
"name": "testpool",
"type": "Microsoft.Batch/batchAccounts/pools",
"id": "/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/sampleacct/pools/testpool",
"properties": {
"allocationState": "Steady",
"allocationStateTransitionTime": "2023-04-27T03:00:34.0646502Z",
"creationTime": "2023-04-27T02:59:41.8592226Z",
"currentDedicatedNodes": 1,
"currentLowPriorityNodes": 0,
"deploymentConfiguration": {
"virtualMachineConfiguration": {
"imageReference": {
"offer": "WindowsServer",
"publisher": "MicrosoftWindowsServer",
"sku": "2016-datacenter-smalldisk",
"version": "latest"
},
"nodeAgentSkuId": "batch.node.windows amd64"
}
},
"interNodeCommunication": "Disabled",
"lastModified": "2023-04-27T02:59:41.8592226Z",
"networkConfiguration": {
"dynamicVnetAssignmentScope": "none",
"enableAcceleratedNetworking": true,
"subnetId": "/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/rg1234/providers/Microsoft.Network/virtualNetworks/network1234/subnets/subnet123"
},
"provisioningState": "Succeeded",
"provisioningStateTransitionTime": "2023-04-27T02:59:41.8592226Z",
"resizeOperationStatus": {
"nodeDeallocationOption": "Requeue",
"resizeTimeout": "PT15M",
"startTime": "2023-04-27T02:59:41.8592226Z",
"targetDedicatedNodes": 1
},
"scaleSettings": {
"fixedScale": {
"resizeTimeout": "PT15M",
"targetDedicatedNodes": 1,
"targetLowPriorityNodes": 0
}
},
"taskSchedulingPolicy": {
"nodeFillType": "Spread"
},
"taskSlotsPerNode": 1,
"vmSize": "STANDARD_D1_V2"
}
}
CreatePool - confidential disk encryption set for user subscription accounts
Exempelförfrågan
PUT https://management.azure.com/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/sampleacct/pools/testpool?api-version=2025-06-01
{
"properties": {
"vmSize": "Standard_DC2as_v5",
"taskSchedulingPolicy": {
"nodeFillType": "Pack"
},
"deploymentConfiguration": {
"virtualMachineConfiguration": {
"imageReference": {
"publisher": "MicrosoftWindowsServer",
"offer": "WindowsServer",
"sku": "2019-datacenter-core-g2",
"version": "latest"
},
"nodeAgentSkuId": "batch.node.windows amd64",
"securityProfile": {
"securityType": "confidentialVM",
"encryptionAtHost": false,
"uefiSettings": {
"vTpmEnabled": true,
"secureBootEnabled": true
}
},
"osDisk": {
"managedDisk": {
"storageAccountType": "Standard_LRS",
"diskEncryptionSet": {
"id": "/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Compute/diskEncryptionSets/DiskEncryptionSetId"
},
"securityProfile": {
"securityEncryptionType": "DiskWithVMGuestState",
"diskEncryptionSet": {
"id": "/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Compute/diskEncryptionSets/ConfidentialDiskEncryptionSetId"
}
}
}
},
"dataDisks": [
{
"lun": 0,
"diskSizeGB": 1024,
"managedDisk": {
"storageAccountType": "Standard_LRS",
"diskEncryptionSet": {
"id": "/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Compute/diskEncryptionSets/DiskEncryptionSetId"
}
}
}
]
}
},
"scaleSettings": {
"fixedScale": {
"targetDedicatedNodes": 1,
"resizeTimeout": "PT15M"
}
}
}
}
Exempelsvar
ETag: W/"0x8D4EDFEBFADF4AB"
{
"id": "/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/sampleacct/pools/testpool",
"name": "testpool",
"type": "Microsoft.Batch/batchAccounts/pools",
"etag": "W/\"0x8D4EDFEBFADF4AB\"",
"properties": {
"lastModified": "2025-06-30T07:30:49.7522647Z",
"creationTime": "2025-06-30T07:30:49.7522634Z",
"provisioningState": "Succeeded",
"provisioningStateTransitionTime": "2025-06-30T07:30:49.7522634Z",
"allocationState": "Resizing",
"allocationStateTransitionTime": "2025-06-30T07:30:49.7522647Z",
"vmSize": "STANDARD_DC2as_v5",
"interNodeCommunication": "Disabled",
"taskSlotsPerNode": 1,
"taskSchedulingPolicy": {
"nodeFillType": "Pack",
"jobDefaultOrder": "None"
},
"deploymentConfiguration": {
"virtualMachineConfiguration": {
"imageReference": {
"publisher": "MicrosoftWindowsServer",
"offer": "WindowsServer",
"sku": "2019-datacenter-core-g2",
"version": "latest"
},
"nodeAgentSkuId": "batch.node.windows amd64",
"dataDisks": [
{
"lun": 0,
"caching": "None",
"diskSizeGB": 1024,
"managedDisk": {
"storageAccountType": "Standard_LRS",
"diskEncryptionSet": {
"id": "/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Compute/diskEncryptionSets/DiskEncryptionSetId"
}
}
}
],
"osDisk": {
"caching": "None",
"managedDisk": {
"storageAccountType": "Standard_LRS",
"securityProfile": {
"securityEncryptionType": "DiskWithVMGuestState",
"diskEncryptionSet": {
"id": "/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Compute/diskEncryptionSets/ConfidentialDiskEncryptionSetId"
}
},
"diskEncryptionSet": {
"id": "/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Compute/diskEncryptionSets/DiskEncryptionSetId"
}
}
},
"securityProfile": {
"securityType": "confidentialVM",
"encryptionAtHost": false,
"uefiSettings": {
"secureBootEnabled": true,
"vTpmEnabled": true
}
}
}
},
"scaleSettings": {
"fixedScale": {
"targetDedicatedNodes": 1,
"targetLowPriorityNodes": 0,
"resizeTimeout": "PT15M"
}
},
"resizeOperationStatus": {
"targetDedicatedNodes": 1,
"nodeDeallocationOption": "Requeue",
"resizeTimeout": "PT15M",
"startTime": "2025-06-30T07:30:49.7522324Z"
},
"currentDedicatedNodes": 0,
"currentLowPriorityNodes": 0
}
}
CreatePool - Custom Image
Exempelförfrågan
PUT https://management.azure.com/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/sampleacct/pools/testpool?api-version=2025-06-01
{
"properties": {
"deploymentConfiguration": {
"virtualMachineConfiguration": {
"imageReference": {
"id": "/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/networking-group/providers/Microsoft.Compute/galleries/testgallery/images/testimagedef/versions/0.0.1"
},
"nodeAgentSkuId": "batch.node.ubuntu 18.04"
}
},
"vmSize": "STANDARD_D4"
}
}
Exempelsvar
ETag: W/"0x8D4EDFEBFADF4AB"
{
"name": "testpool",
"type": "Microsoft.Batch/batchAccounts/pools",
"id": "/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/sampleacct/pools/testpool",
"properties": {
"allocationState": "Steady",
"allocationStateTransitionTime": "2017-08-28T10:22:55.9407275Z",
"creationTime": "2017-08-28T10:22:55.9407275Z",
"currentDedicatedNodes": 0,
"currentLowPriorityNodes": 0,
"deploymentConfiguration": {
"virtualMachineConfiguration": {
"imageReference": {
"id": "/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/networking-group/providers/Microsoft.Compute/galleries/testgallery/images/testimagedef/versions/0.0.1"
},
"nodeAgentSkuId": "batch.node.ubuntu 18.04"
}
},
"interNodeCommunication": "Disabled",
"lastModified": "2017-08-28T10:22:55.9407275Z",
"provisioningState": "Succeeded",
"provisioningStateTransitionTime": "2017-08-28T10:22:55.9407275Z",
"scaleSettings": {
"fixedScale": {
"targetDedicatedNodes": 0,
"targetLowPriorityNodes": 0
}
},
"taskSchedulingPolicy": {
"nodeFillType": "Spread"
},
"taskSlotsPerNode": 1,
"vmSize": "STANDARD_D4"
}
}
CreatePool - customer managed key for Batch managed accounts
Exempelförfrågan
PUT https://management.azure.com/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/sampleacct/pools/testpool?api-version=2025-06-01
{
"properties": {
"vmSize": "Standard_D4ds_v5",
"deploymentConfiguration": {
"virtualMachineConfiguration": {
"imageReference": {
"sku": "2022-Datacenter",
"publisher": "MicrosoftWindowsServer",
"version": "latest",
"offer": "WindowsServer"
},
"nodeAgentSkuId": "batch.node.windows amd64",
"diskEncryptionConfiguration": {
"targets": [
"OsDisk"
],
"customerManagedKey": {
"keyUrl": "http://sample.vault.azure.net//keys/cmk/bb60031a6d4545d3a60d3f94588538c9",
"identityReference": {
"resourceId": "/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.ManagedIdentity/userAssignedIdentities/id1"
}
}
}
}
},
"scaleSettings": {
"fixedScale": {
"targetDedicatedNodes": 1,
"resizeTimeout": "PT15M"
}
}
},
"identity": {
"type": "UserAssigned",
"userAssignedIdentities": {
"/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.ManagedIdentity/userAssignedIdentities/id1": {}
}
}
}
Exempelsvar
ETag: W/"0x8D4EDFEBFADF4AB"
{
"identity": {
"type": "UserAssigned",
"userAssignedIdentities": {
"/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.ManagedIdentity/userAssignedIdentities/id1": {
"principalId": "principalId",
"clientId": "clientId"
}
}
},
"id": "/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/sampleacct/pools/testpool",
"name": "testpool",
"type": "Microsoft.Batch/batchAccounts/pools",
"etag": "W/\"0x8D4EDFEBFADF4AB\"",
"properties": {
"lastModified": "2025-06-30T07:16:33.4309281Z",
"creationTime": "2025-06-30T07:16:33.4309266Z",
"provisioningState": "Succeeded",
"provisioningStateTransitionTime": "2025-06-30T07:16:33.4309266Z",
"allocationState": "Resizing",
"allocationStateTransitionTime": "2025-06-30T07:16:33.4309281Z",
"vmSize": "Standard_D4ds_v5",
"interNodeCommunication": "Disabled",
"taskSlotsPerNode": 1,
"taskSchedulingPolicy": {
"nodeFillType": "Spread",
"jobDefaultOrder": "None"
},
"deploymentConfiguration": {
"virtualMachineConfiguration": {
"imageReference": {
"publisher": "MicrosoftWindowsServer",
"offer": "WindowsServer",
"sku": "2022-Datacenter",
"version": "latest"
},
"nodeAgentSkuId": "batch.node.windows amd64",
"diskEncryptionConfiguration": {
"targets": [
"OsDisk"
],
"customerManagedKey": {
"keyUrl": "http://sample.vault.azure.net//keys/cmk/bb60031a6d4545d3a60d3f94588538c9",
"identityReference": {
"resourceId": "/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.ManagedIdentity/userAssignedIdentities/id1"
}
}
}
}
},
"scaleSettings": {
"fixedScale": {
"targetDedicatedNodes": 1,
"targetLowPriorityNodes": 0,
"resizeTimeout": "PT15M"
}
},
"resizeOperationStatus": {
"targetDedicatedNodes": 1,
"nodeDeallocationOption": "Requeue",
"resizeTimeout": "PT15M",
"startTime": "2025-06-30T07:16:33.4309126Z"
},
"currentDedicatedNodes": 0,
"currentLowPriorityNodes": 0
}
}
CreatePool - disk encryption set for user subscription accounts
Exempelförfrågan
PUT https://management.azure.com/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/sampleacct/pools/testpool?api-version=2025-06-01
{
"properties": {
"vmSize": "Standard_D4ds_v5",
"taskSchedulingPolicy": {
"nodeFillType": "Pack"
},
"deploymentConfiguration": {
"virtualMachineConfiguration": {
"imageReference": {
"sku": "2022-Datacenter",
"publisher": "MicrosoftWindowsServer",
"version": "latest",
"offer": "WindowsServer"
},
"nodeAgentSkuId": "batch.node.windows amd64",
"securityProfile": {
"encryptionAtHost": false
},
"osDisk": {
"managedDisk": {
"storageAccountType": "Standard_LRS",
"diskEncryptionSet": {
"id": "/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Compute/diskEncryptionSets/DiskEncryptionSetId"
}
}
}
}
},
"scaleSettings": {
"fixedScale": {
"targetDedicatedNodes": 1,
"resizeTimeout": "PT15M"
}
}
}
}
Exempelsvar
ETag: W/"0x8D4EDFEBFADF4AB"
{
"id": "/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/sampleacct/pools/testpool",
"name": "testpool",
"type": "Microsoft.Batch/batchAccounts/pools",
"etag": "W/\"0x8D4EDFEBFADF4AB\"",
"properties": {
"lastModified": "2025-06-30T07:45:46.1580726Z",
"creationTime": "2025-06-30T07:35:44.5579791Z",
"provisioningState": "Succeeded",
"provisioningStateTransitionTime": "2025-06-30T07:35:44.5579791Z",
"allocationState": "Resizing",
"allocationStateTransitionTime": "2025-06-30T07:45:46.1580727Z",
"vmSize": "Standard_D4ds_v5",
"interNodeCommunication": "Disabled",
"taskSlotsPerNode": 1,
"taskSchedulingPolicy": {
"nodeFillType": "Pack",
"jobDefaultOrder": "None"
},
"deploymentConfiguration": {
"virtualMachineConfiguration": {
"imageReference": {
"publisher": "MicrosoftWindowsServer",
"offer": "WindowsServer",
"sku": "2022-Datacenter",
"version": "latest"
},
"nodeAgentSkuId": "batch.node.windows amd64",
"osDisk": {
"caching": "None",
"managedDisk": {
"storageAccountType": "Standard_LRS",
"diskEncryptionSet": {
"id": "/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Compute/diskEncryptionSets/DiskEncryptionSetId"
}
}
},
"securityProfile": {
"encryptionAtHost": false
}
}
},
"scaleSettings": {
"fixedScale": {
"targetDedicatedNodes": 1,
"targetLowPriorityNodes": 0,
"resizeTimeout": "PT15M"
}
},
"resizeOperationStatus": {
"targetDedicatedNodes": 1,
"nodeDeallocationOption": "Requeue",
"resizeTimeout": "PT15M",
"startTime": "2025-06-30T07:45:46.1580724Z"
},
"currentDedicatedNodes": 0,
"currentLowPriorityNodes": 0
}
}
CreatePool - dual stack networking
Exempelförfrågan
PUT https://management.azure.com/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/default-azurebatch/providers/Microsoft.Batch/batchAccounts/exampleacc/pools/dualstackpool?api-version=2025-06-01
{
"properties": {
"vmSize": "Standard_D4ds_v5",
"networkConfiguration": {
"publicIPAddressConfiguration": {
"ipFamilies": [
"IPv4",
"IPv6"
]
},
"endpointConfiguration": {
"inboundNatPools": [
{
"backendPort": 22,
"frontendPortRangeStart": 40000,
"frontendPortRangeEnd": 40500,
"name": "sshpool",
"protocol": "TCP",
"networkSecurityGroupRules": [
{
"access": "Allow",
"priority": 1000,
"sourceAddressPrefix": "*",
"sourcePortRanges": [
"*"
]
}
]
}
]
}
},
"deploymentConfiguration": {
"virtualMachineConfiguration": {
"imageReference": {
"publisher": "Canonical",
"offer": "ubuntu-24_04-lts",
"sku": "server"
},
"nodeAgentSkuId": "batch.node.ubuntu 24.04"
}
},
"scaleSettings": {
"fixedScale": {
"targetDedicatedNodes": 1,
"targetLowPriorityNodes": 0
}
}
}
}
Exempelsvar
ETag: W/"0x8D4EDFEBFADF4AB"
{
"id": "/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/sampleacct/pools/dualstackpool",
"name": "dualstackpool",
"type": "Microsoft.Batch/batchAccounts/pools",
"etag": "W/\"0x8DDC34D4A01A419\"",
"properties": {
"lastModified": "2025-07-15T03:11:27.7998105Z",
"creationTime": "2025-07-15T03:11:27.7997967Z",
"provisioningState": "Succeeded",
"provisioningStateTransitionTime": "2025-07-15T03:11:27.7997967Z",
"allocationState": "Resizing",
"allocationStateTransitionTime": "2025-07-15T03:11:27.7998136Z",
"vmSize": "Standard_D4ds_v5",
"interNodeCommunication": "Disabled",
"taskSlotsPerNode": 1,
"taskSchedulingPolicy": {
"nodeFillType": "Spread",
"jobDefaultOrder": "None"
},
"deploymentConfiguration": {
"virtualMachineConfiguration": {
"imageReference": {
"publisher": "Canonical",
"offer": "ubuntu-24_04-lts",
"sku": "server",
"version": "latest"
},
"nodeAgentSkuId": "batch.node.ubuntu 24.04"
}
},
"networkConfiguration": {
"publicIPAddressConfiguration": {
"ipFamilies": [
"IPv4",
"IPv6"
]
},
"endpointConfiguration": {
"inboundNatPools": [
{
"name": "sshpool",
"protocol": "TCP",
"backendPort": 22,
"frontendPortRangeStart": 40000,
"frontendPortRangeEnd": 40500,
"networkSecurityGroupRules": [
{
"access": "Allow",
"sourceAddressPrefix": "*",
"priority": 1000,
"sourcePortRanges": [
"*"
]
}
]
}
]
},
"dynamicVnetAssignmentScope": "none",
"enableAcceleratedNetworking": false
},
"scaleSettings": {
"fixedScale": {
"targetDedicatedNodes": 1,
"targetLowPriorityNodes": 0,
"resizeTimeout": "PT15M"
}
},
"resizeOperationStatus": {
"targetDedicatedNodes": 1,
"nodeDeallocationOption": "Requeue",
"resizeTimeout": "PT15M",
"startTime": "2025-07-15T03:11:27.7994621Z"
},
"currentDedicatedNodes": 0,
"currentLowPriorityNodes": 0
}
}
CreatePool - Full VirtualMachineConfiguration
Exempelförfrågan
PUT https://management.azure.com/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/sampleacct/pools/testpool?api-version=2025-06-01
{
"properties": {
"deploymentConfiguration": {
"virtualMachineConfiguration": {
"dataDisks": [
{
"caching": "ReadWrite",
"diskSizeGB": 30,
"lun": 0,
"managedDisk": {
"storageAccountType": "StandardSSD_LRS"
}
},
{
"caching": "None",
"diskSizeGB": 200,
"lun": 1,
"managedDisk": {
"storageAccountType": "Premium_LRS"
}
}
],
"diskEncryptionConfiguration": {
"targets": [
"OsDisk",
"TemporaryDisk"
]
},
"imageReference": {
"offer": "WindowsServer",
"publisher": "MicrosoftWindowsServer",
"sku": "2016-Datacenter-SmallDisk",
"version": "latest"
},
"licenseType": "Windows_Server",
"nodeAgentSkuId": "batch.node.windows amd64",
"nodePlacementConfiguration": {
"policy": "Zonal"
},
"osDisk": {
"ephemeralOSDiskSettings": {
"placement": "CacheDisk"
}
},
"windowsConfiguration": {
"enableAutomaticUpdates": false
}
}
},
"networkConfiguration": {
"endpointConfiguration": {
"inboundNatPools": [
{
"name": "testnat",
"backendPort": 12001,
"frontendPortRangeEnd": 15100,
"frontendPortRangeStart": 15000,
"networkSecurityGroupRules": [
{
"access": "Allow",
"priority": 150,
"sourceAddressPrefix": "192.100.12.45",
"sourcePortRanges": [
"1",
"2"
]
},
{
"access": "Deny",
"priority": 3500,
"sourceAddressPrefix": "*",
"sourcePortRanges": [
"*"
]
}
],
"protocol": "TCP"
}
]
}
},
"scaleSettings": {
"autoScale": {
"evaluationInterval": "PT5M",
"formula": "$TargetDedicatedNodes=1"
}
},
"vmSize": "STANDARD_D4"
}
}
Exempelsvar
ETag: W/"0x8D4EDFEBFADF4AB"
{
"name": "testpool",
"type": "Microsoft.Batch/batchAccounts/pools",
"id": "/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/sampleacct/pools/testpool",
"properties": {
"allocationState": "Resizing",
"allocationStateTransitionTime": "2017-08-28T10:22:55.9407275Z",
"creationTime": "2017-08-28T10:22:55.9407275Z",
"currentDedicatedNodes": 0,
"currentLowPriorityNodes": 0,
"deploymentConfiguration": {
"virtualMachineConfiguration": {
"dataDisks": [
{
"caching": "ReadWrite",
"diskSizeGB": 30,
"lun": 0,
"managedDisk": {
"storageAccountType": "StandardSSD_LRS"
}
},
{
"caching": "None",
"diskSizeGB": 200,
"lun": 1,
"managedDisk": {
"storageAccountType": "Standard_LRS"
}
}
],
"diskEncryptionConfiguration": {
"targets": [
"OsDisk",
"TemporaryDisk"
]
},
"imageReference": {
"offer": "WindowsServer",
"publisher": "MicrosoftWindowsServer",
"sku": "2016-Datacenter-SmallDisk",
"version": "latest"
},
"licenseType": "Windows_Server",
"nodeAgentSkuId": "batch.node.windows amd64",
"nodePlacementConfiguration": {
"policy": "Zonal"
},
"windowsConfiguration": {
"enableAutomaticUpdates": false
}
}
},
"interNodeCommunication": "Disabled",
"lastModified": "2017-08-28T10:22:55.9407275Z",
"networkConfiguration": {
"endpointConfiguration": {
"inboundNatPools": [
{
"name": "testnat",
"backendPort": 12001,
"frontendPortRangeEnd": 15100,
"frontendPortRangeStart": 15000,
"networkSecurityGroupRules": [
{
"access": "Allow",
"priority": 150,
"sourceAddressPrefix": "192.100.12.45",
"sourcePortRanges": [
"1",
"2"
]
},
{
"access": "Deny",
"priority": 3500,
"sourceAddressPrefix": "*",
"sourcePortRanges": [
"*"
]
}
],
"protocol": "TCP"
}
]
}
},
"provisioningState": "Succeeded",
"provisioningStateTransitionTime": "2017-08-28T10:22:55.9407275Z",
"scaleSettings": {
"autoScale": {
"evaluationInterval": "PT5M",
"formula": "$TargetDedicatedNodes=1"
}
},
"taskSchedulingPolicy": {
"nodeFillType": "Spread"
},
"taskSlotsPerNode": 1,
"vmSize": "STANDARD_D4"
}
}
CreatePool - Minimal VirtualMachineConfiguration
Exempelförfrågan
PUT https://management.azure.com/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/sampleacct/pools/testpool?api-version=2025-06-01
{
"properties": {
"deploymentConfiguration": {
"virtualMachineConfiguration": {
"imageReference": {
"offer": "UbuntuServer",
"publisher": "Canonical",
"sku": "18.04-LTS",
"version": "latest"
},
"nodeAgentSkuId": "batch.node.ubuntu 18.04"
}
},
"scaleSettings": {
"autoScale": {
"evaluationInterval": "PT5M",
"formula": "$TargetDedicatedNodes=1"
}
},
"vmSize": "STANDARD_D4"
}
}
Exempelsvar
ETag: W/"0x8D4EDFEBFADF4AB"
{
"name": "testpool",
"type": "Microsoft.Batch/batchAccounts/pools",
"id": "/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/sampleacct/pools/testpool",
"properties": {
"allocationState": "Resizing",
"allocationStateTransitionTime": "2017-08-28T10:22:55.9407275Z",
"creationTime": "2017-08-28T10:22:55.9407275Z",
"currentDedicatedNodes": 0,
"currentLowPriorityNodes": 0,
"deploymentConfiguration": {
"virtualMachineConfiguration": {
"imageReference": {
"offer": "UbuntuServer",
"publisher": "Canonical",
"sku": "18.04-LTS",
"version": "latest"
},
"nodeAgentSkuId": "batch.node.ubuntu 18.04"
}
},
"interNodeCommunication": "Disabled",
"lastModified": "2017-08-28T10:22:55.9407275Z",
"provisioningState": "Succeeded",
"provisioningStateTransitionTime": "2017-08-28T10:22:55.9407275Z",
"scaleSettings": {
"autoScale": {
"evaluationInterval": "PT5M",
"formula": "$TargetDedicatedNodes=1"
}
},
"taskSchedulingPolicy": {
"nodeFillType": "Spread"
},
"taskSlotsPerNode": 1,
"vmSize": "STANDARD_D4"
}
}
CreatePool - No public IP
Exempelförfrågan
PUT https://management.azure.com/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/sampleacct/pools/testpool?api-version=2025-06-01
{
"properties": {
"deploymentConfiguration": {
"virtualMachineConfiguration": {
"imageReference": {
"id": "/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/networking-group/providers/Microsoft.Compute/galleries/testgallery/images/testimagedef/versions/0.0.1"
},
"nodeAgentSkuId": "batch.node.ubuntu 18.04"
}
},
"networkConfiguration": {
"publicIPAddressConfiguration": {
"provision": "NoPublicIPAddresses"
},
"subnetId": "/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/rg1234/providers/Microsoft.Network/virtualNetworks/network1234/subnets/subnet123"
},
"vmSize": "STANDARD_D4"
}
}
Exempelsvar
ETag: W/"0x8D4EDFEBFADF4AB"
{
"name": "testpool",
"type": "Microsoft.Batch/batchAccounts/pools",
"id": "/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/sampleacct/pools/testpool",
"properties": {
"allocationState": "Steady",
"allocationStateTransitionTime": "2017-08-28T10:22:55.9407275Z",
"creationTime": "2017-08-28T10:22:55.9407275Z",
"currentDedicatedNodes": 0,
"currentLowPriorityNodes": 0,
"deploymentConfiguration": {
"virtualMachineConfiguration": {
"imageReference": {
"id": "/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/networking-group/providers/Microsoft.Compute/galleries/testgallery/images/testimagedef/versions/0.0.1"
},
"nodeAgentSkuId": "batch.node.ubuntu 18.04"
}
},
"interNodeCommunication": "Disabled",
"lastModified": "2017-08-28T10:22:55.9407275Z",
"networkConfiguration": {
"publicIPAddressConfiguration": {
"provision": "NoPublicIPAddresses"
},
"subnetId": "/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/rg1234/providers/Microsoft.Network/virtualNetworks/network1234/subnets/subnet123"
},
"provisioningState": "Succeeded",
"provisioningStateTransitionTime": "2017-08-28T10:22:55.9407275Z",
"scaleSettings": {
"fixedScale": {
"targetDedicatedNodes": 0,
"targetLowPriorityNodes": 0
}
},
"taskSchedulingPolicy": {
"nodeFillType": "Spread"
},
"taskSlotsPerNode": 1,
"vmSize": "STANDARD_D4"
}
}
CreatePool - Public IPs
Exempelförfrågan
PUT https://management.azure.com/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/sampleacct/pools/testpool?api-version=2025-06-01
{
"properties": {
"deploymentConfiguration": {
"virtualMachineConfiguration": {
"imageReference": {
"id": "/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/networking-group/providers/Microsoft.Compute/galleries/testgallery/images/testimagedef/versions/0.0.1"
},
"nodeAgentSkuId": "batch.node.ubuntu 18.04"
}
},
"networkConfiguration": {
"publicIPAddressConfiguration": {
"ipAddressIds": [
"/subscriptions/12345678-1234-1234-1234-1234567890121/resourceGroups/rg13/providers/Microsoft.Network/publicIPAddresses/ip135"
],
"provision": "UserManaged"
},
"subnetId": "/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/rg1234/providers/Microsoft.Network/virtualNetworks/network1234/subnets/subnet123"
},
"vmSize": "STANDARD_D4"
}
}
Exempelsvar
ETag: W/"0x8D4EDFEBFADF4AB"
{
"name": "testpool",
"type": "Microsoft.Batch/batchAccounts/pools",
"id": "/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/sampleacct/pools/testpool",
"properties": {
"allocationState": "Steady",
"allocationStateTransitionTime": "2017-08-28T10:22:55.9407275Z",
"creationTime": "2017-08-28T10:22:55.9407275Z",
"currentDedicatedNodes": 0,
"currentLowPriorityNodes": 0,
"deploymentConfiguration": {
"virtualMachineConfiguration": {
"imageReference": {
"id": "/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/networking-group/providers/Microsoft.Compute/galleries/testgallery/images/testimagedef/versions/0.0.1"
},
"nodeAgentSkuId": "batch.node.ubuntu 18.04"
}
},
"interNodeCommunication": "Disabled",
"lastModified": "2017-08-28T10:22:55.9407275Z",
"networkConfiguration": {
"publicIPAddressConfiguration": {
"ipAddressIds": [
"/subscriptions/12345678-1234-1234-1234-1234567890121/resourceGroups/rg13/providers/Microsoft.Network/publicIPAddresses/ip135"
],
"provision": "UserManaged"
},
"subnetId": "/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/rg1234/providers/Microsoft.Network/virtualNetworks/network1234/subnets/subnet123"
},
"provisioningState": "Succeeded",
"provisioningStateTransitionTime": "2017-08-28T10:22:55.9407275Z",
"scaleSettings": {
"fixedScale": {
"targetDedicatedNodes": 0,
"targetLowPriorityNodes": 0
}
},
"taskSchedulingPolicy": {
"nodeFillType": "Spread"
},
"taskSlotsPerNode": 1,
"vmSize": "STANDARD_D4"
}
}
CreatePool - SecurityProfile
Exempelförfrågan
PUT https://management.azure.com/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/sampleacct/pools/testpool?api-version=2025-06-01
{
"properties": {
"deploymentConfiguration": {
"virtualMachineConfiguration": {
"imageReference": {
"offer": "UbuntuServer",
"publisher": "Canonical",
"sku": "18_04-lts-gen2",
"version": "latest"
},
"nodeAgentSkuId": "batch.node.ubuntu 18.04",
"securityProfile": {
"encryptionAtHost": true,
"securityType": "trustedLaunch",
"uefiSettings": {
"secureBootEnabled": null,
"vTpmEnabled": false
}
}
}
},
"scaleSettings": {
"fixedScale": {
"targetDedicatedNodes": 1,
"targetLowPriorityNodes": 0
}
},
"vmSize": "Standard_d4s_v3"
}
}
Exempelsvar
ETag: W/"0x8DB554F8E08BCF4"
{
"name": "testpool",
"type": "Microsoft.Batch/batchAccounts/pools",
"id": "/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/sampleacct/pools/testpool",
"properties": {
"allocationState": "Resizing",
"allocationStateTransitionTime": "2023-06-14T07:03:58.3231917Z",
"creationTime": "2023-06-14T07:03:58.3231917Z",
"currentDedicatedNodes": 0,
"currentLowPriorityNodes": 0,
"deploymentConfiguration": {
"virtualMachineConfiguration": {
"imageReference": {
"offer": "UbuntuServer",
"publisher": "Canonical",
"sku": "18_04-lts-gen2",
"version": "latest"
},
"nodeAgentSkuId": "batch.node.ubuntu 18.04",
"securityProfile": {
"encryptionAtHost": true,
"securityType": "trustedLaunch",
"uefiSettings": {
"vTpmEnabled": false
}
}
}
},
"interNodeCommunication": "Disabled",
"lastModified": "2023-06-14T07:03:58.3231917Z",
"provisioningState": "Succeeded",
"provisioningStateTransitionTime": "2023-06-14T07:03:58.3231917Z",
"resizeOperationStatus": {
"nodeDeallocationOption": "Requeue",
"resizeTimeout": "PT15M",
"startTime": "2023-06-14T07:03:58.3231917Z",
"targetDedicatedNodes": 1
},
"scaleSettings": {
"fixedScale": {
"resizeTimeout": "PT15M",
"targetDedicatedNodes": 1,
"targetLowPriorityNodes": 0
}
},
"taskSchedulingPolicy": {
"nodeFillType": "Spread"
},
"taskSlotsPerNode": 1,
"vmSize": "STANDARD_D4S_V3"
}
}
CreatePool - Tags
Exempelförfrågan
PUT https://management.azure.com/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/sampleacct/pools/testpool?api-version=2025-06-01
{
"properties": {
"deploymentConfiguration": {
"virtualMachineConfiguration": {
"imageReference": {
"offer": "0001-com-ubuntu-server-jammy",
"publisher": "Canonical",
"sku": "22_04-lts",
"version": "latest"
},
"nodeAgentSkuId": "batch.node.ubuntu 22.04"
}
},
"scaleSettings": {
"fixedScale": {
"targetDedicatedNodes": 1,
"targetLowPriorityNodes": 0
}
},
"vmSize": "Standard_d4s_v3"
}
}
Exempelsvar
ETag: W/"0x8DB554F8E08BCF4"
{
"name": "testpool",
"type": "Microsoft.Batch/batchAccounts/pools",
"id": "/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/sampleacct/pools/testpool",
"properties": {
"allocationState": "Resizing",
"allocationStateTransitionTime": "2023-06-14T07:03:58.3231917Z",
"creationTime": "2023-06-14T07:03:58.3231917Z",
"currentDedicatedNodes": 0,
"currentLowPriorityNodes": 0,
"deploymentConfiguration": {
"virtualMachineConfiguration": {
"imageReference": {
"offer": "0001-com-ubuntu-server-jammy",
"publisher": "Canonical",
"sku": "22_04-lts",
"version": "latest"
},
"nodeAgentSkuId": "batch.node.ubuntu 22.04"
}
},
"interNodeCommunication": "Disabled",
"lastModified": "2023-06-14T07:03:58.3231917Z",
"provisioningState": "Succeeded",
"provisioningStateTransitionTime": "2023-06-14T07:03:58.3231917Z",
"resizeOperationStatus": {
"nodeDeallocationOption": "Requeue",
"resizeTimeout": "PT15M",
"startTime": "2023-09-27T07:33:13.0625789Z",
"targetDedicatedNodes": 1
},
"scaleSettings": {
"fixedScale": {
"resizeTimeout": "PT15M",
"targetDedicatedNodes": 1,
"targetLowPriorityNodes": 0
}
},
"taskSchedulingPolicy": {
"nodeFillType": "Spread"
},
"taskSlotsPerNode": 1,
"vmSize": "STANDARD_D4S_V3"
}
}
CreatePool - UpgradePolicy
Exempelförfrågan
PUT https://management.azure.com/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/sampleacct/pools/testpool?api-version=2025-06-01
{
"properties": {
"deploymentConfiguration": {
"virtualMachineConfiguration": {
"imageReference": {
"offer": "WindowsServer",
"publisher": "MicrosoftWindowsServer",
"sku": "2019-datacenter-smalldisk",
"version": "latest"
},
"nodeAgentSkuId": "batch.node.windows amd64",
"nodePlacementConfiguration": {
"policy": "Zonal"
},
"windowsConfiguration": {
"enableAutomaticUpdates": false
}
}
},
"scaleSettings": {
"fixedScale": {
"targetDedicatedNodes": 2,
"targetLowPriorityNodes": 0
}
},
"upgradePolicy": {
"automaticOSUpgradePolicy": {
"disableAutomaticRollback": true,
"enableAutomaticOSUpgrade": true,
"osRollingUpgradeDeferral": true,
"useRollingUpgradePolicy": true
},
"mode": "automatic",
"rollingUpgradePolicy": {
"enableCrossZoneUpgrade": true,
"maxBatchInstancePercent": 20,
"maxUnhealthyInstancePercent": 20,
"maxUnhealthyUpgradedInstancePercent": 20,
"pauseTimeBetweenBatches": "PT0S",
"prioritizeUnhealthyInstances": false,
"rollbackFailedInstancesOnPolicyBreach": false
}
},
"vmSize": "Standard_d4s_v3"
}
}
Exempelsvar
ETag: W/"0x8DB51E64D3C3B69"
{
"name": "testpool",
"type": "Microsoft.Batch/batchAccounts/pools",
"id": "/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/sampleacct/pools/testpool",
"properties": {
"allocationState": "Resizing",
"allocationStateTransitionTime": "2023-05-11T06:16:44.2372184Z",
"creationTime": "2023-05-11T06:16:44.2372184Z",
"currentDedicatedNodes": 0,
"currentLowPriorityNodes": 0,
"deploymentConfiguration": {
"virtualMachineConfiguration": {
"imageReference": {
"offer": "WindowsServer",
"publisher": "MicrosoftWindowsServer",
"sku": "2019-datacenter-smalldisk",
"version": "latest"
},
"nodeAgentSkuId": "batch.node.windows amd64",
"nodePlacementConfiguration": {
"policy": "Zonal"
},
"windowsConfiguration": {
"enableAutomaticUpdates": false
}
}
},
"interNodeCommunication": "Disabled",
"lastModified": "2023-05-11T06:16:44.2372184Z",
"provisioningState": "Succeeded",
"provisioningStateTransitionTime": "2023-05-11T06:16:44.2372184Z",
"resizeOperationStatus": {
"nodeDeallocationOption": "Requeue",
"resizeTimeout": "PT15M",
"startTime": "2023-05-11T06:16:44.2372184Z",
"targetDedicatedNodes": 2
},
"scaleSettings": {
"fixedScale": {
"resizeTimeout": "PT15M",
"targetDedicatedNodes": 2,
"targetLowPriorityNodes": 0
}
},
"taskSchedulingPolicy": {
"nodeFillType": "Spread"
},
"taskSlotsPerNode": 1,
"upgradePolicy": {
"automaticOSUpgradePolicy": {
"disableAutomaticRollback": true,
"enableAutomaticOSUpgrade": true,
"osRollingUpgradeDeferral": true,
"useRollingUpgradePolicy": true
},
"mode": "automatic",
"rollingUpgradePolicy": {
"enableCrossZoneUpgrade": true,
"maxBatchInstancePercent": 20,
"maxUnhealthyInstancePercent": 20,
"maxUnhealthyUpgradedInstancePercent": 20,
"pauseTimeBetweenBatches": "PT0S",
"prioritizeUnhealthyInstances": false,
"rollbackFailedInstancesOnPolicyBreach": false
}
},
"vmSize": "STANDARD_D4S_V3"
}
}
CreatePool - UserAssignedIdentities
Exempelförfrågan
PUT https://management.azure.com/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/sampleacct/pools/testpool?api-version=2025-06-01
{
"identity": {
"type": "UserAssigned",
"userAssignedIdentities": {
"/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.ManagedIdentity/userAssignedIdentities/id1": {},
"/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.ManagedIdentity/userAssignedIdentities/id2": {}
}
},
"properties": {
"deploymentConfiguration": {
"virtualMachineConfiguration": {
"imageReference": {
"offer": "UbuntuServer",
"publisher": "Canonical",
"sku": "18.04-LTS",
"version": "latest"
},
"nodeAgentSkuId": "batch.node.ubuntu 18.04"
}
},
"scaleSettings": {
"autoScale": {
"evaluationInterval": "PT5M",
"formula": "$TargetDedicatedNodes=1"
}
},
"vmSize": "STANDARD_D4"
}
}
Exempelsvar
ETag: W/"0x8D4EDFEBFADF4AB"
{
"name": "testpool",
"type": "Microsoft.Batch/batchAccounts/pools",
"id": "/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/sampleacct/pools/testpool",
"identity": {
"type": "UserAssigned",
"userAssignedIdentities": {
"/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.ManagedIdentity/userAssignedIdentities/id1": {
"clientId": "clientId1",
"principalId": "principalId1"
},
"/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.ManagedIdentity/userAssignedIdentities/id2": {
"clientId": "clientId2",
"principalId": "principalId2"
}
}
},
"properties": {
"allocationState": "Resizing",
"allocationStateTransitionTime": "2020-10-01T10:22:55.9407275Z",
"creationTime": "2020-10-01T10:22:55.9407275Z",
"currentDedicatedNodes": 0,
"currentLowPriorityNodes": 0,
"deploymentConfiguration": {
"virtualMachineConfiguration": {
"imageReference": {
"offer": "UbuntuServer",
"publisher": "Canonical",
"sku": "18.04-LTS",
"version": "latest"
},
"nodeAgentSkuId": "batch.node.ubuntu 18.04"
}
},
"interNodeCommunication": "Disabled",
"lastModified": "2020-10-01T10:22:55.9407275Z",
"provisioningState": "Succeeded",
"provisioningStateTransitionTime": "2020-10-01T10:22:55.9407275Z",
"scaleSettings": {
"autoScale": {
"evaluationInterval": "PT5M",
"formula": "$TargetDedicatedNodes=1"
}
},
"taskSchedulingPolicy": {
"nodeFillType": "Spread"
},
"taskSlotsPerNode": 1,
"vmSize": "STANDARD_D4"
}
}
CreatePool - VirtualMachineConfiguration Extensions
Exempelförfrågan
PUT https://management.azure.com/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/sampleacct/pools/testpool?api-version=2025-06-01
{
"properties": {
"deploymentConfiguration": {
"virtualMachineConfiguration": {
"imageReference": {
"offer": "0001-com-ubuntu-server-focal",
"publisher": "Canonical",
"sku": "20_04-lts"
},
"nodeAgentSkuId": "batch.node.ubuntu 20.04",
"extensions": [
{
"name": "batchextension1",
"type": "KeyVaultForLinux",
"autoUpgradeMinorVersion": true,
"enableAutomaticUpgrade": true,
"publisher": "Microsoft.Azure.KeyVault",
"settings": {
"authenticationSettingsKey": "authenticationSettingsValue",
"secretsManagementSettingsKey": "secretsManagementSettingsValue"
},
"typeHandlerVersion": "2.0"
}
]
}
},
"scaleSettings": {
"autoScale": {
"evaluationInterval": "PT5M",
"formula": "$TargetDedicatedNodes=1"
}
},
"vmSize": "STANDARD_D4"
}
}
Exempelsvar
ETag: W/"0x8D4EDFEBFADF4AB"
{
"name": "testpool",
"type": "Microsoft.Batch/batchAccounts/pools",
"id": "/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/sampleacct/pools/testpool",
"properties": {
"allocationState": "Resizing",
"allocationStateTransitionTime": "2017-08-28T10:22:55.9407275Z",
"creationTime": "2017-08-28T10:22:55.9407275Z",
"currentDedicatedNodes": 0,
"currentLowPriorityNodes": 0,
"deploymentConfiguration": {
"virtualMachineConfiguration": {
"imageReference": {
"offer": "0001-com-ubuntu-server-focal",
"publisher": "Canonical",
"sku": "20_04-lts"
},
"nodeAgentSkuId": "batch.node.ubuntu 20.04",
"extensions": [
{
"name": "batchextension1",
"type": "KeyVaultForLinux",
"autoUpgradeMinorVersion": true,
"enableAutomaticUpgrade": true,
"publisher": "Microsoft.Azure.KeyVault",
"settings": {
"authenticationSettingsKey": "authenticationSettingsValue",
"secretsManagementSettingsKey": "secretsManagementSettingsValue"
},
"typeHandlerVersion": "2.0"
}
]
}
},
"interNodeCommunication": "Disabled",
"lastModified": "2017-08-28T10:22:55.9407275Z",
"provisioningState": "Succeeded",
"provisioningStateTransitionTime": "2017-08-28T10:22:55.9407275Z",
"scaleSettings": {
"autoScale": {
"evaluationInterval": "PT5M",
"formula": "$TargetDedicatedNodes=1"
}
},
"taskSchedulingPolicy": {
"nodeFillType": "Spread"
},
"taskSlotsPerNode": 1,
"vmSize": "STANDARD_D4"
}
}
CreatePool - VirtualMachineConfiguration OSDisk
Exempelförfrågan
PUT https://management.azure.com/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/sampleacct/pools/testpool?api-version=2025-06-01
{
"properties": {
"deploymentConfiguration": {
"virtualMachineConfiguration": {
"imageReference": {
"offer": "windowsserver",
"publisher": "microsoftwindowsserver",
"sku": "2022-datacenter-smalldisk"
},
"nodeAgentSkuId": "batch.node.windows amd64",
"osDisk": {
"caching": "ReadWrite",
"diskSizeGB": 100,
"managedDisk": {
"storageAccountType": "StandardSSD_LRS"
},
"writeAcceleratorEnabled": false
}
}
},
"scaleSettings": {
"fixedScale": {
"targetDedicatedNodes": 1,
"targetLowPriorityNodes": 0
}
},
"vmSize": "Standard_d2s_v3"
}
}
Exempelsvar
ETag: W/"0x8DB51F14DC1A8AD"
{
"name": "testpool",
"type": "Microsoft.Batch/batchAccounts/pools",
"id": "/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/sampleacct/pools/testpool",
"properties": {
"allocationState": "Resizing",
"allocationStateTransitionTime": "2023-08-24T02:12:27.7527697Z",
"creationTime": "2023-08-24T02:12:27.7527697Z",
"currentDedicatedNodes": 0,
"currentLowPriorityNodes": 0,
"deploymentConfiguration": {
"virtualMachineConfiguration": {
"imageReference": {
"offer": "windowsserver",
"publisher": "microsoftwindowsserver",
"sku": "2022-datacenter-smalldisk",
"version": "latest"
},
"nodeAgentSkuId": "batch.node.windows amd64",
"osDisk": {
"caching": "ReadWrite",
"diskSizeGB": 100,
"managedDisk": {
"storageAccountType": "StandardSSD_LRS"
},
"writeAcceleratorEnabled": false
}
}
},
"interNodeCommunication": "Disabled",
"lastModified": "2023-08-24T02:12:27.7527697Z",
"provisioningState": "Succeeded",
"provisioningStateTransitionTime": "2023-08-24T02:12:27.7527697Z",
"resizeOperationStatus": {
"nodeDeallocationOption": "Requeue",
"resizeTimeout": "PT15M",
"startTime": "2023-08-24T02:12:27.7527697Z",
"targetDedicatedNodes": 1
},
"scaleSettings": {
"fixedScale": {
"resizeTimeout": "PT15M",
"targetDedicatedNodes": 1,
"targetLowPriorityNodes": 0
}
},
"taskSchedulingPolicy": {
"nodeFillType": "Spread"
},
"taskSlotsPerNode": 1,
"vmSize": "STANDARD_D2_V3"
}
}
CreatePool - VirtualMachineConfiguration ServiceArtifactReference
Exempelförfrågan
PUT https://management.azure.com/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/sampleacct/pools/testpool?api-version=2025-06-01
{
"properties": {
"deploymentConfiguration": {
"virtualMachineConfiguration": {
"imageReference": {
"offer": "WindowsServer",
"publisher": "MicrosoftWindowsServer",
"sku": "2019-datacenter-smalldisk",
"version": "latest"
},
"nodeAgentSkuId": "batch.node.windows amd64",
"serviceArtifactReference": {
"id": "/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Compute/galleries/myGallery/serviceArtifacts/myServiceArtifact/vmArtifactsProfiles/vmArtifactsProfile"
},
"windowsConfiguration": {
"enableAutomaticUpdates": false
}
}
},
"scaleSettings": {
"fixedScale": {
"targetDedicatedNodes": 2,
"targetLowPriorityNodes": 0
}
},
"upgradePolicy": {
"automaticOSUpgradePolicy": {
"enableAutomaticOSUpgrade": true
},
"mode": "automatic"
},
"vmSize": "Standard_d4s_v3"
}
}
Exempelsvar
ETag: W/"0x8DB51F14DC1A8AD"
{
"name": "mypool41",
"type": "Microsoft.Batch/batchAccounts/pools",
"id": "/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/sampleacct/pools/testpool",
"properties": {
"allocationState": "Resizing",
"allocationStateTransitionTime": "2023-05-11T07:44:44.8580493Z",
"creationTime": "2023-05-11T07:44:44.8580493Z",
"currentDedicatedNodes": 0,
"currentLowPriorityNodes": 0,
"deploymentConfiguration": {
"virtualMachineConfiguration": {
"imageReference": {
"offer": "WindowsServer",
"publisher": "MicrosoftWindowsServer",
"sku": "2019-datacenter-smalldisk",
"version": "latest"
},
"nodeAgentSkuId": "batch.node.windows amd64",
"serviceArtifactReference": {
"id": "/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Compute/galleries/myGallery/serviceArtifacts/myServiceArtifact/vmArtifactsProfiles/vmArtifactsProfile"
},
"windowsConfiguration": {
"enableAutomaticUpdates": false
}
}
},
"interNodeCommunication": "Disabled",
"lastModified": "2023-05-11T07:44:44.8580493Z",
"provisioningState": "Succeeded",
"provisioningStateTransitionTime": "2023-05-11T07:44:44.8580493Z",
"resizeOperationStatus": {
"nodeDeallocationOption": "Requeue",
"resizeTimeout": "PT15M",
"startTime": "2023-05-11T07:44:44.8580493Z",
"targetDedicatedNodes": 2
},
"scaleSettings": {
"fixedScale": {
"resizeTimeout": "PT15M",
"targetDedicatedNodes": 2,
"targetLowPriorityNodes": 0
}
},
"taskSchedulingPolicy": {
"nodeFillType": "Spread"
},
"taskSlotsPerNode": 1,
"upgradePolicy": {
"automaticOSUpgradePolicy": {
"enableAutomaticOSUpgrade": true
},
"mode": "automatic"
},
"vmSize": "STANDARD_D4S_V3"
}
}
Definitioner
| Namn | Beskrivning |
|---|---|
|
Allocation |
Om poolen ändrar storlek. |
|
Application |
Länka till ett programpaket i batchkontot |
|
Automatic |
De konfigurationsparametrar som används för att utföra automatisk operativsystemuppgradering. |
|
Auto |
Resultatet och felen från en körning av en autoskalningsformel för pooler. |
|
Auto |
Ett fel uppstod vid automatisk skalning av en pool. |
|
Auto |
Autoskalningsinställningar för poolen. |
|
Auto |
Standardvärdet är Pool. Om poolen kör Windows ska värdet Aktivitet anges om striktare isolering mellan aktiviteter krävs. Till exempel om aktiviteten muterar registret på ett sätt som kan påverka andra uppgifter. |
|
Auto |
Anger parametrarna för den automatiska användare som kör en uppgift i Batch-tjänsten. |
|
Azure |
Information som används för att ansluta till en Azure Storage-container med blobfuse. |
|
Azure |
Information som används för att ansluta till en Azure Fileshare. |
|
Batch |
Identiteten för Batch-poolen, om den är konfigurerad. Om poolidentiteten uppdateras under uppdateringen av en befintlig pool kommer endast de nya virtuella datorer som skapas efter att poolen krymper till 0 att ha de uppdaterade identiteterna |
|
Caching |
Typ av cachelagring som ska aktiveras för disken. |
|
CIFSMount |
Information som används för att ansluta till ett CIFS-filsystem. |
|
Cloud |
Ett felsvar från Batch-tjänsten. |
|
Cloud |
Ett felsvar från Batch-tjänsten. |
|
Compute |
Avgör vad du ska göra med en nod och dess aktiviteter som körs när den har valts för frigöring. |
|
Compute |
Hur aktiviteter ska distribueras mellan beräkningsnoder. |
|
Compute |
Referensen till en användartilldelad identitet som är associerad med Batch-poolen som en beräkningsnod ska använda. |
|
Container |
Konfigurationen för containeraktiverade pooler. |
|
Container |
Posten för sökvägen och monteringsläget som du vill montera i aktivitetscontainern. |
|
Container |
Sökvägarna som ska monteras på containeraktivitetens container. |
|
Container |
Ett privat containerregister. |
|
Container |
Den containerteknik som ska användas. |
|
Container |
En flagga som anger var containeruppgiftens arbetskatalog finns. Standardvärdet är "taskWorkingDirectory". |
|
created |
Den typ av identitet som skapade resursen. |
|
Data |
Inställningar som ska användas av de datadiskar som är associerade med beräkningsnoder i poolen. När du använder anslutna datadiskar måste du montera och formatera diskarna från en virtuell dator för att kunna använda dem. |
|
Deployment |
Egenskaper för distributionskonfiguration. |
|
Diff |
Platsen där OS-disken ska placeras. |
|
Diff |
Anger tillfälliga diskinställningar för den operativsystemdisk som används av den virtuella datorn. |
|
Disk |
Referensen för den kundhanterade nyckeln för att kryptera disken. |
|
Disk |
Diskkrypteringskonfigurationen som tillämpas på beräkningsnoder i poolen. Diskkrypteringskonfiguration stöds inte i Linux-pool som skapats med Virtual Machine Image eller Azure Compute Gallery Image. |
|
Disk |
ARM-resurs-ID:t för diskkrypteringsuppsättningen. |
|
Disk |
Om det utelämnas krypteras inga diskar på beräkningsnoderna i poolen. |
|
Dynamic |
Omfånget för dynamisk vnet-tilldelning. |
|
Elevation |
Användarens höjdnivå. |
|
Environment |
En miljövariabel som ska anges i en uppgiftsprocess. |
|
Fixed |
Inställningar för fast skalning för poolen. |
|
Host |
Anger specifika inställningar för värdslutpunkten. |
|
Host |
Anger körningsläget för principen för åtkomstkontroll. |
|
Image |
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". |
|
Inbound |
Slutpunktens protokoll. |
|
Inbound |
En inkommande NAT-pool som kan användas för att hantera specifika portar på beräkningsnoder i en Batch-pool externt. |
|
Inter |
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. |
|
IPAddress |
Etableringstypen för offentliga IP-adresser för Batch-poolen. |
| IPFamily |
IP-familjerna som används för att ange IP-versioner som är tillgängliga för poolen. |
| IPTag |
Anger hur aktiviteter ska distribueras mellan beräkningsnoder. |
|
Job |
Ordningen för schemaläggning av uppgifter från olika jobb med samma prioritet. |
|
Linux |
Egenskaper som används för att skapa ett användarkonto på en Linux-nod. |
|
Login |
Anger inloggningsläge för användaren. Standardvärdet är Interaktivt. |
|
Managed |
Parametrarna för hanterade diskar. |
|
Metadata |
Ett namn/värde-par som är associerat med en Batch-tjänstresurs. |
|
Mount |
Filsystemet som ska monteras på varje nod. |
|
Network |
Nätverkskonfigurationen för en pool. |
|
Network |
En regel för nätverkssäkerhetsgrupp som ska tillämpas på en inkommande slutpunkt. |
|
Network |
Den åtgärd som ska vidtas för en angiven IP-adress, undernätsintervall eller tagg. |
|
NFSMount |
Information som används för att ansluta till ett NFS-filsystem. |
|
Node |
Nodplaceringskonfiguration för batchpooler. |
|
Node |
Standardvärdet är regionalt. |
| OSDisk |
Inställningar för den virtuella datorns operativsystemdisk. |
| Pool |
Innehåller information om en pool. |
|
Pool |
Slutpunktskonfigurationen för en pool. |
|
Pool |
Den typ av identitet som används för Batch-poolen. |
|
Pool |
Poolens aktuella tillstånd. |
|
Proxy |
Anger ProxyAgent-inställningar när den virtuella datorn skapas. |
|
Public |
Den offentliga IP-adresskonfigurationen för nätverkskonfigurationen för en pool. |
|
Resize |
Ett fel uppstod vid storleksändring av en pool. |
|
Resize |
Information om den aktuella eller senast slutförda storleksändringsåtgärden. |
|
Resource |
En enda fil eller flera filer som ska laddas ned till en beräkningsnod. |
|
Rolling |
De konfigurationsparametrar som används vid löpande uppgradering. |
|
Scale |
Skalningsinställningar för poolen |
|
Security |
Anger EncryptionType för den hanterade disken. Den är inställd på DiskWithVMGuestState för kryptering av den hanterade disken tillsammans med VMGuestState-blobben, VMGuestStateOnly för kryptering av endast VMGuestState-blobben, och NonPersistedTPM för att inte behålla firmware-tillståndet i VMGuestState-blobben. Obs: Det kan endast anges för konfidentiella virtuella datorer och krävs när du använder konfidentiella virtuella datorer. |
|
Security |
Anger säkerhetsprofilinställningarna för den virtuella datorn eller vm-skalningsuppsättningen. |
|
Security |
Anger SecurityType för den virtuella datorn. Det måste anges till ett angivet värde för att aktivera UefiSettings. |
|
Service |
Anger tjänstartefaktreferens-ID:t som används för att ange samma avbildningsversion för alla virtuella datorer i skalningsuppsättningen när du använder den senaste avbildningsversionen. |
|
Start |
En uppgift som körs när en beräkningsnod ansluter till en pool i Azure Batch-tjänsten, eller när beräkningsnoden startas om eller omskapas. |
|
Storage |
Lagringskontotypen som ska användas för att skapa datadiskar eller OS-diskar. |
|
system |
Metadata som rör skapande och senaste ändring av resursen. |
|
Task |
Containerinställningarna för en uppgift. |
|
Task |
Anger hur aktiviteter ska distribueras mellan beräkningsnoder. |
|
Uefi |
Anger de säkerhetsinställningar som säker start och vTPM som används när den virtuella datorn skapas. |
|
Upgrade |
Anger läget för en uppgradering till virtuella datorer i skalningsuppsättningen. |
|
Upgrade |
Beskriver en uppgraderingsprincip – automatisk, manuell eller rullande. |
|
User |
Egenskaper som används för att skapa en användare på en Azure Batch-nod. |
|
User |
Listan över associerade användaridentiteter. |
|
User |
Definitionen av användaridentiteten under vilken uppgiften körs. |
|
Virtual |
Konfigurationen för beräkningsnoder i en pool baserat på Azure Virtual Machines-infrastrukturen. |
|
VMDisk |
Anger säkerhetsprofilinställningarna för den hanterade disken. Obs: Det kan bara anges för konfidentiella virtuella datorer och krävs när du använder konfidentiella virtuella datorer. |
| VMExtension |
Konfigurationen för tillägg för virtuella datorer. |
|
Windows |
Inställningar för Windows-operativsystem som ska tillämpas på den virtuella datorn. |
|
Windows |
Egenskaper som används för att skapa ett användarkonto på en Windows-nod. |
AllocationState
Om poolen ändrar storlek.
| Värde | Beskrivning |
|---|---|
| Steady |
Poolen ändrar inte storlek. Det finns inga ändringar i antalet noder i poolen som pågår. En pool anger det här tillståndet när den skapas och när inga åtgärder utförs i poolen för att ändra antalet noder. |
| Resizing |
Poolen ändrar storlek. d.v.s. att beräkningsnoder läggs till eller tas bort från poolen. |
| Stopping |
Poolen ändrade storlek, men användaren har begärt att storleksändringen ska stoppas, men stoppbegäran har ännu inte slutförts. |
ApplicationPackageReference
Länka till ett programpaket i batchkontot
| Namn | Typ | Beskrivning |
|---|---|---|
| id |
string |
ID:t för programpaketet som ska installeras. Detta måste vara i samma batchkonto som poolen. Detta kan antingen vara en referens till en viss version eller standardversionen om det finns en sådan. |
| version |
string |
Den version av programmet som ska distribueras. Om den utelämnas distribueras standardversionen. |
AutomaticOSUpgradePolicy
De konfigurationsparametrar som används för att utföra automatisk operativsystemuppgradering.
| Namn | Typ | Beskrivning |
|---|---|---|
| disableAutomaticRollback |
boolean |
Om funktionen för återställning av os-avbildning ska inaktiveras. |
| enableAutomaticOSUpgrade |
boolean |
Anger om OS-uppgraderingar automatiskt ska tillämpas på skalningsuppsättningsinstanser på ett löpande sätt när en nyare version av OS-avbildningen blir tillgänglig. |
| osRollingUpgradeDeferral |
boolean |
Skjut upp OS-uppgraderingar på TV-datorerna om de kör uppgifter. |
| useRollingUpgradePolicy |
boolean |
Anger om principen för löpande uppgradering ska användas under automatisk operativsystemuppgradering. Automatisk os-uppgradering återgår till standardprincipen om ingen princip har definierats på VMSS. |
AutoScaleRun
Resultatet och felen från en körning av en autoskalningsformel för pooler.
| Namn | Typ | Beskrivning |
|---|---|---|
| error |
Information om felet vid utvärdering av autoskalningsformeln i poolen, om utvärderingen misslyckades. |
|
| evaluationTime |
string (date-time) |
Den tid då autoskalningsformeln senast utvärderades. |
| results |
string |
De slutliga värdena för alla variabler som används i utvärderingen av autoskalningsformeln. |
AutoScaleRunError
Ett fel uppstod vid automatisk skalning av en pool.
| Namn | Typ | Beskrivning |
|---|---|---|
| code |
string |
En identifierare för felet. Koder är invarianta och är avsedda att användas programmatiskt. |
| details |
Ytterligare information om felet. |
|
| message |
string |
Ett meddelande som beskriver felet, avsett att vara lämpligt för visning i ett användargränssnitt. |
AutoScaleSettings
Autoskalningsinställningar för poolen.
| Namn | Typ | Beskrivning |
|---|---|---|
| evaluationInterval |
string (duration) |
Tidsintervallet då poolstorleken ska justeras automatiskt enligt autoskalningsformeln. |
| formula |
string |
En formel för önskat antal beräkningsnoder i poolen. |
AutoUserScope
Standardvärdet är Pool. Om poolen kör Windows ska värdet Aktivitet anges om striktare isolering mellan aktiviteter krävs. Till exempel om aktiviteten muterar registret på ett sätt som kan påverka andra uppgifter.
| Värde | Beskrivning |
|---|---|
| Task |
Anger att tjänsten ska skapa en ny användare för uppgiften. |
| Pool |
Anger att aktiviteten körs som det vanliga automatiska användarkontot som skapas på varje nod i en pool. |
AutoUserSpecification
Anger parametrarna för den automatiska användare som kör en uppgift i Batch-tjänsten.
| Namn | Typ | Beskrivning |
|---|---|---|
| elevationLevel |
Användarens höjdnivå. |
|
| scope |
Omfånget för den automatiska användaren |
AzureBlobFileSystemConfiguration
Information som används för att ansluta till en Azure Storage-container med blobfuse.
| Namn | Typ | Beskrivning |
|---|---|---|
| accountKey |
string (password) |
Azure Storage-kontonyckeln. |
| accountName |
string |
Namnet på Azure Storage-kontot. |
| blobfuseOptions |
string |
Ytterligare kommandoradsalternativ för att skicka till monteringskommandot. |
| containerName |
string |
Namnet på Azure Blob Storage-containern. |
| identityReference |
Referensen till den användartilldelade identitet som ska användas för att komma åt containerName |
|
| relativeMountPath |
string |
Den relativa sökvägen på beräkningsnoden där filsystemet ska monteras |
| sasKey |
string (password) |
Sas-token för Azure Storage. |
AzureFileShareConfiguration
Information som används för att ansluta till en Azure Fileshare.
| Namn | Typ | Beskrivning |
|---|---|---|
| accountKey |
string (password) |
Azure Storage-kontonyckeln. |
| accountName |
string |
Namnet på Azure Storage-kontot. |
| azureFileUrl |
string |
Url:en för Azure Files. |
| mountOptions |
string |
Ytterligare kommandoradsalternativ för att skicka till monteringskommandot. |
| relativeMountPath |
string |
Den relativa sökvägen på beräkningsnoden där filsystemet ska monteras |
BatchPoolIdentity
Identiteten för Batch-poolen, om den är konfigurerad. Om poolidentiteten uppdateras under uppdateringen av en befintlig pool kommer endast de nya virtuella datorer som skapas efter att poolen krymper till 0 att ha de uppdaterade identiteterna
| Namn | Typ | Beskrivning |
|---|---|---|
| type |
Den typ av identitet som används för Batch-poolen. |
|
| userAssignedIdentities |
<string,
User |
Listan över användaridentiteter som är associerade med Batch-poolen. |
CachingType
Typ av cachelagring som ska aktiveras för disken.
| Värde | Beskrivning |
|---|---|
| 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. |
CIFSMountConfiguration
Information som används för att ansluta till ett CIFS-filsystem.
| Namn | Typ | Beskrivning |
|---|---|---|
| mountOptions |
string |
Ytterligare kommandoradsalternativ för att skicka till monteringskommandot. |
| password |
string (password) |
Lösenordet som ska användas för autentisering mot CIFS-filsystemet. |
| relativeMountPath |
string |
Den relativa sökvägen på beräkningsnoden där filsystemet ska monteras |
| source |
string |
URI:n för filsystemet som ska monteras. |
| userName |
string |
Användaren som ska användas för autentisering mot CIFS-filsystemet. |
CloudError
Ett felsvar från Batch-tjänsten.
| Namn | Typ | Beskrivning |
|---|---|---|
| error |
Brödtexten i felsvaret. |
CloudErrorBody
Ett felsvar från Batch-tjänsten.
| Namn | Typ | Beskrivning |
|---|---|---|
| code |
string |
En identifierare för felet. Koder är invarianta och är avsedda att användas programmatiskt. |
| details |
En lista med ytterligare information om felet. |
|
| message |
string |
Ett meddelande som beskriver felet, avsett att vara lämpligt för visning i ett användargränssnitt. |
| target |
string |
Målet för det specifika felet. Till exempel namnet på egenskapen i fel. |
ComputeNodeDeallocationOption
Avgör vad du ska göra med en nod och dess aktiviteter som körs när den har valts för frigöring.
| Värde | Beskrivning |
|---|---|
| Requeue |
Avsluta aktivitetsprocesser som körs och skicka aktiviteterna på nytt. Aktiviteterna körs igen när en nod är tillgänglig. Ta bort noder så snart aktiviteterna har avslutats. |
| Terminate |
Avsluta aktiviteter som körs. Aktiviteterna kommer att slutföras med failureInfo som anger att de har avslutats och inte körs igen. Ta bort noder så snart aktiviteterna har avslutats. |
| TaskCompletion |
Tillåt att aktiviteter som körs för närvarande slutförs. Schemalägg inga nya aktiviteter medan du väntar. Ta bort noder när alla aktiviteter har slutförts. |
| RetainedData |
Tillåt att aktiviteter som körs för närvarande kan slutföras och vänta tills alla kvarhållningsperioder för uppgiftsdata upphör att gälla. Schemalägg inga nya aktiviteter medan du väntar. Ta bort noder när alla kvarhållningsperioder för aktiviteter har upphört att gälla. |
ComputeNodeFillType
Hur aktiviteter ska distribueras mellan beräkningsnoder.
| Värde | Beskrivning |
|---|---|
| Spread |
Aktiviteter bör tilldelas jämnt över alla noder i poolen. |
| Pack |
Så många aktiviteter som möjligt (taskSlotsPerNode) ska tilldelas till varje nod i poolen innan några aktiviteter tilldelas till nästa nod i poolen. |
ComputeNodeIdentityReference
Referensen till en användartilldelad identitet som är associerad med Batch-poolen som en beräkningsnod ska använda.
| Namn | Typ | Beskrivning |
|---|---|---|
| resourceId |
string |
ARM-resurs-ID för den användartilldelade identiteten. |
ContainerConfiguration
Konfigurationen för containeraktiverade pooler.
| Namn | Typ | Beskrivning |
|---|---|---|
| containerImageNames |
string[] |
Samlingen med containeravbildningsnamn. |
| containerRegistries |
Ytterligare privata register från vilka containrar kan hämtas. |
|
| type |
Den containerteknik som ska användas. |
ContainerHostBatchBindMountEntry
Posten för sökvägen och monteringsläget som du vill montera i aktivitetscontainern.
| Namn | Typ | Beskrivning |
|---|---|---|
| isReadOnly |
boolean |
Montera den här källsökvägen som skrivskyddat läge eller inte. Standardvärdet är falskt (läs-/skrivläge). |
| source |
Sökvägarna som ska monteras på containeraktivitetens container. |
ContainerHostDataPath
Sökvägarna som ska monteras på containeraktivitetens container.
| Värde | Beskrivning |
|---|---|
| Shared |
Sökvägen för uppgift för flera instanser att dela sina filer. |
| Startup |
Sökvägen för startaktiviteten. |
| VfsMounts |
Sökvägen innehåller alla virtuella filsystem som är monterade på den här noden. |
| Task |
Aktivitetssökvägen. |
| JobPrep |
Jobbförberedelseaktivitetssökvägen. |
| Applications |
Programsökvägen. |
ContainerRegistry
Ett privat containerregister.
| Namn | Typ | Beskrivning |
|---|---|---|
| identityReference |
Referensen till den användartilldelade identitet som ska användas för att komma åt ett Azure Container Registry i stället för användarnamn och lösenord. |
|
| password |
string (password) |
Lösenordet för att logga in på registerservern. |
| registryServer |
string |
Registrets URL. |
| username |
string |
Användarnamnet för att logga in på registerservern. |
ContainerType
Den containerteknik som ska användas.
| Värde | Beskrivning |
|---|---|
| DockerCompatible |
En Docker-kompatibel containerteknik används för att starta containrarna. |
| CriCompatible |
En CRI-baserad teknik kommer att användas för att starta containrarna. |
ContainerWorkingDirectory
En flagga som anger var containeruppgiftens arbetskatalog finns. Standardvärdet är "taskWorkingDirectory".
| Värde | Beskrivning |
|---|---|
| TaskWorkingDirectory |
Använd standardarbetskatalogen för Batch-tjänsten, som innehåller resursfilerna för aktiviteten som fylls i av Batch. |
| ContainerImageDefault |
Använda containeravbildningsdefinierad arbetskatalog. Se upp för att den här katalogen inte innehåller de resursfiler som laddats ned av Batch. |
createdByType
Den typ av identitet som skapade resursen.
| Värde | Beskrivning |
|---|---|
| User | |
| Application | |
| ManagedIdentity | |
| Key |
DataDisk
Inställningar som ska användas av de datadiskar som är associerade med beräkningsnoder i poolen. När du använder anslutna datadiskar måste du montera och formatera diskarna från en virtuell dator för att kunna använda dem.
| Namn | Typ | Beskrivning |
|---|---|---|
| caching |
Typ av cachelagring som ska aktiveras för disken. 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/. |
|
| diskSizeGB |
integer (int32) |
Den ursprungliga diskstorleken i GB när du skapar en ny datadisk. |
| lun |
integer (int32) |
Det logiska enhetsnumret. |
| managedDisk |
Parametrarna för hanterade diskar. |
DeploymentConfiguration
Egenskaper för distributionskonfiguration.
| Namn | Typ | Beskrivning |
|---|---|---|
| virtualMachineConfiguration |
Konfigurationen av den virtuella datorn för poolen. |
DiffDiskPlacement
Platsen där OS-disken ska placeras.
| Värde | Beskrivning |
|---|---|
| CacheDisk |
OS-disken placeras på VM:ns cachedisk. |
DiffDiskSettings
Anger tillfälliga diskinställningar för den operativsystemdisk som används av den virtuella datorn.
| Namn | Typ | Beskrivning |
|---|---|---|
| placement |
Anger den tillfälliga diskplaceringen för operativsystemdisken för alla virtuella datorer i poolen. |
DiskCustomerManagedKey
Referensen för den kundhanterade nyckeln för att kryptera disken.
| Namn | Typ | Beskrivning |
|---|---|---|
| identityReference |
Referensen till en av poolidentiteterna för att kryptera disken. Den här identiteten används för att komma åt KeyVault. |
|
| keyUrl |
string (uri) |
Fullständigt versionshanterad nyckel-URL som pekar på en nyckel i KeyVault. Versionssegmentet för URL:en krävs oavsett rotationToLatestKeyVersionEnabled-värde. |
| rotationToLatestKeyVersionEnabled |
boolean |
Ställ in den här flaggan på true för att aktivera automatisk uppdatering av diskkrypteringen till den senaste nyckelversionen. Standardvärdet är false. |
DiskEncryptionConfiguration
Diskkrypteringskonfigurationen som tillämpas på beräkningsnoder i poolen. Diskkrypteringskonfiguration stöds inte i Linux-pool som skapats med Virtual Machine Image eller Azure Compute Gallery Image.
| Namn | Typ | Beskrivning |
|---|---|---|
| customerManagedKey |
Referensen för den kundhanterade nyckeln för att kryptera OS-disken. |
|
| targets |
Listan över diskmål som Batch Service krypterar på beräkningsnoden |
DiskEncryptionSetParameters
ARM-resurs-ID:t för diskkrypteringsuppsättningen.
| Namn | Typ | Beskrivning |
|---|---|---|
| id |
string (arm-id) |
Resurs-id för diskens krypteringsuppsättning. |
DiskEncryptionTarget
Om det utelämnas krypteras inga diskar på beräkningsnoderna i poolen.
| Värde | Beskrivning |
|---|---|
| OsDisk |
OS-disken på beräkningsnoden är krypterad. |
| TemporaryDisk |
Den tillfälliga disken på beräkningsnoden krypteras. I Linux gäller den här krypteringen för andra partitioner (till exempel de på monterade datadiskar) när kryptering sker vid start. |
DynamicVNetAssignmentScope
Omfånget för dynamisk vnet-tilldelning.
| Värde | Beskrivning |
|---|---|
| none |
Ingen dynamisk VNet-tilldelning är aktiverad. |
| job |
Dynamisk VNet-tilldelning görs per jobb. Om det här värdet anges måste även nätverkskonfigurationens undernäts-ID anges. Den här funktionen kräver godkännande före användning. Kontakta supporten |
ElevationLevel
Användarens höjdnivå.
| Värde | Beskrivning |
|---|---|
| NonAdmin |
Användaren är en standardanvändare utan förhöjd åtkomst. |
| Admin |
Användaren är en användare med förhöjd åtkomst och fungerar med fullständig administratörsbehörighet. |
EnvironmentSetting
En miljövariabel som ska anges i en uppgiftsprocess.
| Namn | Typ | Beskrivning |
|---|---|---|
| name |
string |
Namnet på miljövariabeln. |
| value |
string |
Värdet för miljövariabeln. |
FixedScaleSettings
Inställningar för fast skalning för poolen.
| Namn | Typ | Standardvärde | Beskrivning |
|---|---|---|---|
| nodeDeallocationOption |
Avgör vad du ska göra med en nod och dess aktiviteter som körs när den har valts för frigöring. |
||
| resizeTimeout |
string (duration) |
PT15M |
Tidsgränsen för allokering av beräkningsnoder till poolen. |
| targetDedicatedNodes |
integer (int32) |
Önskat antal dedikerade beräkningsnoder i poolen. |
|
| targetLowPriorityNodes |
integer (int32) |
Önskat antal beräkningsnoder med oanvänd kapacitet/låg prioritet i poolen. |
HostEndpointSettings
Anger specifika inställningar för värdslutpunkten.
| Namn | Typ | Beskrivning |
|---|---|---|
| inVMAccessControlProfileReferenceId |
string (arm-id) |
Anger referensen till resurs-ID:t InVMAccessControlProfileVersion i form av /subscriptions/{SubscriptionId}/resourceGroups/{ResourceGroupName}/providers/Microsoft.Compute/galleries/{galleryName}/inVMAccessControlProfiles/{profile}/versions/{version}. |
| mode |
Anger körningsläget för principen för åtkomstkontroll. |
HostEndpointSettingsModeTypes
Anger körningsläget för principen för åtkomstkontroll.
| Värde | Beskrivning |
|---|---|
| Audit |
I granskningsläge fungerar systemet som om det tillämpar åtkomstkontrollprincipen, inklusive att generera åtkomstnekande poster i loggarna, men det nekar faktiskt inte några begäranden om värdslutpunkter. |
| Enforce |
Enforce-läget är det rekommenderade driftsläget och systemet kommer att upprätthålla åtkomstkontrollpolicyn. Denna egenskap kan inte användas tillsammans med 'inVMAccessControlProfileReferenceId'. |
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".
| Namn | Typ | Beskrivning |
|---|---|---|
| communityGalleryImageId |
string |
Unik identifierare för communitygalleribilden |
| id |
string |
ARM-resursidentifieraren för Azure Compute Gallery Image. Beräkningsnoder i poolen skapas med det här avbildnings-ID:t. Det här är formuläret /subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Compute/galleries/{galleryName}/images/{imageDefinitionName}/versions/{versionId}. |
| offer |
string |
Erbjudandetypen för Azure Virtual Machines Marketplace-avbildningen. |
| publisher |
string |
Utgivaren av Azure Virtual Machines Marketplace-avbildningen. |
| sharedGalleryImageId |
string |
Unik identifierare för den delade galleribilden |
| sku |
string |
SKU:n för Azure Virtual Machines Marketplace-avbildningen. |
| version |
string |
Versionen av Azure Virtual Machines Marketplace-avbildningen. |
InboundEndpointProtocol
Slutpunktens protokoll.
| Värde | Beskrivning |
|---|---|
| TCP |
Använd TCP för slutpunkten. |
| UDP |
Använd UDP för slutpunkten. |
InboundNatPool
En inkommande NAT-pool som kan användas för att hantera specifika portar på beräkningsnoder i en Batch-pool externt.
| Namn | Typ | Beskrivning |
|---|---|---|
| backendPort |
integer (int32) |
Portnumret på beräkningsnoden. |
| frontendPortRangeEnd |
integer (int32) |
Det sista portnumret i intervallet för externa portar som ska användas för att ge inkommande åtkomst till backendPort på enskilda beräkningsnoder. |
| frontendPortRangeStart |
integer (int32) |
Det första portnumret i intervallet för externa portar som ska användas för att ge inkommande åtkomst till backendPort på enskilda beräkningsnoder. |
| name |
string |
Namnet på slutpunkten. |
| networkSecurityGroupRules |
En lista över regler för nätverkssäkerhetsgrupper som ska tillämpas på slutpunkten. |
|
| protocol |
Slutpunktens protokoll. |
InterNodeCommunicationState
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.
| Värde | Beskrivning |
|---|---|
| Enabled |
Aktivera nätverkskommunikation mellan virtuella datorer. |
| Disabled |
Inaktivera nätverkskommunikation mellan virtuella datorer. |
IPAddressProvisioningType
Etableringstypen för offentliga IP-adresser för Batch-poolen.
| Värde | Beskrivning |
|---|---|
| BatchManaged |
En offentlig IP-adress skapas och hanteras av Batch. Det kan finnas flera offentliga IP-adresser beroende på poolens storlek. |
| UserManaged |
Offentliga IP-adresser tillhandahålls av användaren och används för att etablera beräkningsnoderna. |
| NoPublicIPAddresses |
Ingen offentlig IP-adress skapas för beräkningsnoderna i poolen. |
IPFamily
IP-familjerna som används för att ange IP-versioner som är tillgängliga för poolen.
| Värde | Beskrivning |
|---|---|
| IPv4 |
IPv4 är tillgängligt för poolen. |
| IPv6 |
IPv6 är tillgängligt för poolen. |
IPTag
Anger hur aktiviteter ska distribueras mellan beräkningsnoder.
| Namn | Typ | Beskrivning |
|---|---|---|
| ipTagType |
string |
Typ av IP-tagg. |
| tag |
string |
Värdet för IP-taggen som är associerad med den offentliga IP-adressen. |
JobDefaultOrder
Ordningen för schemaläggning av uppgifter från olika jobb med samma prioritet.
| Värde | Beskrivning |
|---|---|
| None |
Uppgifter bör schemaläggas enhetligt från alla jobb med lika hög prioritet i poolen. |
| CreationTime |
Om jobb har lika hög prioritet bör uppgifter från tidigare jobb schemaläggas först. |
LinuxUserConfiguration
Egenskaper som används för att skapa ett användarkonto på en Linux-nod.
| Namn | Typ | Beskrivning |
|---|---|---|
| gid |
integer (int32) |
Grupp-ID för användarkontot. |
| sshPrivateKey |
string (password) |
Den privata SSH-nyckeln för användarkontot. |
| uid |
integer (int32) |
Användarkontots användar-ID. |
LoginMode
Anger inloggningsläge för användaren. Standardvärdet är Interaktivt.
| Värde | Beskrivning |
|---|---|
| Batch |
Inloggningsläget LOGON32_LOGON_BATCH Win32. Batchinloggningsläget rekommenderas för långvariga parallella processer. |
| Interactive |
Inloggningsläget LOGON32_LOGON_INTERACTIVE Win32. Vissa program kräver behörigheter som är associerade med det interaktiva inloggningsläget. Om detta är fallet för ett program som används i din uppgift rekommenderas det här alternativet. |
ManagedDisk
Parametrarna för hanterade diskar.
| Namn | Typ | Beskrivning |
|---|---|---|
| diskEncryptionSet |
Anger resurs-ID för kundhanterad diskkrypteringsuppsättning för den hanterade disken. Den kan endast ställas in i UserSubscription-läge. |
|
| securityProfile |
Anger säkerhetsprofilen för den hanterade disken. |
|
| storageAccountType |
Lagringskontotypen som ska användas för att skapa datadiskar eller OS-diskar. |
MetadataItem
Ett namn/värde-par som är associerat med en Batch-tjänstresurs.
| Namn | Typ | Beskrivning |
|---|---|---|
| name |
string |
Namnet på metadataobjektet. |
| value |
string |
Värdet för metadataobjektet. |
MountConfiguration
Filsystemet som ska monteras på varje nod.
| Namn | Typ | Beskrivning |
|---|---|---|
| azureBlobFileSystemConfiguration |
Azure Storage-containern som ska monteras med blob-FUSE på varje nod. |
|
| azureFileShareConfiguration |
Den Azure-filresurs som ska monteras på varje nod. |
|
| cifsMountConfiguration |
CIFS/SMB-filsystemet som ska monteras på varje nod. |
|
| nfsMountConfiguration |
NFS-filsystemet som ska monteras på varje nod. |
NetworkConfiguration
Nätverkskonfigurationen för en pool.
| Namn | Typ | Standardvärde | Beskrivning |
|---|---|---|---|
| dynamicVnetAssignmentScope | none |
Omfånget för dynamisk vnet-tilldelning. |
|
| enableAcceleratedNetworking |
boolean |
Om den här poolen ska aktivera accelererat nätverk. |
|
| endpointConfiguration |
Konfigurationen för slutpunkter på beräkningsnoder i Batch-poolen. |
||
| publicIPAddressConfiguration |
Den offentliga IPAddress-konfigurationen för beräkningsnoder i Batch-poolen. |
||
| subnetId |
string |
ARM-resursidentifieraren för det virtuella nätverksundernätet som poolens beräkningsnoder ansluter till. Det här är formuläret /subscriptions/{subscription}/resourceGroups/{group}/providers/{provider}/virtualNetworks/{network}/subnets/{subnet}. |
NetworkSecurityGroupRule
En regel för nätverkssäkerhetsgrupp som ska tillämpas på en inkommande slutpunkt.
| Namn | Typ | Beskrivning |
|---|---|---|
| access |
Den åtgärd som ska vidtas för en angiven IP-adress, undernätsintervall eller tagg. |
|
| priority |
integer (int32) |
Prioriteten för den här regeln. |
| sourceAddressPrefix |
string |
Källadressprefixet eller taggen som ska matchas för regeln. |
| sourcePortRanges |
string[] |
Källportintervallen som ska matchas för regeln. |
NetworkSecurityGroupRuleAccess
Den åtgärd som ska vidtas för en angiven IP-adress, undernätsintervall eller tagg.
| Värde | Beskrivning |
|---|---|
| Allow |
Tillåt åtkomst. |
| Deny |
Neka åtkomst. |
NFSMountConfiguration
Information som används för att ansluta till ett NFS-filsystem.
| Namn | Typ | Beskrivning |
|---|---|---|
| mountOptions |
string |
Ytterligare kommandoradsalternativ för att skicka till monteringskommandot. |
| relativeMountPath |
string |
Den relativa sökvägen på beräkningsnoden där filsystemet ska monteras |
| source |
string |
URI:n för filsystemet som ska monteras. |
NodePlacementConfiguration
Nodplaceringskonfiguration för batchpooler.
| Namn | Typ | Beskrivning |
|---|---|---|
| policy |
Typ av nodplaceringspolicy på batchpooler. |
NodePlacementPolicyType
Standardvärdet är regionalt.
| Värde | Beskrivning |
|---|---|
| Regional |
Alla noder i poolen allokeras i samma region. |
| Zonal |
Noder i poolen kommer att spridas över olika zoner med bästa möjliga balansering. |
OSDisk
Inställningar för den virtuella datorns operativsystemdisk.
| Namn | Typ | Beskrivning |
|---|---|---|
| caching |
Typ av cachelagring som ska aktiveras för disken. |
|
| diskSizeGB |
integer (int32) |
Den ursprungliga diskstorleken i GB när du skapar en ny OS-disk. |
| ephemeralOSDiskSettings |
Anger tillfälliga diskinställningar för den operativsystemdisk som används av den virtuella datorn. |
|
| managedDisk |
Parametrarna för hanterade diskar. |
|
| writeAcceleratorEnabled |
boolean |
Anger om writeAccelerator ska aktiveras eller inaktiveras på disken. |
Pool
Innehåller information om en pool.
| Namn | Typ | Standardvärde | Beskrivning |
|---|---|---|---|
| etag |
string |
ETag för resursen, som används för samtidighetsinstruktioner. |
|
| id |
string (arm-id) |
Fullständigt kvalificerat resurs-ID för resursen. Till exempel "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}" |
|
| identity |
Den typ av identitet som används för Batch-poolen. |
||
| name |
string |
Namnet på resursen |
|
| properties.allocationState |
Om poolen ändrar storlek. |
||
| properties.allocationStateTransitionTime |
string (date-time) |
Den tid då poolen övergick till det aktuella allokeringstillståndet. |
|
| properties.applicationPackages |
Listan över programpaket som ska installeras på varje beräkningsnod i poolen. |
||
| properties.autoScaleRun |
Resultatet och felen från den senaste körningen av autoskalningsformeln. |
||
| properties.creationTime |
string (date-time) |
Skapandetiden för poolen. |
|
| properties.currentDedicatedNodes |
integer (int32) |
Antalet dedikerade beräkningsnoder som för närvarande finns i poolen. |
|
| properties.currentLowPriorityNodes |
integer (int32) |
Antalet beräkningsnoder med oanvänd kapacitet/låg prioritet som för närvarande finns i poolen. |
|
| properties.deploymentConfiguration |
Den här egenskapen beskriver de virtuella datorer som poolnoderna ska distribueras på. |
||
| properties.displayName |
string |
Visningsnamnet för poolen. |
|
| properties.interNodeCommunication |
Om poolen tillåter direkt kommunikation mellan noder. |
||
| properties.lastModified |
string (date-time) |
Den senaste ändrade tiden för poolen. |
|
| properties.metadata |
En lista över namn/värde-par som är associerade med poolen som metadata. |
||
| properties.mountConfiguration |
En lista över filsystem som ska monteras på varje nod i poolen. |
||
| properties.networkConfiguration |
Nätverkskonfigurationen för poolen. |
||
| properties.provisioningState |
Poolens aktuella tillstånd. |
||
| properties.provisioningStateTransitionTime |
string (date-time) |
Den tid då poolen övergick till sitt aktuella tillstånd. |
|
| properties.resizeOperationStatus |
Innehåller information om den aktuella eller senast slutförda storleksändringsåtgärden. |
||
| properties.scaleSettings |
Inställningar som konfigurerar antalet noder i poolen. |
||
| properties.startTask |
En uppgift som har angetts för att köras på varje beräkningsnod när den ansluter till poolen. |
||
| properties.taskSchedulingPolicy |
Hur aktiviteter distribueras mellan beräkningsnoder i en pool. |
||
| properties.taskSlotsPerNode |
integer (int32) |
1 |
Antalet aktivitetsfack som kan användas för att köra samtidiga uppgifter på en enda beräkningsnod i poolen. |
| properties.upgradePolicy |
Uppgraderingsprincipen för poolen. |
||
| properties.userAccounts |
Listan över användarkonton som ska skapas på varje nod i poolen. |
||
| properties.vmSize |
string |
Storleken på virtuella datorer i poolen. Alla virtuella datorer i en pool har samma storlek. |
|
| systemData |
Azure Resource Manager-metadata som innehåller createdBy och modifiedBy information. |
||
| tags |
object |
Taggarna för resursen. |
|
| type |
string |
Resurstypen. Till exempel "Microsoft.Compute/virtualMachines" eller "Microsoft.Storage/storageAccounts" |
PoolEndpointConfiguration
Slutpunktskonfigurationen för en pool.
| Namn | Typ | Beskrivning |
|---|---|---|
| inboundNatPools |
En lista över inkommande NAT-pooler som kan användas för att hantera specifika portar på en enskild beräkningsnod externt. |
PoolIdentityType
Den typ av identitet som används för Batch-poolen.
| Värde | Beskrivning |
|---|---|
| UserAssigned |
Batch-poolen har användartilldelade identiteter med sig. |
| None |
Batch-poolen har ingen associerad identitet. Om du anger |
PoolProvisioningState
Poolens aktuella tillstånd.
| Värde | Beskrivning |
|---|---|
| Succeeded |
Poolen är tillgänglig för att köra uppgifter beroende på tillgängligheten för beräkningsnoder. |
| Deleting |
Användaren har begärt att poolen ska tas bort, men borttagningsåtgärden har ännu inte slutförts. |
ProxyAgentSettings
Anger ProxyAgent-inställningar när den virtuella datorn skapas.
| Namn | Typ | Beskrivning |
|---|---|---|
| enabled |
boolean |
Anger om funktionen Metadata Security Protocol ska vara aktiverad på den virtuella datorn eller VM-skalningsuppsättningen. Standardvärdet är False. |
| imds |
Inställningar för IMDS-slutpunkten. |
|
| wireServer |
Inställningar för WireServer-slutpunkten. |
PublicIPAddressConfiguration
Den offentliga IP-adresskonfigurationen för nätverkskonfigurationen för en pool.
| Namn | Typ | Beskrivning |
|---|---|---|
| ipAddressIds |
string[] |
Listan över offentliga IP-adresser som Batch-tjänsten ska använda vid etablering av beräkningsnoder. |
| ipFamilies |
IPFamily[] |
IP-familjerna som används för att ange IP-versioner som är tillgängliga för poolen. |
| ipTags |
IPTag[] |
IP-taggar som kommer att tillämpas på nya publika IP-adresser som batch-skapar. |
| provision |
Etableringstypen för offentliga IP-adresser för Batch-poolen. |
ResizeError
Ett fel uppstod vid storleksändring av en pool.
| Namn | Typ | Beskrivning |
|---|---|---|
| code |
string |
En identifierare för felet. Koder är invarianta och är avsedda att användas programmatiskt. |
| details |
Ytterligare information om felet. |
|
| message |
string |
Ett meddelande som beskriver felet, avsett att vara lämpligt för visning i ett användargränssnitt. |
ResizeOperationStatus
Information om den aktuella eller senast slutförda storleksändringsåtgärden.
| Namn | Typ | Beskrivning |
|---|---|---|
| errors |
Information om eventuella fel som påträffades när du utförde den senaste storleksändringen i poolen. |
|
| nodeDeallocationOption |
Avgör vad du ska göra med en nod och dess aktiviteter som körs när den har valts för frigöring. |
|
| resizeTimeout |
string (duration) |
Tidsgränsen för allokering av beräkningsnoder till poolen eller borttagning av beräkningsnoder från poolen. |
| startTime |
string (date-time) |
Tiden då den här storleksändringsåtgärden startades. |
| targetDedicatedNodes |
integer (int32) |
Önskat antal dedikerade beräkningsnoder i poolen. |
| targetLowPriorityNodes |
integer (int32) |
Önskat antal beräkningsnoder med oanvänd kapacitet/låg prioritet i poolen. |
ResourceFile
En enda fil eller flera filer som ska laddas ned till en beräkningsnod.
| Namn | Typ | Beskrivning |
|---|---|---|
| autoStorageContainerName |
string |
Namnet på lagringscontainern i det automatiska lagringskontot. |
| blobPrefix |
string |
Blobprefixet som ska användas vid nedladdning av blobar från en Azure Storage-container. Endast de blobar vars namn börjar med det angivna prefixet laddas ned. |
| fileMode |
string |
Attributet för filbehörighetsläge i oktalt format. |
| filePath |
string |
Platsen på beräkningsnoden som filen ska laddas ned till i förhållande till aktivitetens arbetskatalog. |
| httpUrl |
string |
URL:en för filen som ska laddas ned. |
| identityReference |
Referensen till den användartilldelade identitet som ska användas för åtkomst till Azure Blob Storage som anges av storageContainerUrl eller httpUrl |
|
| storageContainerUrl |
string |
URL:en för blobcontainern i Azure Blob Storage. |
RollingUpgradePolicy
De konfigurationsparametrar som används vid löpande uppgradering.
| Namn | Typ | Beskrivning |
|---|---|---|
| enableCrossZoneUpgrade |
boolean |
Tillåt ATT VMSS ignorerar AZ-gränser när du skapar uppgraderingsbatch. Ta hänsyn till uppdateringsdomänen och maxBatchInstancePercent för att fastställa batchstorleken. Om det här fältet inte har angetts kommer Azure Azure Batch inte att ange sitt standardvärde. Värdet för enableCrossZoneUpgrade på den skapade VirtualMachineScaleSet bestäms av standardkonfigurationerna på VirtualMachineScaleSet. Det här fältet kan endast anges till sant eller falskt när nodePlacementConfiguration används som zonindelning. |
| maxBatchInstancePercent |
integer (int32) minimum: 5maximum: 100 |
Den maximala procentandelen av de totala virtuella datorinstanserna som uppgraderas samtidigt av den löpande uppgraderingen i en batch. Eftersom detta är ett maximalt antal felaktiga instanser i tidigare eller framtida batchar kan procentandelen instanser i en batch minska för att säkerställa högre tillförlitlighet. Värdet för det här fältet ska vara mellan 5 och 100, inklusive. Om både maxBatchInstancePercent och maxUnhealthyInstancePercent tilldelas med värde bör värdet för maxBatchInstancePercent inte vara mer än maxUnhealthyInstancePercent. |
| maxUnhealthyInstancePercent |
integer (int32) minimum: 5maximum: 100 |
Den maximala procentandelen av de totala virtuella datorinstanserna i skalningsuppsättningen som kan vara felfritt samtidigt, antingen till följd av uppgraderingen eller genom att hittas i ett feltillstånd av hälsokontrollerna för den virtuella datorn innan den löpande uppgraderingen avbryts. Den här begränsningen kontrolleras innan någon batch startas. Värdet för det här fältet ska vara mellan 5 och 100, inklusive. Om både maxBatchInstancePercent och maxUnhealthyInstancePercent tilldelas med värde bör värdet för maxBatchInstancePercent inte vara mer än maxUnhealthyInstancePercent. |
| maxUnhealthyUpgradedInstancePercent |
integer (int32) minimum: 0maximum: 100 |
Den maximala procentandelen uppgraderade virtuella datorinstanser som kan konstateras vara i ett feltillstånd. Den här kontrollen sker när varje batch har uppgraderats. Om den här procentandelen någonsin överskrids avbryts den löpande uppdateringen. Värdet för det här fältet ska vara mellan 0 och 100, inklusive. |
| pauseTimeBetweenBatches |
string |
Väntetiden mellan att slutföra uppdateringen för alla virtuella datorer i en batch och starta nästa batch. Varaktigheten ska anges i ISO 8601-format. |
| prioritizeUnhealthyInstances |
boolean |
Uppgradera alla instanser med feltillstånd i en skalningsuppsättning före eventuella felfria instanser. |
| rollbackFailedInstancesOnPolicyBreach |
boolean |
Återställningen misslyckades för instanser till en tidigare modell om principen för löpande uppgradering överträds. |
ScaleSettings
Skalningsinställningar för poolen
| Namn | Typ | Beskrivning |
|---|---|---|
| autoScale |
Autoskalningsinställningar för poolen. |
|
| fixedScale |
Inställningar för fast skalning för poolen. |
SecurityEncryptionTypes
Anger EncryptionType för den hanterade disken. Den är inställd på DiskWithVMGuestState för kryptering av den hanterade disken tillsammans med VMGuestState-blobben, VMGuestStateOnly för kryptering av endast VMGuestState-blobben, och NonPersistedTPM för att inte behålla firmware-tillståndet i VMGuestState-blobben. Obs: Det kan endast anges för konfidentiella virtuella datorer och krävs när du använder konfidentiella virtuella datorer.
| Värde | Beskrivning |
|---|---|
| NonPersistedTPM |
EncryptionType för den hanterade disken är inställd på NonPersistedTPM för att inte bevara tillståndet för inbyggd programvara i VMGuestState-bloben. |
| VMGuestStateOnly |
EncryptionType för den hanterade disken är inställd på VMGuestStateOnly för kryptering av bara VMGuestState-bloben. |
| DiskWithVMGuestState |
EncryptionType för den hanterade disken är inställd på DiskWithVMGuestState för kryptering av den hanterade disken tillsammans med VMGuestState-bloben. Det stöds inte i datadiskar. |
SecurityProfile
Anger säkerhetsprofilinställningarna för den virtuella datorn eller vm-skalningsuppsättningen.
| Namn | Typ | Beskrivning |
|---|---|---|
| encryptionAtHost |
boolean |
Den här egenskapen kan användas av användaren i begäran för att aktivera eller inaktivera värdkryptering för den virtuella datorn eller vm-skalningsuppsättningen. Detta aktiverar krypteringen för alla diskar, inklusive resurs/temp-disk på själva värden. |
| proxyAgentSettings |
Anger ProxyAgent-inställningar när den virtuella datorn skapas. |
|
| securityType |
Anger SecurityType för den virtuella datorn. Det måste anges till ett angivet värde för att aktivera UefiSettings. |
|
| uefiSettings |
Anger de säkerhetsinställningar som säker start och vTPM som används när den virtuella datorn skapas. |
SecurityTypes
Anger SecurityType för den virtuella datorn. Det måste anges till ett angivet värde för att aktivera UefiSettings.
| Värde | Beskrivning |
|---|---|
| trustedLaunch |
Betrodd start skyddar mot avancerade och beständiga attacktekniker. |
| confidentialVM |
Konfidentiell databehandling i Azure erbjuder konfidentiella virtuella datorer för klienter med höga krav på säkerhet och konfidentialitet. Dessa virtuella datorer tillhandahåller en stark, maskinvarubaserad gräns som hjälper dig att uppfylla dina säkerhetsbehov. Du kan använda konfidentiella virtuella datorer för migreringar utan att göra ändringar i koden, där plattformen skyddar den virtuella datorns tillstånd från att läsas eller ändras. |
ServiceArtifactReference
Anger tjänstartefaktreferens-ID:t som används för att ange samma avbildningsversion för alla virtuella datorer i skalningsuppsättningen när du använder den senaste avbildningsversionen.
| Namn | Typ | Beskrivning |
|---|---|---|
| id |
string |
Tjänstartefaktens referens-ID för ServiceArtifactReference |
StartTask
En uppgift som körs när en beräkningsnod ansluter till en pool i Azure Batch-tjänsten, eller när beräkningsnoden startas om eller omskapas.
| Namn | Typ | Standardvärde | Beskrivning |
|---|---|---|---|
| commandLine |
string |
Kommandoraden för startaktiviteten. |
|
| containerSettings |
Inställningarna för containern under vilken startaktiviteten körs. |
||
| environmentSettings |
En lista över miljövariabelinställningar för startaktiviteten. |
||
| maxTaskRetryCount |
integer (int32) |
0 |
Det maximala antalet gånger som aktiviteten kan försökas igen. |
| resourceFiles |
En lista över filer som Batch-tjänsten laddar ned till beräkningsnoden innan kommandoraden körs. |
||
| userIdentity |
Användaridentiteten som startaktiviteten körs under. |
||
| waitForSuccess |
boolean |
Om Batch-tjänsten ska vänta tills startaktiviteten har slutförts (d.v.s. avsluta med slutkod 0) innan du schemalägger några aktiviteter på beräkningsnoden. |
StorageAccountType
Lagringskontotypen som ska användas för att skapa datadiskar eller OS-diskar.
| Värde | Beskrivning |
|---|---|
| Standard_LRS |
Datadisken/OS-disken bör använda lokalt redundant standardlagring. |
| Premium_LRS |
Datadisken/OS-disken bör använda premium lokalt redundant lagring. |
| StandardSSD_LRS |
Datadisken/OS-disken ska använda standardlagring med lokalt redundant SSD. |
systemData
Metadata som rör skapande och senaste ändring av resursen.
| Namn | Typ | Beskrivning |
|---|---|---|
| createdAt |
string (date-time) |
Tidsstämpeln för resursskapande (UTC). |
| createdBy |
string |
Identiteten som skapade resursen. |
| createdByType |
Den typ av identitet som skapade resursen. |
|
| lastModifiedAt |
string (date-time) |
Tidsstämpeln för senaste ändring av resurs (UTC) |
| lastModifiedBy |
string |
Identiteten som senast ändrade resursen. |
| lastModifiedByType |
Den typ av identitet som senast ändrade resursen. |
TaskContainerSettings
Containerinställningarna för en uppgift.
| Namn | Typ | Beskrivning |
|---|---|---|
| containerHostBatchBindMounts |
Sökvägarna som du vill montera på containeraktiviteten. |
|
| containerRunOptions |
string |
Ytterligare alternativ för kommandot container create. |
| imageName |
string |
Avbildningen som ska användas för att skapa containern där uppgiften ska köras. |
| registry |
Det privata registret som innehåller containeravbildningen. |
|
| workingDirectory |
En flagga som anger var containeruppgiftens arbetskatalog finns. Standardvärdet är "taskWorkingDirectory". |
TaskSchedulingPolicy
Anger hur aktiviteter ska distribueras mellan beräkningsnoder.
| Namn | Typ | Standardvärde | Beskrivning |
|---|---|---|---|
| jobDefaultOrder |
Om inget anges är standardvärdet none. |
||
| nodeFillType | Spread |
Hur aktiviteter ska distribueras mellan beräkningsnoder. |
UefiSettings
Anger de säkerhetsinställningar som säker start och vTPM som används när den virtuella datorn skapas.
| Namn | Typ | Beskrivning |
|---|---|---|
| secureBootEnabled |
boolean |
Anger om säker start ska aktiveras på den virtuella datorn. |
| vTpmEnabled |
boolean |
Anger om vTPM ska aktiveras på den virtuella datorn. |
UpgradeMode
Anger läget för en uppgradering till virtuella datorer i skalningsuppsättningen.
Möjliga värden är:
Manuell – Du styr programmet för uppdateringar av virtuella datorer i skalningsuppsättningen. Du gör detta med hjälp av åtgärden manualUpgrade.
Automatisk – Alla virtuella datorer i skalningsuppsättningen uppdateras automatiskt samtidigt.
Rullande – Skalningsuppsättningen utför uppdateringar i batchar med en valfri paustid däremellan.
| Värde | Beskrivning |
|---|---|
| automatic |
Alla virtuella datorer i skalningsuppsättningen uppdateras automatiskt samtidigt. |
| manual |
Du styr programmet för uppdateringar av virtuella datorer i skalningsuppsättningen. Du gör detta med hjälp av åtgärden manualUpgrade. |
| rolling |
De befintliga instanserna i en skalningsuppsättning tas ned i batchar som ska uppgraderas. När den uppgraderade batchen är klar börjar instanserna ta trafik igen och nästa batch börjar. Detta fortsätter tills alla instanser har up-to-date. |
UpgradePolicy
Beskriver en uppgraderingsprincip – automatisk, manuell eller rullande.
| Namn | Typ | Beskrivning |
|---|---|---|
| automaticOSUpgradePolicy |
Konfigurationsparametrar som används för att utföra automatisk operativsystemuppgradering. |
|
| mode |
Anger läget för en uppgradering till virtuella datorer i skalningsuppsättningen. |
|
| rollingUpgradePolicy |
De konfigurationsparametrar som används vid löpande uppgradering. |
UserAccount
Egenskaper som används för att skapa en användare på en Azure Batch-nod.
| Namn | Typ | Beskrivning |
|---|---|---|
| elevationLevel |
Användarens höjdnivå. |
|
| linuxUserConfiguration |
Den Linux-specifika användarkonfigurationen för användarkontot. |
|
| name |
string |
Namnet på användarkontot. Namn kan innehålla alla Unicode-tecken upp till en maximal längd på 20. |
| password |
string (password) |
Lösenordet för användarkontot. |
| windowsUserConfiguration |
Den Windows-specifika användarkonfigurationen för användarkontot. |
UserAssignedIdentities
Listan över associerade användaridentiteter.
| Namn | Typ | Beskrivning |
|---|---|---|
| clientId |
string |
Klient-ID för användartilldelad identitet. |
| principalId |
string |
Huvud-ID för användartilldelad identitet. |
UserIdentity
Definitionen av användaridentiteten under vilken uppgiften körs.
| Namn | Typ | Beskrivning |
|---|---|---|
| autoUser |
Den automatiska användare under vilken aktiviteten körs. |
|
| userName |
string |
Namnet på den användaridentitet som aktiviteten körs under. |
VirtualMachineConfiguration
Konfigurationen för beräkningsnoder i en pool baserat på Azure Virtual Machines-infrastrukturen.
| Namn | Typ | Beskrivning |
|---|---|---|
| containerConfiguration |
Containerkonfigurationen för poolen. |
|
| dataDisks |
Data |
Konfigurationen för datadiskar som är anslutna till beräkningsnoderna i poolen. |
| diskEncryptionConfiguration |
Diskkrypteringskonfigurationen för poolen. |
|
| extensions |
Tillägget för den virtuella datorn för poolen. |
|
| imageReference |
En referens till Azure Virtual Machines Marketplace-avbildningen eller den anpassade virtual machine-avbildningen som ska användas. |
|
| licenseType |
string |
Den typ av lokal licens som ska användas vid distribution av operativsystemet. Windows_Server – Den lokala licensen gäller för Windows Server. Windows_Client – Den lokala licensen gäller för Windows-klienten. |
| nodeAgentSkuId |
string |
SKU:n för Batch-nodagenten som ska etableras på beräkningsnoder i poolen. |
| nodePlacementConfiguration |
Nodplaceringskonfigurationen för poolen. |
|
| osDisk |
Inställningar för den virtuella datorns operativsystemdisk. |
|
| securityProfile |
Anger säkerhetsprofilinställningarna för den virtuella datorn eller vm-skalningsuppsättningen. |
|
| serviceArtifactReference |
Anger tjänstartefaktreferens-ID:t som används för att ange samma avbildningsversion för alla virtuella datorer i skalningsuppsättningen när du använder den senaste avbildningsversionen. |
|
| windowsConfiguration |
Inställningar för Windows-operativsystem på den virtuella datorn. |
VMDiskSecurityProfile
Anger säkerhetsprofilinställningarna för den hanterade disken. Obs: Det kan bara anges för konfidentiella virtuella datorer och krävs när du använder konfidentiella virtuella datorer.
| Namn | Typ | Beskrivning |
|---|---|---|
| diskEncryptionSet |
Anger resurs-ID för kundhanterad diskkrypteringsuppsättning för den hanterade disk som används för customer managed key encrypted ConfidentialVM OS Disk och VMGuest blob. Den kan endast ställas in i UserSubscription-läge. |
|
| securityEncryptionType |
Anger EncryptionType för den hanterade disken. Den är inställd på VMGuestStateOnly för kryptering av bara VMGuestState-bloben och NonPersistedTPM för att inte bevara tillståndet för inbyggd programvara i VMGuestState-bloben.
Obs: Det kan endast anges för konfidentiella virtuella datorer och krävs när du använder konfidentiella virtuella datorer. |
VMExtension
Konfigurationen för tillägg för virtuella datorer.
| Namn | Typ | Beskrivning |
|---|---|---|
| autoUpgradeMinorVersion |
boolean |
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. |
| enableAutomaticUpgrade |
boolean |
Anger om tillägget ska uppgraderas automatiskt av plattformen om det finns en nyare version av tillägget tillgängligt. |
| name |
string |
Namnet på tillägget för den virtuella datorn. |
| protectedSettings |
Tillägget kan innehålla antingen protectedSettings eller protectedSettingsFromKeyVault eller inga skyddade inställningar alls. |
|
| provisionAfterExtensions |
string[] |
Samlingen med tilläggsnamn. |
| publisher |
string |
Namnet på tilläggshanterarens utgivare. |
| settings |
JSON-formaterade offentliga inställningar för tillägget. |
|
| type |
string |
Typ av tillägg. |
| typeHandlerVersion |
string |
Versionen av skripthanteraren. |
WindowsConfiguration
Inställningar för Windows-operativsystem som ska tillämpas på den virtuella datorn.
| Namn | Typ | Beskrivning |
|---|---|---|
| enableAutomaticUpdates |
boolean |
Om automatiska uppdateringar är aktiverade på den virtuella datorn. |
WindowsUserConfiguration
Egenskaper som används för att skapa ett användarkonto på en Windows-nod.
| Namn | Typ | Beskrivning |
|---|---|---|
| loginMode |
Inloggningsläge för användare |