Spuštění příkazů pro čtení a zápis

Funkce pro čtení a zápis (RW) umožňuje vzdáleně upravovat konfigurace zařízení bez nutnosti přístupu k zařízení síťové infrastruktury. Použijte příkaz konfigurace RW na úrovni zařízení na síťovém fabricu. Vzhledem k tomu, že příkaz konfigurace přetrvává na úrovni zařízení, musíte konfiguraci použít pro každé zařízení ve fabrice.

Spuštění příkazu RW zachová vaši konfiguraci proti změnám provedeným prostřednictvím rozhraní příkazového řádku (CLI) nebo portálu. Pokud chcete prostřednictvím rozhraní RW API zavést více konfigurací, připojte k existujícímu příkazu RW nové příkazy. Například po úpravě více rozhraní zařízení zahrňte předchozí konfiguraci s novými změnami, aby se zabránilo přepsání.

Vraťte konfiguraci RW pouze během scénáře upgradu. Po upgradu je nutné změny RW v případě potřeby znovu použít. Následující příklady vás provedou podrobným procesem rozhraní RW API.

Požadavky

Ujistěte se, že síťová struktura Nexus byla úspěšně zřízena.

Procedure

Když spustíte příkaz konfigurace RW a provedete změny zařízení, stav konfigurace zařízení se přesune do ovládacího prvku Deferred Control. Tento stav označuje, že na toto zařízení byla odeslána konfigurace RW. Po obrácení použité konfigurace RW se konfigurace zařízení vrátí k původnímu úspěšnému stavu.

Výběr síťového zařízení

Přihlaste se k portálu Azure Portal.

Přístup k síťovým zařízením:

Po přihlášení použijte vyhledávací panel v horní části a hledejte Network Devices nebo přejděte do sekce Všechny služby a najděte Síťová zařízení v kategorii Sítí.

Kliknutím na Síťová zařízení otevřete seznam síťových zařízení ve vašem předplatném.

Vyberte síťové zařízení:

V seznamu síťových zařízení vyhledejte a klikněte na síťové zařízení, které chcete nakonfigurovat. Tím přejdete na stránku podrobností vybraného síťového zařízení.

Poznamenejte si název prostředku a skupinu prostředků tohoto síťového zařízení, protože je budete potřebovat pro příkaz rozhraní příkazového řádku.

Nebo

Pokud chcete získat název prostředku, klikněte na zobrazení JSON (v části Vlastnosti nebo Přehled), ve kterém se zobrazí podrobné vlastnosti zařízení, včetně názvu prostředku.

Examples

Následující části obsahují příklady příkazů RW, které lze použít k úpravě konfigurace zařízení. V příkladech se používají ethernetová rozhraní 1, 2 a 3, abyste ukázali, jak upravit název rozhraní a jak sledovat výsledky těchto úprav.

Snímek zařízení Network Fabric před provedením změn konfigurace pomocí rozhraní RW API

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"**       |

Změna popisu rozhraní

Příklad ukazuje, jak změnit popis rozhraní zařízení na RW-test.

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

Parameter	Description
`az networkfabric device run-rw`	Příkaz Azure CLI pro spuštění operace čtení a zápisu na síťovém zařízení v rámci azure Network Fabric.
`--resource-name`	Určuje název prostředku (síťového zařízení), na kterém se provede operace RW.
`--resource-group`	Určuje název skupiny prostředků, která obsahuje síťové zařízení.
`--rw-command "interface Ethernet 1\n description RW-test"`	Určuje příkaz RW, který se má spustit na síťovém zařízení. V tomto příkladu nastaví popis ethernetového rozhraní 1 na "RW-test".

Očekávaný výstup:

{}

Příkaz s příkazem --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**

Parameter	Description
`az networkfabric device run-rw`	Příkaz Azure CLI pro spuštění operace čtení a zápisu na síťovém zařízení v rámci azure Network Fabric.
`--resource-name`	Určuje název prostředku (síťového zařízení), na kterém se provede operace RW.
`--resource-group`	Určuje název skupiny prostředků, která obsahuje síťové zařízení.
`--rw-command "interface Ethernet 1\n description RW-test"`	Určuje příkaz RW, který se má spustit na síťovém zařízení. V tomto příkladu nastaví popis ethernetového rozhraní 1 na "RW-test".
`--no-wait`	Označuje, že příkaz by se měl spustit asynchronně bez čekání na dokončení operace.
`--debug`	Příznak povolení režimu ladění, který poskytuje další informace o provádění příkazu pro účely řešení potíží.

Očekávaný zkrácený výstup:

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.

Stav operace můžete zkontrolovat programově spuštěním následujícího příkazu:

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

