Merge pull request #272177 from HollyCl/nexus0404

Nexus0404 - Validate Cables Updates

Author: prmerger-automator[bot]

articles/operator-nexus/how-to-validate-cables.md

@@ -5,21 +5,21 @@ author: HollyCl
 ms.author: HollyCl
 ms.service: azure-operator-nexus
 ms.topic: how-to #Required; leave this attribute/value as-is
-ms.date: 04/10/2024
+ms.date: 04/15/2024
 
 #CustomerIntent: As a < type of user >, I want < what? > so that < why? >.
 ---
-# Validate Cables for Nexus Network Fabric 
+# Validate Cables for Nexus Network Fabric
 
-This article explains the  Fabric cable validation, where the primary function of the diagnostic API is to check all fabric devices for potential cabling issues. The Diagnostic API assesses whether the interconnected devices adhere to the Bill of Materials (BOM), classifying them as compliant or non-compliant. The results are presented in a JSON format, encompassing details such as validation status, errors, identifier type, and neighbor device ID. These results are stored in a customer-provided Storage account. It is vital to the overall deployment that errors identified in this report are resolved before moving onto the Cluster deployment step.
+This article explains the  Fabric cable validation, where the primary function of the diagnostic API is to check all fabric devices for potential cabling issues. The Diagnostic API assesses whether the interconnected devices adhere to the Bill of Materials (BOM), classifying them as compliant or noncompliant. The results are presented in a JSON format, encompassing details such as validation status, errors, identifier type, and neighbor device ID. These results are stored in a customer-provided Storage account. It's vital to the overall deployment that errors identified in this report are resolved before moving onto the Cluster deployment step.
 
 ## Prerequisites
 
-- Ensure the Nexus Network Fabric is successfully provisioned. 
-- Provide the Network Fabric ID and storage URL with WRITE access via a support ticket. 
+- Ensure the Nexus Network Fabric is successfully provisioned.
+- Provide the Network Fabric ID and storage URL with WRITE access via a support ticket.
 
 > [!NOTE]
-> The Storage URL (SAS) is short-lived. By default, it is set to expire in eight hours. If the SAS URL expires, then the fabric must be re-patched. 
+> The Storage URL (SAS) is short-lived. By default, it is set to expire in eight hours. If the SAS URL expires, then the fabric must be re-patched.
 
 ## Validate cabling
 
@@ -28,20 +28,24 @@ This article explains the  Fabric cable validation, where the primary function o
     ```azurecli
     az networkfabric fabric validate-configuration –resource-group "<NFResourceGroupName>" --resource-name "<NFResourceName>" --validate-action "Cabling" --no-wait --debug  
     ```
