Batch Account - Create

Service:: Batch Management

Version d'API:: 2025-06-01

Crée un compte Batch avec les paramètres spécifiés. Les comptes existants ne peuvent pas être mis à jour avec cette API et doivent plutôt être mis à jour avec l’API de compte Batch de mise à jour.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Batch/batchAccounts/{accountName}?api-version=2025-06-01

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
accountName	path	True	string minLength: 3 maxLength: 24 pattern: ^[a-z0-9]+$	Un nom pour le compte Batch qui doit être unique dans la région. Les noms de comptes des lots doivent mesurer entre 3 et 24 caractères et ne doivent utiliser que des chiffres et des lettres minuscules. Ce nom est utilisé comme partie intégrante du nom DNS utilisé pour accéder au service Batch dans la région où le compte est créé. Par exemple : `http://accountname.region.batch.azure.com/`.
resourceGroupName	path	True	string	Nom du groupe de ressources qui contient le compte Batch.
subscriptionId	path	True	string	ID de l’abonnement Azure. Il s’agit d’une chaîne au format GUID (par exemple, 000000000-0000-0000-0000-000000000000000000000)
api-version	query	True	string	Version de l’API à utiliser avec la requête HTTP.

Corps de la demande

Nom	Obligatoire	Type	Description
location	True	string	Région dans laquelle créer le compte.
identity		BatchAccountIdentity	Identité du compte Batch.
properties.allowedAuthenticationModes		AuthenticationMode[]	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.
properties.autoStorage		AutoStorageBaseProperties	Propriétés associées au compte de stockage automatique.
properties.encryption		EncryptionProperties	Configuration du chiffrement pour le compte Batch. 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.
properties.keyVaultReference		KeyVaultReference	Référence au coffre de clés Azure associé au compte Batch.
properties.networkProfile		NetworkProfile	Profil réseau pour le compte Batch, qui contient les paramètres de règle réseau pour chaque point de terminaison. Le profil réseau prend effet uniquement lorsque publicNetworkAccess est activé.
properties.poolAllocationMode		PoolAllocationMode	Mode d’allocation à utiliser pour créer des pools dans le compte Batch. 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 de l’ID Microsoft Entra. Si le mode est UserSubscription, les clients doivent utiliser l’ID Microsoft Entra. La valeur par défaut est BatchService.
properties.publicNetworkAccess		PublicNetworkAccessType	Type d’accès réseau pour accéder au compte Azure Batch. Si elle n’est pas spécifiée, la valeur par défaut est « enabled ».
tags		object	Balises spécifiées par l’utilisateur associées au compte.

Réponses

Nom	Type	Description
200 OK	BatchAccount	L’opération a réussi. La réponse contient l’entité du compte Batch.
202 Accepted		L’opération est terminée de façon asynchrone. En-têtes Location: string Retry-After: integer
Other Status Codes	CloudError	Réponse d’erreur décrivant pourquoi l’opération a échoué.

Nom

Type

Description

200 OK

BatchAccount

L’opération a réussi. La réponse contient l’entité du compte Batch.

202 Accepted

L’opération est terminée de façon asynchrone.

En-têtes

Location: string
Retry-After: integer

Other Status Codes

CloudError

Réponse d’erreur décrivant pourquoi l’opération a échoué.

Sécurité

azure_auth

Flux de code d’authentification Microsoft Entra OAuth 2.0

Type: oauth2
Flux: implicit
URL d’autorisation: https://login.microsoftonline.com/common/oauth2/authorize

Étendues

Nom	Description
user_impersonation	emprunter l’identité de votre compte d’utilisateur

Exemples

BatchAccountCreate_BYOS

BatchAccountCreate_Default

BatchAccountCreate_SystemAssignedIdentity

BatchAccountCreate_UserAssignedIdentity

PrivateBatchAccountCreate

BatchAccountCreate_BYOS

Exemple de requête

HTTP

PUT https://management.azure.com/subscriptions/subid/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/sampleacct?api-version=2025-06-01

{
  "location": "japaneast",
  "properties": {
    "autoStorage": {
      "storageAccountId": "/subscriptions/subid/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Storage/storageAccounts/samplestorage"
    },
    "poolAllocationMode": "UserSubscription",
    "keyVaultReference": {
      "id": "/subscriptions/subid/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.KeyVault/vaults/sample",
      "url": "http://sample.vault.azure.net/"
    }
  }
}

Exemple de réponse

Code d’état:: 202

Code d’état:: 200

{
  "name": "sampleacct",
  "location": "japaneast",
  "properties": {
    "accountEndpoint": "sampleacct.japaneast.batch.azure.com",
    "provisioningState": "Succeeded",
    "poolAllocationMode": "UserSubscription",
    "dedicatedCoreQuota": 20,
    "lowPriorityCoreQuota": 20,
    "poolQuota": 20,
    "activeJobAndJobScheduleQuota": 20,
    "autoStorage": {
      "storageAccountId": "/subscriptions/subid/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Storage/storageAccounts/samplestorage",
      "lastKeySync": "2025-07-10T23:48:38.9878479Z"
    },
    "keyVaultReference": {
      "id": "/subscriptions/subid/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.KeyVault/vaults/sample",
      "url": "http://sample.vault.azure.net/"
    },
    "publicNetworkAccess": "Enabled"
  },
  "identity": {
    "type": "None"
  },
  "id": "/subscriptions/subid/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/sampleacct",
  "type": "Microsoft.Batch/batchAccounts"
}

BatchAccountCreate_Default

Exemple de requête

HTTP

PUT https://management.azure.com/subscriptions/subid/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/sampleacct?api-version=2025-06-01

{
  "location": "japaneast",
  "properties": {
    "autoStorage": {
      "storageAccountId": "/subscriptions/subid/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Storage/storageAccounts/samplestorage"
    }
  }
}

Exemple de réponse

Code d’état:: 202

Code d’état:: 200

{
  "name": "sampleacct",
  "location": "japaneast",
  "properties": {
    "accountEndpoint": "sampleacct.japaneast.batch.azure.com",
    "provisioningState": "Succeeded",
    "poolAllocationMode": "BatchService",
    "dedicatedCoreQuota": 20,
    "lowPriorityCoreQuota": 20,
    "poolQuota": 20,
    "activeJobAndJobScheduleQuota": 20,
    "autoStorage": {
      "storageAccountId": "/subscriptions/subid/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Storage/storageAccounts/samplestorage",
      "lastKeySync": "2025-07-10T23:48:38.9878479Z"
    },
    "publicNetworkAccess": "Enabled"
  },
  "identity": {
    "type": "None"
  },
  "id": "/subscriptions/subid/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/sampleacct",
  "type": "Microsoft.Batch/batchAccounts"
}

BatchAccountCreate_SystemAssignedIdentity

Exemple de requête

HTTP

PUT https://management.azure.com/subscriptions/subid/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/sampleacct?api-version=2025-06-01

{
  "location": "japaneast",
  "properties": {
    "autoStorage": {
      "storageAccountId": "/subscriptions/subid/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Storage/storageAccounts/samplestorage"
    }
  },
  "identity": {
    "type": "SystemAssigned"
  }
}

Exemple de réponse

Code d’état:: 202

Code d’état:: 200

{
  "name": "sampleacct",
  "location": "japaneast",
  "properties": {
    "accountEndpoint": "sampleacct.japaneast.batch.azure.com",
    "provisioningState": "Succeeded",
    "poolAllocationMode": "BatchService",
    "dedicatedCoreQuota": 20,
    "lowPriorityCoreQuota": 20,
    "poolQuota": 20,
    "activeJobAndJobScheduleQuota": 20,
    "autoStorage": {
      "storageAccountId": "/subscriptions/subid/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Storage/storageAccounts/samplestorage",
      "lastKeySync": "2025-07-10T23:48:38.9878479Z"
    },
    "publicNetworkAccess": "Enabled"
  },
  "identity": {
    "principalId": "1a2e532b-9900-414c-8600-cfc6126628d7",
    "tenantId": "f686d426-8d16-42db-81b7-ab578e110ccd",
    "type": "SystemAssigned"
  },
  "id": "/subscriptions/subid/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/sampleacct",
  "type": "Microsoft.Batch/batchAccounts"
}

