Uruchamianie poleceń odczytu zapisu

2025-05-20

Funkcja odczytu i zapisu (RW) umożliwia zdalne modyfikowanie konfiguracji urządzenia bez konieczności uzyskiwania dostępu do urządzenia w sieci bazowej. Zastosuj polecenie konfiguracji RW na poziomie urządzenia w tkaninie sieciowej. Ponieważ polecenie konfiguracji utrzymuje się na poziomie urządzenia, aby skonfigurować wszystkie urządzenia, należy zastosować konfigurację do każdego urządzenia w sieci szkieletowej.

Wykonanie polecenia RW zachowuje konfigurację przed zmianami wprowadzonych za pośrednictwem interfejsu wiersza polecenia (CLI) lub portalu. Aby wprowadzić wiele konfiguracji za pośrednictwem interfejsu API RW, dołącz nowe polecenia do istniejącego polecenia RW. Na przykład po zmodyfikowaniu wielu interfejsów urządzeń dołącz poprzednią konfigurację z wszelkimi nowymi zmianami, aby zapobiec zastępowaniu.

Przywróć konfigurację RW tylko podczas scenariusza uaktualniania. Po uaktualnieniu należy ponownie zastosować modyfikacje RW w razie potrzeby. W poniższych przykładach przedstawiono szczegółowe instrukcje dotyczące procesu interfejsu API RW.

Wymagania wstępne

Upewnij się, że sieć szkieletowa Nexus została pomyślnie aprowizowana.

Procedura

Po wykonaniu polecenia konfiguracji RW i wprowadzeniu zmian w urządzeniu stan konfiguracji urządzenia zostanie przeniesiony do odroczonej kontroli. Ten stan wskazuje, że konfiguracja RW została zastosowana na tym urządzeniu. Po odwróceniu zastosowanej konfiguracji RW konfiguracja urządzenia zostanie przywrócona do oryginalnego stanu powodzenia .

Wybierz pozycję Urządzenie sieciowe

Zaloguj się do witryny Azure Portal.

Dostęp do urządzeń sieciowych:

Po zalogowaniu użyj paska wyszukiwania u góry, aby wyszukać Network Devices lub przejść do pozycji Wszystkie usługi i znaleźć urządzenia sieciowe w kategorii Sieć.

Kliknij pozycję Urządzenia sieciowe, aby otworzyć listę urządzeń sieciowych w ramach subskrypcji.

Wybierz urządzenie sieciowe:

Z listy urządzeń sieciowych znajdź i kliknij urządzenie sieciowe, które chcesz skonfigurować. Spowoduje to przejście do strony szczegółów wybranego urządzenia sieciowego.

Zanotuj nazwę zasobu i grupę zasobów tego urządzenia sieciowego, ponieważ będą one potrzebne dla polecenia interfejsu wiersza polecenia.

lub

Aby uzyskać nazwę zasobu, kliknij widok JSON (znajdujący się w sekcji Właściwości lub Przegląd), który wyświetla szczegółowe właściwości urządzenia, w tym nazwę zasobu.

Przykłady

W poniższych sekcjach przedstawiono przykłady poleceń RW, które mogą służyć do modyfikowania konfiguracji urządzenia. W przykładach użyto interfejsów Ethernet 1, 2 i 3, aby pokazać, jak dostosować nazwę interfejsu i umożliwić obserwowanie wyników tych modyfikacji.

Migawka urządzenia sieci szkieletowej przed wprowadzeniem zmian w konfiguracji przy użyciu interfejsu API RW

show interfaces description

|Interface  |Status  |Protocol  |Description  |
|---------|---------|---------|---------|
|Et1      | admin down        | down          | **"AR-Mgmt2:Et1 to Not-Connected"**          |
|Et2      | admin down        | down          | **"AR-Mgmt2:Et2 to Not-Connected"**         |
|Et3      | admin down        | down          | **"AR-Mgmt2:Et3 to Not-Connected"**         |
|Et4      | admin down        | down          | **"AR-Mgmt2:Et4 to Not-Connected"**       |

Zmienianie opisu interfejsu

W przykładzie pokazano, jak zmienić opis interfejsu urządzenia na RW-test.

az networkfabric device run-rw --resource-name <ResourceName> --resource-group <ResourceGroupName> --rw-command "interface Ethernet 1\n description RW-test"

Parametr	Opis
`az networkfabric device run-rw`	Polecenie Azure CLI służące do wykonywania operacji odczytu i zapisu na urządzeniu sieciowym w Azure Network Fabric.
`--resource-name`	Określa nazwę zasobu (urządzenia sieciowego), na którym będzie wykonywana operacja RW.
`--resource-group`	Określa nazwę grupy zasobów, która zawiera urządzenie sieciowe.
`--rw-command "interface Ethernet 1\n description RW-test"`	Określa polecenie RW do wykonania na urządzeniu sieciowym. W tym przykładzie ustawia opis interfejsu Ethernet 1 na "RW-test".

