Microsoft. Batch batchAccount

Definizione di risorsa Bicep

Il tipo di risorsa batchAccounts può essere distribuito con operazioni destinate a:

  • gruppi di risorse - Vedere i comandi di distribuzione del gruppo di risorse

Per un elenco delle proprietà modificate in ogni versione dell'API, vedere log delle modifiche.

Esempi di utilizzo

Esempi bicep

Esempio di base di distribuzione dell'account Azure Batch.

param resourceName string = 'acctest0001'
param location string = 'westeurope'

resource batchAccount 'Microsoft.Batch/batchAccounts@2022-10-01' = {
  name: resourceName
  location: location
  properties: {
    encryption: {
      keySource: 'Microsoft.Batch'
    }
    poolAllocationMode: 'BatchService'
    publicNetworkAccess: 'Enabled'
  }
}

Moduli verificati di Azure

Per distribuire questo tipo di risorsa, è possibile usare moduli verificati di Azure.

Modulo Descrizione
account Batch Modulo di risorse AVM per l'account Batch

Esempi di avvio rapido di Azure

I modelli di avvio rapido di Azure seguenti contengono esempi Bicep per la distribuzione di questo tipo di risorsa.

File bicipite Descrizione
pool di Azure Batch senza indirizzi IP pubblici Questo modello crea un pool di comunicazione dei nodi semplificato di Azure Batch senza indirizzi IP pubblici.
Creare un account Batch usando un modello Questo modello crea un account Batch e un account di archiviazione.

Formato risorsa

Per creare una risorsa Microsoft.Batch/batchAccounts, aggiungere il bicep seguente al modello.

resource symbolicname 'Microsoft.Batch/batchAccounts@2025-06-01' = {
  identity: {
    type: 'string'
    userAssignedIdentities: {
      {customized property}: {}
    }
  }
  location: 'string'
  name: 'string'
  properties: {
    allowedAuthenticationModes: [
      'string'
    ]
    autoStorage: {
      authenticationMode: 'string'
      nodeIdentityReference: {
        resourceId: 'string'
      }
      storageAccountId: 'string'
    }
    encryption: {
      keySource: 'string'
      keyVaultProperties: {
        keyIdentifier: 'string'
      }
    }
    keyVaultReference: {
      id: 'string'
      url: 'string'
    }
    networkProfile: {
      accountAccess: {
        defaultAction: 'string'
        ipRules: [
          {
            action: 'Allow'
            value: 'string'
          }
        ]
      }
      nodeManagementAccess: {
        defaultAction: 'string'
        ipRules: [
          {
            action: 'Allow'
            value: 'string'
          }
        ]
      }
    }
    poolAllocationMode: 'string'
    publicNetworkAccess: 'string'
  }
  tags: {
    {customized property}: 'string'
  }
}

Valori delle proprietà

Microsoft.Batch/batchAccounts

Nome Descrizione Valore
identità Identità dell'account Batch. batchAccountIdentity
ubicazione Area in cui creare l'account. stringa (obbligatorio)
nome Nome della risorsa corda

Vincoli:
Lunghezza minima = 3
Lunghezza massima = 24
Pattern = ^[a-zA-Z0-9]+$ (obbligatorio)
proprietà Proprietà dell'account Batch. BatchAccountCreatePropertiesOrBatchAccountProperties
Tag Tag delle risorse Dizionario di nomi e valori di tag. Vedere tag nei modelli

AutoStorageBasePropertiesOrAutoStorageProperties

Nome Descrizione Valore
authenticationMode Modalità di autenticazione che verrà usata dal servizio Batch per gestire l'account di archiviazione automatica. 'BatchAccountManagedIdentity'
'Chiavi di archiviazione'
nodeIdentityReference L'identità a cui viene fatto riferimento qui deve essere assegnata ai pool che dispongono di nodi di calcolo che devono accedere all'archiviazione automatica. ComputeNodeIdentityReference
storageAccountId ID risorsa dell'account di archiviazione da usare per l'account di archiviazione automatico. stringa (obbligatorio)

BatchAccountCreateParametersTags

Nome Descrizione Valore

BatchAccountCreatePropertiesOrBatchAccountProperties