BatchAccountCreate_UserAssignedIdentity

Exemple de requête

HTTP

PUT https://management.azure.com/subscriptions/subid/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/sampleacct?api-version=2025-06-01

{
  "location": "japaneast",
  "properties": {
    "autoStorage": {
      "storageAccountId": "/subscriptions/subid/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Storage/storageAccounts/samplestorage"
    }
  },
  "identity": {
    "type": "UserAssigned",
    "userAssignedIdentities": {
      "/subscriptions/subid/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.ManagedIdentity/userAssignedIdentities/id1": {}
    }
  }
}

Exemple de réponse

Code d’état:: 202

Code d’état:: 200

{
  "name": "sampleacct",
  "location": "japaneast",
  "properties": {
    "accountEndpoint": "sampleacct.japaneast.batch.azure.com",
    "provisioningState": "Succeeded",
    "poolAllocationMode": "BatchService",
    "dedicatedCoreQuota": 20,
    "lowPriorityCoreQuota": 20,
    "poolQuota": 20,
    "activeJobAndJobScheduleQuota": 20,
    "autoStorage": {
      "storageAccountId": "/subscriptions/subid/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Storage/storageAccounts/samplestorage",
      "lastKeySync": "2025-07-10T23:48:38.9878479Z"
    },
    "publicNetworkAccess": "Enabled"
  },
  "identity": {
    "type": "UserAssigned",
    "userAssignedIdentities": {
      "/subscriptions/subid/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.ManagedIdentity/userAssignedIdentities/id1": {
        "principalId": "principalId1",
        "clientId": "clientId1"
      }
    }
  },
  "id": "/subscriptions/subid/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/sampleacct",
  "type": "Microsoft.Batch/batchAccounts"
}

PrivateBatchAccountCreate

Exemple de requête

HTTP

PUT https://management.azure.com/subscriptions/subid/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/sampleacct?api-version=2025-06-01

{
  "location": "japaneast",
  "properties": {
    "autoStorage": {
      "storageAccountId": "/subscriptions/subid/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Storage/storageAccounts/samplestorage"
    },
    "keyVaultReference": {
      "id": "/subscriptions/subid/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.KeyVault/vaults/sample",
      "url": "http://sample.vault.azure.net/"
    },
    "publicNetworkAccess": "Disabled"
  }
}

Exemple de réponse

Code d’état:: 202

Code d’état:: 200

{
  "name": "sampleacct",
  "location": "japaneast",
  "properties": {
    "accountEndpoint": "sampleacct.japaneast.batch.azure.com",
    "provisioningState": "Succeeded",
    "poolAllocationMode": "UserSubscription",
    "dedicatedCoreQuota": 20,
    "lowPriorityCoreQuota": 20,
    "poolQuota": 20,
    "activeJobAndJobScheduleQuota": 20,
    "autoStorage": {
      "storageAccountId": "/subscriptions/subid/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Storage/storageAccounts/samplestorage",
      "lastKeySync": "2025-07-10T23:48:38.9878479Z"
    },
    "keyVaultReference": {
      "id": "/subscriptions/subid/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.KeyVault/vaults/sample",
      "url": "http://sample.vault.azure.net/"
    },
    "publicNetworkAccess": "Disabled"
  },
  "identity": {
    "type": "None"
  },
  "id": "/subscriptions/subid/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/sampleacct",
  "type": "Microsoft.Batch/batchAccounts"
}

Définitions

Nom	Description
AuthenticationMode	Mode d’authentification pour le compte Batch.
AutoStorageAuthenticationMode	Mode d’authentification utilisé par le service Batch pour gérer le compte de stockage automatique.
AutoStorageBaseProperties	Propriétés associées au compte de stockage automatique.
AutoStorageProperties	Contient des informations sur le compte de stockage automatique associé à un compte Batch.
BatchAccount	Contient des informations sur un compte Azure Batch.
BatchAccountCreateParameters	Paramètres fournis à l’opération Créer.
BatchAccountIdentity	Identité du compte Batch, s’il est configuré. Cela est utilisé lorsque l’utilisateur spécifie « Microsoft.KeyVault » comme configuration de chiffrement de compte Batch ou lorsque `ManagedIdentity` est sélectionné comme mode d’authentification de stockage automatique.
CloudError	Réponse d’erreur du service Batch.
CloudErrorBody	Réponse d’erreur du service Batch.
ComputeNodeIdentityReference	Référence à une identité affectée par l’utilisateur associée au pool Batch qu’un nœud de calcul utilisera.
EncryptionProperties	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.
EndpointAccessDefaultAction	Action par défaut lorsqu’il n’existe aucune correspondance IPRule.
EndpointAccessProfile	Profil d’accès réseau pour le point de terminaison Batch.
IPRule	Règle pour filtrer l’adresse IP du client.
IPRuleAction	Action lorsque l’adresse IP du client est mise en correspondance.
KeySource	Type de la source de clé.
KeyVaultProperties	Configuration de KeyVault lors de l’utilisation d’une clé de chiffrement de Microsoft.KeyVault.
KeyVaultReference	Identifie le coffre de clés Azure associé à un compte Batch.
NetworkProfile	Profil réseau pour le compte Batch, qui contient les paramètres de règle réseau pour chaque point de terminaison.
PoolAllocationMode	Mode d’allocation pour la création de pools dans le compte Batch.
PrivateEndpoint	Point de terminaison privé de la connexion de point de terminaison privé.
PrivateEndpointConnection	Contient des informations sur une ressource de liaison privée.
PrivateEndpointConnectionProvisioningState	État d’approvisionnement de la connexion de point de terminaison privé.
PrivateLinkServiceConnectionState	État de connexion du service de liaison privée de la connexion de point de terminaison privé
PrivateLinkServiceConnectionStatus	État de la connexion de point de terminaison privé Batch
ProvisioningState	État provisionné de la ressource
PublicNetworkAccessType	Type d’accès réseau pour l’exploitation sur les ressources du compte Batch.
ResourceIdentityType	Type d’identité utilisé pour le compte Batch.
UserAssignedIdentities	Liste des identités utilisateur associées.
VirtualMachineFamilyCoreQuota	Une famille de machines virtuelles et son quota de cœurs associé pour le compte Batch.

AuthenticationMode

Énumération

Mode d’authentification pour le compte Batch.

Valeur	Description
SharedKey	Mode d’authentification à l’aide de clés partagées.
AAD	Mode d’authentification à l’aide de l’ID Microsoft Entra.
TaskAuthenticationToken	Mode d’authentification à l’aide de jetons d’authentification de tâche.

AutoStorageAuthenticationMode

Énumération

Mode d’authentification utilisé par le service Batch pour gérer le compte de stockage automatique.

Valeur	Description
StorageKeys	Le service Batch authentifie les demandes de stockage automatique à l’aide de clés de compte de stockage.
BatchAccountManagedIdentity	Le service Batch authentifie les demandes de stockage automatique à l’aide de l’identité managée affectée au compte Batch.

AutoStorageBaseProperties

Objet

Propriétés associées au compte de stockage automatique.

Nom	Type	Valeur par défaut	Description
authenticationMode	AutoStorageAuthenticationMode	StorageKeys	Mode d’authentification utilisé par le service Batch pour gérer le compte de stockage automatique.
nodeIdentityReference	ComputeNodeIdentityReference		Référence à l’identité affectée par l’utilisateur que les nœuds de calcul utiliseront pour accéder au stockage automatique. 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.
storageAccountId	string (arm-id)		ID de ressource du compte de stockage à utiliser pour le compte de stockage automatique.

AutoStorageProperties

Objet

Contient des informations sur le compte de stockage automatique associé à un compte Batch.

Nom	Type	Valeur par défaut	Description
authenticationMode	AutoStorageAuthenticationMode	StorageKeys	Mode d’authentification utilisé par le service Batch pour gérer le compte de stockage automatique.
lastKeySync	string (date-time)		Heure UTC à laquelle les clés de stockage ont été synchronisées pour la dernière fois avec le compte Batch.
nodeIdentityReference	ComputeNodeIdentityReference		Référence à l’identité affectée par l’utilisateur que les nœuds de calcul utiliseront pour accéder au stockage automatique. 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.
storageAccountId	string (arm-id)		ID de ressource du compte de stockage à utiliser pour le compte de stockage automatique.