Oczekiwane dane wyjściowe:

{}

Polecenie za pomocą polecenia --no-wait--debug

az networkfabric device run-rw --resource-name <ResourceName> --resource-group <ResourceGroupName> --rw-command "interface Ethernet 1\n description RW-test" **--no-wait --debug**

Parametr	Opis
`az networkfabric device run-rw`	Polecenie Azure CLI służące do wykonywania operacji odczytu i zapisu na urządzeniu sieciowym w Azure Network Fabric.
`--resource-name`	Określa nazwę zasobu (urządzenia sieciowego), na którym będzie wykonywana operacja RW.
`--resource-group`	Określa nazwę grupy zasobów, która zawiera urządzenie sieciowe.
`--rw-command "interface Ethernet 1\n description RW-test"`	Określa polecenie RW do wykonania na urządzeniu sieciowym. W tym przykładzie ustawia opis interfejsu Ethernet 1 na "RW-test".
`--no-wait`	Wskazuje, że polecenie powinno być wykonywane asynchronicznie bez oczekiwania na zakończenie operacji.
`--debug`	Flaga włączania trybu debugowania, podając dodatkowe informacje na temat wykonywania polecenia na potrzeby rozwiązywania problemów.

Oczekiwane obcięte dane wyjściowe:

cli.knack.cli: __init__ debug log: 
cli.azure.cli.core.sdk.policies:     'Azure-AsyncOperation': 'https://eastus.management.azure.com/subscriptions/XXXXXXXXXXXXXXXXXXXXXXXXXXXXX/providers/Microsoft.ManagedNetworkFabric/locations/EASTUS/operationStatuses/e239299a-8c71-426e-8460-58d4c0b470e2*BF225A07F7F4850DA565ABE0036AB?api-version=2022-01-15-privatepreview&t=638479088323069839&c= 
telemetry.main: Begin creating telemetry upload process. 
telemetry.process: Return from creating process 
telemetry.main: Finish creating telemetry upload process.

Możesz programowo sprawdzić stan operacji, uruchamiając następujące polecenie:

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

Przykład adresu URL punktu końcowego Azure-AsyncOperation wyodrębnionego z obciętego wyniku.

<https://eastus.management.azure.com/subscriptions/xxxxxxxxxxx/providers/Microsoft.ManagedNetworkFabric/locations/EASTUS/operationStatuses/xxxxxxxxxxx?api-version=20XX-0X-xx-xx>

Stan powinien wskazywać, czy interfejs API zakończył się powodzeniem, czy niepowodzeniem.

Oczekiwane dane wyjściowe:

{ 
  "id": "/subscriptions/XXXXXXXXXXXX/resourceGroups/ResourceGroupName/providers/Microsoft.ManagedNetworkFabric/networkDevices/ResourceName", 
  "location": "eastus", 
  "name": "ResourceName", 
  "properties": { 
    "administrativeState": "Enabled", 
    "configurationState": "DeferredControl", 
    "hostName": "<Hostname>", 
    "networkDeviceRole": "Management", 
    "networkDeviceSku": "DefaultSku", 
    "networkRackId": "/subscriptions/XXXXXXXXXXXX/resourceGroups/ResourceGroupName/providers/Microsoft.ManagedNetworkFabric/networkRacks/NFResourceName", 
    "provisioningState": "Succeeded", 
    "serialNumber": "Arista;CCS-720DT-XXXX;11.07;WTW2248XXXX", 
    "version": "3.0.0" 
  }, 
  "systemData": { 
    "createdAt": "2024-XX-XXT13:41:13.8558264Z", 
    "createdBy": "xxxxxxxx-xxxx-xxxx-xxxxxx", 
    "createdByType": "Application", 
    "lastModifiedAt": "2024-XX-XXT10:44:21.3736554Z", 
    "lastModifiedBy": "xxxxxxxx-xxxx-xxxx-xxxxxx", 
    "lastModifiedByType": "Application" 
  }, 
  "type": "microsoft.managednetworkfabric/networkdevices" 
}

Po pomyślnym zakończeniu konfiguracji RW stan konfiguracji urządzenia zostanie przeniesiony do stanu odroczonej kontroli . W przypadku niepowodzenia konfiguracji nie nastąpi żadna zmiana stanu.

show interfaces description

|Interface  |Status  |Protocol  |Description  |
|---------|---------|---------|---------|
|Et1      | admin down        | down          | **RW-test1**         |
|Et2      | admin down        | down          | "AR-Mgmt2:Et2 to Not-Connected"        |
|Et3      | admin down        | down          | "AR-Mgmt2:Et3 to Not-Connected"          |
|Et4      | admin down        | down          | "AR-Mgmt2:Et4 to Not-Connected"     |

Zmiana trzech opisów interfejsu

W tym przykładzie pokazano, jak zmienić trzy różne interfejsy w opisie urządzenia na RW-test1, RW-test2, RW-test3.

