読み取り書き込みコマンドの実行

2025-05-20

読み取り書き込み (RW) 機能を使用して、ネットワークファブリックデバイスにアクセスせずにリモートでデバイス構成を変更する方法について説明します。ネットワークファブリックのデバイスレベルで RW 構成コマンドを適用します。構成コマンドはデバイスレベルで永続化するため、すべてのデバイスで構成するには、ファブリック内の各デバイスに構成を適用する必要があります。

RW コマンドを実行すると、コマンドラインインターフェイス (CLI) またはポータルを介した変更に対して構成が保持されます。 RW API を通じて複数の構成を導入するには、既存の RW コマンドに新しいコマンドを追加します。たとえば、複数のデバイスインターフェイスを変更した後、上書きを防ぐために、新しい変更に以前の構成を含めます。

アップグレードシナリオ時のみ、RW 構成を元に戻します。アップグレード後、必要に応じて RW の変更を再適用する必要があります。次の例では、RW API プロセスの詳細な手順について説明します。

前提条件

Nexus Network Fabric が正常にプロビジョニングされていることを確認します。

手順

RW 構成コマンドを実行してデバイスに変更を加えると、デバイスの構成状態が [遅延制御] に移行します。この状態は、RW 構成がそのデバイス上でプッシュされたことを示します。適用された RW 構成が反転すると、デバイスの構成は元の成功状態に戻ります。

ネットワークデバイスを選択する

Azure ポータルにサインインする

ネットワークデバイスにアクセスします:

ログインしたら、上部の検索バーを使用して Network Devices を検索するか、[すべてのサービス] に移動し、[ネットワーク] カテゴリで [ネットワークデバイス] を見つけます。

[ネットワークデバイス] をクリックして、サブスクリプション内のネットワークデバイスの一覧を開きます。

ネットワークデバイスを選択します。

ネットワークデバイスの一覧から、構成するネットワークデバイスを見つけてクリックします。これにより、選択したネットワークデバイスの詳細ページに移動します。

CLI コマンドで必要になるので、このネットワークデバイスのリソース名とリソースグループを書き留めておきます。

または

リソースの名前を取得するには、JSON ビュー ([プロパティ] または [概要] セクションにあります) をクリックすると、リソース名を含むデバイスの詳細なプロパティが表示されます。

例

次のセクションでは、RW コマンドを使用してデバイスの構成を変更する例を示します。この例では、Ethernet インターフェイス 1、2、3 を使用したインターフェイス名の調整方法を示し、これらの変更の結果を観察できます。

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

インターフェイスの説明を変更する

デバイスのインターフェイス記述を RW-test に変更する方法を次の例に示します。

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

パラメーター	説明
`az networkfabric device run-rw`	Azure Network Fabric 内のネットワークデバイスで読み取り書き込み操作を実行するための Azure CLI コマンド。
`--resource-name`	RW 操作が実行されるリソース (ネットワークデバイス) の名前を指定します。
`--resource-group`	ネットワークデバイスが含まれているリソースグループの名前を指定します。
`--rw-command "interface Ethernet 1\n description RW-test"`	ネットワークデバイスで実行する RW コマンドを指定します。この例では、Ethernet インターフェイス 1 の記述を "RW-test "に設定します。

予想される出力:

{}

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