BatchAccount

Objet

Contient des informations sur un compte Azure Batch.

Nom	Type	Valeur par défaut	Description
id	string		ID de la ressource.
identity	BatchAccountIdentity		Identité du compte Batch.
location	string		Emplacement de la ressource.
name	string		Nom de la ressource.
properties.accountEndpoint	string		Point de terminaison de compte utilisé pour interagir avec le service Batch.
properties.activeJobAndJobScheduleQuota	integer (int32)		Quota de planification de travail et de travail actif pour le compte Batch.
properties.allowedAuthenticationModes	AuthenticationMode[]		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.
properties.autoStorage	AutoStorageProperties		Propriétés et état de n’importe quel compte de stockage automatique associé au compte Batch. Contient des informations sur le compte de stockage automatique associé à un compte Batch.
properties.dedicatedCoreQuota	integer (int32)		Quota de cœurs dédiés pour le compte Batch. Pour les comptes avec PoolAllocationMode défini sur UserSubscription, le quota est géré sur l’abonnement afin que cette valeur ne soit pas retournée.
properties.dedicatedCoreQuotaPerVMFamily	VirtualMachineFamilyCoreQuota[]		Liste du quota de cœurs dédiés par famille de machines virtuelles pour le compte Batch. Pour les comptes avec PoolAllocationMode défini sur UserSubscription, le quota est géré sur l’abonnement afin que cette valeur ne soit pas retournée.
properties.dedicatedCoreQuotaPerVMFamilyEnforced	boolean		Valeur indiquant si les quotas de base par famille de machines virtuelles sont appliqués pour ce compte Si cet indicateur est vrai, le quota de cœurs dédiés est appliqué via les propriétés dedicatedCoreQuotaPerVMFamily et dedicatedCoreQuota sur le compte. Si cet indicateur a la valeur false, le quota de cœurs dédiés est appliqué uniquement via la propriété dedicatedCoreQuota sur le compte et ne prend pas en compte la famille de machines virtuelles.
properties.encryption	EncryptionProperties		Configuration du chiffrement pour le compte Batch. 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.
properties.keyVaultReference	KeyVaultReference		Référence au coffre de clés Azure associé au compte Batch. Identifie le coffre de clés Azure associé à un compte Batch.
properties.lowPriorityCoreQuota	integer (int32)		Quota de cœurs Spot/basse priorité pour le compte Batch. Pour les comptes avec PoolAllocationMode défini sur UserSubscription, le quota est géré sur l’abonnement afin que cette valeur ne soit pas retournée.
properties.networkProfile	NetworkProfile		Profil réseau pour le compte Batch, qui contient les paramètres de règle réseau pour chaque point de terminaison. Le profil réseau prend effet uniquement lorsque publicNetworkAccess est activé.
properties.nodeManagementEndpoint	string		Point de terminaison utilisé par le nœud de calcul pour se connecter au service de gestion des nœuds Batch.
properties.poolAllocationMode	PoolAllocationMode		Mode d’allocation à utiliser pour créer des pools dans le compte Batch. Mode d’allocation pour la création de pools dans le compte Batch.
properties.poolQuota	integer (int32)		Quota de pool pour le compte Batch.
properties.privateEndpointConnections	PrivateEndpointConnection[]		Liste des connexions de point de terminaison privé associées au compte Batch
properties.provisioningState	ProvisioningState		État provisionné de la ressource
properties.publicNetworkAccess	PublicNetworkAccessType	Enabled	Type d’interface réseau pour accéder aux opérations de service Azure Batch et de compte Batch. Si elle n’est pas spécifiée, la valeur par défaut est « enabled ».
tags	object		Balises de la ressource.
type	string		Type de la ressource.

BatchAccountCreateParameters

Objet

Paramètres fournis à l’opération Créer.

