Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 
 

Descrições de interface (API)

Além dos principais parâmetros de interfaces de rede, como nome, velocidade e modo de porta, o Apstra também configura uma descrição para interfaces físicas e interfaces lógicas agregadas (os chamados canais de porta). A descrição da interface é gerada automaticamente se as seguintes condições forem atendidas:

  1. A interface está conectada a um peer.
  2. A interface pertence ao leaf, spine ou sistema genérico.
  3. A interface peer pertence ao sistema leaf, spine ou genérico com endpoint de rede virtual neste servidor.

A descrição gerada tem o formulário <facing_|to.><peer-device-label>[:peer-interface-name]. Exemplos:

  • facing_spine2:Ethernet1/2
  • to.server1:eth0
  • to.server2

O prefixo do nome é facing_ se o peer for leaf, spine ou roteador externo. O prefixo é to. no caso de um dispositivo peer ser um servidor L2 ou L3. A parte do nome da interface de peer só está presente quando o dispositivo peer é controlado pelo Apstra.

Apstra REST API — Descrições da interface

A API do Apstra é capaz de alterar a descrição da interface gerada automaticamente. No entanto, não existe essa funcionalidade na UI do Apstra.

A descrição da interface pode conter caracteres ASCII com códigos 33-126 e espaços, exceto "?", que é interpretado como uma conclusão de comando. O comprimento de descrição é limitado a 240 caracteres, que é o comprimento mais longo possível em modelos de switch suportados.

As interfaces são armazenadas internamente como nós gráficos com determinado conjunto de propriedades. A descrição é uma dessas propriedades. Para modificar a descrição, use a API genérica para interagir com nós gráficos.

API — Obtenha a configuração da interface

Para obter a configuração da interface, envie a solicitação GET para https://aos-server/api/blueprints/{blueprint-id}/nodes/{interface-node-id}.

Solicitação:

API — Crie ou modifique a descrição da interface

Para criar ou modificar a descrição da interface, envie uma solicitação de PATCH para https://aos-server/api/blueprints/{blueprint-id}/nodes/{interface-node-id} com um JSON válido. O JSON deve conter o campo "descrição" com dados válidos.

Resposta:

API — Exclua a descrição da interface

Para excluir a descrição da interface personalizada e voltar à geração de descrição automática, defina a descrição para vazio de valor.

Solicitação:

Resposta:

A solicitação get subseqüente mostrará que a descrição foi gerada automaticamente.

Solicitação:

Resposta: