kaioguilherme1 / netbox-client Goto Github PK

1.0 1.0 0.0 237 KB

O NetboxCli é um pacote Python projetado para simplificar e agilizar a interação com o NetBox, uma popular plataforma de gerenciamento de infraestrutura de rede de código aberto. Com este pacote, você pode facilmente interagir com as funcionalidades do NetBox.

Home Page: https://netboxcli.readthedocs.io/pt/latest/

License: MIT License

Python 100.00%

agent client hacktoberfest2024 lib netbox netbox-api python3

netbox-client's Introduction

Netbox Client

Índice

Netbox Client
📄Dependências
🔧Instalação
🚀 Getting Started
📝Documentação
⚙️Uso
📦Desenvolvimento
📌Versão
👥Colaboradores
✒️Autores
📑Licença

Documentação Disponível aqui

📄 Dependências

Lista as dependencias

requests
python 3.12 ou superior
netbox >=3.7.5

🔧 Instalação

pip install netboxcli

⚙️ uso

Importando o Módulo e Preparando a Conexão

Antes de começar a interagir com o NetBox, você precisa importar o módulo netboxcli e criar um objeto NetBox para estabelecer a conexão com o servidor. Substitua 'sua_url_aqui' pelo endereço IP e porta do seu servidor NetBox e 'seu_token_aqui' pelo seu token de API.

import netboxcli as nb
import json

def printj(data):
    print(json.dumps(data, indent=4))

# Criar um objeto NetBox
nb_client = nb.Client('sua_url_aqui', 'seu_token_aqui')

Utilizando Classes Finais Padrão

Todas as classes finais no NetboxCli têm os mesmos nomes que as classes do NetBox por padrão. Isso facilita a navegação e a familiarização com a estrutura. Aqui estão alguns exemplos de como você pode usar essas classes e seus métodos padronizados:

Exemplo de IPAM: Criar um Novo Bloco de Endereços IP

# Exemplo de criação de um novo bloco de endereços IP
ip_block_data = {
    "prefix": "192.168.10.0/24",
    "description": "Bloco de IPs para Servidores",
    "vlan": 100
}

new_ip_block = nb_client.ipam.prefixes.create(ip_block_data)

Exemplo de Virtualização: Obter uma Máquina Virtual por ID

# Exemplo de obtenção de uma máquina virtual por ID
vm_by_id = nb_client.virtualization.virtual_machines.get(id=1)

Exemplo de IPAM: Atualizar um Bloco de Endereços IP

# Exemplo de atualização de um bloco de endereços IP
updated_ip_block_data = {
    "id": 1,
    "description": "Novo Descrição para o Bloco de IPs"
}

updated_ip_block = nb_client.ipam.prefixes.update(updated_ip_block_data)

Exemplo de Virtualização: Excluir uma Máquina Virtual

# Exemplo de exclusão de uma máquina virtual pelo ID
deleted_vm_id = nb_client.virtualization.virtual_machines.delete(id=1)

para mais exemplos de uso acesse a documentação

Personalizando e Extendendo

Além das operações básicas, você pode personalizar e estender as funcionalidades do NetboxCli de acordo com suas necessidades específicas. As classes finais oferecem uma base sólida para construir interações mais avançadas com a API do NetBox.

Lembre-se de substituir os exemplos de dados e IDs pelos valores reais correspondentes ao seu ambiente NetBox.

Objetivo

O objetivo do projeto NetboxCli é fornecer uma interface Python simples e eficiente para interagir com o NetBox. oferecendo uma alternativa conveniente para os administradores de rede que desejam automatizar tarefas e gerenciar recursos de infraestrutura de maneira mais fácil.

Checklist de Desenvolvimento

Aqui está um checklist do que está atualmente disponível no NetboxCli e do que será adicionado no futuro:

Este checklist será atualizado à medida que novas funcionalidades forem implementadas. Agradecemos por seu interesse e paciência enquanto trabalhamos para tornar o NetboxCli mais abrangente e útil para suas necessidades de automação e gerenciamento de rede.

📌 Versão 1.2.0

Adições na Versão 1.2.0

Criação de nova feature: Criação de nova funcionalidade no metodo get que permite passar querys ultilizadas na pagína de filtro

✒️ Autores

developer - Initial Work - Kaio Guilherme

📑 Licença

Esse projeto esta sob a licença(MIT) - veja o arquivo Licenca.md para mais detalhes.

Recommend Projects