API version change log for deployment of Microsoft.ContainerRegistry/registries

This article describes the properties that changed in each API version for microsoft.containerregistry/registries. It only covers properties that are available during deployments.

2026-01-01-preview

Added:

• SoftDeletePolicy

Updated:

• Policies: Added property 'softDeletePolicy'
• RegistryProperties: Added property 'autoGeneratedDomainNameLabelScope'
• RegistryProperties: Added property 'endpointProtocol'
• RegistryProperties: Added property 'metadataSearch'
• RegistryProperties: Added property 'regionalEndpointHostNames'
• RegistryProperties: Added property 'regionalEndpoints'

2025-11-01

Removed:

• SoftDeletePolicy

Updated:

• Policies: Removed property 'softDeletePolicy'
• RegistryProperties: Removed property 'autoGeneratedDomainNameLabelScope'
• RegistryProperties: Removed property 'metadataSearch'

2025-06-01-preview

Added:

• TrackedResourceTags

Removed:

• ResourceTags

2025-05-01-preview

Added:

• SoftDeletePolicy

Updated:

• Policies: Added property 'softDeletePolicy'
• RegistryProperties: Added property 'autoGeneratedDomainNameLabelScope'
• RegistryProperties: Added property 'metadataSearch'
• RegistryProperties: Added property 'networkRuleBypassAllowedForTasks'
• RegistryProperties: Added property 'roleAssignmentMode'

2025-04-01

Removed:

• SoftDeletePolicy

Updated:

• Policies: Removed property 'softDeletePolicy'
• RegistryProperties: Removed property 'autoGeneratedDomainNameLabelScope'
• RegistryProperties: Removed property 'metadataSearch'
• RegistryProperties: Removed property 'roleAssignmentMode'

2025-03-01-preview

Updated:

• RegistryProperties: Added property 'roleAssignmentMode'

2024-11-01-preview

Updated:

• RegistryProperties: Added property 'autoGeneratedDomainNameLabelScope'

2023-11-01-preview

Updated:

• RegistryProperties: Added property 'metadataSearch'

2023-08-01-preview

Added:

• AzureADAuthenticationAsArmPolicy
• SoftDeletePolicy

Updated:

• Policies: Added property 'azureADAuthenticationAsArmPolicy'
• Policies: Added property 'softDeletePolicy'
• RegistryProperties: Added property 'anonymousPullEnabled'

2023-07-01

Removed:

• AzureADAuthenticationAsArmPolicy
• SoftDeletePolicy

Updated:

• Policies: Removed property 'azureADAuthenticationAsArmPolicy'
• Policies: Removed property 'softDeletePolicy'
• RegistryProperties: Removed property 'anonymousPullEnabled'

2023-06-01-preview

No properties added, updated or removed.

2023-01-01-preview

Added:

• AzureADAuthenticationAsArmPolicy
• SoftDeletePolicy

Updated:

• Policies: Added property 'azureADAuthenticationAsArmPolicy'
• Policies: Added property 'softDeletePolicy'
• RegistryProperties: Added property 'anonymousPullEnabled'

2022-12-01

Removed:

• AzureADAuthenticationAsArmPolicy
• SoftDeletePolicy

Updated:

• Policies: Removed property 'azureADAuthenticationAsArmPolicy'
• Policies: Removed property 'softDeletePolicy'
• RegistryProperties: Removed property 'anonymousPullEnabled'

2022-02-01-preview

Added:

• AzureADAuthenticationAsArmPolicy
• SoftDeletePolicy

Removed:

• VirtualNetworkRule

Updated:

• NetworkRuleSet: Removed property 'virtualNetworkRules'
• Policies: Added property 'azureADAuthenticationAsArmPolicy'
• Policies: Added property 'softDeletePolicy'

2021-12-01-preview

Added:

• VirtualNetworkRule

Updated:

• NetworkRuleSet: Added property 'virtualNetworkRules'
• RegistryProperties: Added property 'anonymousPullEnabled'

2021-09-01

Removed:

• VirtualNetworkRule

Updated:

• NetworkRuleSet: Removed property 'virtualNetworkRules'
• RegistryProperties: Removed property 'anonymousPullEnabled'

2021-08-01-preview

No properties added, updated or removed.

2021-06-01-preview

Added:

• ExportPolicy

Updated:

• Policies: Added property 'exportPolicy'

2020-11-01-preview

Updated:

• RegistryProperties: Added property 'anonymousPullEnabled'
• RegistryProperties: Added property 'zoneRedundancy'

2019-12-01-preview

Added:

• EncryptionProperty
• IdentityProperties
• IdentityPropertiesUserAssignedIdentities
• KeyVaultProperties
• UserIdentityProperties

Removed:

• StorageAccountProperties

Updated:

• Microsoft.ContainerRegistry/registries: Added property 'identity'
• Microsoft.ContainerRegistry/registries: Added property 'systemData'
• RegistryProperties: Added property 'dataEndpointEnabled'
• RegistryProperties: Added property 'dataEndpointHostNames'
• RegistryProperties: Added property 'encryption'
• RegistryProperties: Added property 'networkRuleBypassOptions'
• RegistryProperties: Added property 'privateEndpointConnections'
• RegistryProperties: Added property 'publicNetworkAccess'
• RegistryProperties: Removed property 'storageAccount'

2019-05-01

Added:

• Policies
• QuarantinePolicy
• RetentionPolicy
• TrustPolicy

Updated:

• RegistryProperties: Added property 'policies'

2017-10-01

Added:

• IPRule
• NetworkRuleSet
• RegistryProperties
• ResourceTags
• StorageAccountProperties
• VirtualNetworkRule

Removed:

• RegistryCreateParametersTags
• RegistryPropertiesCreateParametersOrRegistryProperties
• StorageAccountParametersOrStorageAccountProperties

2017-03-01

Oldest version tracked in change log