Leesbewerkingsopdrachten uitvoeren

Artikel
05/04/2024

Met de functie Lezen schrijven (RW) kunt u apparaatconfiguraties op afstand wijzigen zonder toegang te krijgen tot het netwerkinfrastructuurapparaat. Pas de rw-configuratieopdracht toe op apparaatniveau op netwerkinfrastructuur. Omdat de configuratieopdracht op apparaatniveau blijft bestaan, moet u de configuratie toepassen op elk apparaat in de infrastructuur om alle apparaten te configureren.

Als u de RW-opdracht uitvoert, blijft uw configuratie behouden op basis van wijzigingen die zijn aangebracht via de CLI (Opdrachtregelinterface) of de portal. Als u meerdere configuraties wilt introduceren via de RW-API, voegt u nieuwe opdrachten toe aan de bestaande RW-opdracht. Neem na het wijzigen van meerdere apparaatinterfaces bijvoorbeeld de vorige configuratie op met eventuele nieuwe wijzigingen om overschrijven te voorkomen.

Herstel de RW-configuratie alleen tijdens een upgradescenario. Na de upgrade moet u indien nodig de RW-wijzigingen opnieuw aanbrengen. In de volgende voorbeelden wordt u stapsgewijs begeleid bij het RW API-proces.

Vereisten

Zorg ervoor dat de Nexus Network Fabric is ingericht.

Procedure

Wanneer u een RW-configuratieopdracht uitvoert en wijzigingen aanbrengt in het apparaat, wordt de configuratiestatus van het apparaat verplaatst naar Uitgesteld besturingselement. Deze status geeft aan dat de RW-configuratie op dat apparaat is gepusht. Wanneer de toegepaste RW-configuratie wordt omgekeerd, keert de configuratie van het apparaat terug naar de oorspronkelijke status geslaagd .

Netwerkapparaat selecteren

Meld u aan bij het Azure Portal

Toegang tot de netwerkapparaten:

Nadat u bent aangemeld, gebruikt u de zoekbalk bovenaan om te zoeken Network Devices naar of te navigeren naar alle services en te zoeken naar netwerkapparaten onder de categorie Netwerken.

Klik op Netwerkapparaten om de lijst met netwerkapparaten in uw abonnement te openen.

Selecteer het netwerkapparaat:

Zoek en klik in de lijst met netwerkapparaten op het netwerkapparaat dat u wilt configureren. Hiermee gaat u naar de detailpagina van het geselecteerde netwerkapparaat.

Noteer de resourcenaam en de resourcegroep van dit netwerkapparaat, omdat u deze nodig hebt voor de CLI-opdracht.

Als u de naam van de resource wilt ophalen, klikt u op de JSON-weergave (te vinden in de sectie Eigenschappen of Overzicht) waarin de gedetailleerde eigenschappen van het apparaat worden weergegeven, inclusief de resourcenaam.

Voorbeelden

De volgende secties bevatten voorbeelden van RW-opdrachten die kunnen worden gebruikt om de configuratie van het apparaat te wijzigen. In de voorbeelden worden Ethernet-interfaces 1, 2 en 3 gebruikt om u te laten zien hoe u de interfacenaam kunt aanpassen en de resultaten van deze wijzigingen kunt bekijken.

Momentopname van het Network Fabric-apparaat voordat u wijzigingen aanbrengt in de configuratie met behulp van 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"**       |

De beschrijving van een interface wijzigen

In het voorbeeld ziet u hoe u de interfacebeschrijving van het apparaat wijzigt in 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`	Azure CLI-opdracht voor het uitvoeren van een lees-/schrijfbewerking op een netwerkapparaat in Azure Network Fabric.
`--resource-name`	Hiermee geeft u de naam van de resource (netwerkapparaat) waarop de RW-bewerking wordt uitgevoerd.
`--resource-group`	Hiermee geeft u de naam van de resourcegroep die het netwerkapparaat bevat.
`--rw-command "interface Ethernet 1\n description RW-test"`	Hiermee geeft u de RW-opdracht moet worden uitgevoerd op het netwerkapparaat. In dit voorbeeld wordt de beschrijving van ethernetinterface 1 ingesteld op 'RW-test'.

Verwachte uitvoer:

{}

Opdracht met --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`	Azure CLI-opdracht voor het uitvoeren van een lees-/schrijfbewerking op een netwerkapparaat in Azure Network Fabric.
`--resource-name`	Hiermee geeft u de naam van de resource (netwerkapparaat) waarop de RW-bewerking wordt uitgevoerd.
`--resource-group`	Hiermee geeft u de naam van de resourcegroep die het netwerkapparaat bevat.
`--rw-command "interface Ethernet 1\n description RW-test"`	Hiermee geeft u de RW-opdracht moet worden uitgevoerd op het netwerkapparaat. In dit voorbeeld wordt de beschrijving van ethernetinterface 1 ingesteld op 'RW-test'.
`--no-wait`	Geeft aan dat de opdracht asynchroon moet worden uitgevoerd zonder te wachten tot de bewerking is voltooid.
`--debug`	Markeer het inschakelen van de foutopsporingsmodus en geef aanvullende informatie over de uitvoering van de opdracht voor probleemoplossingsdoeleinden.

Verwachte afgekapte uitvoer:

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.

U kunt de status van de bewerking programmatisch controleren door de volgende opdracht uit te voeren:

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

Voorbeeld van de Eindpunt-URL van Azure-AsyncOperation die is geëxtraheerd uit de afgekapte uitvoer.

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

De status moet aangeven of de API is geslaagd of mislukt.

Verwachte uitvoer:

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

Wanneer de RW-configuratie slaagt, wordt de configuratiestatus van het apparaat verplaatst naar een uitgestelde controlestatus . Er treedt geen wijziging in de status op als de configuratie mislukt.

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

Drie van de beschrijvingen van de interface wijzigen

In dit voorbeeld ziet u hoe u drie verschillende interfaces op een apparaatbeschrijving wijzigt in 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`	Azure CLI-opdracht voor het uitvoeren van een lees-/schrijfbewerking op een netwerkapparaat in Azure Network Fabric.
`--resource-name <ResourceName>`	Hiermee geeft u de naam van de resource (netwerkapparaat) waarop de RW-bewerking wordt uitgevoerd.
`--resource-group <ResourceGroupName>`	Hiermee geeft u de naam van de resourcegroep die het netwerkapparaat bevat.
`--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"`	Hiermee geeft u de RW-opdrachten die moeten worden uitgevoerd op het netwerkapparaat. Met elke 'interface'-opdracht wordt de beschrijving voor de opgegeven Ethernet-interface ingesteld.

Verwachte uitvoer:

{}

Opdracht met --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`	Azure CLI-opdracht voor het uitvoeren van een lees-/schrijfbewerking op een netwerkapparaat in Azure Network Fabric.
`--resource-name <ResourceName>`	Hiermee geeft u de naam van de resource (netwerkapparaat) waarop de RW-bewerking wordt uitgevoerd.
`--resource-group <ResourceGroupName>`	Hiermee geeft u de naam van de resourcegroep die het netwerkapparaat bevat.
`--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"`	Hiermee geeft u de RW-opdrachten die moeten worden uitgevoerd op het netwerkapparaat. Met elke 'interface'-opdracht wordt de beschrijving voor de opgegeven Ethernet-interface ingesteld.
`--no-wait`	Geeft aan dat de opdracht asynchroon moet worden uitgevoerd zonder te wachten tot de bewerking is voltooid.
`--debug`	Markeer het inschakelen van de foutopsporingsmodus en geef aanvullende informatie over de uitvoering van de opdracht voor probleemoplossingsdoeleinden.

Verwachte afgekapte uitvoer:

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.

U kunt de status van de bewerking programmatisch controleren door de volgende opdracht uit te voeren:

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

Voorbeeld van de Eindpunt-URL van Azure-AsyncOperation die is geëxtraheerd uit de afgekapte uitvoer.

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

De status moet aangeven of de API is geslaagd of mislukt.

Verwachte uitvoer:

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

Vorige configuratie overschrijven

In dit voorbeeld ziet u hoe de vorige configuratie wordt overschreven als u de oude RW-configuratie niet toevoegt:

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`	Azure CLI-opdracht voor het uitvoeren van een lees-/schrijfbewerking op een netwerkapparaat in Azure Network Fabric.
`--resource-name`	Hiermee geeft u de naam van de resource (netwerkapparaat) waarop de RW-bewerking wordt uitgevoerd.
`--resource-group`	Hiermee geeft u de naam van de resourcegroep die het netwerkapparaat bevat.
`--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"`	Hiermee geeft u de RW-opdrachten die moeten worden uitgevoerd op het netwerkapparaat. Met elke 'interface'-opdracht wordt de beschrijving voor de opgegeven Ethernet-interface ingesteld.

Verwachte uitvoer:

{}

