Microsoft.Batch batchAccounts
Definizione di risorsa Bicep
Il tipo di risorsa batchAccounts può essere distribuito in:
- Gruppi di risorse - Vedere i comandi di distribuzione dei gruppi di risorse
Per un elenco delle proprietà modificate in ogni versione dell'API, vedere Log delle modifiche.
Formato di risorsa
Per creare una risorsa Microsoft.Batch/batchAccounts, aggiungere il bicep seguente al modello.
resource symbolicname 'Microsoft.Batch/batchAccounts@2022-10-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'
}
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 |
|---|---|---|
| name | Nome della risorsa | stringa (obbligatorio) Limite di caratteri: 3-24 Caratteri validi: Lettere minuscole e numeri. |
| posizione | Area in cui creare l'account. | stringa (obbligatorio) |
| tags | Tag specificati dall'utente associati all'account. | Dizionario di nomi e valori di tag. Vedere Tag nei modelli |
| identity | Identità dell'account Batch. | BatchAccountIdentity |
| properties | Proprietà dell'account Batch. | BatchAccountCreatePropertiesOrBatchAccountProperties |
BatchAccountIdentity
| Nome | Descrizione | valore |
|---|---|---|
| tipo | Tipo di identità usato per l'account Batch. | 'Nessuno' 'SystemAssigned' 'UserAssigned' (obbligatorio) |
| userAssignedIdentities | Elenco di identità utente associate all'account Batch. | object |
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 |
| Crittografia | 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 chiavi di accesso o Azure Active Directory. Se la modalità è UserSubscription, i client devono usare Azure Active Directory. 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 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. | string |
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 versione. Ad esempio, https://mykeyvault.vault.azure.net/keys/testkey/6e34a81fef704045975661e297a4c053. Per 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 L'insieme di credenziali delle chiavi ha la protezione dell'eliminazione temporanea e dell'eliminazione abilitata |
string |
KeyVaultReference
| Nome | Descrizione | valore |
|---|---|---|
| id | ID risorsa dell'istanza di Azure Key Vault associata all'account Batch. | stringa (obbligatorio) |
| url | URL dell'istanza di Azure Key Vault associata all'account Batch. | stringa (obbligatorio) |
NetworkProfile
| Nome | Descrizione | valore |
|---|---|---|
| accountAccess | Profilo di accesso alla 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.
| Modello | Descrizione |
|---|---|
Azure Batch pool senza indirizzi IP pubblici |
Questo modello crea Azure Batch pool di comunicazione dei nodi semplificato 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 in:
- Gruppi di risorse - Vedere i comandi di distribuzione dei gruppi di risorse
Per un elenco delle proprietà modificate in ogni versione dell'API, vedere Log delle modifiche.
Formato di risorsa
Per creare una risorsa Microsoft.Batch/batchAccounts, aggiungere il codice JSON seguente al modello.
{
"type": "Microsoft.Batch/batchAccounts",
"apiVersion": "2022-10-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"
},
"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 |
|---|---|---|
| tipo | Tipo di risorsa | 'Microsoft.Batch/batchAccounts' |
| apiVersion | Versione dell'API della risorsa | '2022-10-01' |
| name | Nome della risorsa | stringa (obbligatorio) Limite di caratteri: 3-24 Caratteri validi: Lettere minuscole e numeri. |
| posizione | Area in cui creare l'account. | stringa (obbligatorio) |
| tags | Tag specificati dall'utente associati all'account. | Dizionario di nomi e valori di tag. Vedere Tag nei modelli |
| identity | Identità dell'account Batch. | BatchAccountIdentity |
| properties | Proprietà dell'account Batch. | BatchAccountCreatePropertiesOrBatchAccountProperties |
BatchAccountIdentity
| Nome | Descrizione | valore |
|---|---|---|
| tipo | Tipo di identità usato per l'account Batch. | 'Nessuno' 'SystemAssigned' 'UserAssigned' (obbligatorio) |
| userAssignedIdentities | Elenco di identità utente associate all'account Batch. | object |
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 |
| Crittografia | 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 chiavi di accesso o Azure Active Directory. Se la modalità è UserSubscription, i client devono usare Azure Active Directory. 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 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. | string |
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 versione. Ad esempio, https://mykeyvault.vault.azure.net/keys/testkey/6e34a81fef704045975661e297a4c053. Per essere utilizzabile, è necessario soddisfare i prerequisiti seguenti:L'account Batch ha un'identità assegnata dal sistema L'identità dell'account è stata concessa alle autorizzazioni Key/Get, Key/Unwrap e Key/Wrapping KeyVault ha la protezione di eliminazione temporanea e eliminazione abilitata |
string |
KeyVaultReference
| Nome | Descrizione | valore |
|---|---|---|
| id | ID risorsa dell'istanza di Azure Key Vault associata all'account Batch. | stringa (obbligatoria) |
| url | URL dell'istanza di Azure Key Vault associata all'account Batch. | stringa (obbligatoria) |
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 di rete per l'endpoint nodeManagement (servizio Batch che gestisce i nodi di calcolo per i pool batch). | EndpointAccessProfile |
EndpointAccessProfile
| Nome | Descrizione | valore |
|---|---|---|
| Defaultaction | Azione predefinita per l'accesso all'endpoint. È applicabile solo quando publicNetworkAccess è abilitato. | 'Allow' 'Deny' (obbligatorio) |
| ipRules | Matrice di intervalli IP per filtrare l'indirizzo IP client. | IPRule[] |
IPRule
| Nome | Descrizione | valore |
|---|---|---|
| azione | Azione quando viene corrispondente l'indirizzo IP client. | 'Allow' (obbligatorio) |
| Valore | Indirizzo IPv4 o intervallo di indirizzi IPv4 in formato CIDR. | stringa (obbligatoria) |
Modelli di avvio rapido
I modelli di avvio rapido seguenti distribuiscono questo tipo di risorsa.
| Modello | Descrizione |
|---|---|
| Azure Batch pool senza indirizzi IP pubblici |
Questo modello crea Azure Batch pool di comunicazioni del nodo semplificato senza indirizzi IP pubblici. |
| Creare un account Batch usando un modello |
Questo modello crea un account Batch e un account di archiviazione. |
Definizione della risorsa Terraform (provider AzAPI)
Il tipo di risorsa batchAccounts può essere distribuito in:
- Gruppi di risorse
Per un elenco delle proprietà modificate in ogni versione dell'API, vedere log delle modifiche.
Formato di risorsa
Per creare una risorsa Microsoft.Batch/batchAccounts, aggiungere il codice Terraform seguente al modello.
resource "azapi_resource" "symbolicname" {
type = "Microsoft.Batch/batchAccounts@2022-10-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 |
|---|---|---|
| tipo | Tipo di risorsa | "Microsoft.Batch/batchAccounts@2022-10-01" |
| name | Nome della risorsa | stringa (obbligatoria) Limite di caratteri: 3-24 Caratteri validi: Lettere minuscole e numeri. |
| posizione | Area in cui creare l'account. | stringa (obbligatoria) |
| parent_id | Per distribuire in un gruppo di risorse, usare l'ID del gruppo di risorse. | stringa (obbligatoria) |
| tags | Tag specificati dall'utente associati all'account. | Dizionario dei nomi e dei valori dei tag. |
| identity | Identità dell'account Batch. | BatchAccountIdentity |
| properties | Proprietà dell'account Batch. | BatchAccountCreatePropertiesOrBatchAccountProperties |
BatchAccountIdentity
| Nome | Descrizione | valore |
|---|---|---|
| tipo | Tipo di identità utilizzata per l'account Batch. | "SystemAssigned" "UserAssigned" (obbligatorio) |
| identity_ids | Elenco delle identità utente associate all'account Batch. | Matrice di ID identità utente. |
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 qualsiasi di: "AAD" "SharedKey" "TaskAuthenticationToken" |
| autoStorage | Proprietà correlate all'account di archiviazione automatica. | AutoStorageBasePropertiesOrAutoStorageProperties |
| Crittografia | Configura il modo in cui i dati dei clienti vengono crittografati 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 ha effetto 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 chiavi di accesso o Azure Active Directory. Se la modalità è UserSubscription, i client devono usare Azure Active Directory. Il valore predefinito è BatchService. | "BatchService" "UserSubscription" |
| publicNetworkAccess | Se non specificato, il valore predefinito è "abilitato". | "Disabilitato" "Abilitato" |
AutoStorageBasePropertiesOrAutoStorageProperties
| Nome | Descrizione | valore |
|---|---|---|
| authenticationMode | Modalità di autenticazione che il servizio Batch userà per gestire l'account di archiviazione automatica. | "BatchAccountManagedIdentity" "StorageKeys" |
| nodeIdentityReference | L'identità a cui si fa riferimento qui deve essere assegnata a pool con nodi di calcolo che necessitano dell'accesso all'archiviazione automatica. | ComputeNodeIdentityReference |
| storageAccountId | ID risorsa dell'account di archiviazione da usare per l'account di archiviazione automatica. | stringa (obbligatoria) |
ComputeNodeIdentityReference
| Nome | Descrizione | valore |
|---|---|---|
| resourceId | ID risorsa ARM dell'identità assegnata dall'utente. | string |
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 versione. Ad esempio, https://mykeyvault.vault.azure.net/keys/testkey/6e34a81fef704045975661e297a4c053. Per essere utilizzabile, è necessario soddisfare i prerequisiti seguenti:L'account Batch ha un'identità assegnata dal sistema L'identità dell'account è stata concessa alle autorizzazioni Key/Get, Key/Unwrap e Key/Wrapping KeyVault ha la protezione di eliminazione temporanea e eliminazione abilitata |
string |
KeyVaultReference
| Nome | Descrizione | valore |
|---|---|---|
| id | ID risorsa dell'istanza di Azure Key Vault associata all'account Batch. | stringa (obbligatoria) |
| url | URL dell'istanza di Azure Key Vault associata all'account Batch. | stringa (obbligatoria) |
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 di rete per l'endpoint nodeManagement (servizio Batch che gestisce i nodi di calcolo per i pool 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 client. | IPRule[] |
IPRule
| Nome | Descrizione | valore |
|---|---|---|
| azione | Azione quando viene corrispondente l'indirizzo IP client. | "Consenti" (obbligatorio) |
| Valore | Indirizzo IPv4 o intervallo di indirizzi IPv4 in formato CIDR. | stringa (obbligatoria) |