パラメーター	説明
`az networkfabric device run-rw`	Azure Network Fabric 内のネットワークデバイスで読み取り書き込み操作を実行するための Azure CLI コマンド。
`--resource-name`	RW 操作が実行されるリソース (ネットワークデバイス) の名前を指定します。
`--resource-group`	ネットワークデバイスが含まれているリソースグループの名前を指定します。
`--rw-command "interface Ethernet 1\n description RW-test"`	ネットワークデバイスで実行する RW コマンドを指定します。この例では、Ethernet インターフェイス 1 の記述を "RW-test "に設定します。
`--no-wait`	操作の完了を待たずに、コマンドが非同期的に実行されることを示します。
`--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: Return from creating process 
telemetry.main: Finish creating telemetry upload process.

次のコマンドを実行して、操作の状態をプログラムで確認できます:

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

切り捨てられた出力から抽出された Azure-AsyncOperation エンドポイント URL の例。

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

[状態] は、API が成功したか、失敗したかを示す必要があります。

想定される出力:

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

RW 構成が成功すると、デバイス構成の状態は遅延制御状態に移行します。構成に失敗しても状態は変更しません。

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

インターフェイスの説明の 3 つの変更

この例では、デバイス記述における 3 つの異なるインターフェイスを 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"

パラメーター	説明
`az networkfabric device run-rw`	Azure Network Fabric 内のネットワークデバイスで読み取り書き込み操作を実行するための Azure CLI コマンド。
`--resource-name <ResourceName>`	RW 操作が実行されるリソース (ネットワークデバイス) の名前を指定します。
`--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"`	ネットワークデバイスで実行する RW コマンドを指定します。それぞれの 'interface' コマンドは、指定された Ethernet インターフェイスの説明を設定します。

予想される出力:

{}

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

パラメーター	説明
`az networkfabric device run-rw`	Azure Network Fabric 内のネットワークデバイスで読み取り書き込み操作を実行するための Azure CLI コマンド。
`--resource-name <ResourceName>`	RW 操作が実行されるリソース (ネットワークデバイス) の名前を指定します。
`--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"`	ネットワークデバイスで実行する RW コマンドを指定します。それぞれの 'interface' コマンドは、指定された Ethernet インターフェイスの説明を設定します。
`--no-wait`	操作の完了を待たずに、コマンドが非同期的に実行されることを示します。
`--debug`	デバッグモードを有効にするフラグです。トラブルシューティングのためにコマンド実行に関する関連情報を提供します。

予想される、切り捨てられた出力:

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.

次のコマンドを実行して、操作の状態をプログラムで確認できます:

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

切り捨てられた出力から抽出された Azure-AsyncOperation エンドポイント URL の例。

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

[状態] は、API が成功したか、失敗したかを示す必要があります。

予想される出力:

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

前の構成を上書きする

次の例では、不要になった RW 構成を追加しない場合に、前の構成を上書きする方法を示します:

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

パラメーター	説明
`az networkfabric device run-rw`	Azure Network Fabric 内のネットワークデバイスで読み取り書き込み操作を実行するための Azure CLI コマンド。
`--resource-name`	RW 操作が実行されるリソース (ネットワークデバイス) の名前を指定します。
`--resource-group`	ネットワークデバイスが含まれているリソースグループの名前を指定します。
`--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"`	ネットワークデバイスで実行する RW コマンドを指定します。それぞれの 'interface' コマンドは、指定された Ethernet インターフェイスの説明を設定します。

予想される出力:

{}

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

パラメーター	説明
`az networkfabric device run-rw`	Azure Network Fabric 内のネットワークデバイスで読み取り書き込み操作を実行するための Azure CLI コマンド。
`--resource-name`	RW 操作が実行されるリソース (ネットワークデバイス) の名前を指定します。
`--resource-group`	ネットワークデバイスが含まれているリソースグループの名前を指定します。
`--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"`	ネットワークデバイスで実行する RW コマンドを指定します。それぞれの 'interface' コマンドは、指定された Ethernet インターフェイスの説明を設定します。
`--no-wait`	操作の完了を待たずに、コマンドが非同期的に実行されることを示します。
`--debug`	デバッグモードを有効にするフラグです。トラブルシューティングのためにコマンド実行に関する関連情報を提供します。

予想される、切り捨てられた出力:

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.

次のコマンドを実行して、操作の状態をプログラムで確認できます:

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

切り捨てられた出力から抽出された Azure-AsyncOperation エンドポイント URL の例。

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

予想される出力:

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

読み取り書き込み構成のクリーンアップ

この例では、RW 構成をクリーンアップする方法を示します。クリーンアップを実行すると、構成は元の構成に戻ります。

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