Opdracht met --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`	Azure CLI-opdracht voor het uitvoeren van een lees-/schrijfbewerking op een netwerkapparaat in Azure Network Fabric.
`--resource-name`	Hiermee geeft u de naam van de resource (netwerkapparaat) waarop de RW-bewerking wordt uitgevoerd.
`--resource-group`	Hiermee geeft u de naam van de resourcegroep die het netwerkapparaat bevat.
`--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"`	Hiermee geeft u de RW-opdrachten die moeten worden uitgevoerd op het netwerkapparaat. Met elke 'interface'-opdracht wordt de beschrijving voor de opgegeven Ethernet-interface ingesteld.
`--no-wait`	Geeft aan dat de opdracht asynchroon moet worden uitgevoerd zonder te wachten tot de bewerking is voltooid.
`--debug`	Markeer het inschakelen van de foutopsporingsmodus en geef aanvullende informatie over de uitvoering van de opdracht voor probleemoplossingsdoeleinden.

Verwachte afgekapte uitvoer:

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.

U kunt de status van de bewerking programmatisch controleren door de volgende opdracht uit te voeren:

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

Voorbeeld van de Eindpunt-URL van Azure-AsyncOperation die is geëxtraheerd uit de afgekapte uitvoer.

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

Verwachte uitvoer:

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

De configuratie voor lezen/schrijven opschonen

In dit voorbeeld ziet u hoe de RW-configuratie wordt opgeschoond. Wanneer u de opschoonactie uitvoert, wordt de configuratie teruggezet naar de oorspronkelijke configuratie.

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

Parameter	Description
`az networkfabric device run-rw`	Azure CLI-opdracht voor het uitvoeren van een lees-/schrijfbewerking op een netwerkapparaat in Azure Network Fabric.
`--resource-name <ResourceName>`	Hiermee geeft u de naam van de resource (netwerkapparaat) waarop de RW-bewerking wordt uitgevoerd.
`--resource-group <ResourceGroupName>`	Hiermee geeft u de naam van de resourcegroep die het netwerkapparaat bevat.
`--rw-command " "`	Hiermee geeft u een lege RW-opdracht moet worden uitgevoerd op het netwerkapparaat. Deze opdracht is in feite een tijdelijke aanduiding zonder actie.

Notitie

Zorg ervoor dat er een spatie tussen de aanhalingstekens in de lege RW-opdracht staat.

Verwachte uitvoer:

{}