Nome Descrizione Valore
allowedAuthenticationModes Elenco delle modalità di autenticazione consentite per l'account Batch che può essere usato per l'autenticazione con il piano dati. Ciò non influisce sull'autenticazione con il piano di controllo. Matrice di stringhe contenente uno dei seguenti elementi:
'AAD'
'Chiave condivisa'
'TaskAuthenticationToken'
Archiviazione automatica Proprietà correlate all'account di archiviazione automatica. AutoStorageBasePropertiesOrAutoStorageProperties
codifica Configura la modalità di crittografia dei dati dei clienti all'interno dell'account Batch. Per impostazione predefinita, gli account vengono crittografati usando una chiave gestita da Microsoft. Per un controllo aggiuntivo, è possibile usare invece una chiave gestita dal cliente. Proprietà di crittografia
keyVaultReference Riferimento all'insieme di credenziali delle chiavi di Azure associato all'account Batch. KeyVaultReference
Profilo di rete Il profilo di rete diventa effettivo solo quando publicNetworkAccess è abilitato. NetworkProfile
poolAllocationMode La modalità di allocazione del pool influisce anche sul modo in cui i client possono eseguire l'autenticazione all'API del servizio Batch. Se la modalità è BatchService, i client possono eseguire l'autenticazione usando le chiavi di accesso o l'ID Microsoft Entra. Se la modalità è UserSubscription, i client devono usare Microsoft Entra ID. Il valore predefinito è BatchService. 'BatchService'
'Abbonamento utente'
pubblicoAccesso alla rete Tipo di accesso di rete per l'uso delle risorse nell'account Batch. 'Disabilitato'
'Abilitato'
'SecuredByPerimeter'

BatchAccountIdentity

Nome Descrizione Valore
digitare Tipo di identità usato per l'account Batch. 'Nessuno'
'Assegnato dal sistema'
'UserAssigned' (obbligatorio)
userAssignedIdentities Elenco di identità utente associate all'account Batch. BatchAccountIdentityUserAssignedIdentities

BatchAccountIdentityUserAssignedIdentities

Nome Descrizione Valore

ComputeNodeIdentityReference

Nome Descrizione Valore
ID della risorsa ID risorsa ARM dell'identità assegnata dall'utente. corda

Proprietà di crittografia

Nome Descrizione Valore
Origine chiave Tipo dell'origine della chiave. 'Microsoft.Batch'
'Microsoft.KeyVault'
keyVaultProperties Dettagli aggiuntivi quando si usa Microsoft.KeyVault KeyVaultProperties

EndpointAccessProfile

Nome Descrizione Valore
defaultAction Azione predefinita per l'accesso all'endpoint. È applicabile solo quando publicNetworkAccess è abilitato. 'Consenti'
'Deny' (obbligatorio)
ipRegole Matrice di intervalli IP per filtrare l'indirizzo IP del client. IPRule[]

IPRule

Nome Descrizione Valore
azione Azione quando viene trovata una corrispondenza con l'indirizzo IP del client. 'Consenti' (obbligatorio)
valore Indirizzo IPv4 o intervallo di indirizzi IPv4 in formato CIDR. stringa (obbligatorio)

KeyVaultProperties

Nome Descrizione Valore
keyIdentifier Percorso completo del segreto con o senza versione. Esempio https://mykeyvault.vault.azure.net/keys/testkey/6e34a81fef704045975661e297a4c053. o https://mykeyvault.vault.azure.net/keys/testkey. Per poter essere utilizzabili, è necessario soddisfare i prerequisiti seguenti:

L'account Batch ha un'identità assegnata dal sistema
All'identità dell'account sono state concesse le autorizzazioni Key/Get, Key/Unwrap e Key/Wrap
KeyVault ha la protezione per l'eliminazione temporanea e la ripulitura abilitata		 corda

KeyVaultReference

Nome Descrizione Valore
Id ID risorsa dell'insieme di credenziali delle chiavi di Azure associato all'account Batch. stringa (obbligatorio)
URL URL dell'insieme di credenziali delle chiavi di Azure associato all'account Batch. stringa (obbligatorio)

Profilo di rete

Nome Descrizione Valore
accountAccesso Profilo di accesso di rete per l'endpoint batchAccount (API del piano dati dell'account Batch). EndpointAccessProfile
nodeManagementAccess Profilo di accesso alla rete per l'endpoint nodeManagement (servizio Batch che gestisce i nodi di calcolo per i pool di Batch). EndpointAccessProfile

