MédiaMúltipla escolha

Questão de prática de 200-901

Um desenvolvedor está usando a Cisco NX-OS REST API (NX-API) para configurar um switch Cisco Nexus. O desenvolvedor deseja enviar um payload JSON para criar uma nova VLAN. Qual método HTTP e quais cabeçalhos são necessários para usar a interface NX-API REST?

Escolha a melhor resposta.

Resposta correta

  • BPOST com Content-Type: application/json e um corpo JSON contendo a configuração da VLAN.

Explicação

O NX-API REST usa HTTP POST para enviar payloads de configuração. Ao enviar JSON, o cabeçalho Content-Type deve ser application/json. O corpo contém a representação JSON da configuração, como o objeto VLAN. Outros métodos ou tipos de conteúdo não correspondem ao requisito de enviar um payload JSON para configuração.

Por que cada alternativa está certa ou errada

A

Incorreta

POST com Content-Type: application/xml e um corpo XML contendo a configuração da VLAN.

O NX-API REST aceita tanto JSON quanto XML, mas o cabeçalho Content-Type deve descrever o corpo realmente enviado. O desenvolvedor deseja enviar JSON, portanto um corpo XML com 'application/xml' não atende ao requisito, e misturar um corpo JSON com um tipo de conteúdo XML faria com que o switch falhasse ao analisar a requisição. Use POST com 'Content-Type: application/json' e um corpo JSON descrevendo o objeto VLAN.

B

Correta

POST com Content-Type: application/json e um corpo JSON contendo a configuração da VLAN.

O NX-API REST modela a configuração do switch como objetos gerenciados no Data Management Engine, e as alterações de configuração são enviadas com HTTP POST para a URL do objeto, por exemplo, sob /api/mo/sys/bd.json para domínios de ponte, que representam VLANs. O corpo JSON descreve o objeto e seus atributos. Após fazer login em /api/aaaLogin.json, o cookie de token retornado autentica requisições posteriores. O GET lê objetos e o DELETE os remove.

C

Incorreta

PUT com Content-Type: application/json e um corpo JSON contendo a configuração da VLAN.

O NX-API REST usa POST para criar e modificar objetos gerenciados; PUT não é o método esperado para essas operações. Muitas outras APIs REST, incluindo RESTCONF, usam PUT para criar ou substituir um recurso, o que torna esta opção tentadora, mas no NX-API REST a requisição seria rejeitada ou não se comportaria conforme o pretendido. Corresponder o método à documentação de cada API é essencial, já que as convenções REST diferem entre plataformas.

D

Incorreta

GET com Content-Type: application/json e um corpo JSON contendo a configuração da VLAN.

O GET recupera dados e não deve carregar um corpo de requisição nem alterar nada no servidor; o NX-API REST o usa para ler objetos como VLANs existentes, não para criá-las. Enviar a configuração em um corpo GET seria ignorado ou rejeitado. Para criar uma VLAN, o desenvolvedor deve fazer POST do objeto JSON e, em seguida, pode usar o GET para confirmar que a VLAN existe.

Para se aprofundar

Os switches Cisco Nexus oferecem duas interfaces programáticas sob o nome NX-API, e ajuda mantê-las separadas. O NX-API CLI permite que um cliente envie comandos CLI comuns, envolvidos em um envelope JSON ou XML, para o endpoint '/ins', com um tipo como 'cli_show', 'cli_show_ascii' ou 'cli_conf'. O NX-API REST expõe o modelo de objetos do switch, o Data Management Engine (DME), como recursos sob '/api/mo/' e '/api/class/', de modo que a configuração é expressa como objetos em vez de comandos; uma VLAN, por exemplo, é um objeto bridge-domain sob a árvore de topologia. Em ambos, a configuração é enviada com HTTP POST e um corpo no formato declarado, de modo que criar uma VLAN com um corpo JSON significa POST com 'Content-Type: application/json'; o POST no NX-API REST cria ou atualiza o objeto, e o 'GET' lê os objetos de volta. Antes que qualquer coisa disso funcione, o recurso deve ser habilitado com 'feature nxapi', e o cliente deve se autenticar: o NX-API REST usa uma chamada de login (aaaLogin) que retorna um token, enviado como um cookie em requisições posteriores, enquanto o NX-API CLI normalmente usa autenticação básica HTTP sobre HTTPS. O sandbox NX-API embutido, acessado navegando para o endereço de gerenciamento do switch, converte comandos CLI no payload JSON ou XML correspondente, o que é uma maneira rápida de aprender o formato. Os distratores fazem uso incorreto do protocolo. Declarar XML ao enviar JSON, ou o inverso, causa um erro de análise. O PUT não é a forma como o NX-API REST cria objetos de configuração. O GET é para leitura; uma requisição GET com um corpo de configuração não é processada como uma alteração.

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.