Partager via

Microsoft.Batch BatchAccounts 2022-10-01

  • Article

Définition de ressource Bicep

Le type de ressource batchAccounts peut être déployé avec des opérations qui ciblent :

Pour obtenir la liste des propriétés modifiées dans chaque version de l’API, consultez journal des modifications.

Format de ressource

Pour créer une ressource Microsoft.Batch/batchAccounts, ajoutez le bicep suivant à votre modèle.

resource symbolicname 'Microsoft.Batch/batchAccounts@2022-10-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'
  }
}

Valeurs de propriété

AutoStorageBasePropertiesOrAutoStorageProperties

Nom Description Valeur
authenticationMode Mode d’authentification utilisé par le service Batch pour gérer le compte de stockage automatique. 'BatchAccountManagedIdentity'
'StorageKeys'
nodeIdentityReference L’identité référencée ici doit être affectée aux pools qui ont des nœuds de calcul qui ont besoin d’accéder au stockage automatique. ComputeNodeIdentityReference
storageAccountId ID de ressource du compte de stockage à utiliser pour le compte de stockage automatique. chaîne (obligatoire)

BatchAccountCreateParametersTags

Nom Description Valeur

BatchAccountCreatePropertiesOrBatchAccountProperties

Nom Description Valeur
allowedAuthenticationModes Liste des modes d’authentification autorisés pour le compte Batch qui peuvent être utilisés pour s’authentifier auprès du plan de données. Cela n’affecte pas l’authentification avec le plan de contrôle. Tableau de chaînes contenant l’un des éléments suivants :
'AAD'
'SharedKey'
'TaskAuthenticationToken'
autoStorage Propriétés associées au compte de stockage automatique. AutoStorageBasePropertiesOrAutoStorageProperties
chiffrement Configure la façon dont les données client sont chiffrées à l’intérieur du compte Batch. Par défaut, les comptes sont chiffrés à l’aide d’une clé gérée par Microsoft. Pour un contrôle supplémentaire, une clé gérée par le client peut être utilisée à la place. EncryptionProperties
keyVaultReference Référence au coffre de clés Azure associé au compte Batch. KeyVaultReference
networkProfile Le profil réseau prend effet uniquement lorsque publicNetworkAccess est activé. NetworkProfile
poolAllocationMode Le mode d’allocation de pool affecte également la façon dont les clients peuvent s’authentifier auprès de l’API de service Batch. Si le mode est BatchService, les clients peuvent s’authentifier à l’aide de clés d’accès ou d’Azure Active Directory. Si le mode est UserSubscription, les clients doivent utiliser Azure Active Directory. La valeur par défaut est BatchService. 'BatchService'
'UserSubscription'
publicNetworkAccess Si elle n’est pas spécifiée, la valeur par défaut est « enabled ». 'Désactivé'
'Activé'

BatchAccountIdentity

Nom Description Valeur
type Type d’identité utilisé pour le compte Batch. 'None'
'SystemAssigned'
'UserAssigned' (obligatoire)
userAssignedIdentities Liste des identités utilisateur associées au compte Batch. BatchAccountIdentityUserAssignedIdentities

BatchAccountIdentityUserAssignedIdentities

Nom Description Valeur

ComputeNodeIdentityReference

Nom Description Valeur
resourceId ID de ressource ARM de l’identité affectée par l’utilisateur. corde

EncryptionProperties

Nom Description Valeur
keySource Type de la source de clé. 'Microsoft.Batch'
'Microsoft.KeyVault'
keyVaultProperties Détails supplémentaires lors de l’utilisation de Microsoft.KeyVault KeyVaultProperties

EndpointAccessProfile

Nom Description Valeur
defaultAction Action par défaut pour l’accès au point de terminaison. Elle s’applique uniquement lorsque publicNetworkAccess est activé. 'Autoriser'
'Deny' (obligatoire)
ipRules Tableau de plages d’adresses IP pour filtrer l’adresse IP du client. IPRule []

IPRule

Nom Description Valeur
action Action lorsque l’adresse IP du client est mise en correspondance. 'Allow' (obligatoire)
valeur Adresse IPv4 ou plage d’adresses IPv4 au format CIDR. chaîne (obligatoire)

KeyVaultProperties

Nom Description Valeur
keyIdentifier Chemin complet du secret versionné. Par exemple : https://mykeyvault.vault.azure.net/keys/testkey/6e34a81fef704045975661e297a4c053. Pour être utilisable, les conditions préalables suivantes doivent être remplies :

Le compte Batch a une identité affectée par le système
L’identité du compte a reçu les autorisations Key/Get, Key/Unwrap et Key/Wrap
KeyVault a la protection contre la suppression réversible et le vidage activés		 corde

