Condividi tramite


Microsoft.Batch batchAccounts

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.

Formato risorsa

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

resource symbolicname 'Microsoft.Batch/batchAccounts@2024-02-01' = {
  name: 'string'
  location: 'string'
  tags: {
    tagName1: 'tagValue1'
    tagName2: 'tagValue2'
  }
  identity: {
    type: 'string'
    userAssignedIdentities: {
      {customized property}: {}
    }
  }
  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à

batchAccounts

Nome Descrizione Valore
nome Nome della risorsa stringa (obbligatorio)

Limite di caratteri: 3-24

Caratteri validi:
Lettere minuscole e numeri.
ubicazione Area in cui creare l'account. stringa (obbligatorio)
Tag Tag specificati dall'utente associati all'account. Dizionario di nomi e valori di tag. Vedere tag nei modelli
identità Identità dell'account Batch. batchAccountIdentity
proprietà Proprietà dell'account Batch. BatchAccountCreatePropertiesOrBatchAccountProperties

BatchAccountIdentity

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

BatchAccountIdentityUserAssignedIdentities

Nome Descrizione Valore
{proprietà personalizzata} UserAssignedIdentities

UserAssignedIdentities

Questo oggetto non contiene proprietà da impostare durante la distribuzione. Tutte le proprietà sono ReadOnly.

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'
'SharedKey'
'TaskAuthenticationToken'
autoStorage 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. EncryptionProperties
keyVaultReference Riferimento all'insieme di credenziali delle chiavi di Azure associato all'account Batch. KeyVaultReference
networkProfile 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'
'UserSubscription'
publicNetworkAccess Se non specificato, il valore predefinito è 'enabled'. 'Disabilitato'
'Enabled'

AutoStorageBasePropertiesOrAutoStorageProperties

Nome Descrizione Valore
authenticationMode Modalità di autenticazione che verrà usata dal servizio Batch per gestire l'account di archiviazione automatica. 'BatchAccountManagedIdentity'
'StorageKeys'
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)

ComputeNodeIdentityReference

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

EncryptionProperties

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

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)

NetworkProfile

Nome Descrizione Valore
accountAccess 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

EndpointAccessProfile

Nome Descrizione Valore
defaultAction Azione predefinita per l'accesso all'endpoint. È applicabile solo quando publicNetworkAccess è abilitato. 'Consenti'
'Deny' (obbligatorio)
ipRules 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)

Modelli di avvio rapido

I modelli di avvio rapido seguenti distribuiscono 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.

Definizione di risorsa del modello di Resource Manager

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.

Formato risorsa

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

{
  "type": "Microsoft.Batch/batchAccounts",
  "apiVersion": "2024-02-01",
  "name": "string",
  "location": "string",
  "tags": {
    "tagName1": "tagValue1",
    "tagName2": "tagValue2"
  },
  "identity": {
    "type": "string",
    "userAssignedIdentities": {
      "{customized property}": {}
    }
  },
  "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à

batchAccounts

Nome Descrizione Valore
digitare Tipo di risorsa 'Microsoft.Batch/batchAccounts'
apiVersion Versione dell'API della risorsa '2024-02-01'
nome Nome della risorsa stringa (obbligatorio)

Limite di caratteri: 3-24

Caratteri validi:
Lettere minuscole e numeri.
ubicazione Area in cui creare l'account. stringa (obbligatorio)
Tag Tag specificati dall'utente associati all'account. Dizionario di nomi e valori di tag. Vedere tag nei modelli
identità Identità dell'account Batch. batchAccountIdentity
proprietà Proprietà dell'account Batch. BatchAccountCreatePropertiesOrBatchAccountProperties

BatchAccountIdentity

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

BatchAccountIdentityUserAssignedIdentities

Nome Descrizione Valore
{proprietà personalizzata} UserAssignedIdentities

UserAssignedIdentities

Questo oggetto non contiene proprietà da impostare durante la distribuzione. Tutte le proprietà sono ReadOnly.

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'
'SharedKey'
'TaskAuthenticationToken'
autoStorage 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. EncryptionProperties
keyVaultReference Riferimento all'insieme di credenziali delle chiavi di Azure associato all'account Batch. KeyVaultReference
networkProfile 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'
'UserSubscription'
publicNetworkAccess Se non specificato, il valore predefinito è 'enabled'. 'Disabilitato'
'Enabled'

AutoStorageBasePropertiesOrAutoStorageProperties

Nome Descrizione Valore
authenticationMode Modalità di autenticazione che verrà usata dal servizio Batch per gestire l'account di archiviazione automatica. 'BatchAccountManagedIdentity'
'StorageKeys'
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)

