Команды только для чтения Network Fabric для устранения неполадок
Устранение неполадок сетевых устройств является важным аспектом эффективного управления сетями. Обеспечение работоспособности и оптимальной производительности инфраструктуры требует своевременной диагностики и решения проблем. В этом руководстве мы предлагаем комплексный подход к устранению неполадок устройств с оператором Azure Nexus с помощью команд только для чтения (RO).
Общие сведения о командах только для чтения
Команды RO служат основными средствами для сетевых администраторов. В отличие от команд чтения и записи (RW), которые изменяют конфигурации устройств, команды RO позволяют администраторам собирать диагностические сведения без изменения состояния устройства. Эти команды предоставляют ценные сведения о состоянии, конфигурации и операционных данных устройства.
API диагностики только для чтения
API диагностики только для чтения позволяет пользователям выполнять show
команды на сетевых устройствах с помощью вызова API. Этот эффективный метод позволяет администраторам удаленно выполнять диагностические запросы на всех устройствах сетевой структуры. К ключевым функциям API диагностики только для чтения относятся:
Эффективность. Выполнение
show
команд без прямого доступа к консоли устройства.Простая интеграция с AZCLI: пользователи могут использовать обычные интерфейс командной строки Azure (AZCLI) для передачи требуемой команды show. Затем API упрощает выполнение команд на целевом устройстве, извлекая выходные данные.
Выходные данные JSON: результаты выполняемых команд представлены в формате JSON, что упрощает анализ и анализ.
Безопасная служба хранилища. Выходные данные хранятся в учетной записи хранения, принадлежащей клиенту, обеспечивая безопасность и соответствие данным.
С помощью API диагностики только для чтения администраторы сети могут эффективно устранять проблемы, проверять конфигурации и отслеживать работоспособность устройств на устройствах Оператора Azure Nexus.
Необходимые компоненты
Чтобы использовать команды только для чтения Network Fabric, выполните следующие действия.
Подготовка Nexus Network Fabric успешно.
Создайте URL-адрес хранилища.
Сведения о создании контейнера см. в статье "Создание контейнера ".
Примечание.
Введите имя контейнера, используя только строчные буквы.
Чтобы создать URL-адрес SAS контейнера, см. раздел "Создать подписанный URL-адрес общего доступа". Укажите разрешение на запись для SAS.
Примечание.
URL-адреса SAS являются короткими. По умолчанию срок действия истекает в восемь часов. Если срок действия URL-адреса SAS истек, структура должна быть повторно исправлена.
Укажите URL-адрес хранилища с доступом WRITE через запрос в службу поддержки.
Примечание.
URL-адрес служба хранилища должен находиться в другом регионе, отличном от Network Fabric. Например, если Структура размещена в восточной части США, URL-адрес хранилища должен находиться за пределами восточной части США.
Ограничения команд
Чтобы обеспечить безопасность и соответствие требованиям, команды RO должны соответствовать следующим правилам:
- В качестве входных данных должны предоставляться только абсолютные команды. Короткие формы и запросы не поддерживаются. Например:
- Введите
show interfaces Ethernet 1/1 status
- Не вводите или не вводите
sh int stat
sh int e1/1 status
- Введите
- Команды не должны быть пустыми, пустыми или состоять только из одного слова.
- Команды не должны содержать символ канала (|).
- Показать команды являются неограниченными, за исключением команд с высоким объемом ресурсов ЦП, которые специально называются в этом списке ограничений.
- Команды не должны заканчиваться ,
tech-support
agent logs
илиip route
ip route vrf all
. - На определенном устройстве можно использовать только одну команду за раз
show
. - Вы можете выполнять команду в другом окне ИНТЕРФЕЙСА командной
show
строки параллельно. - Вы можете одновременно выполнять
show
команду на разных устройствах.
Устранение неполадок с помощью команд только для чтения
Чтобы устранить неполадки с помощью команд только для чтения, выполните следующие действия.
Откройте запрос в службу поддержки Майкрософт. Инженер службы поддержки выполняет необходимые обновления.
Выполните следующую команду Azure CLI:
az networkfabric device run-ro --resource-name "<NFResourceName>" --resource-group "<NFResourceGroupName>" --ro-command "show version"
Ожидаемые выходные данные:
{ }
Введите следующую команду:
az networkfabric device run-ro --resource-group Fab3LabNF-6-0-A --resource-name nffab3-6-0-A-AggrRack-CE1 --ro-command "show version" --no-wait --debug
Отображаются следующие (усеченные) выходные данные. Скопируйте URL-адрес через частную предварительную версию. Эта часть URL-адреса используется на следующем шаге для проверка состояния операции.
https://management.azure.com/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/providers/Microsoft.ManagedNetworkFabric/locations/EASTUS2EUAP/operationStatuses/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e*A9E6DB3DF5C58D67BD395F7A608C056BC8219C392CC1CE0AD22E4C36D70CEE5C?api-version=2022-01-15-privatepreview***&t=638485032018035520&c=MIIHHjCCBgagAwIBAgITfwKWMg6goKCq4WwU2AAEApYyDjANBgkqhkiG9w0BAQsFADBEMRMwEQYKCZImiZPyLGQBGRYDR0JMMRMwEQYKCZImiZPyLGQBGRYDQU1FMRgwFgYDVQQDEw9BTUUgSW5mcmEgQ0EgMDIwHhcNMjQwMTMwMTAzMDI3WhcNMjUwMTI0MTAzMDI3WjBAMT4wPAYDVQQDEzVhc3luY29wZXJhdGlvbnNpZ25pbmdjZXJ0aWZpY2F0ZS5tYW5hZ2VtZW50LmF6dXJlLmNvbTCCASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBALMk1pBZQQoNY8tos8XBaEjHjcdWubRHrQk5CqKcX3tpFfukMI0_PVZK-Kr7xkZFQTYp_ItaM2RPRDXx-0W9-mmrUBKvdcQ0rdjcSXDek7GvWS29F5sDHojD1v3e9k2jJa4cVSWwdIguvXmdUa57t1EHxqtDzTL4WmjXitzY8QOIHLMRLyXUNg3Gqfxch40cmQeBoN4rVMlP31LizDfdwRyT1qghK7vgvworA3D9rE00aM0n7TcBH9I0mu-96JE0gSX1FWXctlEcmdwQmXj_U0sZCu11_Yr6Oa34bmUQHGc3hDvO226L1Au-QsLuRWFLbKJ-0wmSV5b3CbU1kweD5LUCAwEAAaOCBAswggQHMCcGCSsGAQQBgjcVCgQaMBgwCgYIKwYBBQUHAwEwCgYIKwYBBQUHAwIwPQYJKwYBBAGCNxUHBDAwLgYmKwYBBAGCNxUIhpDjDYTVtHiE8Ys-
Проверьте состояние операции программным способом с помощью следующей команды Azure CLI:
az rest -m get -u "<Azure-AsyncOperation-endpoint url>"
Состояние операции указывает, успешно ли выполнен ИЛИ завершился сбой API, и отображается примерно так же, как и в следующих выходных данных:
https://management.azure.com/subscriptions/xxxxxxxxxxx/providers/Microsoft.ManagedNetworkFabric/locations/EASTUS/operationStatuses/xxxxxxxxxxx?api-version=20XX-0X-xx-xx
Просмотр и скачивание созданного выходного файла. Пример выходных данных показан здесь.
{ "architecture": "x86_64", "bootupTimestamp": 1701940797.5429916, "configMacAddress": "00:00:00:00:00:00", "hardwareRevision": "12.05", "hwMacAddress": "c4:ca:2b:62:6d:d3", "imageFormatVersion": "3.0", "imageOptimization": "Default", "internalBuildId": "d009619b-XXXX-XXXX-XXXX-fcccff30ae3b", "internalVersion": "4.30.3M-33434233.4303M", "isIntlVersion": false, "memFree": 3744220, "memTotal": 8107980, "mfgName": "Arista", "modelName": "DCS-7280DR3-24-F", "serialNumber": "JPAXXXX1LZ", "systemMacAddress": "c4:ca:2b:62:6d:d3", "uptime": 8475685.5, "version": "4.30.3M" }