Příklad adresy URL koncového bodu Azure-AsyncOperation extrahované z zkráceného výstupu

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

Stav by měl indikovat, jestli rozhraní API proběhlo úspěšně nebo selhalo.

Očekávaný výstup:

{ 
  "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 úspěšném dokončení konfigurace RW se stav konfigurace zařízení přesune do odloženého stavu řízení . V případě selhání konfigurace nedojde k žádné změně stavu.

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"     |

Změna tří popisů rozhraní

Tento příklad ukazuje, jak změnit tři různá rozhraní v popisu zařízení 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"

Parameter	Description
`az networkfabric device run-rw`	Příkaz Azure CLI pro spuštění operace čtení a zápisu na síťovém zařízení v rámci azure Network Fabric.
`--resource-name <ResourceName>`	Určuje název prostředku (síťového zařízení), na kterém se provede operace RW.
`--resource-group <ResourceGroupName>`	Určuje název skupiny prostředků, která obsahuje síťové zařízení.
`--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"`	Určuje příkazy RW, které se mají spustit na síťovém zařízení. Každý příkaz "interface" nastaví popis zadaného ethernetového rozhraní.

Očekávaný výstup:

{}

Příkaz s příkazem --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

Parameter	Description
`az networkfabric device run-rw`	Příkaz Azure CLI pro spuštění operace čtení a zápisu na síťovém zařízení v rámci azure Network Fabric.
`--resource-name <ResourceName>`	Určuje název prostředku (síťového zařízení), na kterém se provede operace RW.
`--resource-group <ResourceGroupName>`	Určuje název skupiny prostředků, která obsahuje síťové zařízení.
`--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"`	Určuje příkazy RW, které se mají spustit na síťovém zařízení. Každý příkaz "interface" nastaví popis zadaného ethernetového rozhraní.
`--no-wait`	Označuje, že příkaz by se měl spustit asynchronně bez čekání na dokončení operace.
`--debug`	Příznak povolení režimu ladění, který poskytuje další informace o provádění příkazu pro účely řešení potíží.

Očekávaný zkrácený výstup:

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.

Stav operace můžete zkontrolovat programově spuštěním následujícího příkazu:

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

Příklad adresy URL koncového bodu Azure-AsyncOperation extrahované z zkráceného výstupu

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

Stav by měl indikovat, jestli rozhraní API proběhlo úspěšně nebo selhalo.

Očekávaný výstup:

{ 
  "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"     |

Přepsání předchozí konfigurace

Tento příklad ukazuje, jak se předchozí konfigurace přepíše, pokud nepřipojujete starou konfiguraci RW:

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

Parameter	Description
`az networkfabric device run-rw`	Příkaz Azure CLI pro spuštění operace čtení a zápisu na síťovém zařízení v rámci azure Network Fabric.
`--resource-name`	Určuje název prostředku (síťového zařízení), na kterém se provede operace RW.
`--resource-group`	Určuje název skupiny prostředků, která obsahuje síťové zařízení.
`--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"`	Určuje příkazy RW, které se mají spustit na síťovém zařízení. Každý příkaz "interface" nastaví popis zadaného ethernetového rozhraní.

Očekávaný výstup:

{}

Příkaz s příkazem --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

Parameter	Description
`az networkfabric device run-rw`	Příkaz Azure CLI pro spuštění operace čtení a zápisu na síťovém zařízení v rámci azure Network Fabric.
`--resource-name`	Určuje název prostředku (síťového zařízení), na kterém se provede operace RW.
`--resource-group`	Určuje název skupiny prostředků, která obsahuje síťové zařízení.
`--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"`	Určuje příkazy RW, které se mají spustit na síťovém zařízení. Každý příkaz "interface" nastaví popis zadaného ethernetového rozhraní.
`--no-wait`	Označuje, že příkaz by se měl spustit asynchronně bez čekání na dokončení operace.
`--debug`	Příznak povolení režimu ladění, který poskytuje další informace o provádění příkazu pro účely řešení potíží.

Očekávaný zkrácený výstup:

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.

Stav operace můžete zkontrolovat programově spuštěním následujícího příkazu:

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

Příklad adresy URL koncového bodu Azure-AsyncOperation extrahované z zkráceného výstupu

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

Očekávaný výstup:

{ 
  "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"     |

Vyčištění konfigurace pro čtení a zápis

Tento příklad ukazuje, jak se konfigurace RW vyčistí. Když spustíte vyčištění, konfigurace se vrátí k původní konfiguraci.

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

Parameter	Description
`az networkfabric device run-rw`	Příkaz Azure CLI pro spuštění operace čtení a zápisu na síťovém zařízení v rámci azure Network Fabric.
`--resource-name <ResourceName>`	Určuje název prostředku (síťového zařízení), na kterém se provede operace RW.
`--resource-group <ResourceGroupName>`	Určuje název skupiny prostředků, která obsahuje síťové zařízení.
`--rw-command " "`	Určuje prázdný příkaz RW, který se má spustit na síťovém zařízení. Tento příkaz je v podstatě zástupný symbol bez akce.

Poznámka:

Ujistěte se, že je mezi uvozovkami v prázdném příkazu RW mezera.

Očekávaný výstup:

{}

Příkaz s příkazem --no-wait--debug

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

Parameter	Description
`az networkfabric device run-rw`	Příkaz Azure CLI pro spuštění operace čtení a zápisu na síťovém zařízení v rámci azure Network Fabric.
`--resource-name <ResourceName>`	Určuje název prostředku (síťového zařízení), na kterém se provede operace RW.
`--resource-group <ResourceGroupName>`	Určuje název skupiny prostředků, která obsahuje síťové zařízení.
`--rw-command " "`	Určuje prázdný příkaz RW, který se má spustit na síťovém zařízení. Tento příkaz je v podstatě zástupný symbol bez akce.
`--no-wait`	Označuje, že příkaz by se měl spustit asynchronně bez čekání na dokončení operace.
`--debug`	Příznak povolení režimu ladění, který poskytuje další informace o provádění příkazu pro účely řešení potíží.

Očekávaný zkrácený výstup:

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.

Stav operace můžete zkontrolovat programově spuštěním následujícího příkazu:

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

Příklad adresy URL koncového bodu Azure-AsyncOperation extrahované z zkráceného výstupu

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

Stav označuje, jestli bylo rozhraní API úspěšné nebo neúspěšné.

Očekávaný výstup:

{ 
  "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" 
}

Když se konfigurace RW vrátí zpět k původní konfiguraci, stav konfigurace zařízení se přesune na Úspěšné z Odložené řízení.

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"**    |

Omezení příkazů

Funkce příkazu RW je otevřená a neexistují žádná omezení. Pokračujte ale opatrně, protože nesprávné použití konfigurace může systém snížit.

Vytváření sítí VLAN od 1 do 500 a 3000 až 4095 se nedoporučuje, protože tento rozsah je vyhrazený pro účely infrastruktury.
Nemanipulujte s konfigurací vLAN pro správu.
Je nutné neměnit přístupové seznamy (ACL) pro vstup a výstup v rámci síťového propojení mezi sítěmi (NNI), protože jakékoli úpravy by mohly potenciálně vést ke ztrátě připojení k instanci Azure Operator Nexus.
U příkazů RW se neprovádí žádné ověřování schémat ani syntaxe. Před spuštěním je nutné zajistit, aby byla konfigurace prověřena.
Příkazy konfigurace RW by měly být absolutním příkazem; krátké formuláře a výzvy nejsou podporované. Příklad: Enter router bgp <ASN>\n vrf <name>\n neighbor <IPaddress> shutdown Not router bgp <ASN>\n vrf <name>\n nei <IPaddress> sh or shut
Před implementací je důležité důkladně zkontrolovat konfiguraci politiky směrování, protože jakákoli chyba by mohla potenciálně ohrozit stávající nastavení politiky směrování.
Změna konfigurace protokolu BGP směrovače a jeho vypnutí zpomalí stabilitu zařízení.

Načíst konfiguraci runRW

Pokud chcete získat poslední úspěšně použitou konfiguraci runRW, podívejte se na vlastnost rwDeviceConfig. Tato vlastnost ukládá poslední úspěšně použitou konfiguraci RW pro zařízení. Pokud k němu chcete získat přístup, proveďte požadavek GET na prostředku zařízení.

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

Parameter	Alias	Description
`--resource-group`	`-g`	Název skupiny prostředků. Výchozí skupinu můžete nakonfigurovat pomocí `az configure --defaults group=<name>`.
`--resource-name`		Název síťového zařízení.

Očekávaný výstup

{
  "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"
}

Poznámka:

Konfigurace RW přetrvává během restartování bez ZTP, ale nezachovává upgrady, zařízení RMA ani restartování pomocí ZTP. Po těchto událostech je vlastnost rwDeviceConfig prázdná, pokud uživatel znovu neskončí konfiguraci RW ručně.

Trvalá konfigurace RW během upgradů zařízení

V Azure Operator Nexus jsou konfigurace Read-Write (RW) na síťových zařízeních uchovány i při upgradu softwaru zařízení. Tím se zajistí, aby změny RW definované uživatelem zůstaly po upgradu nedotčené, zachovaly konzistenci a snížily riziko posunu konfigurace.

Jak to funguje

Proces upgradu se řídí dvěma kroky:

Aktualizace zařízení: EOS software zařízení je aktualizován, inicializován a spuštěn.
RW Reapplication: Po dokončení upgradu systém automaticky znovu zobrazí všechny dříve nakonfigurované příkazy RW pro zařízení.

Tato opětovná replikace zajišťuje obnovení trvalých konfigurací a zachování platnosti po restartování zařízení nebo přechodu verze.

Důležité

Arista EOS v současné době nepodporuje předběžné ověření konfigurací RW. Pokud je některý příkaz zastaralý, neplatný nebo nefunkční, může způsobit selhání upgradu.

Řešení poruch

Pokud se konfigurace RW během opětovného zpracování nezdaří, zařízení přejde do stavu selhání a proces upgradu se nedokončí.

Uživatelům se prostřednictvím Azure CLI zobrazí výstup chyby.

V takových případech:

Otevřete podpůrný tiket s aktualizovanou a opravenou konfigurací RW.

Tým podpory bude s vámi spolupracovat na znovuzavedení nové konfigurace RW prostřednictvím správcovské akce umožněné Lockboxem.

Pokud se opětovná replikace stále nezdaří, bude možná potřeba akci správce opakovat s dalšími opravami.

Shrnutí

Vlastnost	Chování
Trvalost příkazu RW	Automatické opětovné použití po upgradu
Předběžné ověření konfigurací RW	Není podporováno
Při selhání	Zařízení přejde do stavu selhání.
Recovery	Odeslat podpůrný tiket; opravená konfigurace použitá prostřednictvím akce provedené správcem s funkcí Lockbox.

Omezení

Běžné otázky:

Můžu současně spustit více příkazů?

Ano, můžete současně spouštět více příkazů. Projděte si příklady a podívejte se, jak současně spouštět více příkazů.
Jak můžu zkontrolovat, jestli konfigurace proběhla úspěšně?

Konfiguraci můžete zkontrolovat jedním z následujících způsobů:
- Spuštění Read-Only rozhraní API a spuštění požadovaných show příkazů pro ověření úspěšné konfigurace
- Spuštění funkce porovnání konfigurací pro zobrazení rozdílů mezi konfiguracemi.
Zpráva RW POST označuje, jestli bylo spuštění úspěšné nebo ne.
Co se stane, když nesprávně spustím příkaz konfigurace RW?

Zpráva RW POST vrátí chybovou zprávu, jak je znázorněno v příkladu uvedeném v tomto článku. Na zařízení nejsou použity žádné změny konfigurace. Musíte znovu spustit konfigurační příkaz.
Jak můžu několikrát zachovat příkaz konfigurace RW?

Pokud se pokusíte upravit a aktualizovat konfiguraci u již trvalé konfigurace, musíte zadat veškerou upravenou trvalou konfiguraci, jinak se konfigurace přepíše nejnovější konfigurací RW.

Například

Pokud jste úspěšně vytvořili síť vlan 505 a pokusíte se vytvořit další sadu virtuálních sítí (vlan 510), musíte přidat vlan 505\\n vlan 510. Pokud to neuděláte, nejnovější příkaz konfigurace RW přepíše síť VLAN 505.
Jak odstraním konfiguraci?

Je nutné zadat hodnotu " "null . Projděte si část s příklady tohoto článku.
Je příkaz RW trvalý přes celou síť strukturu?

Příkaz konfigurace RW je trvalý, ale rozhraní API umožňuje spouštět na úrovni zařízení. Pokud chcete spustit příkaz RW napříč prostředky infrastruktury, musíte rozhraní RW API spustit na požadovaných zařízeních infrastruktury.

Známý problém

Níže je známý problém s konfigurací RW:

Je hlášena chyba, protože vnitřní chyba nebo chyba sady gNMI nelze rozlišit pomocí chybových odpovědí.

Váš názor

Byla tato stránka užitečná?

Last updated on 2025-09-19

Sdílet prostřednictvím

Spuštění příkazů pro čtení a zápis

Požadavky

Procedure

Výběr síťového zařízení

Přístup k síťovým zařízením:

Vyberte síťové zařízení:

Examples

Snímek zařízení Network Fabric před provedením změn konfigurace pomocí rozhraní RW API

Změna popisu rozhraní

Změna tří popisů rozhraní

Přepsání předchozí konfigurace

Vyčištění konfigurace pro čtení a zápis

Omezení příkazů

Načíst konfiguraci runRW

Trvalá konfigurace RW během upgradů zařízení

Jak to funguje

Řešení poruch

V takových případech:

Shrnutí

Omezení

Známý problém

Související obsah

Váš názor

Další materiály