Automatisierung und Skripterstellung in Mist

2. Automationsmodell

Mist ist laut Juniper API-driven. Technische Automatisierbarkeit ersetzt aber keine Scope-, Risiko- und Wirkungsprüfung.

3. Werkzeugvergleich

4. Objekt- und Scope-Modell

7. REST und HTTP

https://API_HOST/api/v1/sites/SITE_ID/stats/devices/DEVICE_ID

Partieller oder vollständiger Update ergibt sich aus der jeweiligen API-Referenz, nicht allein aus der Methode.

8. cURL-Grundmuster

export MIST_API_HOST="api.eu.mist.com"
export MIST_ORG_ID="00000000-0000-0000-0000-000000000000"

curl --fail-with-body --silent --show-error \
  --connect-timeout 5 --max-time 30 \
  -H "Authorization: Token $MIST_APITOKEN" \
  -H "Accept: application/json" \
  "https://$MIST_API_HOST/api/v1/orgs/$MIST_ORG_ID/sites?limit=1000"

Das Beispiel enthält Platzhalter. Endpoint und Schema werden vor Nutzung in der aktuellen Referenz geprüft.

9. Robuster Python-Basisklient

import os, random, time, requests

base = "https://" + os.environ["MIST_API_HOST"] + "/api/v1"
session = requests.Session()
session.headers.update({
    "Authorization": "Token " + os.environ["MIST_APITOKEN"],
    "Accept": "application/json",
    "Content-Type": "application/json",
    "User-Agent": "mist-automation/1.0"
})

def api(method, path, **kwargs):
    for attempt in range(5):
        r = session.request(method, base + path, timeout=(5, 30), **kwargs)
        if r.status_code == 429:
            time.sleep(int(r.headers.get("Retry-After", "60")) + random.random())
            continue
        if 500 <= r.status_code < 600:
            time.sleep(min(2 ** attempt + random.random(), 30))
            continue
        r.raise_for_status()
        return r
    raise RuntimeError("request failed after retries")

Write-Retries brauchen Fachlogik gegen Doppelwirkung. Nach einem Timeout wird zuerst der Istzustand gelesen.

11. Pagination vollständig lesen

def get_all(path, limit=1000):
    page, result = 1, []
    while True:
        r = api("GET", path, params={"limit": limit, "page": page})
        body = r.json()
        batch = body if isinstance(body, list) else body.get("results", [])
        if not isinstance(batch, list):
            raise TypeError("unexpected response schema")
        result.extend(batch)
        total = int(r.headers.get("X-Page-Total", len(result)))
        if not batch or len(result) >= total or len(batch) < limit:
            return result
        page += 1

Juniper nennt häufig 100 als Default und 1000 als Maximum. Manche Endpoints nutzen einen next-Verweis. Der konkrete Endpoint entscheidet.

12. Rate Limit und Backoff

Juniper dokumentiert derzeit 5.000 Calls je Stunde. Der Login-Endpoint wird nach wenigen Fehlversuchen früher begrenzt.

• Org-Level statt vieler Site-Abfragen
• Webhook statt Event-Polling
• stabile Referenzdaten cachen
• Retry-After und Jitter respektieren
• Parallelität begrenzen

14. Reconciliation Loop

desired = load_and_validate("desired/site.json")
current = read_current(desired["id"])
diff = normalized_diff(current, desired)

if not diff:
    print("NOOP")
elif dry_run:
    print_plan(diff)
else:
    require_approval(diff)
    backup(current)
    apply(build_write_payload(desired))
    verify(desired)

15. Bulk und Parallelität

16. Webhooks

Org- und Site-Webhooks liefern unter anderem Alarme, Device Events oder Location-Daten. Kritische Workflows werden entkoppelt.

17. Produktionsreifer Receiver

def receive(request):
    raw = request.get_data(cache=False)
    verify_source_and_secret(request.headers, raw)
    event = validate_event(raw)
    key = stable_event_key(event)
    if not store.seen(key):
        queue.publish({"key": key, "event": event})
        store.mark_seen(key)
    return "", 204

• schnell bestätigen, asynchron arbeiten
• Duplikate und Reihenfolge tolerieren
• Payloadgröße und Schema begrenzen
• Dead Letter Queue und Replay
• keine Produktivdaten an öffentliche Tester

18. WebSockets

wss://api-ws.eu.mist.com/api-ws/v1/stream
{"subscribe": "/sites/SITE_ID/pcaps"}

Use Cases: Live-Dashboard, BLE, Device-Statistiken und PCAP-Streaming.

19. Terraform Provider

terraform {
  required_providers {
    mist = {
      source  = "Juniper/mist"
      version = "~> 0.9"
    }
  }
}
provider "mist" { host = var.mist_api_host }

resource "mist_site" "berlin" {
  org_id       = var.org_id
  name         = "DE-BER-01"
  country_code = "DE"
  timezone     = "Europe/Berlin"
}

26. Use Cases