Merge pull request #300666 from eak13/main

Adding reference table that shows deprecating resource fields and their replacements

Author: prmerger-automator[bot]

articles/operator-nexus/howto-cluster-managed-identity-user-provided-resources.md

@@ -207,7 +207,7 @@ az networkcloud cluster update --name "clusterName" --resource-group "resourceGr
 _Example 3:_ Update a Cluster that already has a SAMI and add a UAMI. The SAMI is retained. Then assign the UAMI to the log analytics output settings (LAW).
 
 > [!CAUTION]
-> Changing the LAW settings will cause a brief disruption in sending metrics to the LAW as the extensions which use the LAW might need to be reinstalled.
+> Changing the LAW settings causes a brief disruption in sending metrics to the LAW as the extensions which use the LAW might need to be reinstalled.
 
 Cluster update to add the UAMI `mUAMI`.
 
@@ -397,7 +397,7 @@ az networkcloud cluster update --name "clusterName" --resource-group "resourceGr
 _Example 2:_ Add or update the log analytics output settings (LAW) for a Cluster.
 
 > [!CAUTION]
-> Changing the LAW settings will cause a brief disruption in sending metrics to the LAW as the extensions which use the LAW need to be reinstalled.
+> Changing the LAW settings causes a brief disruption in sending metrics to the LAW as the extensions which use the LAW need to be reinstalled.
 
 ```azurecli-interactive
 az networkcloud cluster update --name "clusterName" --resource-group "resourceGroupName" \
@@ -489,3 +489,62 @@ Note, `<APIVersion>` is the API version 2024-07-01 or newer.
     }
   }
   ```
+
+## Field deprecations and replacements
+
+This section is a reference for the deprecated resource fields and their replacements. All fields are found on the Cluster resource except for the Cluster Manager managed identity used for the deprecated key vault method. This list also assumes that an associated managed identity is defined on the Cluster that corresponds with the managed identity for the resource.
+
+`identity-resource-id` is only required when using a UAMI. It shouldn't be specified if using a SAMI for the resource.
+
+### Storage Account
+
+_**Deprecated Fields:**_ N/A
+
+_**Replacing Fields:**_
+
+```azurecli
+command-output-settings:
+  container-url
+  identity-type
+  identity-resource-id
+```
+
+_**Notes:**_ Deprecated Fields is N/A because the Cluster Manager storage account gets created automatically today and doesn't require user input.
+
+### Key Vault
+
+_**Deprecated Fields:**_
+
+```azurecli
+cluster-secret-archive:
+  use-key-vault
+  key-vault-id
+```
+
+Cluster Manager managed identity
+
+_**Replacing Fields:**_
+
+```azurecli
+secret-archive-settings:
+  vault-uri
+  identity-type
+  identity-resource-id
+```
+
+_**Notes:**_ `vault-uri` in `secret-archive-settings` is the URI for the Key Vault being specified versus the ARM resource ID that is specified for `key-vault-id`. The same managed identity that was specified for the Cluster Manager can be used on the Cluster.
+
+### Log Analytics Workspace
+
+_**Deprecated Fields:**_ `analytics-workspace-id`
+
+_**Replacing Fields:**_
+
+```azurecli
+analytics-output-settings:
+  analytics-workspace-id
+  identity-type
+  identity-resource-id
+```
+
+_**Notes:**_ The input format (LAW ARM resource ID) is the same between the deprecated `analytics-workspace-id` field and the `analytics-workspace-id` within `analytics-output-settings`.