共用方式為

驗證 Nexus 網路網狀架構的纜線

  • 發行項

本文說明網狀架構纜線驗證，其中診斷 API 的主要功能是檢查所有網狀架構裝置是否有潛在的纜線問題。 診斷 API 會評估互連裝置是否符合「材料帳單」（BOM），將其分類為符合規範或不符合規範。 結果會以 JSON 格式呈現，其中包含驗證狀態、錯誤、標識碼類型和鄰近裝置識別碼等詳細數據。 這些結果會儲存在客戶提供的 儲存體 帳戶中。 在移至叢集部署步驟之前，必須解決此報告中所識別錯誤的整體部署。

必要條件

  • 請確定已成功布建 Nexus Network Fabric。
  • 透過支援票證提供具有寫入存取權的網路網狀架構標識碼和記憶體 URL。

注意

儲存體 URL （SAS） 是短期的。 根據預設，它會設定為八小時內到期。 如果 SAS URL 過期，則必須重新修補網狀架構。

驗證纜線

  1. 執行下列 Azure CLI 命令：

    az networkfabric fabric validate-configuration –resource-group "<NFResourceGroupName>" --resource-name "<NFResourceName>" --validate-action "Cabling" --no-wait --debug

    下列 （截斷） 輸出隨即出現。 透過 私人預覽複製 URL。 下一個步驟會使用這個部分的 URL 來檢查作業的狀態。

    https://management.azure.com/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/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-

  2. 您可以執行下列命令，以程式設計方式檢查作業的狀態：

    az rest -m get -u "<Azure-AsyncOperation-endpoint url>"

    作業狀態會指出 API 是否成功或失敗。

    注意

    作業需要大約 20~40 分鐘的時間，才能根據機架數目來完成。

  3. 從記憶體 URL 下載並讀取已驗證的結果。

下列各節會顯示範例輸出。

Customer Edge （CE） 至 Provider Edge （PE） 驗證輸出範例

networkFabricInfoSkuId": "M8-A400-A100-C16-ab", 
  "racks": [ 
    { 
      "rackId": "AR-SKU-10005", 
      "networkFabricResourceId": "/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx/resourceGroups/ResourceGroupName/providers/Microsoft.managedNetworkFabric/networkFabrics/NFName", 
      "rackInfo": { 
        "networkConfiguration": { 
          "configurationState": "Succeeded", 
          "networkDevices": [ 
            { 
              "name": "AR-CE1", 
              "deviceSourceResourceId": "/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx/resourceGroups/ResourceGroupName/providers/Microsoft.ManagedNetworkFabric/networkDevices/NFName-AggrRack", 
              "roleName": "CE1", 
              "deviceSku": "DCS-XXXXXXXXX-36", 
              "deviceSN": "XXXXXXXXXXX", 
              "fixedInterfaceMaps": [ 
                { 
                  "name": "Ethernet1/1", 
                  "description": "AR-CE1:Et1/1 to PE1:EtXX", 
                  "deviceConnectionDescription": "SourceHostName:Ethernet1/1 to DestinationHostName:Ethernet", 
                  "sourceHostname": "SourceHostName", 
                  "sourcePort": "Ethernet1/1", 
                  "destinationHostname": "DestinationHostName", 
                  "destinationPort": "Ethernet", 
                  "identifier": "Ethernet1", 
                  "interfaceType": "Ethernet", 
                  "deviceDestinationResourceId": null, 
                  "speed in Gbps": "400", 
                  "cableSpecification": { 
                    "transceiverType": "400GBASE-FR4", 
                    "transceiverSN": "XKT220900XXX", 
                    "cableSubType": "AOC", 
                    "modelType": "AOC-D-D-400G-10M", 
                    "mediaType": "Straight" 
                  }, 
                  "validationResult": [ 
                    { 
                      "validationType": "CableValidation", 
                      "status": "Compliant", 
                      "validationDetails": { 
                        "deviceConfiguration": "Device Configuration detail", 
                        "error": null, 
                        "reason": null 
                      } 
                    }, 
                    { 
                      "validationType": "CableSpecificationValidation", 
                      "status": "Compliant", 
                      "validationDetails": { 
                        "deviceConfiguration": "Speed: 400 ; MediaType : Straight", 
                        "error": "null", 
                        "reason": null 
                      } 
                    } 
                  ] 
                },

Customer Edge 至機架交換器驗證的頂端

{ 
                      "name": "Ethernet11/1", 
                      "description": "AR-CE2:Et11/1 to CR1-TOR1:Et24", 
                      "deviceConnectionDescription": " SourceHostName:Ethernet11/1 to DestinationHostName:Ethernet24", 
                      "sourceHostname": "SourceHostName", 
                      "sourcePort": "Ethernet11/1", 
                      "destinationHostname": "DestinationHostName ", 
                      "destinationPort": "24", 
                      "identifier": "Ethernet11", 
                      "interfaceType": "Ethernet", 
                      "deviceDestinationResourceId": "/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx/resourceGroups/ResourceGroupName/providers/Microsoft.ManagedNetworkFabric/networkDevices/ NFName-CompRack", 
                      "speed in Gbps": "400", 
                      "cableSpecification": { 
                        "transceiverType": "400GBASE-AR8", 
                        "transceiverSN": "XYL221911XXX", 
                        "cableSubType": "AOC", 
                        "modelType": "AOC-D-D-400G-10M", 
                        "mediaType": "Straight" 
                      }, 
                      "validationResult": [ 
                        { 
                          "validationType": "CableValidation", 
                          "status": "Compliant", 
                          "validationDetails": { 
                            "deviceConfiguration": "Device Configuration detail", 
                            "error": null, 
                            "reason": null 
                          } 
                        }, 
                        { 
                          "validationType": "CableSpecificationValidation", 
                          "status": "Compliant", 
                          "validationDetails": { 
                            "deviceConfiguration": "Speed: 400 ; MediaType : Straight", 
                            "error": "", 
                            "reason": null 
                          } 
                        } 
                      ]

驗證的狀態

狀態類型 定義
符合標準 當狀態符合 BOM 規格時
不符合標準 當狀態不符合 BOM 規格時
Unknown 當狀態未知時

驗證屬性

屬性 定義
deviceConfiguration 裝置上可用的設定。
error 來自裝置的錯誤
reason 當裝置的狀態不明時，就會填入此欄位。
validationType 此參數會指出驗證的類型。 （纜線和纜線規格驗證）
deviceDestinationResourceId 已連線芳鄰的 Azure Resource Manager 識別碼（目的地裝置）
roleName 網路網狀架構裝置的角色（CE 或 TOR）

纜線驗證的已知問題和限制

  • 不支援 TOR 與計算伺服器之間的驗證後 連線。
  • 不支援 NPB 的纜線驗證，因為 Arista 不支援 “show lldp neighbors”。
  • 儲存體 URL 必須位於網路網狀架構的不同區域中。 例如，如果網狀架構裝載在美國東部，則記憶體 URL 應位於美國東部以外。
  • 纜線驗證同時支援四個機架和八個機架 BOM。

產生記憶體 URL

請參閱建立容器以建立容器。

注意

僅使用小寫字母輸入容器的名稱。

請參閱產生共用存取簽章，以建立容器的SAS URL。 提供SAS的寫入許可權。

注意

ESAS URL 的存留時間很短。 根據預設，它會設定為八小時內到期。 如果 SAS URL 到期，您必須開啟 Microsoft 支援票證以新增 URL。