UserAssignedIdentities

Nome Descrizione Valore

Definizione di risorsa del modello di Resource Manager

Il tipo di risorsa batchAccounts può essere distribuito con operazioni destinate a:

Esempi di utilizzo

Modelli di avvio rapido di Azure

I modelli di avvio rapido di Azure seguenti distribuire questo tipo di risorsa.

Sagoma Descrizione
pool di Azure Batch senza indirizzi IP pubblici

Distribuire in Azure 		Questo modello crea un pool di comunicazione dei nodi semplificato di Azure Batch senza indirizzi IP pubblici.
Creare un account Batch usando un modello

Distribuire in Azure 		Questo modello crea un account Batch e un account di archiviazione.

Formato risorsa

Per creare una risorsa Microsoft.Batch/batchAccounts, aggiungere il codice JSON seguente al modello.

{
  "type": "Microsoft.Batch/batchAccounts",
  "apiVersion": "2025-06-01",
  "name": "string",
  "identity": {
    "type": "string",
    "userAssignedIdentities": {
      "{customized property}": {
      }
    }
  },
  "location": "string",
  "properties": {
    "allowedAuthenticationModes": [ "string" ],
    "autoStorage": {
      "authenticationMode": "string",
      "nodeIdentityReference": {
        "resourceId": "string"
      },
      "storageAccountId": "string"
    },
    "encryption": {
      "keySource": "string",
      "keyVaultProperties": {
        "keyIdentifier": "string"
      }
    },
    "keyVaultReference": {
      "id": "string",
      "url": "string"
    },
    "networkProfile": {
      "accountAccess": {
        "defaultAction": "string",
        "ipRules": [
          {
            "action": "Allow",
            "value": "string"
          }
        ]
      },
      "nodeManagementAccess": {
        "defaultAction": "string",
        "ipRules": [
          {
            "action": "Allow",
            "value": "string"
          }
        ]
      }
    },
    "poolAllocationMode": "string",
    "publicNetworkAccess": "string"
  },
  "tags": {
    "{customized property}": "string"
  }
}

Valori delle proprietà

Microsoft.Batch/batchAccounts

Nome Descrizione Valore
versione dell'API Versione dell'API '2025-06-01'
identità Identità dell'account Batch. batchAccountIdentity
ubicazione Area in cui creare l'account. stringa (obbligatorio)
nome Nome della risorsa corda

Vincoli:
Lunghezza minima = 3
Lunghezza massima = 24
Pattern = ^[a-zA-Z0-9]+$ (obbligatorio)
proprietà Proprietà dell'account Batch. BatchAccountCreatePropertiesOrBatchAccountProperties
Tag Tag delle risorse Dizionario di nomi e valori di tag. Vedere tag nei modelli
digitare Tipo di risorsa 'Microsoft.Batch/batchAccounts'

AutoStorageBasePropertiesOrAutoStorageProperties

Nome Descrizione Valore
authenticationMode Modalità di autenticazione che verrà usata dal servizio Batch per gestire l'account di archiviazione automatica. 'BatchAccountManagedIdentity'
'Chiavi di archiviazione'
nodeIdentityReference L'identità a cui viene fatto riferimento qui deve essere assegnata ai pool che dispongono di nodi di calcolo che devono accedere all'archiviazione automatica. ComputeNodeIdentityReference
storageAccountId ID risorsa dell'account di archiviazione da usare per l'account di archiviazione automatico. stringa (obbligatorio)

BatchAccountCreateParametersTags

Nome Descrizione Valore

BatchAccountCreatePropertiesOrBatchAccountProperties