Nom	Type	Valeur par défaut	Description
identity	BatchAccountIdentity		Identité du compte Batch.
location	string		Région dans laquelle créer le compte.
properties.allowedAuthenticationModes	AuthenticationMode[]		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.
properties.autoStorage	AutoStorageBaseProperties		Propriétés associées au compte de stockage automatique.
properties.encryption	EncryptionProperties		Configuration du chiffrement pour le compte Batch. 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.
properties.keyVaultReference	KeyVaultReference		Référence au coffre de clés Azure associé au compte Batch.
properties.networkProfile	NetworkProfile		Profil réseau pour le compte Batch, qui contient les paramètres de règle réseau pour chaque point de terminaison. Le profil réseau prend effet uniquement lorsque publicNetworkAccess est activé.
properties.poolAllocationMode	PoolAllocationMode		Mode d’allocation à utiliser pour créer des pools dans le compte Batch. 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 de l’ID Microsoft Entra. Si le mode est UserSubscription, les clients doivent utiliser l’ID Microsoft Entra. La valeur par défaut est BatchService.
properties.publicNetworkAccess	PublicNetworkAccessType	Enabled	Type d’accès réseau pour accéder au compte Azure Batch. Si elle n’est pas spécifiée, la valeur par défaut est « enabled ».
tags	object		Balises spécifiées par l’utilisateur associées au compte.

BatchAccountIdentity

Objet

Identité du compte Batch, s’il est configuré. Cela est utilisé lorsque l’utilisateur spécifie « Microsoft.KeyVault » comme configuration de chiffrement de compte Batch ou lorsque ManagedIdentity est sélectionné comme mode d’authentification de stockage automatique.

Nom	Type	Description
principalId	string	ID principal du compte Batch. Cette propriété est fournie uniquement pour une identité affectée par le système.
tenantId	string	ID de locataire associé au compte Batch. Cette propriété est fournie uniquement pour une identité affectée par le système.
type	ResourceIdentityType	Type d’identité utilisé pour le compte Batch.
userAssignedIdentities	<string, UserAssignedIdentities>	Liste des identités utilisateur associées au compte Batch.

CloudError

Objet

Réponse d’erreur du service Batch.

Nom	Type	Description
error	CloudErrorBody	Corps de la réponse d’erreur.

CloudErrorBody

Objet

Réponse d’erreur du service Batch.

Nom	Type	Description
code	string	Identificateur de l’erreur. Les codes sont invariants et sont destinés à être consommés par programme.
details	CloudErrorBody[]	Liste des détails supplémentaires sur l’erreur.
message	string	Message décrivant l’erreur, destiné à être adapté à l’affichage dans une interface utilisateur.
target	string	Cible de l’erreur particulière. Par exemple, le nom de la propriété en erreur.

ComputeNodeIdentityReference

Objet

Référence à une identité affectée par l’utilisateur associée au pool Batch qu’un nœud de calcul utilisera.

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

EncryptionProperties

Objet

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.

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

EndpointAccessDefaultAction

Énumération

Action par défaut lorsqu’il n’existe aucune correspondance IPRule.

Valeur	Description
Allow	Autoriser l’accès client.
Deny	Refuser l’accès au client.

EndpointAccessProfile

Objet

Profil d’accès réseau pour le point de terminaison Batch.

Nom	Type	Description
defaultAction	EndpointAccessDefaultAction	Action par défaut lorsqu’il n’existe aucune correspondance IPRule. Action par défaut pour l’accès au point de terminaison. Elle s’applique uniquement lorsque publicNetworkAccess est activé.
ipRules	IPRule[]	Tableau de plages d’adresses IP pour filtrer l’adresse IP du client.

IPRule

Objet

Règle pour filtrer l’adresse IP du client.

Nom	Type	Description
action	IPRuleAction	Action lorsque l’adresse IP du client est mise en correspondance.
value	string	Adresse IP ou plage d’adresses IP à filtrer Adresse IPv4 ou plage d’adresses IPv4 au format CIDR.

IPRuleAction

Énumération

Action lorsque l’adresse IP du client est mise en correspondance.

Valeur	Description
Allow	Autoriser l’accès pour l’adresse IP du client correspondant.

KeySource

Énumération

Type de la source de clé.

Valeur	Description
Microsoft.Batch	Batch crée et gère les clés de chiffrement utilisées pour protéger les données du compte.
Microsoft.KeyVault	Les clés de chiffrement utilisées pour protéger les données du compte sont stockées dans un coffre de clés externe. Si cette valeur est définie, l’identité du compte Batch doit être définie sur `SystemAssigned` et un identificateur de clé valide doit également être fourni sous keyVaultProperties.

