Automatiser NetBox par l'API

$api=https://netbox.example.com/api
$auth="Authorization: Token ${NETBOX_TOKEN}"
$curl -sk -H "$auth" -H 'Content-Type: application/json' "$api/users/users/" \
$  -d "{\"username\": \"netbox-automation\", \"password\": \"$(openssl rand -base64 24)\"}"

import re
import pynetbox
nb = pynetbox.api("https://netbox.example.com", token="${AUTOMATION_TOKEN}")
for site in nb.dcim.sites.all():
    print(site.id, site.name, site.status)
slug = re.sub(r"[^a-z0-9]+", "-", "Paris DC1".lower()).strip("-")
site = nb.dcim.sites.get(slug=slug)
if site is None:
    site = nb.dcim.sites.create(name="Paris DC1", slug=slug, status="active")
    print("created", site.name)
elif site.update({"description": "managed by netbox-automation"}):
    print("updated", site.name)
else:
    print("unchanged", site.name)

import re
import pynetbox
nb = pynetbox.api("https://netbox.example.com", token="${AUTOMATION_TOKEN}")
slug = lambda s: re.sub(r"[^a-z0-9]+", "-", s.lower()).strip("-")
def ensure(endpoint, lookup, **fields):
    """Cherche par champs uniques, sinon crée. Relançable sans risque."""
    obj = endpoint.get(**lookup)
    return obj if obj is not None else endpoint.create(**fields)
site = ensure(nb.dcim.sites, {"slug": slug("Paris DC1")},
              name="Paris DC1", slug=slug("Paris DC1"), status="active")
mfr = ensure(nb.dcim.manufacturers, {"slug": "generic"}, name="Generic", slug="generic")
dtype = ensure(nb.dcim.device_types, {"slug": "generic-48p"},
               manufacturer=mfr.id, model="Generic 48-port switch", slug="generic-48p")
role = ensure(nb.dcim.device_roles, {"slug": "access-switch"},
              name="Access switch", slug="access-switch", color="2196f3")
dev = ensure(nb.dcim.devices, {"name": "sw-01", "site_id": site.id},
             name="sw-01", site=site.id, role=role.id, device_type=dtype.id, status="active")
iface = ensure(nb.dcim.interfaces, {"device_id": dev.id, "name": "Ethernet1"},
               device=dev.id, name="Ethernet1", type="1000base-t")
ip = ensure(nb.ipam.ip_addresses, {"address": "192.0.2.11/24"},
            address="192.0.2.11/24", status="active",
            assigned_object_type="dcim.interface", assigned_object_id=iface.id)
if dev.primary_ip4 is None or dev.primary_ip4.id != ip.id:
    dev.update({"primary_ip4": ip.id})
print("ok:", dev.name, "at", site.name, "primary", ip.address)

import csv
import pynetbox
nb = pynetbox.api("https://netbox.example.com", token="${AUTOMATION_TOKEN}")
created = skipped = failed = 0
with open("devices.csv", newline="") as f:
    for row in csv.DictReader(f):
        if nb.dcim.devices.get(name=row["name"], site=row["site"]) is not None:
            skipped += 1
            continue
        try:
            nb.dcim.devices.create(
                name=row["name"], status=row["status"],
                site={"slug": row["site"]}, role={"slug": row["role"]},
                device_type={"slug": row["device_type"]},
            )
            created += 1
        except pynetbox.RequestError as e:
            failed += 1
            print(f"FAILED {row['name']}: {e.error}")
print(f"created {created}, skipped {skipped}, failed {failed}")

$api=https://netbox.example.com/api
$auth="Authorization: Token ${NETBOX_TOKEN}"
$curl -sk -H "$auth" -H 'Content-Type: application/json' "$api/extras/webhooks/" -d '{
$  "name": "device-changes", "payload_url": "http://203.0.113.50:9000/netbox",
$  "http_method": "POST", "http_content_type": "application/json"
$}'

$python -c 'import pynetbox; nb = pynetbox.api("https://netbox.example.com", token="${AUTOMATION_TOKEN}"); nb.dcim.devices.get(name="sw-01").update({"description": "hello webhook"})'

$api=https://netbox.example.com/api
$auth="Authorization: Token ${NETBOX_TOKEN}"
$curl -sk -H "$auth" "$api/extras/scripts/" | python3 -m json.tool | grep -E '"(id|name)"'