Executar comandos de leitura e gravação

Artigo
05/23/2024

O recurso RW (Leitura e Gravação) permite que você modifique remotamente as configurações do dispositivo sem acessar o dispositivo de malha de rede. Aplique o comando de configuração RW no nível do dispositivo no Network Fabric. Como o comando de configuração persiste no nível do dispositivo, para configurar em todos os dispositivos, você precisa aplicar a configuração a cada dispositivo no Fabric.

A execução do comando RW preserva sua configuração em relação às alterações feitas por meio da CLI (Interface de Linha de Comando) ou do portal. Para introduzir várias configurações por meio da API de RW, acrescente novos comandos ao comando RW existente. Por exemplo, depois de modificar várias interfaces de dispositivo, inclua a configuração anterior com quaisquer novas alterações para impedir a substituição.

Reverta a configuração do RW somente durante um cenário de atualização. Após a atualização, você precisa reaplicar as modificações do RW, se necessário. Os exemplos a seguir orientam você passo a passo pelo processo da API de RW.

Pré-requisitos

Garanta que o Nexus Network Fabric tenha sido provisionado com êxito.

Procedimento

Quando você executa um comando de configuração do RW e faz alterações no dispositivo, o estado de configuração do dispositivo é movido para Controle Adiado. Esse estado indica que a configuração de RW foi enviada por push nesse dispositivo. Quando a configuração de RW aplicada é invertida, a configuração do dispositivo é revertida para seu estado de êxito original.

Selecione o Dispositivo de Rede

Entre no Portal do Azure

Acesse os Dispositivos de Rede:

Depois de conectado, use a barra de pesquisa na parte superior para pesquisar Network Devices ou navegar até Todos os Serviços e encontrar os Dispositivos de Rede na categoria Rede.

Clique em Dispositivos de Rede para abrir a lista de dispositivos de rede na sua assinatura.

Selecione o Dispositivo de Rede:

Na lista de dispositivos de rede, localize e clique no dispositivo de rede que você quer configurar. Isso o levará à página de detalhes do dispositivo de rede selecionado.

Anote o nome do recurso e o grupo de recursos deste dispositivo de rede, pois você precisará deles para o comando da CLI.

Para obter o nome do recurso, clique na exibição JSON (encontrada na seção Propriedades ou Visão Geral) que exibe as propriedades detalhadas do dispositivo, incluindo o nome do recurso.

Exemplos

As seções a seguir fornecem exemplos de comandos RW que podem ser usados para modificar a configuração do dispositivo. Os exemplos usam as interfaces Ethernet 1, 2 e 3 para mostrar como ajustar o nome da interface e permitir que você observe os resultados dessas modificações.

Instantâneo do dispositivo do Network Fabric antes de fazer alterações na configuração usando a API de RW

show interfaces description

|Interface  |Status  |Protocol  |Decsription  |
|---------|---------|---------|---------|
|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"**       |

Alterar a descrição de uma interface

O exemplo mostra como alterar a descrição da interface do dispositivo para RW-test.

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

Parâmetro	Descrição
`az networkfabric device run-rw`	Comando da CLI do Azure para executar uma operação de leitura/gravação em um dispositivo de rede no Azure Network Fabric.
`--resource-name`	Especifica o nome do recurso (dispositivo de rede) no qual a operação de RW será executada.
`--resource-group`	Especifica o nome do grupo de recursos que contém o dispositivo de rede.
`--rw-command "interface Ethernet 1\n description RW-test"`	Especifica o comando RW a ser executado no dispositivo de rede. Neste exemplo, define a descrição da interface Ethernet 1 como "RW-test".

Saída esperada:

{}

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

Parâmetro	Descrição
`az networkfabric device run-rw`	Comando da CLI do Azure para executar uma operação de leitura/gravação em um dispositivo de rede no Azure Network Fabric.
`--resource-name`	Especifica o nome do recurso (dispositivo de rede) no qual a operação de RW será executada.
`--resource-group`	Especifica o nome do grupo de recursos que contém o dispositivo de rede.
`--rw-command "interface Ethernet 1\n description RW-test"`	Especifica o comando RW a ser executado no dispositivo de rede. Neste exemplo, define a descrição da interface Ethernet 1 como "RW-test".
`--no-wait`	Indica que o comando deve ser executado de maneira assíncrona, sem aguardar a conclusão da operação.
`--debug`	Sinalizador habilitando o modo de depuração, fornecendo informações adicionais sobre a execução do comando para fins de solução de problemas.

