Skip to content

AI Gateway CLI 1.0.0b34 (Public Preview)

Latest

Choose a tag to compare

@paulyuk paulyuk released this 17 Nov 06:32
· 43 commits to main since this release
ea30225

Quickstart | CLI Reference | Documentation

Highlights

  • Default control-plane API version 2026-11-01 with 1-line fallback to 2025-09-01-preview: Switches the default Microsoft.ApiManagement/aigateways ARM api-version to 2026-11-01 and adapts model-provider, model, mcp (including re-fetching ETag after listSecrets before If-Match PATCH writes), telemetry-exporter, and inline requestRateLimit / costLimit policy wire shapes transparently. Standard 1-line fallback to 2025-09-01-preview is supported via export AZURE_AIGATEWAY_API_VERSION=2025-09-01-preview, az config set aigateway.api_version=2025-09-01-preview, or per-command --api-version 2025-09-01-preview.
  • Content Safety policy CLI commands and flags disabled pending 2026-11-01 alignment: Removes unsupported Content Safety policy setters and flags from az aigateway policy and az aigateway model policy while preserving unrecognized server-side policy entries unchanged during read-modify-write policy updates.
  • Multi-target model-alias table output: az aigateway model-alias list -o table and az aigateway model-alias show -o table now render one row per backend target (Name, Gateway, ModelName, Target, Priority, Weight) instead of truncating multi-backend pools to the first target.
  • Actionable @file JSON diagnostics and idempotent policy removal: Malformed @file.json arguments now report the file path, line, column, and JSON parse error directly instead of cascading into shorthand syntax errors, and az aigateway [model] policy remove warns and skips no-op PATCH writes when a requested policy type is not configured on the resource.

Canonical DX

# 1. Create a gateway and configure model policies against 2026-11-01 (default)
az aigateway create -g rg-ai -n gw-01 -l eastus2
az aigateway model policy set \
  -g rg-ai \
  --gateway-name gw-01 \
  --provider-name foundry-eastus2 \
  -n gpt-5-mini \
  --token-limit 50000 --token-period minute \
  --cost-limit 100.50 --cost-period month

# 2. Inspect multi-target alias priorities and weights in table view
az aigateway model-alias list -g rg-ai --gateway-name gw-01 -o table

# 3. Optional 1-line fallback to 2025-09-01-preview
export AZURE_AIGATEWAY_API_VERSION=2025-09-01-preview
# Or persistent CLI config / single-command override:
az config set aigateway.api_version=2025-09-01-preview
az aigateway show -g rg-ai -n gw-01 --api-version 2025-09-01-preview

Install or Upgrade

macOS / Linux / WSL / Cloud Shell (Bash)

curl -fsSL https://raw.githubusercontent.com/Azure/aigateway/main/cli/install.sh | bash

Windows (PowerShell)

irm https://raw.githubusercontent.com/Azure/aigateway/main/cli/install.ps1 | iex

Direct Wheel Install

az extension remove --name aigateway 2>/dev/null || true
az extension add --upgrade --source https://github.com/Azure/aigateway/releases/download/cli-v1.0.0b34/aigateway-1.0.0b34-py3-none-any.whl --yes

Documentation URLs

Release Asset & Checksum