Nome Descrizione Valore
allowedAuthenticationModes Elenco delle modalità di autenticazione consentite per l'account Batch che può essere usato per l'autenticazione con il piano dati. Ciò non influisce sull'autenticazione con il piano di controllo. Matrice di stringhe contenente uno dei seguenti elementi:
'AAD'
'Chiave condivisa'
'TaskAuthenticationToken'
Archiviazione automatica Proprietà correlate all'account di archiviazione automatica. AutoStorageBasePropertiesOrAutoStorageProperties
codifica Configura la modalità di crittografia dei dati dei clienti all'interno dell'account Batch. Per impostazione predefinita, gli account vengono crittografati usando una chiave gestita da Microsoft. Per un controllo aggiuntivo, è possibile usare invece una chiave gestita dal cliente. Proprietà di crittografia
keyVaultReference Riferimento all'insieme di credenziali delle chiavi di Azure associato all'account Batch. KeyVaultReference
Profilo di rete Il profilo di rete diventa effettivo solo quando publicNetworkAccess è abilitato. NetworkProfile
poolAllocationMode La modalità di allocazione del pool influisce anche sul modo in cui i client possono eseguire l'autenticazione all'API del servizio Batch. Se la modalità è BatchService, i client possono eseguire l'autenticazione usando le chiavi di accesso o l'ID Microsoft Entra. Se la modalità è UserSubscription, i client devono usare Microsoft Entra ID. Il valore predefinito è BatchService. 'BatchService'
'Abbonamento utente'
pubblicoAccesso alla rete Tipo di accesso di rete per l'uso delle risorse nell'account Batch. 'Disabilitato'
'Abilitato'
'SecuredByPerimeter'

BatchAccountIdentity

Nome Descrizione Valore
digitare Tipo di identità usato per l'account Batch. 'Nessuno'
'Assegnato dal sistema'
'UserAssigned' (obbligatorio)
userAssignedIdentities Elenco di identità utente associate all'account Batch. BatchAccountIdentityUserAssignedIdentities

BatchAccountIdentityUserAssignedIdentities

Nome Descrizione Valore

ComputeNodeIdentityReference

Nome Descrizione Valore
ID della risorsa ID risorsa ARM dell'identità assegnata dall'utente. corda

Proprietà di crittografia

Nome Descrizione Valore
Origine chiave Tipo dell'origine della chiave. 'Microsoft.Batch'
'Microsoft.KeyVault'
keyVaultProperties Dettagli aggiuntivi quando si usa Microsoft.KeyVault KeyVaultProperties

EndpointAccessProfile

Nome Descrizione Valore
defaultAction Azione predefinita per l'accesso all'endpoint. È applicabile solo quando publicNetworkAccess è abilitato. 'Consenti'
'Deny' (obbligatorio)
ipRegole Matrice di intervalli IP per filtrare l'indirizzo IP del client. IPRule[]

IPRule

Nome Descrizione Valore
azione Azione quando viene trovata una corrispondenza con l'indirizzo IP del client. 'Consenti' (obbligatorio)
valore Indirizzo IPv4 o intervallo di indirizzi IPv4 in formato CIDR. stringa (obbligatorio)

KeyVaultProperties

Nome Descrizione Valore
keyIdentifier Percorso completo del segreto con o senza versione. Esempio https://mykeyvault.vault.azure.net/keys/testkey/6e34a81fef704045975661e297a4c053. o https://mykeyvault.vault.azure.net/keys/testkey. Per poter essere utilizzabili, è necessario soddisfare i prerequisiti seguenti:

L'account Batch ha un'identità assegnata dal sistema
All'identità dell'account sono state concesse le autorizzazioni Key/Get, Key/Unwrap e Key/Wrap
KeyVault ha la protezione per l'eliminazione temporanea e la ripulitura abilitata		 corda

KeyVaultReference

Nome Descrizione Valore
Id ID risorsa dell'insieme di credenziali delle chiavi di Azure associato all'account Batch. stringa (obbligatorio)
URL URL dell'insieme di credenziali delle chiavi di Azure associato all'account Batch. stringa (obbligatorio)

Profilo di rete

Nome Descrizione Valore
accountAccesso Profilo di accesso di rete per l'endpoint batchAccount (API del piano dati dell'account Batch). EndpointAccessProfile
nodeManagementAccess Profilo di accesso alla rete per l'endpoint nodeManagement (servizio Batch che gestisce i nodi di calcolo per i pool di Batch). EndpointAccessProfile

UserAssignedIdentities

Nome Descrizione Valore

Definizione di risorsa Terraform (provider AzAPI)

Il tipo di risorsa batchAccounts può essere distribuito con operazioni destinate a:

  • Gruppi di risorse Per un elenco delle proprietà modificate in ogni versione dell'API, vedi il registro modifiche.