az networkfabric device run-rw --resource-name <ResourceName> --resource-group <ResourceGroupName> --rw-command "interface Ethernet 1\n description RW-test1\n interface Ethernet 2\n description RW-test2\n interface Ethernet 3\n description RW-test3"

Parametr	Opis
`az networkfabric device run-rw`	Polecenie Azure CLI służące do wykonywania operacji odczytu i zapisu na urządzeniu sieciowym w Azure Network Fabric.
`--resource-name <ResourceName>`	Określa nazwę zasobu (urządzenia sieciowego), na którym będzie wykonywana operacja RW.
`--resource-group <ResourceGroupName>`	Określa nazwę grupy zasobów, która zawiera urządzenie sieciowe.
`--rw-command "interface Ethernet 1\n description RW-test1\n interface Ethernet 2\n description RW-test2\n interface Ethernet 3\n description RW-test3"`	Określa polecenia RW, które mają być wykonywane na urządzeniu sieciowym. Każde polecenie "interface" ustawia opis określonego interfejsu Ethernet.

Oczekiwane dane wyjściowe:

{}

Polecenie za pomocą polecenia --no-wait--debug

az networkfabric device run-rw --resource-name <ResourceName> --resource-group <ResourceGroupName> --rw-command "interface Ethernet 1\n description RW-test1\n interface Ethernet 2\n description RW-test2\n interface Ethernet 3\n description RW-test3" --no-wait --debug

Parametr	Opis
`az networkfabric device run-rw`	Polecenie Azure CLI służące do wykonywania operacji odczytu i zapisu na urządzeniu sieciowym w Azure Network Fabric.
`--resource-name <ResourceName>`	Określa nazwę zasobu (urządzenia sieciowego), na którym będzie wykonywana operacja RW.
`--resource-group <ResourceGroupName>`	Określa nazwę grupy zasobów, która zawiera urządzenie sieciowe.
`--rw-command "interface Ethernet 1\n description RW-test1\n interface Ethernet 2\n description RW-test2\n interface Ethernet 3\n description RW-test3"`	Określa polecenia RW, które mają być wykonywane na urządzeniu sieciowym. Każde polecenie "interface" ustawia opis określonego interfejsu Ethernet.
`--no-wait`	Wskazuje, że polecenie powinno być wykonywane asynchronicznie bez oczekiwania na zakończenie operacji.
`--debug`	Flaga włączania trybu debugowania, podając dodatkowe informacje na temat wykonywania polecenia na potrzeby rozwiązywania problemów.

Oczekiwane obcięte dane wyjściowe:

cli.knack.cli: Command arguments: \['networkfabric', 'device', 'run-rw', '--resource-name', 'nffab100g-5-3-AggrRack-MgmtSwitch2', '--resource-group', 'Fab100GLabNF-5-3', '--rw-command', 'interface Ethernet 1\\\\n description RW-test1\\\\n interface Ethernet 2\\\\n description RW-test2\\\\n interface Ethernet 3\\\\n description RW-test3', '--debug'\]
cli.knack.cli: \_\_init\_\_ debug log:
cli.azure.cli.core.sdk.policies: 'Azure-AsyncOperation': 'https://eastus.management.azure.com/subscriptions/XXXXXXXXXXXXXXXXXXXXXXXXXXXXX/providers/Microsoft.ManagedNetworkFabric/locations/EASTUS/operationStatuses/e239299a-8c71-426e-8460-58d4c0b470e2\*BF225A07F7F4850DA565ABE0036AB?api-version=2022-01-15-privatepreview&t=638479088323069839&c=
telemetry.main: Begin creating telemetry upload process.
telemetry.process: Creating upload process: "C:\\Program Files (x86)\\Microsoft SDKs\\Azure\\CLI2\\python.exe C:\\Program Files (x86)\\Microsoft SDKs\\Azure\\CLI2\\Lib\\site-packages\\azure\\cli\\telemetry\\\_\_init\_\_.pyc \\.azure"
telemetry.process: Return from creating process
telemetry.main: Finish creating telemetry upload process.

Możesz programowo sprawdzić stan operacji, uruchamiając następujące polecenie:

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

Przykład adresu URL punktu końcowego Azure-AsyncOperation wyodrębnionego z obciętego wyniku.

<https://eastus.management.azure.com/subscriptions/xxxxxxxxxxx/providers/Microsoft.ManagedNetworkFabric/locations/EASTUS/operationStatuses/xxxxxxxxxxx?api-version=20XX-0X-xx-xx>

Stan powinien wskazywać, czy interfejs API zakończył się powodzeniem, czy niepowodzeniem.

Oczekiwane dane wyjściowe:

{ 
  "id": "/subscriptions/XXXXXXXXXXXX/resourceGroups/ResourceGroupName/providers/Microsoft.ManagedNetworkFabric/networkDevices/ResourceName", 
  "location": "eastus", 
  "name": "ResourceName", 
  "properties": { 
    "administrativeState": "Enabled", 
    "configurationState": "**DeferredControl**", 
    "hostName": "<Hostname>", 
    "networkDeviceRole": "Management", 
    "networkDeviceSku": "DefaultSku", 
    "networkRackId": "/subscriptions/ XXXXXXXXXXXX /resourceGroups/ ResourceGroupName /providers/Microsoft.ManagedNetworkFabric/networkRacks/ NFResourceName ", 
    "provisioningState": "Succeeded", 
    "serialNumber": "Arista;CCS-720DT-XXXX;11.07;WTW2248XXXX", 
    "version": "3.0.0" 
  }, 
  "systemData": { 
    "createdAt": "2024-XX-XXT13:41:13.8558264Z", 
    "createdBy": "xxxxxxxx-xxxx-xxxx-xxxxxx", 
    "createdByType": "Application", 
    "lastModifiedAt": "2024-XX-XXT10:44:21.3736554Z", 
    "lastModifiedBy": "xxxxxxxx-xxxx-xxxx-xxxxxx", 
    "lastModifiedByType": "Application" 
  }, 
  "type": "microsoft.managednetworkfabric/networkdevices" 
}

show interfaces description

|Interface  |Status  |Protocol  |Description  |
|---------|---------|---------|---------|
|Et1      | admin down        | down          | **RW-test1**         |
|Et2      | admin down        | down          | **RW-test2**         |
|Et3      | admin down        | down          | **RW-test3**         |
|Et4      | admin down        | down          | "AR-Mgmt2:Et4 to Not-Connected"     |

Zastąp poprzednią konfigurację

W tym przykładzie pokazano, jak poprzednia konfiguracja jest zastępowana, jeśli nie dołączysz starej konfiguracji RW:

az networkfabric device run-rw --resource-name <ResourceName> --resource-group <ResourceGroupName> --rw-command "interface Ethernet 3\n description RW-test3"

Parametr	Opis
`az networkfabric device run-rw`	Polecenie Azure CLI służące do wykonywania operacji odczytu i zapisu na urządzeniu sieciowym w Azure Network Fabric.
`--resource-name`	Określa nazwę zasobu (urządzenia sieciowego), na którym będzie wykonywana operacja RW.
`--resource-group`	Określa nazwę grupy zasobów, która zawiera urządzenie sieciowe.
`--rw-command "interface Ethernet 1\n description RW-test1\n interface Ethernet 2\n description RW-test2\n interface Ethernet 3\n description RW-test3"`	Określa polecenia RW, które mają być wykonywane na urządzeniu sieciowym. Każde polecenie "interface" ustawia opis określonego interfejsu Ethernet.

Oczekiwane dane wyjściowe:

{}

Polecenie za pomocą polecenia --no-wait--debug

az networkfabric device run-rw --resource-name <ResourceName> --resource-group <ResourceGroupName> --rw-command "interface Ethernet 3\n description RW-test3" --no-wait --debug

Parametr	Opis
`az networkfabric device run-rw`	Polecenie Azure CLI służące do wykonywania operacji odczytu i zapisu na urządzeniu sieciowym w Azure Network Fabric.
`--resource-name`	Określa nazwę zasobu (urządzenia sieciowego), na którym będzie wykonywana operacja RW.
`--resource-group`	Określa nazwę grupy zasobów, która zawiera urządzenie sieciowe.
`--rw-command "interface Ethernet 1\n description RW-test1\n interface Ethernet 2\n description RW-test2\n interface Ethernet 3\n description RW-test3"`	Określa polecenia RW, które mają być wykonywane na urządzeniu sieciowym. Każde polecenie "interface" ustawia opis określonego interfejsu Ethernet.
`--no-wait`	Wskazuje, że polecenie powinno być wykonywane asynchronicznie bez oczekiwania na zakończenie operacji.
`--debug`	Flaga włączania trybu debugowania, podając dodatkowe informacje na temat wykonywania polecenia na potrzeby rozwiązywania problemów.

Oczekiwane obcięte dane wyjściowe:

cli.knack.cli: Command arguments: \['networkfabric', 'device', 'run-rw', '--resource-name', 'nffab100g-5-3-AggrRack-MgmtSwitch2', '--resource-group', 'Fab100GLabNF-5-3', '--rw-command', \`interface Ethernet 3\\n description RW-test3\`, '--debug'\]cli.knack.cli: \_\_init\_\_ debug log:
cli.azure.cli.core.sdk.policies: 'Azure-AsyncOperation': 'https://eastus.management.azure.com/subscriptions/XXXXXXXXXXXXXXXXXXXXXXXXXXXXX/providers/Microsoft.ManagedNetworkFabric/locations/EASTUS/operationStatuses/e239299a-8c71-426e-8460-58d4c0b470e2\*BF225A07F7F4850DA565ABE0036AB?api-version=2022-01-15-privatepreview&t=638479088323069839&c=
telemetry.main: Begin creating telemetry upload process.
telemetry.process: Creating upload process: "C:\\Program Files (x86)\\Microsoft SDKs\\Azure\\CLI2\\python.exe C:\\Program Files (x86)\\Microsoft SDKs\\Azure\\CLI2\\Lib\\site-packages\\azure\\cli\\telemetry\\\_\_init\_\_.pyc \\.azure"
telemetry.process: Return from creating process
telemetry.main: Finish creating telemetry upload process.

Możesz programowo sprawdzić stan operacji, uruchamiając następujące polecenie:

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

Przykład adresu URL punktu końcowego Azure-AsyncOperation wyodrębnionego z obciętego wyniku.

<https://eastus.management.azure.com/subscriptions/xxxxxxxxxxx/providers/Microsoft.ManagedNetworkFabric/locations/EASTUS/operationStatuses/xxxxxxxxxxx?api-version=20XX-0X-xx-xx>

Oczekiwane dane wyjściowe:

{ 
  "id": "/subscriptions/XXXXXXXXXXXX/resourceGroups/ResourceGroupName/providers/Microsoft.ManagedNetworkFabric/networkDevices/ResourceName", 
  "location": "eastus", 
  "name": "ResourceName", 
  "properties": { 
    "administrativeState": "Enabled", 
    "configurationState": "**DeferredControl**", 
    "hostName": "<Hostname>", 
    "networkDeviceRole": "Management", 
    "networkDeviceSku": "DefaultSku", 
    "networkRackId": "/subscriptions/ XXXXXXXXXXXX /resourceGroups/ ResourceGroupName /providers/Microsoft.ManagedNetworkFabric/networkRacks/ NFResourceName ", 
    "provisioningState": "Succeeded", 
    "serialNumber": "Arista;CCS-720DT-XXXX;11.07;WTW2248XXXX", 
    "version": "3.0.0" 
  }, 
  "systemData": { 
    "createdAt": "2024-XX-XXT13:41:13.8558264Z", 
    "createdBy": "xxxxxxxx-xxxx-xxxx-xxxxxx", 
    "createdByType": "Application", 
    "lastModifiedAt": "2024-XX-XXT10:44:21.3736554Z", 
    "lastModifiedBy": "xxxxxxxx-xxxx-xxxx-xxxxxx", 
    "lastModifiedByType": "Application" 
  }, 

  "type": "microsoft.managednetworkfabric/networkdevices" 

}

show interfaces description

|Interface  |Status  |Protocol  |Description  |
|---------|---------|---------|---------|
|Et1      | admin down        | down          | "AR-Mgmt2:Et1 to Not-Connected"          |
|Et2      | admin down        | down          | "AR-Mgmt2:Et2 to Not-Connected"        |
|Et3      | admin down        | down          | **RW-test3**         |
|Et4      | admin down        | down          | "AR-Mgmt2:Et4 to Not-Connected"     |

Czyszczenie konfiguracji odczytu zapisu

W tym przykładzie pokazano, jak konfiguracja RW jest czyszczona. Po uruchomieniu oczyszczania konfiguracja zostanie przywrócona do oryginalnej konfiguracji.

az networkfabric device run-rw --resource-name <ResourceName> --resource-group <ResourceGroupName> --rw-command " "

Parametr	Opis
`az networkfabric device run-rw`	Polecenie Azure CLI służące do wykonywania operacji odczytu i zapisu na urządzeniu sieciowym w Azure Network Fabric.
`--resource-name <ResourceName>`	Określa nazwę zasobu (urządzenia sieciowego), na którym będzie wykonywana operacja RW.
`--resource-group <ResourceGroupName>`	Określa nazwę grupy zasobów, która zawiera urządzenie sieciowe.
`--rw-command " "`	Określa puste polecenie RW do wykonania na urządzeniu sieciowym. To polecenie jest zasadniczo symbolem zastępczym bez działania.

Uwaga / Notatka

Upewnij się, że istnieje spacja między cudzysłowami w pustym poleceniu RW.

Oczekiwane dane wyjściowe:

{}

Polecenie za pomocą polecenia --no-wait--debug

az networkfabric device run-rw --resource-name <ResourceName> --resource-group <ResourceGroupName> --rw-command " " --no-wait --debug

Parametr	Opis
`az networkfabric device run-rw`	Polecenie Azure CLI służące do wykonywania operacji odczytu i zapisu na urządzeniu sieciowym w Azure Network Fabric.
`--resource-name <ResourceName>`	Określa nazwę zasobu (urządzenia sieciowego), na którym będzie wykonywana operacja RW.
`--resource-group <ResourceGroupName>`	Określa nazwę grupy zasobów, która zawiera urządzenie sieciowe.
`--rw-command " "`	Określa puste polecenie RW do wykonania na urządzeniu sieciowym. To polecenie jest zasadniczo symbolem zastępczym bez działania.
`--no-wait`	Wskazuje, że polecenie powinno być wykonywane asynchronicznie bez oczekiwania na zakończenie operacji.
`--debug`	Flaga włączania trybu debugowania, podając dodatkowe informacje na temat wykonywania polecenia na potrzeby rozwiązywania problemów.

Oczekiwane obcięte dane wyjściowe:

cli.knack.cli: Command arguments: \['networkfabric', 'device', 'run-rw', '--resource-name', 'nffab100g-5-3-AggrRack-MgmtSwitch2', '--resource-group', 'Fab100GLabNF-5-3', '--rw-command', ' ' '--debug'\]cli.knack.cli: \_\_init\_\_ debug log:
cli.azure.cli.core.sdk.policies: 'Azure-AsyncOperation': 'https://eastus.management.azure.com/subscriptions/XXXXXXXXXXXXXXXXXXXXXXXXXXXXX/providers/Microsoft.ManagedNetworkFabric/locations/EASTUS/operationStatuses/e239299a-8c71-426e-8460-58d4c0b470e2\*BF225A07F7F4850DA565ABE0036AB?api-version=2022-01-15-privatepreview&t=638479088323069839&c=
telemetry.main: Begin creating telemetry upload process.
telemetry.process: Creating upload process: "C:\\Program Files (x86)\\Microsoft SDKs\\Azure\\CLI2\\python.exe C:\\Program Files (x86)\\Microsoft SDKs\\Azure\\CLI2\\Lib\\site-packages\\azure\\cli\\telemetry\\\_\_init\_\_.pyc \\.azure"
telemetry.process: Return from creating process
telemetry.main: Finish creating telemetry upload process.

Możesz programowo sprawdzić stan operacji, uruchamiając następujące polecenie:

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

Przykład adresu URL punktu końcowego Azure-AsyncOperation wyodrębnionego z obciętego wyniku.

<https://eastus.management.azure.com/subscriptions/xxxxxxxxxxx/providers/Microsoft.ManagedNetworkFabric/locations/EASTUS/operationStatuses/xxxxxxxxxxx?api-version=20XX-0X-xx-xx>

Stan wskazuje, czy interfejs API zakończył się powodzeniem, czy niepowodzeniem.

Oczekiwane dane wyjściowe:

{ 
  "id": "/subscriptions/XXXXXXXXXXXX/resourceGroups/ResourceGroupName/providers/Microsoft.ManagedNetworkFabric/networkDevices/ResourceName", 
  "location": "eastus", 
  "name": "ResourceName", 
  "properties": { 
    "administrativeState": "Enabled", 
    "configurationState": "**Succeeded**", 
    "hostName": "<Hostname>", 
    "networkDeviceRole": "Management", 
    "networkDeviceSku": "DefaultSku", 
    "networkRackId": "/subscriptions/ XXXXXXXXXXXX /resourceGroups/ ResourceGroupName /providers/Microsoft.ManagedNetworkFabric/networkRacks/ NFResourceName ", 
    "provisioningState": "Succeeded", 
    "serialNumber": "Arista;CCS-720DT-XXXX;11.07;WTW2248XXXX", 
    "version": "3.0.0" 
  }, 
  "systemData": { 
    "createdAt": "2024-XX-XXT13:41:13.8558264Z", 
    "createdBy": "xxxxxxxx-xxxx-xxxx-xxxxxx", 
    "createdByType": "Application", 
    "lastModifiedAt": "2024-XX-XXT10:44:21.3736554Z", 
    "lastModifiedBy": "xxxxxxxx-xxxx-xxxx-xxxxxx", 
    "lastModifiedByType": "Application" 
  }, 
  "type": "microsoft.managednetworkfabric/networkdevices" 
}

Gdy konfiguracja RW zostanie przywrócona do pierwotnej konfiguracji, stan urządzenia zostanie przeniesiony do stanu "Sukces" z trybu odroczonej kontroli.

show interfaces description

|Interface  |Status  |Protocol  |Description  |
|---------|---------|---------|---------|
|Et1      | admin down        | down          | **"AR-Mgmt2:Et1 to Not-Connected"**         |
|Et2      | admin down        | down          | **"AR-Mgmt2:Et2 to Not-Connected"**         |
|Et3      | admin down        | down          | **"AR-Mgmt2:Et3 to Not-Connected"**      |
|Et4      | admin down        | down          |  **"AR-Mgmt2:Et4 to Not-Connected"**    |

Ograniczenia poleceń

Funkcja polecenia RW jest otwarta i nie ma żadnych ograniczeń. Należy jednak zachować ostrożność, ponieważ nieprawidłowe użycie konfiguracji może spowodować wyłączenie systemu.

Tworzenie sieci vLAN z zakresu od 1 do 500 i 3000 do 4095 nie jest zalecane, ponieważ ten zakres jest zarezerwowany dla celów infrastruktury.
Nie manipuluj konfiguracją sieci vLAN zarządzania.
Konieczne jest, aby nie ingerować w NNI Ingress i Egress Access Control Lists (ACL), ponieważ wszelkie modyfikacje mogą potencjalnie spowodować utratę łączności z instancją Azure Operator Nexus.
Dla poleceń RW nie są wykonywane żadne weryfikacje schematu ani składni. Przed wykonaniem konfiguracji należy się upewnić, że konfiguracja została sprawdzona.
Polecenia RW config powinny być bezwzględnym poleceniem; krótkie formularze i monity nie są obsługiwane. Na przykład: Wprowadź router bgp <ASN>\n vrf <name>\n neighbor <IPaddress> shutdown nie router bgp <ASN>\n vrf <name>\n nei <IPaddress> sh or shut
Przed wdrożeniem należy dokładnie przejrzeć konfigurację zasad tras, ponieważ każdy nadzór może potencjalnie naruszyć istniejącą konfigurację zasad tras.
Zmiana konfiguracji protokołu BGP routera i wyłączenie go powoduje spadek stabilności urządzenia.

Pobierz konfigurację runRW

Aby uzyskać ostatnio pomyślnie zastosowaną konfigurację runRW, zapoznaj się z właściwością rwDeviceConfig . Ta właściwość przechowuje ostatnio pomyślnie zastosowaną konfigurację RW dla urządzenia. Aby uzyskać do niego dostęp, wykonaj żądanie GET na zasobie urządzenia.

az networkfabric device show --resource-group "example-rg" --resource-name "example-device"

Parametr	Pseudonim	Opis
`--resource-group`	`-g`	Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu `az configure --defaults group=<name>`.
`--resource-name`		Nazwa urządzenia sieciowego.

Oczekiwane dane wyjściowe

{
  "id": "/subscriptions/xxxxxx-xxxx-xxxx-xxxxxx/resourceGroups/example-rg/providers/Microsoft.ManagedNetworkFabric/networkDevices/example-device-name",
  "location": "uaenorth",
  "name": "example-device-name",
  "properties": {
    "administrativeState": "Enabled",
    "configurationState": "DeferredControl",
    "hostName": "AR-CE1",
    "networkDeviceRole": "CE",
    "networkDeviceSku": "DefaultSku",
    "networkRackId": "/subscriptions/xxxxxx-xxxx-xxxx-xxxxxx/resourceGroups/example-rg/providers/Microsoft.ManagedNetworkFabric/networkRacks/example-rack-name",
    "provisioningState": "Succeeded",
    "rwDeviceConfig": "interface Ethernet 1/1\n description RW-test1",
    "serialNumber": "Arista;CCS-720DT-XXXX;11.07;WTW2248XXXX",
    "version": "4.0.0"
  },
  "systemData": {
    "createdAt": "2025-02-23T04:57:13.6113277Z",
    "createdBy": "xxxxxxxx-xxxx-xxxx-xxxxxx",
    "createdByType": "Application",
    "lastModifiedAt": "2025-02-27T08:27:46.3818706Z",
    "lastModifiedBy": "xxxxxxxx-xxxx-xxxx-xxxxxx",
    "lastModifiedByType": "Application"
  },
  "type": "microsoft.managednetworkfabric/networkdevices"
}

Uwaga / Notatka

Konfiguracja RW jest utrwalana podczas ponownego rozruchu bez ZTP, ale nie utrwala uaktualnień, RMA urządzenia ani ponownego uruchamiania z użyciem ZTP. Po tych zdarzeniach właściwość rwDeviceConfig jest pusta, chyba że użytkownik ponownie wykona konfigurację RW ręcznie.

Trwała konfiguracja RW podczas uaktualniania urządzenia

W programie Azure Operator Nexus konfiguracje Read-Write (RW) na urządzeniach sieciowych są teraz zachowywane w ramach uaktualnień oprogramowania urządzeń. Dzięki temu zmiany RW zdefiniowane przez użytkownika pozostaną nienaruszone po uaktualnieniu, zachowując spójność i zmniejszając ryzyko dryfu konfiguracji.

Jak to działa

Proces uaktualniania jest zgodny z podejściem dwuetapowym:

Uaktualnianie urządzenia: oprogramowanie EOS urządzenia jest uaktualniane i uruchamiane.
RW Reapplication: po zakończeniu uaktualniania system automatycznie ponownie zastosuje wszystkie wcześniej skonfigurowane komendy RW dla urządzenia.

Ta ponowna aplikacja gwarantuje, że trwałe konfiguracje zostaną przywrócone i pozostaną skuteczne po ponownym uruchomieniu urządzenia lub przejściu wersji.

Ważne

System Arista EOS nie obsługuje obecnie wstępnej weryfikacji konfiguracji RW. Jeśli jakiekolwiek polecenie jest przestarzałe, nieprawidłowe lub niefunkcjonalne, może spowodować niepowodzenie uaktualnienia.

Obsługa błędów

Jeśli konfiguracja RW zakończy się niepowodzeniem podczas ponownej aplikacji, urządzenie przejdzie w stan niepowodzenia, a proces uaktualniania nie zostanie ukończony.

Użytkownicy otrzymają dane wyjściowe błędu za pośrednictwem interfejsu wiersza polecenia platformy Azure.

W takich przypadkach:

Otwórz zgłoszenie do pomocy technicznej z zaktualizowaną i poprawioną konfiguracją RW.

Zespół pomocy technicznej będzie współpracować z Tobą, aby ponownie wdrożyć nową konfigurację RW za pomocą działania administracyjnego z włączoną obsługą Lockbox.

Jeśli ponowne zastosowanie nadal kończy się niepowodzeniem, może być konieczne ponowne uruchomienie działania administratora z dalszymi poprawkami.

Podsumowanie

Funkcja	Zachowanie
Trwałość poleceń RW	Automatycznie ponownie zastosuje się po uaktualnieniu
Wstępne sprawdzanie poprawności konfiguracji RW	Niewspierane
Po awarii	Urządzenie przechodzi w stan niepowodzenia
Odzyskiwanie	Prześlij bilet pomocy technicznej; Poprawiono konfigurację zastosowaną za pomocą akcji administratora z włączoną obsługą blokady

Ograniczenia

Często zadawane pytania

Czy mogę uruchomić wiele poleceń w tym samym czasie?

Tak, można uruchomić wiele poleceń w tym samym czasie. Zapoznaj się z przykładami, aby przejrzeć sposób wykonywania wielu poleceń w tym samym czasie.
Jak sprawdzić, czy konfiguracja zakończyła się pomyślnie?

Konfigurację można sprawdzić, wykonując jedną z następujących czynności:
- Uruchamianie interfejsu API Read-Only i uruchamianie wymaganych show poleceń w celu zweryfikowania pomyślnej konfiguracji,
- Uruchomienie funkcji różnicy konfiguracji w celu wyświetlenia różnicy między konfiguracjami.
Komunikat RW POST wskazuje, czy wykonanie zakończyło się pomyślnie, czy nie.
Co się stanie w przypadku nieprawidłowego wykonania polecenia konfiguracji RW?

Komunikat RW POST zwraca komunikat o błędzie, jak pokazano w przykładzie podanym w tym artykule. Do urządzenia nie są stosowane żadne zmiany konfiguracji. Należy ponownie uruchomić polecenie konfiguracji.
Jak można wielokrotnie utrwalać polecenie konfiguracji RW?

Jeśli spróbujesz zmodyfikować i zaktualizować konfigurację za pośrednictwem już utrwalonej konfiguracji, musisz podać całą zmodyfikowaną konfigurację utrwalonej. W przeciwnym razie konfiguracja zostanie zastąpiona najnowszą konfiguracją RW.

Na przykład

Jeśli pomyślnie utworzono sieć vlan 505 i spróbujesz utworzyć inny zestaw sieci vlan (vlan 510), musisz dodać element vlan 505\\n vlan 510. Jeśli tego nie zrobisz, najnowsze polecenie konfiguracji RW zastępuje vlan 505.
Jak usunąć konfigurację?

Musisz podać wartość " "null . Zapoznaj się z sekcją przykładów tego artykułu.
Czy polecenie RW jest stałe w całej infrastrukturze sieciowej?

Polecenie konfiguracji RW jest trwałe, ale interfejs API umożliwia uruchamianie na poziomie urządzenia. Jeśli chcesz uruchomić polecenie RW w sieci szkieletowej, musisz uruchomić interfejs API RW na wymaganych urządzeniach sieci szkieletowych.

Znany problem

Poniżej przedstawiono znany problem z konfiguracją RW:

Zgłaszany jest błąd, ponieważ nie można odróżnić błędu wewnętrznego ani błędu zestawu gNMI za pomocą odpowiedzi na błędy.

Udostępnij za pośrednictwem

Uruchamianie poleceń odczytu zapisu

Wymagania wstępne

Procedura

Wybierz pozycję Urządzenie sieciowe

Dostęp do urządzeń sieciowych:

Wybierz urządzenie sieciowe:

Przykłady

Migawka urządzenia sieci szkieletowej przed wprowadzeniem zmian w konfiguracji przy użyciu interfejsu API RW

Zmienianie opisu interfejsu

Zmiana trzech opisów interfejsu

Zastąp poprzednią konfigurację

Czyszczenie konfiguracji odczytu zapisu

Ograniczenia poleceń

Pobierz konfigurację runRW

Trwała konfiguracja RW podczas uaktualniania urządzenia

Jak to działa

Obsługa błędów

W takich przypadkach:

Podsumowanie

Ograniczenia

Znany problem

Treści powiązane

Opinia

Dodatkowe zasoby