パラメーター	説明
`az networkfabric device run-rw`	Azure Network Fabric 内のネットワークデバイスで読み取り書き込み操作を実行するための Azure CLI コマンド。
`--resource-name <ResourceName>`	RW 操作が実行されるリソース (ネットワークデバイス) の名前を指定します。
`--resource-group <ResourceGroupName>`	ネットワークデバイスが含まれているリソースグループの名前を指定します。
`--rw-command " "`	ネットワークデバイスで実行する空の RW コマンドを指定します。このコマンドは基本的に何もアクションもないレースホルダーです。

注

空の RW コマンドの引用符の間にスペースがあることを確認してください。

予想される出力:

{}

--no-wait --debug を使用したコマンド

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

パラメーター	説明
`az networkfabric device run-rw`	Azure Network Fabric 内のネットワークデバイスで読み取り書き込み操作を実行するための Azure CLI コマンド。
`--resource-name <ResourceName>`	RW 操作が実行されるリソース (ネットワークデバイス) の名前を指定します。
`--resource-group <ResourceGroupName>`	ネットワークデバイスが含まれているリソースグループの名前を指定します。
`--rw-command " "`	ネットワークデバイスで実行する空の RW コマンドを指定します。このコマンドは基本的に何もアクションもないレースホルダーです。
`--no-wait`	操作の完了を待たずに、コマンドが非同期的に実行されることを示します。
`--debug`	デバッグモードを有効にするフラグです。トラブルシューティングのためにコマンド実行に関する関連情報を提供します。

予想される、切り捨てられた出力:

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.

次のコマンドを実行して、操作の状態をプログラムで確認できます:

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

切り捨てられた出力から抽出された Azure-AsyncOperation エンドポイント URL の例。

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

状態が、API が成功したか、失敗したかを示します。

予想される出力:

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

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

コマンドの制限

RW コマンド機能はオープンで、何の制限もありません。ただし、構成の使用方法を誤るとシステムがダウンする可能性があるため、注意してください。

1 - 500 および 3000 - 4095 の範囲はインフラストラクチャ用に予約されているため、この範囲の vLAN を作成することはお勧めしません。
管理 vLAN の構成を変更しないでください。
ネットワーク間相互接続 (NNI) のイングレスおよびエグレスのアクセス制御リスト (ACL) を変更すると、Azure Operator Nexus インスタンスへの接続性が失われる可能性があるため、変更しないでください。
RW コマンドを実行しても、回路図や構文の検証は行われません。構成する前に、その構成が十分確認されている必要があります。
RW 構成コマンドは絶対コマンドである必要があり、短いフォームとプロンプトはサポートされていません。例: Enter router bgp <ASN>\n vrf <name>\n neighbor <IPaddress> shutdown Not router bgp <ASN>\n vrf <name>\n nei <IPaddress> sh or shut
見落としがあると、既存のルートポリシーの設定が侵害される可能性があるため、実装前にルートポリシー構成を十分に確認しておくことが重要です。
ルーターの BGP 構成を変更してシャットダウンすると、デバイスの安定性が低下します。

runRW 構成を取得する

最後に正常に適用された runRW 構成を取得するには、rwDeviceConfig プロパティを参照してください。このプロパティは、デバイスに最後に正常に適用された RW 構成を格納します。アクセスするには、デバイスリソースに対して GET 要求を実行します。

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

パラメーター	別名	説明
`--resource-group`	`-g`	リソースグループの名前。 `az configure --defaults group=<name>`を使用して既定のグループを構成できます。
`--resource-name`		ネットワークデバイスの名前。

想定される出力

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

注

RW 構成は、ZTP なしで再起動中も保持されますが、アップグレード、デバイス RMA、または ZTP による再起動は保持されません。これらのイベントの後、ユーザーが RW 構成を手動で再適用しない限り、rwDeviceConfig プロパティは空になります。

デバイスのアップグレード中の永続的な RW 構成

Azure Operator Nexus では、ネットワークデバイス上の Read-Write (RW) 構成がデバイスソフトウェアのアップグレード間で保持されるようになりました。これにより、アップグレード後もユーザー定義 RW の変更はそのまま維持され、一貫性が維持され、構成ドリフトのリスクが軽減されます。

動作方法

アップグレードプロセスは、次の 2 段階のアプローチに従います。