Opdracht met --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`	Azure CLI-opdracht voor het uitvoeren van een lees-/schrijfbewerking op een netwerkapparaat in Azure Network Fabric.
`--resource-name <ResourceName>`	Hiermee geeft u de naam van de resource (netwerkapparaat) waarop de RW-bewerking wordt uitgevoerd.
`--resource-group <ResourceGroupName>`	Hiermee geeft u de naam van de resourcegroep die het netwerkapparaat bevat.
`--rw-command " "`	Hiermee geeft u een lege RW-opdracht moet worden uitgevoerd op het netwerkapparaat. Deze opdracht is in feite een tijdelijke aanduiding zonder actie.
`--no-wait`	Geeft aan dat de opdracht asynchroon moet worden uitgevoerd zonder te wachten tot de bewerking is voltooid.
`--debug`	Markeer het inschakelen van de foutopsporingsmodus en geef aanvullende informatie over de uitvoering van de opdracht voor probleemoplossingsdoeleinden.

Verwachte afgekapte uitvoer:

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.

U kunt de status van de bewerking programmatisch controleren door de volgende opdracht uit te voeren:

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

Voorbeeld van de Eindpunt-URL van Azure-AsyncOperation die is geëxtraheerd uit de afgekapte uitvoer.

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

De status geeft aan of de API is geslaagd of mislukt.

Verwachte uitvoer:

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

Wanneer de RW-configuratie wordt teruggezet naar de oorspronkelijke configuratie, wordt de configuratiestatus van het apparaat vanuit Uitgesteld besturingselement verplaatst naar Geslaagd.

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

Opdrachtbeperkingen

De rw-opdrachtfunctie is geopend en er zijn geen beperkingen voor. Wees echter voorzichtig omdat een onjuist gebruik van de configuratie het systeem kan uitschakelen.

Het maken van vLAN's tussen 1 en 500 en 3000 tot 4095 wordt niet aanbevolen omdat dit bereik is gereserveerd voor infrastructuurdoeleinden.
Manipulatie van de vLAN-beheerconfiguratie niet.
Het is noodzakelijk dat u de toegangsbeheerlijsten (ACL's) voor inkomend en uitgaand verkeer (NNI) niet kunt wijzigen, omdat eventuele wijzigingen kunnen leiden tot een verlies van connectiviteit met het Azure Operator Nexus-exemplaar.
Er zijn geen schematische of syntaxisvalidaties uitgevoerd voor RW-opdrachten. U moet ervoor zorgen dat de configuratie wordt gecontroleerd voordat u deze uitvoert.
De RW-configuratieopdrachten moeten een absolute opdracht zijn; korte formulieren en prompts worden niet ondersteund. Bijvoorbeeld: Voer niet in router bgp <ASN>\n vrf <name>\n neighbor <IPaddress> shutdownrouter bgp <ASN>\n vrf <name>\n nei <IPaddress> sh or shut
Het is van cruciaal belang om de configuratie van het routebeleid grondig te controleren vóór de implementatie, omdat elk toezicht mogelijk inbreuk kan maken op de bestaande configuratie van routebeleid.
Door de BGP-configuratie van de router te wijzigen en af te sluiten, wordt de stabiliteit van het apparaat uitgeschakeld.

Beperkingen

Veelgestelde vragen:

Kan ik meerdere opdrachten tegelijk uitvoeren?

Ja, u kunt meerdere opdrachten tegelijk uitvoeren. Raadpleeg de voorbeelden om te controleren hoe u meerdere opdrachten tegelijk uitvoert.
Hoe kan ik controleren of de configuratie is geslaagd?

U kunt de configuratie controleren door:
- Een alleen-lezen-API uitvoeren en de vereiste show opdrachten uitvoeren om de configuratie te controleren,
- De functie Configuratieverschil uitvoeren om de verschillen tussen de configuraties weer te geven.
Het bericht RW POST geeft aan of de uitvoering is geslaagd of niet.
Wat gebeurt er als ik de RW-configuratieopdracht onjuist uitvoer?

Het BERICHT RW POST retourneert een foutbericht, zoals wordt weergegeven in het voorbeeld in dit artikel. Er worden geen configuratiewijzigingen toegepast op het apparaat. U moet de configuratieopdracht opnieuw uitvoeren.
Hoe kan ik de RW-configuratieopdracht meerdere keren behouden?

Als u de configuratie probeert te wijzigen en bij te werken via een reeds persistente configuratie, moet u alle gewijzigde permanente configuratie opgeven, anders wordt de configuratie overschreven met de nieuwste RW-configuratie.

Bijvoorbeeld

Als u een vlan 505 hebt gemaakt en een andere set vlan's (vlan 510) wilt maken, moet u toevoegen vlan 505\\n vlan 510. Als u dat niet doet, overschrijft de meest recente RW-configuratieopdracht de vlan 505.
Hoe kan ik de configuratie verwijderen?

U moet de null-waarde " "opgeven. Raadpleeg de voorbeeldensectie van dit artikel.
Is de RW-opdracht permanent in de infrastructuur?

De rw-configuratieopdracht is permanent, maar met de API kunt u op apparaatniveau worden uitgevoerd. Als u de RW-opdracht wilt uitvoeren in de infrastructuur, moet u de RW-API uitvoeren op de vereiste infrastructuurapparaten.

Bekende problemen

Hier volgen bekende problemen voor de RW-configuratie:

Er is geen ondersteuning voor de RW-configuratie om tijdens een upgrade te blijven bestaan. Tijdens de upgrade wordt het uitgestelde besturingselement voor de configuratiestatus overschreven. De infrastructuurserviceautomatisering overschrijft de RW-configuratie via de network fabric-werkstroom. U moet de RW-configuratieopdracht opnieuw uitvoeren voor de vereiste apparaten.
Er wordt een fout gerapporteerd omdat een interne fout of een gNMI-setfout niet kan worden onderscheiden van foutreacties.

Delen via

Leesbewerkingsopdrachten uitvoeren

Vereisten

Procedure

Netwerkapparaat selecteren

Toegang tot de netwerkapparaten:

Selecteer het netwerkapparaat:

Voorbeelden

Momentopname van het Network Fabric-apparaat voordat u wijzigingen aanbrengt in de configuratie met behulp van rw-API

De beschrijving van een interface wijzigen

Drie van de beschrijvingen van de interface wijzigen

Vorige configuratie overschrijven

De configuratie voor lezen/schrijven opschonen

Opdrachtbeperkingen

Beperkingen

Bekende problemen

Feedback

Aanvullende resources

Delen via

Leesbewerkingsopdrachten uitvoeren

Vereisten

Procedure

Netwerkapparaat selecteren

Toegang tot de netwerkapparaten:

Selecteer het netwerkapparaat:

Voorbeelden

Momentopname van het Network Fabric-apparaat voordat u wijzigingen aanbrengt in de configuratie met behulp van rw-API

De beschrijving van een interface wijzigen

Drie van de beschrijvingen van de interface wijzigen

Vorige configuratie overschrijven

De configuratie voor lezen/schrijven opschonen

Opdrachtbeperkingen

Beperkingen

Bekende problemen

Gerelateerde inhoud

Feedback

Aanvullende resources