Saída truncada esperada:

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.

Você pode verificar programaticamente o status da operação executando o seguinte comando:

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

Exemplo da URL do ponto de extremidade Azure-AsyncOperation extraída da saída truncada.

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

O Status deve indicar se a API foi bem-sucedida ou falhou.

Saída esperada:

{ 
  "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": "cbe7d642-9e0a-475d-b2bf-2cb0a9825e13", 
    "createdByType": "Application", 
    "lastModifiedAt": "2024-XX-XXT10:44:21.3736554Z", 
    "lastModifiedBy": "cbe7d642-9e0a-475d-b2bf-2cb0a9825e13", 
    "lastModifiedByType": "Application" 
  }, 
  "type": "microsoft.managednetworkfabric/networkdevices" 
}

Quando a configuração do RW for bem-sucedida, o estado de configuração do dispositivo passará para um estado de controle adiado. Nenhuma alteração no estado ocorrerá se a configuração falhar.

show interfaces description

|Interface  |Status  |Protocol  |Decsription  |
|---------|---------|---------|---------|
|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"     |

Alterando três descrições da interface

Este exemplo mostra como alterar três interfaces diferentes em uma descrição do dispositivo para 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"

Parâmetro	Descrição
`az networkfabric device run-rw`	Comando da CLI do Azure para executar uma operação de leitura/gravação em um dispositivo de rede no Azure Network Fabric.
`--resource-name <ResourceName>`	Especifica o nome do recurso (dispositivo de rede) no qual a operação de RW será executada.
`--resource-group <ResourceGroupName>`	Especifica o nome do grupo de recursos que contém o dispositivo de rede.
`--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"`	Especifica os comandos de RW a serem executados no dispositivo de rede. Cada comando 'interface' define a descrição da interface Ethernet especificada.

Saída esperada:

{}

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

Parâmetro	Descrição
`az networkfabric device run-rw`	Comando da CLI do Azure para executar uma operação de leitura/gravação em um dispositivo de rede no Azure Network Fabric.
`--resource-name <ResourceName>`	Especifica o nome do recurso (dispositivo de rede) no qual a operação de RW será executada.
`--resource-group <ResourceGroupName>`	Especifica o nome do grupo de recursos que contém o dispositivo de rede.
`--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"`	Especifica os comandos de RW a serem executados no dispositivo de rede. Cada comando 'interface' define a descrição da interface Ethernet especificada.
`--no-wait`	Indica que o comando deve ser executado de maneira assíncrona, sem aguardar a conclusão da operação.
`--debug`	Sinalizador habilitando o modo de depuração, fornecendo informações adicionais sobre a execução do comando para fins de solução de problemas.

Saída truncada esperada:

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.

Você pode verificar programaticamente o status da operação executando o seguinte comando:

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

Exemplo da URL do ponto de extremidade Azure-AsyncOperation extraída da saída truncada.

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

O Status deve indicar se a API foi bem-sucedida ou falhou.

Saída esperada:

{ 
  "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": "cbe7d642-9e0a-475d-b2bf-2cb0a9825e13", 
    "createdByType": "Application", 
    "lastModifiedAt": "2024-XX-XXT10:44:21.3736554Z", 
    "lastModifiedBy": "cbe7d642-9e0a-475d-b2bf-2cb0a9825e13", 
    "lastModifiedByType": "Application" 
  }, 
  "type": "microsoft.managednetworkfabric/networkdevices" 
}

show interfaces description

|Interface  |Status  |Protocol  |Decsription  |
|---------|---------|---------|---------|
|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"     |

Substituir a configuração anterior

Este exemplo mostra como a configuração anterior será substituída se você não anexar a configuração antiga do RW:

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

Parâmetro	Descrição
`az networkfabric device run-rw`	Comando da CLI do Azure para executar uma operação de leitura/gravação em um dispositivo de rede no Azure Network Fabric.
`--resource-name`	Especifica o nome do recurso (dispositivo de rede) no qual a operação de RW será executada.
`--resource-group`	Especifica o nome do grupo de recursos que contém o dispositivo de rede.
`--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"`	Especifica os comandos de RW a serem executados no dispositivo de rede. Cada comando 'interface' define a descrição da interface Ethernet especificada.

Saída esperada:

{}

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