KeyVaultProperties

Objet

Configuration de KeyVault lors de l’utilisation d’une clé de chiffrement de Microsoft.KeyVault.

Nom Type Description

keyIdentifier

Nom	Type	Description
keyIdentifier	string	Chemin complet du secret avec ou sans version. Exemple `https://mykeyvault.vault.azure.net/keys/testkey/6e34a81fef704045975661e297a4c053`. ou `https://mykeyvault.vault.azure.net/keys/testkey`. 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 Clé/Get, Key/Unwrap et Key/Wrap. Le Coffre de clés a la protection de suppression réversible et de vidage activée

string

Chemin complet du secret avec ou sans version. Exemple https://mykeyvault.vault.azure.net/keys/testkey/6e34a81fef704045975661e297a4c053. ou https://mykeyvault.vault.azure.net/keys/testkey. 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 Clé/Get, Key/Unwrap et Key/Wrap. Le Coffre de clés a la protection de suppression réversible et de vidage activée

KeyVaultReference

Objet

Identifie le coffre de clés Azure associé à un compte Batch.

Nom	Type	Description
id	string (arm-id)	ID de ressource du coffre de clés Azure associé au compte Batch.
url	string	URL du coffre de clés Azure associé au compte Batch.

NetworkProfile

Objet

Profil réseau pour le compte Batch, qui contient les paramètres de règle réseau pour chaque point de terminaison.

Nom	Type	Description
accountAccess	EndpointAccessProfile	Profil d’accès réseau pour le point de terminaison batchAccount (API de plan de données de compte Batch).
nodeManagementAccess	EndpointAccessProfile	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).

PoolAllocationMode

Énumération

Mode d’allocation pour la création de pools dans le compte Batch.

Valeur	Description
BatchService	Les pools seront alloués dans les abonnements appartenant au service Batch.
UserSubscription	Les pools seront alloués dans un abonnement appartenant à l’utilisateur.

PrivateEndpoint

Objet

Point de terminaison privé de la connexion de point de terminaison privé.

Nom	Type	Description
id	string	Identificateur de ressource ARM du point de terminaison privé. Il s’agit de la forme /subscriptions/{subscription}/resourceGroups/{group}/providers/Microsoft.Network/privateEndpoints/{privateEndpoint}.

PrivateEndpointConnection

Objet

Contient des informations sur une ressource de liaison privée.

Nom	Type	Description
etag	string	ETag de la ressource, utilisée pour les instructions d’accès concurrentiel.
id	string	ID de la ressource.
name	string	Nom de la ressource.
properties.groupIds	string[]	ID de groupe de la connexion de point de terminaison privé. La valeur a un et un seul ID de groupe.
properties.privateEndpoint	PrivateEndpoint	Identificateur de ressource ARM du point de terminaison privé. Point de terminaison privé de la connexion de point de terminaison privé.
properties.privateLinkServiceConnectionState	PrivateLinkServiceConnectionState	État de connexion du service de liaison privée de la connexion de point de terminaison privé. État de connexion du service de liaison privée de la connexion de point de terminaison privé
properties.provisioningState	PrivateEndpointConnectionProvisioningState	État d’approvisionnement de la connexion de point de terminaison privé.
tags	object	Balises de la ressource.
type	string	Type de la ressource.

PrivateEndpointConnectionProvisioningState

Énumération

État d’approvisionnement de la connexion de point de terminaison privé.

Valeur	Description
Creating	La connexion est créée.
Updating	L’utilisateur a demandé que l’état de la connexion soit mis à jour, mais que l’opération de mise à jour n’a pas encore été terminée. Vous ne pouvez pas référencer la connexion lors de la connexion au compte Batch.
Deleting	La connexion est en cours de suppression.
Succeeded	L’état de la connexion est final et est prêt à être utilisé si l’état est approuvé.
Failed	L’utilisateur a demandé que la connexion soit mise à jour et qu’elle a échoué. Vous pouvez réessayer l’opération de mise à jour.
Cancelled	L’utilisateur a annulé la création de la connexion.

