azure-subscription-context

Azure Subscription Context

Category: Azure Time Saved: 30 minutes - 1 hour debugging Battle-tested: Yes — affects nearly every Azure CLI session

---

The Problem

Your Azure CLI command returns empty results, "resource not found", or creates resources in the wrong location. The command syntax is correct. The resource exists. You can see it in the portal.

Why It Happens

Azure CLI commands run against the currently active subscription. If you have multiple subscriptions (personal, work, client projects), you're probably in the wrong one.

The Rule

Always verify subscription context with az account show before running commands.

# FIRST command in any Azure session
az account show --query "{name:name, id:id}" -o table

Quick Reference

Check Current Context

# Show current subscription
az account show

# Just the name and ID
az account show --query "{name:name, id:id}" -o table

List All Subscriptions

# See all subscriptions you have access to
az account list --query "[].{name:name, id:id, isDefault:isDefault}" -o table

Switch Subscription

# By name
az account set --subscription "My Subscription Name"

# By ID (more reliable if names have spaces)
az account set --subscription "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"

Verification Pattern

Before running any destructive or expensive command:

# 1. Verify context
az account show --query name -o tsv
# Expected: "Production Subscription"

# 2. Then run your command
az group create --name mygroup --location eastus

Per-Command Override

You can specify subscription per-command without changing default:

# Query specific subscription
az vm list --subscription "Dev Subscription"

# Create in specific subscription
az group create \
  --name mygroup \
  --location eastus \
  --subscription "Production Subscription"

Common Symptoms

Symptom	Likely Cause
Empty results from az resource list	Wrong subscription
"Resource not found"	Resource is in different subscription
Resource created in wrong subscription	Default subscription is wrong
"You do not have access"	Subscription requires re-auth or different account