Parâmetro	Descrição
`az networkfabric device run-rw`	Comando da CLI do Azure para executar uma operação de leitura/gravação em um dispositivo de rede no Azure Network Fabric.
`--resource-name`	Especifica o nome do recurso (dispositivo de rede) no qual a operação de RW será executada.
`--resource-group`	Especifica o nome do grupo de recursos que contém o dispositivo de rede.
`--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"`	Especifica os comandos de RW a serem executados no dispositivo de rede. Cada comando 'interface' define a descrição da interface Ethernet especificada.
`--no-wait`	Indica que o comando deve ser executado de maneira assíncrona, sem aguardar a conclusão da operação.
`--debug`	Sinalizador habilitando o modo de depuração, fornecendo informações adicionais sobre a execução do comando para fins de solução de problemas.

Saída truncada esperada:

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.

Você pode verificar programaticamente o status da operação executando o seguinte comando:

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

Exemplo da URL do ponto de extremidade Azure-AsyncOperation extraída da saída truncada.

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

Saída esperada:

{ 
  "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": "cbe7d642-9e0a-475d-b2bf-2cb0a9825e13", 
    "createdByType": "Application", 
    "lastModifiedAt": "2024-XX-XXT10:44:21.3736554Z", 
    "lastModifiedBy": "cbe7d642-9e0a-475d-b2bf-2cb0a9825e13", 
    "lastModifiedByType": "Application" 
  }, 

  "type": "microsoft.managednetworkfabric/networkdevices" 

}

show interfaces description

|Interface  |Status  |Protocol  |Decsription  |
|---------|---------|---------|---------|
|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"     |

Limpar a configuração de leitura e gravação

Este exemplo mostra como a configuração de RW é limpa. Quando você executa a limpeza, a configuração é revertida para a original.

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

Parâmetro	Descrição
`az networkfabric device run-rw`	Comando da CLI do Azure para executar uma operação de leitura/gravação em um dispositivo de rede no Azure Network Fabric.
`--resource-name <ResourceName>`	Especifica o nome do recurso (dispositivo de rede) no qual a operação de RW será executada.
`--resource-group <ResourceGroupName>`	Especifica o nome do grupo de recursos que contém o dispositivo de rede.
`--rw-command " "`	Especifica um comando RW vazio a ser executado no dispositivo de rede. Esse comando é essencialmente um espaço reservado sem nenhuma ação.

Observação

Verifique se há um espaço entre as aspas no comando RW vazio.

Saída esperada:

{}

Comando com --no-wait--debug

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

Parâmetro	Descrição
`az networkfabric device run-rw`	Comando da CLI do Azure para executar uma operação de leitura/gravação em um dispositivo de rede no Azure Network Fabric.
`--resource-name <ResourceName>`	Especifica o nome do recurso (dispositivo de rede) no qual a operação de RW será executada.
`--resource-group <ResourceGroupName>`	Especifica o nome do grupo de recursos que contém o dispositivo de rede.
`--rw-command " "`	Especifica um comando RW vazio a ser executado no dispositivo de rede. Esse comando é essencialmente um espaço reservado sem nenhuma ação.
`--no-wait`	Indica que o comando deve ser executado de maneira assíncrona, sem aguardar a conclusão da operação.
`--debug`	Sinalizador habilitando o modo de depuração, fornecendo informações adicionais sobre a execução do comando para fins de solução de problemas.

Saída truncada esperada:

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.

Você pode verificar programaticamente o status da operação executando o seguinte comando:

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

Exemplo da URL do ponto de extremidade Azure-AsyncOperation extraída da saída truncada.

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

O status indica se a API foi bem-sucedida ou falhou.

Saída esperada:

{ 
  "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": "cbe7d642-9e0a-475d-b2bf-2cb0a9825e13", 
    "createdByType": "Application", 
    "lastModifiedAt": "2024-XX-XXT10:44:21.3736554Z", 
    "lastModifiedBy": "cbe7d642-9e0a-475d-b2bf-2cb0a9825e13", 
    "lastModifiedByType": "Application" 
  }, 
  "type": "microsoft.managednetworkfabric/networkdevices" 
}

Quando a configuração de RW é revertida de volta para a original, o estado de configuração do dispositivo é movido para "Bem-sucedido" de Controle Adiado.

show interfaces description

|Interface  |Status  |Protocol  |Decsription  |
|---------|---------|---------|---------|
|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"**    |

Restrições de comandos

O recurso de comando de RW está aberto e não há restrições sobre ele. No entanto, prossiga com cuidado porque o uso incorreto da configuração pode derrubar o sistema.

