az-mapping 2026.2.2

Interactive web tool to visualize Azure Availability Zone logical-to-physical mappings across subscriptions

az-mapping

Visualize how Azure maps logical Availability Zones to physical zones across your subscriptions.

Different subscriptions may map the same logical zone (e.g. Zone 1) to different physical datacenters. This tool lets you compare them side-by-side.

Quick start

# Make sure you are authenticated to Azure
az login

# Run the tool (no install required)
uvx az-mapping

Your browser opens automatically at http://127.0.0.1:5001.

CLI options

az-mapping [OPTIONS]

  --host TEXT     Host to bind to.  [default: 127.0.0.1]
  --port INTEGER  Port to listen on.  [default: 5001]
  --no-open       Don't open the browser automatically.
  -v, --verbose   Enable verbose logging.
  --help          Show this message and exit.

Alternative install

pip install az-mapping
az-mapping

Prerequisites

Requirement	Details
Python	≥ 3.11
Azure credentials	Any method supported by DefaultAzureCredential (az login, managed identity, …)
RBAC	Reader on the subscriptions you want to query

Features

• Region selector – AZ-enabled regions, loaded automatically.
• Subscription picker – searchable, multi-select.
• Collapsible sidebar – toggle the filter panel to maximize the results area.
• Graph view – D3.js bipartite diagram (Logical Zone → Physical Zone), colour-coded per subscription with interactive hover highlighting.
• Table view – comparison table with consistency indicators.
• SKU availability view – shows VM SKU availability per physical zone with filtering and CSV export.
• Export – download the graph as PNG or the tables as CSV.
• Shareable URLs – filters are reflected in the URL; reload or share a link to restore the exact view.

How it works

The backend calls the Azure Resource Manager REST API to fetch:

• Zone mappings: availabilityZoneMappings from /subscriptions/{id}/locations endpoint
• Resource SKUs: SKU details from /subscriptions/{id}/providers/Microsoft.Compute/skus endpoint with zone restrictions and capabilities

The frontend renders the results as an interactive graph, comparison table, and SKU availability table.

License

MIT