Esempi di utilizzo

Esempi di Terraform

Esempio di base di distribuzione dell'account Azure Batch.

terraform {
  required_providers {
    azapi = {
      source = "Azure/azapi"
    }
  }
}

provider "azapi" {
  skip_provider_registration = false
}

variable "resource_name" {
  type    = string
  default = "acctest0001"
}

variable "location" {
  type    = string
  default = "westeurope"
}

resource "azapi_resource" "resourceGroup" {
  type     = "Microsoft.Resources/resourceGroups@2020-06-01"
  name     = var.resource_name
  location = var.location
}

resource "azapi_resource" "batchAccount" {
  type      = "Microsoft.Batch/batchAccounts@2022-10-01"
  parent_id = azapi_resource.resourceGroup.id
  name      = var.resource_name
  location  = var.location
  body = {
    properties = {
      encryption = {
        keySource = "Microsoft.Batch"
      }
      poolAllocationMode  = "BatchService"
      publicNetworkAccess = "Enabled"
    }
  }
  schema_validation_enabled = false
  response_export_values    = ["*"]
}

Moduli verificati di Azure

Per distribuire questo tipo di risorsa, è possibile usare moduli verificati di Azure.

Modulo Descrizione
account Batch Modulo di risorse AVM per l'account Batch

Formato risorsa

Per creare una risorsa Microsoft.Batch/batchAccounts, aggiungere il codice Terraform seguente al modello.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Batch/batchAccounts@2025-06-01"
  name = "string"
  parent_id = "string"
  identity {
    type = "string"
    identity_ids = [
      "string"
    ]
  }
  location = "string"
  tags = {
    {customized property} = "string"
  }
  body = {
    properties = {
      allowedAuthenticationModes = [
        "string"
      ]
      autoStorage = {
        authenticationMode = "string"
        nodeIdentityReference = {
          resourceId = "string"
        }
        storageAccountId = "string"
      }
      encryption = {
        keySource = "string"
        keyVaultProperties = {
          keyIdentifier = "string"
        }
      }
      keyVaultReference = {
        id = "string"
        url = "string"
      }
      networkProfile = {
        accountAccess = {
          defaultAction = "string"
          ipRules = [
            {
              action = "Allow"
              value = "string"
            }
          ]
        }
        nodeManagementAccess = {
          defaultAction = "string"
          ipRules = [
            {
              action = "Allow"
              value = "string"
            }
          ]
        }
      }
      poolAllocationMode = "string"
      publicNetworkAccess = "string"
    }
  }
}

Valori delle proprietà

Microsoft.Batch/batchAccounts

Nome Descrizione Valore
identità Identità dell'account Batch. batchAccountIdentity
ubicazione Area in cui creare l'account. stringa (obbligatorio)
nome Nome della risorsa corda

Vincoli:
Lunghezza minima = 3
Lunghezza massima = 24
Pattern = ^[a-zA-Z0-9]+$ (obbligatorio)
proprietà Proprietà dell'account Batch. BatchAccountCreatePropertiesOrBatchAccountProperties
Tag Tag delle risorse Dizionario di nomi e valori di tag.
digitare Tipo di risorsa "Microsoft.Batch/batchAccounts@2025-06-01"

AutoStorageBasePropertiesOrAutoStorageProperties

Nome Descrizione Valore
authenticationMode Modalità di autenticazione che verrà usata dal servizio Batch per gestire l'account di archiviazione automatica. 'BatchAccountManagedIdentity'
'Chiavi di archiviazione'
nodeIdentityReference L'identità a cui viene fatto riferimento qui deve essere assegnata ai pool che dispongono di nodi di calcolo che devono accedere all'archiviazione automatica. ComputeNodeIdentityReference
storageAccountId ID risorsa dell'account di archiviazione da usare per l'account di archiviazione automatico. stringa (obbligatorio)

BatchAccountCreateParametersTags

Nome Descrizione Valore

BatchAccountCreatePropertiesOrBatchAccountProperties

