Comandos¶
Todos os comandos nbx de nível superior. Execute qualquer comando com --help para a lista completa de opções.
nbx init¶
Configuração interativa do perfil default. Solicita URL NetBox, chave do token,
segredo do token e timeout. Salva em ~/.config/netbox-sdk/config.json.
Arquivos antigos ~/.config/netbox-cli/config.json ainda são lidos automaticamente se uma
nova config NetBox SDK ainda não foi gravada.
Qualquer comando que precise de conexão também dispara esse prompt automaticamente se a config estiver ausente.
nbx config¶
Exibe a configuração do perfil default atual.
Opções
| Flag | Descrição |
|---|---|
--show-token |
Inclui chave e segredo do token na saída (texto plano) |
nbx groups¶
Lista todos os grupos de app OpenAPI disponíveis no esquema integrado.
A saída é um nome de grupo por linha: circuits, core, dcim, extras, ipam, plugins, tenancy, users, virtualization, vpn, wireless.
nbx resources GROUP¶
Lista todos os recursos dentro de um grupo de app.
nbx ops GROUP RESOURCE¶
Mostra todas as operações HTTP (método, caminho, ID da operação) para um recurso específico.
A saída é uma tabela Rich com colunas: Method, Path, Operation ID.
nbx call METHOD PATH¶
Faz uma requisição HTTP explícita a qualquer caminho da API NetBox.
nbx call GET /api/status/
nbx call GET /api/dcim/sites/ --json
nbx call GET /api/dcim/sites/ --markdown
nbx call POST /api/ipam/ip-addresses/ --body-json '{"address":"192.0.2.1/24","status":"active"}'
nbx call PUT /api/dcim/devices/1/ --body-file ./device.json
Opções
| Flag | Descrição |
|---|---|
-q / --query KEY=VALUE |
Parâmetro de query string (repetível) |
--body-json TEXT |
Corpo JSON inline da requisição |
--body-file PATH |
Caminho para arquivo JSON como corpo |
--json |
Saída JSON bruta em vez de tabela Rich |
--yaml |
Saída YAML |
--markdown |
Respostas da API como Markdown com tabelas primeiro |
--json, --yaml e --markdown são mutuamente exclusivos.
nbx graphql QUERY¶
Executa uma consulta GraphQL contra a API NetBox.
# Consulta simples
nbx graphql "{ sites { name } }"
# Consulta com variáveis
nbx graphql "query($id: Int!) { device(id: $id) { name } }" --variables '{"id": 1}'
# Consulta com variáveis key=value
nbx graphql "query($name: String!) { devices(name: $name) { id } }" --variables name=sw01
# Várias variáveis (repita -v / --variables)
nbx graphql "query($a: Int!, $b: Int!) { __typename }" -v a=1 -v b=2
# Saída JSON
nbx graphql "{ sites { name } }" --json
Opções
| Flag | Descrição |
|---|---|
--variables / -v TEXT |
Variáveis GraphQL: um objeto JSON, ou repita para vários pares key=value |
--json |
Saída JSON bruta em vez de tabela formatada |
--yaml |
Saída YAML |
Veja GraphQL para exemplos e orientação focados.
nbx graphql tui¶
Lança o explorador GraphQL interativo dedicado e executor de consultas.
nbx graphql tui
nbx graphql tui --theme dracula
nbx graphql tui --theme
nbx demo graphql tui
nbx demo graphql tui --theme dracula
Esta TUI carrega introspecção de esquema GraphQL da instância NetBox atual, permite navegar campos raiz e seus argumentos, inserir esqueletos de consulta/filtro/paginação no editor e executar consultas GraphQL arbitrárias com variáveis JSON opcionais.
Opções
| Flag | Descrição |
|---|---|
--theme |
Listar temas (sem argumento) ou lançar com nome de tema específico |
Veja GraphQL e TUI GraphQL para o fluxo completo.
nbx tui¶
Lança o navegador Textual interativo principal.
Opções
| Flag | Descrição |
|---|---|
--theme |
Listar temas (sem argumento) ou lançar com nome de tema específico |
Veja Guia da TUI para o fluxo do navegador principal.
nbx logs¶
Imprime logs estruturados recentes da aplicação a partir do arquivo de log compartilhado.
Opções
| Flag | Padrão | Descrição |
|---|---|---|
--limit |
200 |
Número máximo de entradas de log a carregar |
--source |
desligado | Incluir detalhes módulo/função/linha |
Novas instalações gravam logs em ~/.config/netbox-sdk/logs/netbox-sdk.log, com
leituras de compatibilidade de arquivos de log antigos do netbox-cli quando presentes.
Para o visualizador de logs Textual em tela cheia, use nbx tui logs.
nbx dev tui¶
Lança a TUI de bancada de requisições do desenvolvedor contra seu perfil default.
Esta visão é voltada à exploração da API e construção de requisições em vez do fluxo padrão de navegação/resultados.
Quando você lança a mesma visão via nbx demo dev tui, a CLI atualiza automaticamente tokens v1 demo expirados se credenciais demo foram salvas durante nbx demo init.
Opções
| Flag | Descrição |
|---|---|
--theme |
Listar temas (sem argumento) ou lançar com nome de tema específico |
nbx dev http¶
Auxiliares HTTP orientados ao desenvolvedor para explorar caminhos e operações arbitrários da API.
Use nbx dev http --help e os helps dos subcomandos para a matriz completa de opções.
nbx cli tui¶
Lança a TUI de construtor de comandos guiado.
Útil quando você quer explorar a árvore de comandos visualmente e executar um
comando nbx montado sem sair do terminal.
nbx dev django-model¶
Auxiliares para contribuidores: analisar, cachear, buscar e navegar os modelos Django internos do NetBox.
nbx docs generate-capture¶
Gera os artefatos de captura de comandos seguros para documentação usados pelas páginas de referência MkDocs. A geração de documentação só usa o perfil demo e nunca deve rodar contra produção.
Opções
| Flag | Padrão | Descrição |
|---|---|---|
-o / --output |
docs/generated/nbx-command-capture.md |
Caminho de saída Markdown |
--raw-dir |
docs/generated/raw/ |
Diretório para arquivos JSON por comando |
--markdown |
ligado | Anexar --markdown a capturas compatíveis |
-j / --concurrency |
4 |
Número de workers de captura paralelos |
Veja Geração de documentação para o guia completo.