KeyVaultReference

Nom Description Valeur
id ID de ressource du coffre de clés Azure associé au compte Batch. chaîne (obligatoire)
URL URL du coffre de clés Azure associé au compte Batch. chaîne (obligatoire)

Microsoft.Batch/batchAccounts

Nom Description Valeur
identité Identité du compte Batch. BatchAccountIdentity
emplacement Région dans laquelle créer le compte. chaîne (obligatoire)
nom Nom de la ressource corde

Contraintes:
Longueur minimale = 3
Longueur maximale = 3
Modèle = ^[a-z0-9]+$ (obligatoire)
Propriétés Propriétés du compte Batch. BatchAccountCreatePropertiesOrBatchAccountProperties
étiquettes Balises de ressource Dictionnaire de noms et de valeurs d’étiquettes. Consultez les balises dans les modèles

NetworkProfile

Nom Description Valeur
accountAccess Profil d’accès réseau pour le point de terminaison batchAccount (API de plan de données de compte Batch). EndpointAccessProfile
nodeManagementAccess Profil d’accès réseau pour le point de terminaison nodeManagement (service Batch gérant les nœuds de calcul pour les pools Batch). EndpointAccessProfile

UserAssignedIdentities

Nom Description Valeur

Exemples de démarrage rapide

Les exemples de démarrage rapide suivants déploient ce type de ressource.

Fichier Bicep Description
pool Azure Batch sans adresses IP publiques Ce modèle crée un pool de communications de nœud simplifié Azure Batch sans adresses IP publiques.
Créer un compte Batch à l’aide d’un modèle Ce modèle crée un compte Batch et un compte de stockage.

Définition de ressource de modèle ARM

Le type de ressource batchAccounts peut être déployé avec des opérations qui ciblent :

Pour obtenir la liste des propriétés modifiées dans chaque version de l’API, consultez journal des modifications.

Format de ressource

Pour créer une ressource Microsoft.Batch/batchAccounts, ajoutez le code JSON suivant à votre modèle.

{
  "type": "Microsoft.Batch/batchAccounts",
  "apiVersion": "2022-10-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"
  }
}

Valeurs de propriété

AutoStorageBasePropertiesOrAutoStorageProperties

Nom Description Valeur
authenticationMode Mode d’authentification utilisé par le service Batch pour gérer le compte de stockage automatique. 'BatchAccountManagedIdentity'
'StorageKeys'
nodeIdentityReference L’identité référencée ici doit être affectée aux pools qui ont des nœuds de calcul qui ont besoin d’accéder au stockage automatique. ComputeNodeIdentityReference
storageAccountId ID de ressource du compte de stockage à utiliser pour le compte de stockage automatique. chaîne (obligatoire)

BatchAccountCreateParametersTags

Nom Description Valeur

BatchAccountCreatePropertiesOrBatchAccountProperties

Nom Description Valeur
allowedAuthenticationModes Liste des modes d’authentification autorisés pour le compte Batch qui peuvent être utilisés pour s’authentifier auprès du plan de données. Cela n’affecte pas l’authentification avec le plan de contrôle. Tableau de chaînes contenant l’un des éléments suivants :
'AAD'
'SharedKey'
'TaskAuthenticationToken'
autoStorage Propriétés associées au compte de stockage automatique. AutoStorageBasePropertiesOrAutoStorageProperties
chiffrement Configure la façon dont les données client sont chiffrées à l’intérieur du compte Batch. Par défaut, les comptes sont chiffrés à l’aide d’une clé gérée par Microsoft. Pour un contrôle supplémentaire, une clé gérée par le client peut être utilisée à la place. EncryptionProperties
keyVaultReference Référence au coffre de clés Azure associé au compte Batch. KeyVaultReference
networkProfile Le profil réseau prend effet uniquement lorsque publicNetworkAccess est activé. NetworkProfile
poolAllocationMode Le mode d’allocation de pool affecte également la façon dont les clients peuvent s’authentifier auprès de l’API de service Batch. Si le mode est BatchService, les clients peuvent s’authentifier à l’aide de clés d’accès ou d’Azure Active Directory. Si le mode est UserSubscription, les clients doivent utiliser Azure Active Directory. La valeur par défaut est BatchService. 'BatchService'
'UserSubscription'
publicNetworkAccess Si elle n’est pas spécifiée, la valeur par défaut est « enabled ». 'Désactivé'
'Activé'

BatchAccountIdentity

Nom Description Valeur
type Type d’identité utilisé pour le compte Batch. 'None'
'SystemAssigned'
'UserAssigned' (obligatoire)
userAssignedIdentities Liste des identités utilisateur associées au compte Batch. BatchAccountIdentityUserAssignedIdentities

BatchAccountIdentityUserAssignedIdentities

Nom Description Valeur

ComputeNodeIdentityReference

Nom Description Valeur
resourceId ID de ressource ARM de l’identité affectée par l’utilisateur. corde

EncryptionProperties

Nom Description Valeur
keySource Type de la source de clé. 'Microsoft.Batch'
'Microsoft.KeyVault'
keyVaultProperties Détails supplémentaires lors de l’utilisation de Microsoft.KeyVault KeyVaultProperties

EndpointAccessProfile

Nom Description Valeur
defaultAction Action par défaut pour l’accès au point de terminaison. Elle s’applique uniquement lorsque publicNetworkAccess est activé. 'Autoriser'
'Deny' (obligatoire)
ipRules Tableau de plages d’adresses IP pour filtrer l’adresse IP du client. IPRule []

IPRule

Nom Description Valeur
action Action lorsque l’adresse IP du client est mise en correspondance. 'Allow' (obligatoire)
valeur Adresse IPv4 ou plage d’adresses IPv4 au format CIDR. chaîne (obligatoire)

KeyVaultProperties

Nom Description Valeur
keyIdentifier Chemin complet du secret versionné. Par exemple : https://mykeyvault.vault.azure.net/keys/testkey/6e34a81fef704045975661e297a4c053. Pour être utilisable, les conditions préalables suivantes doivent être remplies :

Le compte Batch a une identité affectée par le système
L’identité du compte a reçu les autorisations Key/Get, Key/Unwrap et Key/Wrap
KeyVault a la protection contre la suppression réversible et le vidage activés		 corde

KeyVaultReference

Nom Description Valeur
id ID de ressource du coffre de clés Azure associé au compte Batch. chaîne (obligatoire)
URL URL du coffre de clés Azure associé au compte Batch. chaîne (obligatoire)

Microsoft.Batch/batchAccounts

Nom Description Valeur
apiVersion Version de l’API '2022-10-01'
identité Identité du compte Batch. BatchAccountIdentity
emplacement Région dans laquelle créer le compte. chaîne (obligatoire)
nom Nom de la ressource corde

Contraintes:
Longueur minimale = 3
Longueur maximale = 3
Modèle = ^[a-z0-9]+$ (obligatoire)
Propriétés Propriétés du compte Batch. BatchAccountCreatePropertiesOrBatchAccountProperties
étiquettes Balises de ressource Dictionnaire de noms et de valeurs d’étiquettes. Consultez les balises dans les modèles
type Type de ressource 'Microsoft.Batch/batchAccounts'

NetworkProfile

Nom Description Valeur
accountAccess Profil d’accès réseau pour le point de terminaison batchAccount (API de plan de données de compte Batch). EndpointAccessProfile
nodeManagementAccess Profil d’accès réseau pour le point de terminaison nodeManagement (service Batch gérant les nœuds de calcul pour les pools Batch). EndpointAccessProfile

UserAssignedIdentities

Nom Description Valeur

Modèles de démarrage rapide

Les modèles de démarrage rapide suivants déploient ce type de ressource.

Modèle Description
pool Azure Batch sans adresses IP publiques

Déployer sur Azure 		Ce modèle crée un pool de communications de nœud simplifié Azure Batch sans adresses IP publiques.
Créer un compte Batch à l’aide d’un modèle

Déployer sur Azure 		Ce modèle crée un compte Batch et un compte de stockage.

Définition de ressource Terraform (fournisseur AzAPI)

Le type de ressource batchAccounts peut être déployé avec des opérations qui ciblent :

  • groupes de ressources

Pour obtenir la liste des propriétés modifiées dans chaque version de l’API, consultez journal des modifications.

Format de ressource

Pour créer une ressource Microsoft.Batch/batchAccounts, ajoutez terraform suivant à votre modèle.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Batch/batchAccounts@2022-10-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"
    }
  })
}

Valeurs de propriété

AutoStorageBasePropertiesOrAutoStorageProperties

Nom Description Valeur
authenticationMode Mode d’authentification utilisé par le service Batch pour gérer le compte de stockage automatique. 'BatchAccountManagedIdentity'
'StorageKeys'
nodeIdentityReference L’identité référencée ici doit être affectée aux pools qui ont des nœuds de calcul qui ont besoin d’accéder au stockage automatique. ComputeNodeIdentityReference
storageAccountId ID de ressource du compte de stockage à utiliser pour le compte de stockage automatique. chaîne (obligatoire)

BatchAccountCreateParametersTags

Nom Description Valeur

BatchAccountCreatePropertiesOrBatchAccountProperties

