---
title: "PATCH /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Batch/batchAccounts/{accountName}"
method: PATCH
path: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Batch/batchAccounts/{accountName}"
tags: ["BatchAccount"]
---

# PATCH /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Batch/batchAccounts/{accountName}

`PATCH /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Batch/batchAccounts/{accountName}`

Updates the properties of an existing Batch account.

## Path parameters

- `accountName` string, required

## Parameters

- `../../../../../../common-types/resource-management/v5/types.json#/components/parameters/ApiVersionParameter` — unresolved $ref
- `../../../../../../common-types/resource-management/v5/types.json#/components/parameters/SubscriptionIdParameter` — unresolved $ref
- `../../../../../../common-types/resource-management/v5/types.json#/components/parameters/ResourceGroupNameParameter` — unresolved $ref

## Request body

- BatchAccountUpdateParameters — Parameters for updating an Azure Batch account.
  - `tags` object — The user-specified tags associated with the account.
  - `properties` BatchAccountUpdateProperties — The properties of a Batch account.
    - `autoStorage` AutoStorageBaseProperties — The properties related to the auto-storage account.
      - `storageAccountId` string, arm-id, required — The resource ID of the storage account to be used for auto-storage account.
      - `authenticationMode` 'StorageKeys' | 'BatchAccountManagedIdentity' — The authentication mode which the Batch service will use to manage the auto-storage account.
      - `nodeIdentityReference` ComputeNodeIdentityReference — The reference to a user assigned identity associated with the Batch pool which a compute node will use.
        - `resourceId` string — The ARM resource id of the user assigned identity.
    - `encryption` EncryptionProperties — Configures how customer data is encrypted inside the Batch account. By default, accounts are encrypted using a Microsoft managed key. For additional control, a customer-managed key can be used instead.
      - `keySource` 'Microsoft.Batch' | 'Microsoft.KeyVault' — Type of the key source.
      - `keyVaultProperties` KeyVaultProperties — KeyVault configuration when using an encryption KeySource of Microsoft.KeyVault.
        - `keyIdentifier` string — Full path to the secret with or without version. Example https://mykeyvault.vault.azure.net/keys/testkey/6e34a81fef704045975661e297a4c053. or https://mykeyvault.vault.azure.net/keys/testkey. To be usable the following prerequisites must be met: The Batch Account has a System Assigned identity The account identity has been granted Key/Get, Key/Unwrap and Key/Wrap permissions The KeyVault has soft-delete and purge protection enabled
    - `allowedAuthenticationModes` AuthenticationMode[], nullable — List of allowed authentication modes for the Batch account that can be used to authenticate with the data plane. This does not affect authentication with the control plane.
    - `publicNetworkAccess` 'Enabled' | 'Disabled' | 'SecuredByPerimeter' — The network access type for operating on the resources in the Batch account.
    - `networkProfile` NetworkProfile — Network profile for Batch account, which contains network rule settings for each endpoint.
      - `accountAccess` EndpointAccessProfile — Network access profile for Batch endpoint.
        - `defaultAction` 'Allow' | 'Deny', required — Default action for endpoint access. It is only applicable when publicNetworkAccess is enabled.
        - `ipRules` IPRule[] — Array of IP ranges to filter client IP address.
          - `action` 'Allow', required — The action when client IP address is matched.
          - `value` string, required — IPv4 address, or IPv4 address range in CIDR format.
      - `nodeManagementAccess` EndpointAccessProfile — Network access profile for Batch endpoint.
        - `defaultAction` 'Allow' | 'Deny', required — Default action for endpoint access. It is only applicable when publicNetworkAccess is enabled.
        - `ipRules` IPRule[] — Array of IP ranges to filter client IP address.
          - `action` 'Allow', required — The action when client IP address is matched.
          - `value` string, required — IPv4 address, or IPv4 address range in CIDR format.
  - `identity` BatchAccountIdentity — The identity of the Batch account, if configured. This is used when the user specifies 'Microsoft.KeyVault' as their Batch account encryption configuration or when `ManagedIdentity` is selected as the auto-storage authentication mode.
    - `principalId` string — The principal id of the Batch account. This property will only be provided for a system assigned identity.
    - `tenantId` string — The tenant id associated with the Batch account. This property will only be provided for a system assigned identity.
    - `type` 'SystemAssigned' | 'UserAssigned' | 'None', required — The type of identity used for the Batch account.
    - `userAssignedIdentities` object — The list of user identities associated with the Batch account.

## Response `200`

Azure operation completed successfully.

- BatchAccount — unresolved $ref

## Other responses

- `default` — An unexpected error response.

## Changes

- **2026-07-13** (2015-12-01) `bd5ddd708825` — 3 warning
  - deleted the `path` request parameter `resourceGroupName`
  - deleted the `path` request parameter `subscriptionId`
  - deleted the `query` request parameter `api-version`

[Change history](https://skmtc.dev/azure/apis/batch-microsoft-batch-batch/changes/subscriptions/:subscriptionId/resourceGroups/:resourceGroupName/providers/Microsoft.Batch/batchAccounts/:accountName/patch.md)

---

[API](https://skmtc.dev/azure/apis/batch-microsoft-batch-batch.md) · [All operations](https://skmtc.dev/azure/apis/batch-microsoft-batch-batch/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/azure/batch-microsoft-batch-batch/revisions/bd5ddd708825/schema)
