Microsoft.Batch batchAccounts

  • مقالة
  • قراءة خلال 3 دقائق

The batchAccounts resource type can be deployed to: Resource groups.

To learn about resource group deployments, see Bicep or ARM template.

Template format

To create a Microsoft.Batch/batchAccounts resource, add the following Bicep or JSON to your template.

resource symbolicname 'Microsoft.Batch/batchAccounts@2022-01-01' = {
  name: 'string'
  location: 'string'
  tags: {
    tagName1: 'tagValue1'
    tagName2: 'tagValue2'
  }
  identity: {
    type: 'string'
    userAssignedIdentities: {}
  }
  properties: {
    allowedAuthenticationModes: [
      'string'
    ]
    autoStorage: {
      authenticationMode: 'string'
      nodeIdentityReference: {
        resourceId: 'string'
      }
      storageAccountId: 'string'
    }
    encryption: {
      keySource: 'string'
      keyVaultProperties: {
        keyIdentifier: 'string'
      }
    }
    keyVaultReference: {
      id: 'string'
      url: 'string'
    }
    poolAllocationMode: 'string'
    publicNetworkAccess: 'string'
  }
}

Property values

batchAccounts

Name Description Value
type The resource type

For Bicep, set this value in the resource declaration.		 'Microsoft.Batch/batchAccounts'
apiVersion The resource api version

For Bicep, set this value in the resource declaration.		 '2022-01-01'
name The resource name string (required)

Character limit: 3-24

Valid characters:
Lowercase letters and numbers.
location The region in which to create the account. string (required)
tags The user-specified tags associated with the account. Dictionary of tag names and values. See Tags in templates
identity The identity of the Batch account, if configured. This is used when the user specifies 'Microsoft.KeyVault' as their Batch account encryption configuration or when ManagedIdentity is selected as the auto-storage authentication mode. BatchAccountIdentity
properties The properties of a Batch account. BatchAccountCreateProperties

BatchAccountIdentity

Name Description Value
type The type of identity used for the Batch account. 'None'
'SystemAssigned'
'UserAssigned'
userAssignedIdentities The list of user identities associated with the Batch account. object

BatchAccountCreateProperties

Name Description Value
allowedAuthenticationModes List of allowed authentication modes for the Batch account that can be used to authenticate with the data plane. This does not affect authentication with the control plane. String array containing any of:
'AAD'
'SharedKey'
'TaskAuthenticationToken'
autoStorage The properties related to the auto-storage account. AutoStorageBaseProperties
encryption Configures how customer data is encrypted inside the Batch account. By default, accounts are encrypted using a Microsoft managed key. For additional control, a customer-managed key can be used instead. EncryptionProperties
keyVaultReference Identifies the Azure key vault associated with a Batch account. KeyVaultReference
poolAllocationMode The allocation mode for creating pools in the Batch account. 'BatchService'
'UserSubscription'
publicNetworkAccess The network access type for operating on the resources in the Batch account. 'Disabled'
'Enabled'

AutoStorageBaseProperties

Name Description Value
authenticationMode The authentication mode which the Batch service will use to manage the auto-storage account. 'BatchAccountManagedIdentity'
'StorageKeys'
nodeIdentityReference The reference to a user assigned identity associated with the Batch pool which a compute node will use. ComputeNodeIdentityReference
storageAccountId The resource ID of the storage account to be used for auto-storage account. string (required)

ComputeNodeIdentityReference

Name Description Value
resourceId The ARM resource id of the user assigned identity. string

EncryptionProperties

Name Description Value
keySource Type of the key source. 'Microsoft.Batch'
'Microsoft.KeyVault'
keyVaultProperties KeyVault configuration when using an encryption KeySource of Microsoft.KeyVault. KeyVaultProperties

KeyVaultProperties

Name Description Value
keyIdentifier Full path to the versioned secret. Example https://mykeyvault.vault.azure.net/keys/testkey/6e34a81fef704045975661e297a4c053. To be usable the following prerequisites must be met:

The Batch Account has a System Assigned identity
The account identity has been granted Key/Get, Key/Unwrap and Key/Wrap permissions
The KeyVault has soft-delete and purge protection enabled
 string

KeyVaultReference

Name Description Value
id The resource ID of the Azure key vault associated with the Batch account. string (required)
url The URL of the Azure key vault associated with the Batch account. string (required)

Quickstart templates

The following quickstart templates deploy this resource type.

Template Description
Create a Batch Account using a template

Deploy to Azure		 This template creates a Batch Account and a storage account.