-     The following (truncated) output should appear. Locate the operation status URL within the output. This URL is used to check the status of the operation, as described in the following step. 
+
+    The following (truncated) output appears. Copy the URL through **private preview**. This portion of the URL is used in the following step to check the status of the operation.
 
     ```azurecli
-     https://management.azure.com/subscriptions/xxxxxxxxxxx/providers/Microsoft.ManagedNetworkFabric/locations/EASTUS/operationStatuses/xxxxxxxxxxx?api-version=20XX-0X-xx-xx 
-      ```
+    https://management.azure.com/subscriptions/9531faa8-8c39-4165-b033-48697fe943db/providers/Microsoft.ManagedNetworkFabric/locations/EASTUS2EUAP/operationStatuses/59fdc0c8-eeb1-4258-9163-3cf096490148*A9E6DB3DF5C58D67BD395F7A608C056BC8219C392CC1CE0AD22E4C36D70CEE5C?api-version=2022-01-15-privatepreview&t=638485032018035520&c=MIIHHjCCBgagAwIBAgITfwKWMg6goKCq4WwU2AAEApYyDjANBgkqhkiG9w0BAQsFADBEMRMwEQYKCZImiZPyLGQBGRYDR0JMMRMwEQYKCZImiZPyLGQBGRYDQU1FMRgwFgYDVQQDEw9BTUUgSW5mcmEgQ0EgMDIwHhcNMjQwMTMwMTAzMDI3WhcNMjUwMTI0MTAzMDI3WjBAMT4wPAYDVQQDEzVhc3luY29wZXJhdGlvbnNpZ25pbmdjZXJ0aWZpY2F0ZS5tYW5hZ2VtZW50LmF6dXJlLmNvbTCCASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBALMk1pBZQQoNY8tos8XBaEjHjcdWubRHrQk5CqKcX3tpFfukMI0_PVZK-Kr7xkZFQTYp_ItaM2RPRDXx-0W9-mmrUBKvdcQ0rdjcSXDek7GvWS29F5sDHojD1v3e9k2jJa4cVSWwdIguvXmdUa57t1EHxqtDzTL4WmjXitzY8QOIHLMRLyXUNg3Gqfxch40cmQeBoN4rVMlP31LizDfdwRyT1qghK7vgvworA3D9rE00aM0n7TcBH9I0mu-96JE0gSX1FWXctlEcmdwQmXj_U0sZCu11_Yr6Oa34bmUQHGc3hDvO226L1Au-QsLuRWFLbKJ-0wmSV5b3CbU1kweD5LUCAwEAAaOCBAswggQHMCcGCSsGAQQBgjcVCgQaMBgwCgYIKwYBBQUHAwEwCgYIKwYBBQUHAwIwPQYJKwYBBAGCNxUHBDAwLgYmKwYBBAGCNxUIhpDjDYTVtHiE8Ys-
+
+    ```
 
 1. You can programmatically check the status of the operation by running the following command:
+
     ```azurecli
-    az rest -m get -u "<Azure-operationsstatus-endpoint url>" 
+    az rest -m get -u "<Azure-AsyncOperation-endpoint url>" 
     ```
-    The operation status indicates if the API succeeded or failed. 
 
-   > [!NOTE]
-   > The operation takes roughly 20~40 minutes to complete based on the number of racks.  
+    The operation status indicates if the API succeeded or failed.
+
+    > [!NOTE]
+    > The operation takes roughly 20~40 minutes to complete based on the number of racks.  
 
 1. Download and read the validated results from the storage URL.
 
@@ -108,10 +112,8 @@ networkFabricInfoSkuId": "M8-A400-A100-C16-ab",
                 },
 ```
 
-
 ### Customer Edge to Top of the Rack switch validation
 
-
 ```azurecli
 { 
                       "name": "Ethernet11/1", 
@@ -173,13 +175,12 @@ networkFabricInfoSkuId": "M8-A400-A100-C16-ab",
 |`deviceDestinationResourceId`      |  Azure Resource Manager ID of the connected Neighbor (destination device)        |
 |`roleName`      |  The role of the Network Fabric Device (CE or TOR)        |
 
-
 ## Known issues and limitations in cable validation
 
-- Post Validation Connections between TORs and Compute Servers isn't supported. 
+- Post Validation Connections between TORs and Compute Servers isn't supported.
 - Cable Validation for NPB isn't supported because there's no support for "show lldp neighbors" from Arista.  
-- The Storage URL must be in a different region from the Network Fabric. For instance, if the Fabric is hosted in East US, the storage URL should be outside of East US. 
-- Cable validation supports both 4 rack and 8 rack BOMs.
+- The Storage URL must be in a different region from the Network Fabric. For instance, if the Fabric is hosted in East US, the storage URL should be outside of East US.
+- Cable validation supports both four rack and eight rack BOMs.
 
 ## Generate the storage URL
 
@@ -191,4 +192,4 @@ Refer to [Create a container](../storage/blobs/blob-containers-portal.md#create-
 Refer to [Generate a shared access signature](../storage/blobs/blob-containers-portal.md#generate-a-shared-access-signature) to create the SAS URL of the container. Provide Write permission for SAS.
 
 > [!NOTE]
-> ESAS URLs are short lived. By default, it is set to expire in eight hours. If the SAS URL expires, then you must open a Microsoft support ticket to add a new URL. 
+> ESAS URLs are short lived. By default, it is set to expire in eight hours. If the SAS URL expires, then you must open a Microsoft support ticket to add a new URL.