Nome Descrizione Valore
allowedAuthenticationModes Elenco delle modalità di autenticazione consentite per l'account Batch che può essere usato per l'autenticazione con il piano dati. Ciò non influisce sull'autenticazione con il piano di controllo. Matrice di stringhe contenente uno dei seguenti elementi:
'AAD'
'Chiave condivisa'
'TaskAuthenticationToken'
Archiviazione automatica Proprietà correlate all'account di archiviazione automatica. AutoStorageBasePropertiesOrAutoStorageProperties
codifica Configura la modalità di crittografia dei dati dei clienti all'interno dell'account Batch. Per impostazione predefinita, gli account vengono crittografati usando una chiave gestita da Microsoft. Per un controllo aggiuntivo, è possibile usare invece una chiave gestita dal cliente. Proprietà di crittografia
keyVaultReference Riferimento all'insieme di credenziali delle chiavi di Azure associato all'account Batch. KeyVaultReference
Profilo di rete Il profilo di rete diventa effettivo solo quando publicNetworkAccess è abilitato. NetworkProfile
poolAllocationMode La modalità di allocazione del pool influisce anche sul modo in cui i client possono eseguire l'autenticazione all'API del servizio Batch. Se la modalità è BatchService, i client possono eseguire l'autenticazione usando le chiavi di accesso o l'ID Microsoft Entra. Se la modalità è UserSubscription, i client devono usare Microsoft Entra ID. Il valore predefinito è BatchService. 'BatchService'
'Abbonamento utente'
pubblicoAccesso alla rete Tipo di accesso di rete per l'uso delle risorse nell'account Batch. 'Disabilitato'
'Abilitato'
'SecuredByPerimeter'

BatchAccountIdentity

Nome Descrizione Valore
digitare Tipo di identità usato per l'account Batch. 'Nessuno'
'Assegnato dal sistema'
'UserAssigned' (obbligatorio)
userAssignedIdentities Elenco di identità utente associate all'account Batch. BatchAccountIdentityUserAssignedIdentities

BatchAccountIdentityUserAssignedIdentities

Nome Descrizione Valore

ComputeNodeIdentityReference

Nome Descrizione Valore
ID della risorsa ID risorsa ARM dell'identità assegnata dall'utente. corda

Proprietà di crittografia

Nome Descrizione Valore
Origine chiave Tipo dell'origine della chiave. 'Microsoft.Batch'
'Microsoft.KeyVault'
keyVaultProperties Dettagli aggiuntivi quando si usa Microsoft.KeyVault KeyVaultProperties

EndpointAccessProfile

Nome Descrizione Valore
defaultAction Azione predefinita per l'accesso all'endpoint. È applicabile solo quando publicNetworkAccess è abilitato. 'Consenti'
'Deny' (obbligatorio)
ipRegole Matrice di intervalli IP per filtrare l'indirizzo IP del client. IPRule[]

IPRule

Nome Descrizione Valore
azione Azione quando viene trovata una corrispondenza con l'indirizzo IP del client. 'Consenti' (obbligatorio)
valore Indirizzo IPv4 o intervallo di indirizzi IPv4 in formato CIDR. stringa (obbligatorio)

KeyVaultProperties

Nome Descrizione Valore
keyIdentifier Percorso completo del segreto con o senza versione. Esempio https://mykeyvault.vault.azure.net/keys/testkey/6e34a81fef704045975661e297a4c053. o https://mykeyvault.vault.azure.net/keys/testkey. Per poter essere utilizzabili, è necessario soddisfare i prerequisiti seguenti:

L'account Batch ha un'identità assegnata dal sistema
All'identità dell'account sono state concesse le autorizzazioni Key/Get, Key/Unwrap e Key/Wrap
KeyVault ha la protezione per l'eliminazione temporanea e la ripulitura abilitata		 corda

KeyVaultReference

Nome Descrizione Valore
Id ID risorsa dell'insieme di credenziali delle chiavi di Azure associato all'account Batch. stringa (obbligatorio)
URL URL dell'insieme di credenziali delle chiavi di Azure associato all'account Batch. stringa (obbligatorio)

Profilo di rete

Nome Descrizione Valore
accountAccesso Profilo di accesso di rete per l'endpoint batchAccount (API del piano dati dell'account Batch). EndpointAccessProfile
nodeManagementAccess Profilo di accesso alla rete per l'endpoint nodeManagement (servizio Batch che gestisce i nodi di calcolo per i pool di Batch). EndpointAccessProfile

UserAssignedIdentities

Nome Descrizione Valore
  • Last updated on