Skip to content

Commit ca6cf18

Browse files
Merge pull request #312936 from vgs-msft/docs-editor/immutable-policy-configure-ver-1773167156
Update immutable-policy-configure-version-scope.md
2 parents c9e3d49 + 7bed6d9 commit ca6cf18

1 file changed

Lines changed: 5 additions & 4 deletions

File tree

articles/storage/blobs/immutable-policy-configure-version-scope.md

Lines changed: 5 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -147,11 +147,11 @@ If version-level immutability support is enabled for a container and the contain
147147

148148
#### Migrate an existing container to support version-level immutability
149149

150-
To configure version-level immutability policies for an existing container, you must migrate the container to support version-level immutable storage. Container migration may take some time and can't be reversed. You can migrate 10 containers at a time per storage account.
150+
To configure version-level immutability policies for an existing container, you must migrate the container to support version-level immutable storage. Container migration may take some time and can't be reversed. However, if a migration fails, it will revert back to a container-level WORM policy, and you will have to start the migration again. You can migrate 10 containers at a time per storage account.
151151

152-
To migrate an existing container to support version-level immutability policies, the container must have a container-level time-based retention policy configured. The migration fails unless the container has an existing policy. The retention interval for the container-level policy is maintained as the retention interval for the default version-level policy on the container.
152+
To migrate an existing container to support version-level immutability policies, the container must have a container-level time-based retention policy configured and versioning enabled at the account level. The migration fails unless the container has an existing policy. The retention interval for the container-level policy is maintained as the retention interval for the default version-level policy on the container.
153153

154-
If the container has an existing container-level legal hold, then it can't be migrated until the legal hold is removed. If a container or any blob within that container has an active lease, it cannot be migrated.
154+
If the container has an existing container-level legal hold, then it can't be migrated until the legal hold is removed. If a container or any blob within that container has an active lease, it cannot be migrated. The migration will continue to fail after restarting unless all active leases are removed. There is a possibility that if a migration is started and then fails, some of the blobs will have a version-level immutability policy that will not be visible on the Azure Portal until the migration completes successfully.
155155

156156
##### [Portal](#tab/azure-portal)
157157

@@ -176,7 +176,8 @@ After the migration is complete, the scope of the policy on the container shows
176176

177177
You can restart a failed migration by repeating the earlier steps. Before starting the process again, it is recommended that you verify there are no active leases on any blobs. The easiest way to do so is using [Blob Inventory](/azure/storage/blobs/blob-inventory). Migrations could fail for multiple reasons, the most common one being active leases on any blob.
178178

179-
NOTE: A failed migration could result in a partial migration state where some of the blobs in the container have a blob-level policy and is not reflected on the Portal. But the scope of the immutability policy will remain at the container level until a successful migration has been completed.
179+
> [!NOTE]
180+
> A failed migration could result in a partial migration state where some of the blobs in the container have a blob-level policy and is not reflected on the Portal. But the scope of the immutability policy will remain at the container level until a successful migration has been completed. There are currently no error messages showing the cause of failure, so you will have to investigate potential causes in your container.
180181
181182
##### [PowerShell](#tab/azure-powershell)
182183

0 commit comments

Comments
 (0)