Repository navigation
AI Gateway CLI 1.0.0b30 (Public Preview)
Quickstart | CLI Reference | Documentation
Highlights
- Explicit Foundry provider vs. bulk model import split:
az aigateway model-provider create -g <rg> --gateway-name <gw> [-n <provider-name>] --foundry-resource-id <foundry-arm-id>registers the Foundry model provider resource and configures RBAC without importing model deployments (pass--import-modelsto import deployments duringcreate).az aigateway model-provider import -g <rg> --gateway-name <gw> [-n <provider-name>] --foundry-resource-id <foundry-arm-id>runs the full one-step Foundry onboarding workflow (RBAC role assignment, provider creation/update, and bulk import of all deployed models).- Both
model-provider createandmodel-provider importaccept piped JSON fromaz cognitiveservices account showoraz cognitiveservices account list.
- First-class MCP
--url,--transport, and--namespaceflags + GA bug-bash fixes:az aigateway mcp createandaz aigateway mcp updatenow accept--url,--transport(streamableHttpdefault orsse), and--namespacedirectly without requiring raw--endpointsJSON.- Added pre-flight MCP reachability probing (including HTTP
200,401,403,405, and421 Misdirected Request),--yesconfirmation prompts on destructive commands, and validation improvements.
- Subscription precedence layering (
--subscription):- All
az aigatewaycommands now consistently honor--subscriptionand Azure CLI subscription resolution precedence.
- All
- MCP OAuth
getLoginLinkscontract update:- Updated MCP OAuth login-link requests to the new
scopes+providerscontract with automatic fallback for regions still rolling out.
- Updated MCP OAuth login-link requests to the new
Canonical DX
# Register only the Foundry model-provider resource (no model import)
az aigateway model-provider create \
-g my-rg \
--gateway-name my-gw \
-n foundry-eastus \
--foundry-resource-id "$FOUNDRY_RESOURCE_ID"
# Full Foundry onboarding: RBAC + provider + bulk model import
az aigateway model-provider import \
-g my-rg \
--gateway-name my-gw \
-n foundry-eastus \
--foundry-resource-id "$FOUNDRY_RESOURCE_ID"
# Register a streamable HTTP MCP server with first-class flags
az aigateway mcp create \
-g my-rg \
--gateway-name my-gw \
-n learn \
--url https://learn.microsoft.com/api/mcpInstall or Upgrade
macOS / Linux / WSL / Cloud Shell (Bash)
curl -fsSL https://raw.githubusercontent.com/Azure/aigateway/main/cli/install.sh | bashWindows (PowerShell)
irm https://raw.githubusercontent.com/Azure/aigateway/main/cli/install.ps1 | iexDirect 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.0b30/aigateway-1.0.0b30-py3-none-any.whl --yesDocumentation URLs
- Quickstart & Overview: https://github.com/Azure/aigateway/blob/main/cli/README.md
- Command Reference: https://github.com/Azure/aigateway/blob/main/cli/command-reference.md
- AI Gateway Labs Quickstart: https://github.com/Azure/aigateway/blob/main/labs/quickstart/README.md
Release Asset & Checksum
- Asset:
aigateway-1.0.0b30-py3-none-any.whl - Download URL: https://github.com/Azure/aigateway/releases/download/cli-v1.0.0b30/aigateway-1.0.0b30-py3-none-any.whl
- SHA-256:
b62000e4bdcb99bd812e9da574bb0e44711960d7657a3c4aa16c63455586fd16