デバイスのアップグレード: デバイスの EOS ソフトウェアがアップグレードされ、ブートストラップされます。
RW 再適用: アップグレードが完了すると、システムは、以前に構成されたすべての RW コマンドをデバイスに自動的に再適用します。

この再適用により、永続的な構成が復元され、デバイスの再起動またはバージョンの移行後も有効なままになります。

Von Bedeutung

Arista EOS では現在、RW 構成の事前検証はサポートされていません。非推奨、無効、または機能しないコマンドがある場合は、アップグレードが失敗する可能性があります。

エラー処理

再適用中に RW 構成が失敗した場合、デバイスは失敗状態になり、アップグレードプロセスは完了しません。

ユーザーは Azure CLI を使用してエラー出力を受け取ります。

このような場合:

更新され、修正された RW 構成でサポートチケットを開きます。

サポートチームは、ロックボックスが有効な管理者アクションを使用して、新しい RW 構成を再適用するように調整します。

再適用が失敗した場合は、管理者アクションをさらに修正して再試行する必要がある場合があります。

概要

特徴	行動
RW コマンドの永続化	アップグレード後に自動的に再適用される
RW 構成の事前検証	サポートされていません
失敗時	デバイスが失敗状態に入る
復元	サポートチケットを送信する。Lockbox が有効な管理者アクションを使用して適用された修正済みの構成

制限事項

一般的な質問:

複数のコマンドを同時に実行することはできますか?

はい、複数のコマンドを同時に実行できます。複数のコマンドを同時に実行する方法については、例を参照してください。
構成が成功したかどうかを確認するにはどうすればいいですか?

構成は、次の方法のいずれかで確認できます。
- 読み取り専用 API を実行し、必要な show コマンドを実行して、構成が成功したことを確認し、
- 構成差分機能を実行すると、構成間の差分が表示されます。
RW POST メッセージは、実行が成功したかどうかを示します。
RW 構成コマンドを間違って実行するとどうなりますか?

RW POST メッセージは、この記事で提供された例に示すように、エラーメッセージを返します。構成の変更はデバイスに適用されません。構成コマンドを再実行する必要があります。
RW 構成コマンドを複数回永続化するにはどうすればいいですか?

既に永続化された構成に変更を加えて構成を更新しようとする場合、変更済みの永続化された構成のすべてを提供する必要があります。それ以外の場合は、構成が最新の RW 構成に上書きされます。

例

vlan505 が正常に作成され、別の vlan セット (vlan 510) を作成しようとした場合は、vlan 505\\n vlan 510 を追加する必要があります。そうしないと、最新の RW 構成コマンドで vlan 505 が上書きされます。
構成を削除するにはどうすればいいですか?

null 値 " " を指定する必要があります。この記事の例のセクションを参照してください。
RW コマンドはファブリック全体で永続的ですか?

RW 構成コマンドは永続的ですが、API ではデバイスレベルで実行できます。ファブリック全体で RW コマンドを実行する場合は、必要なファブリックデバイス全体で RW API を実行する必要があります。

既知の問題

RW 構成の既知の問題を次に示します。

エラー応答で内部エラーと gNMI 設定エラーを区別できないため、エラーが報告されます。

次の方法で共有

読み取り書き込みコマンドの実行

前提条件

手順

ネットワーク デバイスを選択する

ネットワーク デバイスにアクセスします:

ネットワーク デバイスを選択します。

例

RW API を使用して構成を変更する前のネットワーク ファブリック デバイスのスナップショット

インターフェイスの説明を変更する

インターフェイスの説明の 3 つの変更

前の構成を上書きする

読み取り書き込み構成のクリーンアップ

コマンドの制限

runRW 構成を取得する

デバイスのアップグレード中の永続的な RW 構成

動作方法

エラー処理

このような場合:

概要

制限事項

既知の問題

関連コンテンツ

フィードバック

その他のリソース

ネットワークデバイスを選択する

ネットワークデバイスにアクセスします:

ネットワークデバイスを選択します。

RW API を使用して構成を変更する前のネットワークファブリックデバイスのスナップショット