Lit les réseaux et les équipements d'une organisation Meraki et liste les firmwares qui ne sont pas celui voulu.
Ce programme lit les réseaux et les équipements d'une organisation Meraki par l'API du
Dashboard. Il affiche les équipements sous forme de tableau, les compte par modèle, et liste
les équipements qui n'utilisent pas le firmware que vous voulez pour leur famille de produits.
Chaque requête est une lecture.
Exécutez-le depuis ce dossier, sur les réponses enregistrées dans saved :
bogo run --replay saved meraki_inventory.bogo
bogo test meraki_inventory.bogo
Avec --replay saved, rien n'est contacté et aucune clé d'API n'est nécessaire. Les réponses
enregistrées ont été écrites à la main. L'organisation, les noms, les numéros de série et les
adresses sont inventés.
Pour l'utiliser sur votre propre organisation :
Enregistrez votre clé d'API une fois : bogo login --api meraki.
Réglez org sur le nom ou le numéro de votre organisation, et wanted sur votre propre
référence de firmware.
Exécutez-le sans --replay. Il se connecte alors vraiment au cloud Meraki. Ajoutez
--save-replay saved pour garder les réponses pour un rejeu ultérieur.
meraki_inventory.bogo
edition2027"""The devices of one Meraki organisation, and those not on the firmware we want."""classMerakiInventory:
"""Reads the networks and devices of an organisation through the Dashboard API.
Every request is a read. The API key is the token stored under the name "meraki"
with `bogo login --api meraki`; it is never printed.
"""
org = "Example Org"# the firmware each product family should run; change to your own baseline
wanted: dict[str, str] = {"MX": "MX 18.211.2", "MS": "MS 17.1.4", "MR": "MR 31.1.6"}
@staticmethoddef family(model: str) -> str:
return model[:2].upper()
@staticmethoddef behind(devices: list[Row], wanted: dict[str, str]) -> list[Row]:
"""The devices whose family has a wanted firmware and that run another one."""
out: list[Row] = []
for d in devices:
want = wanted.get(MerakiInventory.family(d.model))
if want isnotNoneand d.firmware != want:
out.append(d)
return out
@staticmethoddef per_model(devices: list[Row]) -> dict[str, int]:
count: dict[str, int] = {}
for d in devices:
count[d.model] = count.get(d.model, 0) + 1return dict(sorted(count.items()))
@staticmethoddef main(args: list[str]) -> None:
m = meraki(org=MerakiInventory.org)
networks = {n.id: n.name for n in m.networks()}
devices = m.devices()
print(f"{m.org_name} ({m.org_id}): {len(networks)} networks, {len(devices)} devices")
print()
table(devices, ["name", "model", "serial", "lanIp", "firmware"])
print()
for model, n inMerakiInventory.per_model(devices).items():
print(f"{n:3} {model}")
print()
late = MerakiInventory.behind(devices, MerakiInventory.wanted)
for d in late:
want = MerakiInventory.wanted[MerakiInventory.family(d.model)]
print(
f"Behind: {d.name} in {networks.get(d.networkId, '?')} runs {d.firmware}, wanted {want}"
)
print(f"{len(late)} of {len(devices)} devices are not on the wanted firmware.")
classTestMerakiInventory:
def test_family_of_a_model(self) -> None:
assertMerakiInventory.family("MS225-48LP") == "MS"assertMerakiInventory.family("mr46") == "MR"def test_behind_skips_matching_and_unknown_families(self) -> None:
devices = [
Row({"name": "a", "model": "MX68", "firmware": "MX 18.211.2"}),
Row({"name": "b", "model": "MR36", "firmware": "MR 30.7"}),
Row({"name": "c", "model": "MG21", "firmware": "MG 1.0"}),
]
late = MerakiInventory.behind(devices, MerakiInventory.wanted)
assert [d.name for d in late] == ["b"]
def test_per_model_counts(self) -> None:
devices = [Row({"model": "MR46"}), Row({"model": "MX85"}), Row({"model": "MR46"})]
assertMerakiInventory.per_model(devices) == {"MR46": 2, "MX85": 1}