PrivateLinkServiceConnectionState

Objet

État de connexion du service de liaison privée de la connexion de point de terminaison privé

Nom	Type	Description
actionsRequired	string	Action requise sur l’état de connexion privée
description	string	Description de l’état de connexion privée
status	PrivateLinkServiceConnectionStatus	Le statut de la connexion au point de terminaison privé du compte Batch

PrivateLinkServiceConnectionStatus

Énumération

État de la connexion de point de terminaison privé Batch

Valeur	Description
Approved	La connexion de point de terminaison privé est approuvée et peut être utilisée pour accéder au compte Batch
Pending	La connexion de point de terminaison privé est en attente et ne peut pas être utilisée pour accéder au compte Batch
Rejected	La connexion de point de terminaison privé est rejetée et ne peut pas être utilisée pour accéder au compte Batch
Disconnected	La connexion de point de terminaison privé est déconnectée et ne peut pas être utilisée pour accéder au compte Batch

ProvisioningState

Énumération

État provisionné de la ressource

Valeur	Description
Invalid	Le compte est dans un état non valide.
Creating	Le compte est en cours de création.
Deleting	Le compte est supprimé.
Succeeded	Le compte a été créé et est prêt à être utilisé.
Failed	La dernière opération du compte a échoué.
Cancelled	La dernière opération du compte est annulée.

PublicNetworkAccessType

Énumération

Type d’accès réseau pour l’exploitation sur les ressources du compte Batch.

Valeur	Description
Enabled	Active la connectivité à Azure Batch par le biais du DNS public.
Disabled	Désactive la connectivité publique et active la connectivité privée à Azure Batch Service via une ressource de point de terminaison privé.
SecuredByPerimeter	Sécurise la connectivité à Azure Batch via la configuration NSP.

ResourceIdentityType

Énumération

Type d’identité utilisé pour le compte Batch.

Valeur	Description
SystemAssigned	Le compte Batch a une identité affectée par le système avec celle-ci.
UserAssigned	Le compte Batch a des identités affectées par l’utilisateur.
None	Le compte Batch n’a aucune identité associée. La définition de `None` dans le compte de mise à jour supprime les identités existantes.

UserAssignedIdentities

Objet

Liste des identités utilisateur associées.

Nom	Type	Description
clientId	string	ID client de l’identité affectée par l’utilisateur.
principalId	string	ID principal de l’identité affectée par l’utilisateur.

VirtualMachineFamilyCoreQuota

Objet

Une famille de machines virtuelles et son quota de cœurs associé pour le compte Batch.

Nom	Type	Description
coreQuota	integer (int32)	Quota principal pour la famille de machines virtuelles pour le compte Batch.
name	string	Nom de la famille de machines virtuelles.

Partager via

Batch Account - Create

Paramètres URI

Corps de la demande

Réponses

Sécurité

azure_auth

Étendues

Exemples

BatchAccountCreate_BYOS

Exemple de requête

Exemple de réponse

BatchAccountCreate_Default

Exemple de requête

Exemple de réponse

BatchAccountCreate_SystemAssignedIdentity

Exemple de requête

Exemple de réponse

BatchAccountCreate_UserAssignedIdentity

Exemple de requête

Exemple de réponse

PrivateBatchAccountCreate

Exemple de requête

Exemple de réponse

Définitions

AuthenticationMode

AutoStorageAuthenticationMode

AutoStorageBaseProperties

AutoStorageProperties

BatchAccount

BatchAccountCreateParameters

BatchAccountIdentity

CloudError

CloudErrorBody

ComputeNodeIdentityReference

EncryptionProperties

EndpointAccessDefaultAction

EndpointAccessProfile

IPRule

IPRuleAction

KeySource

KeyVaultProperties

KeyVaultReference

NetworkProfile

PoolAllocationMode

PrivateEndpoint

PrivateEndpointConnection

PrivateEndpointConnectionProvisioningState

PrivateLinkServiceConnectionState

PrivateLinkServiceConnectionStatus

ProvisioningState

PublicNetworkAccessType

ResourceIdentityType

UserAssignedIdentities

VirtualMachineFamilyCoreQuota