ComputeNodeIdentityReference

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

EncryptionProperties

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

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)

NetworkProfile

Nome Descrizione Valore
accountAccess 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

EndpointAccessProfile

Nome Descrizione Valore
defaultAction Azione predefinita per l'accesso all'endpoint. È applicabile solo quando publicNetworkAccess è abilitato. 'Consenti'
'Deny' (obbligatorio)
ipRules 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)

Modelli di avvio rapido

I modelli di avvio rapido seguenti distribuiscono 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.

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, vedere log delle modifiche.

Formato risorsa

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

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Batch/batchAccounts@2024-02-01"
  name = "string"
  location = "string"
  parent_id = "string"
  tags = {
    tagName1 = "tagValue1"
    tagName2 = "tagValue2"
  }
  identity {
    type = "string"
    identity_ids = []
  }
  body = jsonencode({
    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à

batchAccounts

Nome Descrizione Valore
digitare Tipo di risorsa "Microsoft.Batch/batchAccounts@2024-02-01"
nome Nome della risorsa stringa (obbligatorio)

Limite di caratteri: 3-24

Caratteri validi:
Lettere minuscole e numeri.
ubicazione Area in cui creare l'account. stringa (obbligatorio)
parent_id Per eseguire la distribuzione in un gruppo di risorse, usare l'ID del gruppo di risorse. stringa (obbligatorio)
Tag Tag specificati dall'utente associati all'account. Dizionario di nomi e valori di tag.
identità Identità dell'account Batch. batchAccountIdentity
proprietà Proprietà dell'account Batch. BatchAccountCreatePropertiesOrBatchAccountProperties

BatchAccountIdentity

Nome Descrizione Valore
digitare Tipo di identità usato per l'account Batch. "SystemAssigned"
"UserAssigned" (obbligatorio)
identity_ids Elenco di identità utente associate all'account Batch. Matrice di ID identità utente.

BatchAccountIdentityUserAssignedIdentities

Nome Descrizione Valore
{proprietà personalizzata} UserAssignedIdentities

UserAssignedIdentities

Questo oggetto non contiene proprietà da impostare durante la distribuzione. Tutte le proprietà sono ReadOnly.

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"
"SharedKey"
"TaskAuthenticationToken"
autoStorage 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. EncryptionProperties
keyVaultReference Riferimento all'insieme di credenziali delle chiavi di Azure associato all'account Batch. KeyVaultReference
networkProfile 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"
"UserSubscription"
publicNetworkAccess Se non specificato, il valore predefinito è 'enabled'. "Disabilitato"
"Abilitato"

AutoStorageBasePropertiesOrAutoStorageProperties

Nome Descrizione Valore
authenticationMode Modalità di autenticazione che verrà usata dal servizio Batch per gestire l'account di archiviazione automatica. "BatchAccountManagedIdentity"
"StorageKeys"
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)

ComputeNodeIdentityReference

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

EncryptionProperties

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

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)

NetworkProfile

Nome Descrizione Valore
accountAccess 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

EndpointAccessProfile

Nome Descrizione Valore
defaultAction Azione predefinita per l'accesso all'endpoint. È applicabile solo quando publicNetworkAccess è abilitato. "Consenti"
"Nega" (obbligatorio)
ipRules 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)