DifícilMúltipla escolha

Questão de prática de 200-901

Um desenvolvedor está usando o Cisco NX-API em um switch Cisco Nexus para recuperar a configuração em execução (running configuration). O desenvolvedor envia uma requisição HTTP POST para o endpoint NX-API com a carga útil JSON: {"ins_api": {"version": "1.0", "type": "cli_show", "chassis": "1", "input": "show running-config", "output_format": "json"}}. O switch retorna um erro indicando que o comando não é suportado. Qual é o motivo mais provável?

Escolha a melhor resposta.

Resposta correta

  • AO comando 'show running-config' requer o tipo 'cli_show_ascii' em vez de 'cli_show'.

Explicação

O NX-API usa diferentes tipos para comandos: 'cli_show' para saída JSON estruturada e 'cli_show_ascii' para saída de texto ASCII. O comando 'show running-config' não suporta saída JSON, portanto deve ser solicitado com 'cli_show_ascii'. O erro ocorre porque o desenvolvedor usou 'cli_show' com um comando que carece de suporte a JSON. Alterar o tipo para 'cli_show_ascii' resolve o problema.

Por que cada alternativa está certa ou errada

A

Correta

O comando 'show running-config' requer o tipo 'cli_show_ascii' em vez de 'cli_show'.

O NX-API distingue entre comandos que retornam saída JSON estruturada e aqueles que retornam texto ASCII. O comando 'show running-config' não possui um esquema JSON, portanto deve ser solicitado com o tipo 'cli_show_ascii'. O uso de 'cli_show' espera saída estruturada e falha para este comando. Assim, o desenvolvedor deve alterar o tipo.

B

Incorreta

O NX-API requer que o campo 'input' seja uma lista de comandos, não uma única string.

O campo 'input' pode ser uma única string de comando ou uma lista. O erro não é sobre o formato de 'input'; é sobre o tipo de comando. 'show running-config' é um comando válido, mas deve ser solicitado com 'cli_show_ascii' para retornar saída ASCII. Portanto, esta não é a razão para o erro.

C

Incorreta

O 'output_format' deve ser definido como 'ascii' em vez de 'json'.

'output_format' não decide se um comando é suportado; o campo 'type' é que decide. 'cli_show' pede ao switch uma saída estruturada, que 'show running-config' não fornece, de modo que o erro permanece independentemente do formato de saída. Alterar o tipo para 'cli_show_ascii' diz ao NX-API para retornar o texto simples do comando, que é como a configuração em execução é recuperada através da interface no estilo JSON-RPC.

D

Incorreta

O campo 'chassis' deve ser omitido para comandos que não são específicos de chassi.

O campo 'chassis' identifica o chassi em sistemas de vários chassis; para um switch Nexus autônomo, '1' é válido e o campo pode ser omitido. Ele não tem nada a ver com o fato de um comando suportar saída estruturada, portanto removê-lo não corrigiria o erro. O erro vem de solicitar saída estruturada com 'cli_show' para um comando que produz apenas texto, o que 'cli_show_ascii' resolve.

Para se aprofundar

As requisições CLI do NX-API carregam um campo 'type' que diz ao switch como executar o comando e formatar a resposta. 'cli_show' executa um comando show e retorna saída estruturada (JSON ou XML) construída a partir do modelo de dados do comando, o que é ideal para automação porque os campos podem ser lidos diretamente em vez de analisados a partir de texto. 'cli_show_ascii' executa um comando show e retorna o texto simples exatamente como apareceria no console. 'cli_conf' envia comandos de configuração. A saída estruturada está disponível apenas para comandos que possuem um modelo de dados por trás deles, e 'show running-config' não possui: é uma renderização em texto da configuração, portanto solicitá-lo com o tipo 'cli_show' falha com um erro de que o comando não suporta saída estruturada. Alterar o tipo para 'cli_show_ascii' retorna a configuração como texto, dentro do campo body da resposta. Quando você precisa de valores de configuração específicos em forma estruturada, consulte os comandos show operacionais que suportam JSON, ou use NX-API REST ou NETCONF, que expõem a configuração como dados. Outros detalhes da requisição valem a pena ser conhecidos. 'input' aceita vários comandos em uma única string, separados por ' ;' (um espaço e um ponto e vírgula). 'output_format' seleciona JSON ou XML para o envelope de resposta e não torna um comando estruturado por si só. 'chassis' e 'version' são campos padrão e são inofensivos. O sandbox do NX-API na interface web do switch mostra quais comandos suportam saída estruturada e gera o corpo exato da requisição, o que evita esse tipo de erro.

Sobre estas questões de prática

Esta é uma das questões de prática originais de 200-901 da Courseiva, escrita para o aprendizado e nunca copiada de provas reais nem de dumps.

Traduzida do original em inglês com IA e conferida quanto ao sentido. Códigos de exame, comandos e nomes de produtos são mantidos como aparecem na prova.