Nom Description Valeur
allowedAuthenticationModes Liste des modes d’authentification autorisés pour le compte Batch qui peuvent être utilisés pour s’authentifier auprès du plan de données. Cela n’affecte pas l’authentification avec le plan de contrôle. Tableau de chaînes contenant l’un des éléments suivants :
'AAD'
'SharedKey'
'TaskAuthenticationToken'
autoStorage Propriétés associées au compte de stockage automatique. AutoStorageBasePropertiesOrAutoStorageProperties
chiffrement Configure la façon dont les données client sont chiffrées à l’intérieur du compte Batch. Par défaut, les comptes sont chiffrés à l’aide d’une clé gérée par Microsoft. Pour un contrôle supplémentaire, une clé gérée par le client peut être utilisée à la place. EncryptionProperties
keyVaultReference Référence au coffre de clés Azure associé au compte Batch. KeyVaultReference
networkProfile Le profil réseau prend effet uniquement lorsque publicNetworkAccess est activé. NetworkProfile
poolAllocationMode Le mode d’allocation de pool affecte également la façon dont les clients peuvent s’authentifier auprès de l’API de service Batch. Si le mode est BatchService, les clients peuvent s’authentifier à l’aide de clés d’accès ou d’Azure Active Directory. Si le mode est UserSubscription, les clients doivent utiliser Azure Active Directory. La valeur par défaut est BatchService. 'BatchService'
'UserSubscription'
publicNetworkAccess Si elle n’est pas spécifiée, la valeur par défaut est « enabled ». 'Désactivé'
'Activé'

BatchAccountIdentity

Nom Description Valeur
type Type d’identité utilisé pour le compte Batch. 'None'
'SystemAssigned'
'UserAssigned' (obligatoire)
userAssignedIdentities Liste des identités utilisateur associées au compte Batch. BatchAccountIdentityUserAssignedIdentities

BatchAccountIdentityUserAssignedIdentities

Nom Description Valeur

ComputeNodeIdentityReference

Nom Description Valeur
resourceId ID de ressource ARM de l’identité affectée par l’utilisateur. corde

EncryptionProperties

Nom Description Valeur
keySource Type de la source de clé. 'Microsoft.Batch'
'Microsoft.KeyVault'
keyVaultProperties Détails supplémentaires lors de l’utilisation de Microsoft.KeyVault KeyVaultProperties

EndpointAccessProfile

Nom Description Valeur
defaultAction Action par défaut pour l’accès au point de terminaison. Elle s’applique uniquement lorsque publicNetworkAccess est activé. 'Autoriser'
'Deny' (obligatoire)
ipRules Tableau de plages d’adresses IP pour filtrer l’adresse IP du client. IPRule []

IPRule

Nom Description Valeur
action Action lorsque l’adresse IP du client est mise en correspondance. 'Allow' (obligatoire)
valeur Adresse IPv4 ou plage d’adresses IPv4 au format CIDR. chaîne (obligatoire)

KeyVaultProperties

Nom Description Valeur
keyIdentifier Chemin complet du secret versionné. Par exemple : https://mykeyvault.vault.azure.net/keys/testkey/6e34a81fef704045975661e297a4c053. Pour être utilisable, les conditions préalables suivantes doivent être remplies :

Le compte Batch a une identité affectée par le système
L’identité du compte a reçu les autorisations Key/Get, Key/Unwrap et Key/Wrap
KeyVault a la protection contre la suppression réversible et le vidage activés		 corde

KeyVaultReference

Nom Description Valeur
id ID de ressource du coffre de clés Azure associé au compte Batch. chaîne (obligatoire)
URL URL du coffre de clés Azure associé au compte Batch. chaîne (obligatoire)

Microsoft.Batch/batchAccounts

Nom Description Valeur
identité Identité du compte Batch. BatchAccountIdentity
emplacement Région dans laquelle créer le compte. chaîne (obligatoire)
nom Nom de la ressource corde

Contraintes:
Longueur minimale = 3
Longueur maximale = 3
Modèle = ^[a-z0-9]+$ (obligatoire)
Propriétés Propriétés du compte Batch. BatchAccountCreatePropertiesOrBatchAccountProperties
étiquettes Balises de ressource Dictionnaire de noms et de valeurs d’étiquettes.
type Type de ressource « Microsoft.Batch/batchAccounts@2022-10-01 »

NetworkProfile

Nom Description Valeur
accountAccess Profil d’accès réseau pour le point de terminaison batchAccount (API de plan de données de compte Batch). EndpointAccessProfile
nodeManagementAccess Profil d’accès réseau pour le point de terminaison nodeManagement (service Batch gérant les nœuds de calcul pour les pools Batch). EndpointAccessProfile

UserAssignedIdentities

Nom Description Valeur