A criação de vLANs que variam de 1 a 500 e 3000 a 4095 não é recomendada, pois esse intervalo é reservado para fins de infraestrutura.
Não adultere a configuração de vLAN de gerenciamento.
É imperativo não adulterar as ACLs (Listas de Controle de Acesso) de Entrada e Saída de NNI (Interconexão de Rede para Rede), pois qualquer modificação pode resultar em uma perda de conectividade com a instância do Nexus do Operador do Azure.
Não há validações de esquema ou sintaxe executadas para comandos RW. Você precisa garantir que a configuração seja verificada antes de executá-la.
Os comandos de configuração de RW devem ser um comando absoluto; não há suporte para formulários curtos e prompts. Por exemplo, insira router bgp <ASN>\n vrf <name>\n neighbor <IPaddress> shutdown, não router bgp <ASN>\n vrf <name>\n nei <IPaddress> sh or shut
É crucial examinar minuciosamente a configuração da Política de Rota antes da implementação, pois qualquer deslize poderia comprometer a configuração da Política de Rota existente.
Alterar a configuração do BGP do roteador e desligá-lo reduz a estabilidade do dispositivo.

Limitações

Perguntas comuns:

Posso executar vários comandos ao mesmo tempo?

Sim, você pode executar vários comandos ao mesmo tempo. Consulte os exemplos para examinar como executar vários comandos ao mesmo tempo.
Como fazer para verificar se a configuração foi bem-sucedida?

Você pode verificar a configuração com um dos seguintes procedimentos:
- Executando uma API somente leitura e executando os comandos show necessários para verificar que a configuração foi bem-sucedida,
- Executando o recurso de diferença de configuração para exibir o delta entre as configurações.
A mensagem RW POST indica se a execução foi bem-sucedida ou não.
O que acontece se eu executar o comando de configuração RW incorretamente?

A mensagem RW POST retorna uma mensagem de erro, conforme mostrado no exemplo fornecido neste artigo. Nenhuma alteração de configuração é aplicada ao dispositivo. Você precisa executar novamente o comando de configuração.
Como posso persistir o comando de configuração do RW várias vezes?

Se você tentar modificar e atualizar a configuração em uma configuração persistente, precisará fornecer toda a configuração persistente modificada, caso contrário, a configuração será substituída pela configuração mais recente do RW.

Por exemplo

Se você criou um vlan 505 com êxito e tenta criar outro conjunto de vlans (vlan 510), você precisa adicionar vlan 505\\n vlan 510. Se você não fizer isso, o comando de configuração de RW mais recente substituirá o vlan 505.
Como fazer para excluir a configuração?

Você precisa fornecer o valor nulo " ". Consulte a seção de exemplos deste artigo.
O comando RW é persistente em toda a malha?

O comando de configuração de RW é persistente, mas a API permite que você o execute em um nível de dispositivo. Se você quiser executar o comando RW na malha, precisará executar a API de RW nos dispositivos de malha necessários.

Problemas conhecidos

Veja os seguintes problemas conhecidos para a configuração do RW:

Não há suporte para que a configuração de RW persista durante uma atualização. Durante a atualização, o estado de configuração Controle adiado é substituído. A automação de serviço do Fabric substitui a configuração de RW por meio do fluxo de trabalho de reconciliação do Network Fabric. Você precisa executar novamente o comando de configuração de RW para os dispositivos necessários.
Um erro é relatado porque um erro interno ou um erro de conjunto gNMI não pode ser distinguido com respostas de erro.

Compartilhar via

Executar comandos de leitura e gravação

Pré-requisitos

Procedimento

Selecione o Dispositivo de Rede

Acesse os Dispositivos de Rede:

Selecione o Dispositivo de Rede:

Exemplos

Instantâneo do dispositivo do Network Fabric antes de fazer alterações na configuração usando a API de RW

Alterar a descrição de uma interface

Alterando três descrições da interface

Substituir a configuração anterior

Limpar a configuração de leitura e gravação

Restrições de comandos

Limitações

Problemas conhecidos

Comentários

Recursos adicionais

Compartilhar via

Executar comandos de leitura e gravação

Pré-requisitos

Procedimento

Selecione o Dispositivo de Rede

Acesse os Dispositivos de Rede:

Selecione o Dispositivo de Rede:

Exemplos

Instantâneo do dispositivo do Network Fabric antes de fazer alterações na configuração usando a API de RW

Alterar a descrição de uma interface

Alterando três descrições da interface

Substituir a configuração anterior

Limpar a configuração de leitura e gravação

Restrições de comandos

Limitações

Problemas conhecidos

Conteúdo relacionado

Comentários

Recursos adicionais