Microsoft.Batch batchAccounts 2024-07-01
Definizione di risorsa Bicep
Il tipo di risorsa batchAccounts può essere distribuito con operazioni destinate a:
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-07-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à
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) |
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' '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' 'SecuredByPerimeter' |
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 |
|---|
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 |
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) |
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) |
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 = 3 Pattern = ^[a-z0-9]+$ (obbligatorio) |
| proprietà | Proprietà dell'account Batch. | BatchAccountCreatePropertiesOrBatchAccountProperties |
| Tag | Tag delle risorse | Dizionario di nomi e valori di tag. Vedere tag nei modelli |
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 |
UserAssignedIdentities
| Nome | Descrizione | Valore |
|---|
Esempi di avvio rapido
Gli esempi di avvio rapido seguenti distribuiscono questo tipo di risorsa.
| Bicep File | 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. |
Definizione di risorsa del modello di Resource Manager
Il tipo di risorsa batchAccounts può essere distribuito con operazioni destinate a:
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-07-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à
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) |
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' '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' 'SecuredByPerimeter' |
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 |
|---|
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 |
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) |
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) |
Microsoft.Batch/batchAccounts
| Nome | Descrizione | Valore |
|---|---|---|
| apiVersion | Versione dell'API | '2024-07-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 = 3 Pattern = ^[a-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' |
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 |
UserAssignedIdentities
| Nome | Descrizione | Valore |
|---|
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
|
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. |
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-07-01"
name = "string"
identity = {
type = "string"
userAssignedIdentities = {
{customized property} = {
}
}
}
location = "string"
tags = {
{customized property} = "string"
}
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à
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) |
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' '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' 'SecuredByPerimeter' |
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 |
|---|
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 |
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) |
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) |
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 = 3 Pattern = ^[a-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@2024-07-01" |
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 |
UserAssignedIdentities
| Nome | Descrizione | Valore |
|---|