Examples

📋 List Azure Subscriptions

The simplest API call — list all subscriptions available to your account.

azd rest get https://management.azure.com/subscriptions?api-version=2020-01-01

With pagination to get all results:

azd rest get https://management.azure.com/subscriptions?api-version=2020-01-01 --paginate

🗂️ Manage Resource Groups

Create, list, and manage Azure resource groups.

List Resource Groups

azd rest get https://management.azure.com/subscriptions/{subscriptionId}/resourcegroups?api-version=2021-04-01

Create a Resource Group

azd rest put https://management.azure.com/subscriptions/{subscriptionId}/resourcegroups/my-rg?api-version=2021-04-01 \
  --data '{"location":"eastus","tags":{"environment":"dev"}}'

Delete a Resource Group

azd rest delete https://management.azure.com/subscriptions/{subscriptionId}/resourcegroups/my-rg?api-version=2021-04-01

💾 Create a Storage Account

Provision Azure Storage with a POST request and JSON body.

Inline JSON

azd rest put https://management.azure.com/subscriptions/{sub}/resourceGroups/{rg}/providers/Microsoft.Storage/storageAccounts/{name}?api-version=2021-04-01 \
  --data '{"location":"eastus","kind":"StorageV2","sku":{"name":"Standard_LRS"}}'

From File

# storage-account.json
# {"location":"eastus","kind":"StorageV2","sku":{"name":"Standard_LRS"}}

azd rest put https://management.azure.com/subscriptions/{sub}/resourceGroups/{rg}/providers/Microsoft.Storage/storageAccounts/{name}?api-version=2021-04-01 \
  --data-file storage-account.json

🔐 Key Vault Secrets

Read and manage secrets in Azure Key Vault — scope is auto-detected.

Get a Secret

azd rest get https://myvault.vault.azure.net/secrets/mysecret?api-version=7.4

List All Secrets

azd rest get https://myvault.vault.azure.net/secrets?api-version=7.4

Set a Secret

azd rest put https://myvault.vault.azure.net/secrets/newsecret?api-version=7.4 \
  --data '{"value":"my-secret-value"}'

👤 Microsoft Graph

Query Microsoft Graph API for user and organization data.

Get Current User

azd rest get https://graph.microsoft.com/v1.0/me

List Groups

azd rest get https://graph.microsoft.com/v1.0/groups

List Applications

azd rest get https://graph.microsoft.com/v1.0/applications

📊 Verbose Diagnostics

Debug requests with verbose output showing headers, timing, and token info (redacted).

azd rest get https://management.azure.com/subscriptions?api-version=2020-01-01 --verbose

Example output:

> GET https://management.azure.com/subscriptions?api-version=2020-01-01
> Authorization: Bearer ***REDACTED***
> Accept: application/json
>
< 200 OK
< Content-Type: application/json
< Content-Length: 1234
<
Request completed in 234ms
{
  "value": [...]
}

📁 Save & Format Responses

Control output format and save responses to files.

Save to File

azd rest get https://management.azure.com/subscriptions?api-version=2020-01-01 \
  --output-file subscriptions.json

Compact JSON

azd rest get https://management.azure.com/subscriptions?api-version=2020-01-01 --format json

Raw Output

azd rest get https://api.example.com/data --format raw --no-auth

Binary Download

azd rest get https://example.com/image.png --binary --output-file image.png --no-auth

🔄 Pagination & Retries

Handle large result sets and transient failures automatically.

Auto Pagination

# Follow nextLink headers to get all results
azd rest get https://management.azure.com/subscriptions/{sub}/resources?api-version=2021-04-01 --paginate

Custom Retry Count

# Retry up to 5 times on transient errors
azd rest get https://management.azure.com/subscriptions?api-version=2020-01-01 --retry 5

Disable Retries

azd rest get https://management.azure.com/subscriptions?api-version=2020-01-01 --retry 0

🌐 Public APIs (No Auth)

Call non-Azure endpoints by disabling authentication.

# GitHub API
azd rest get https://api.github.com/repos/Azure/azure-dev --no-auth

# Any public REST API
azd rest get https://jsonplaceholder.typicode.com/posts/1 --no-auth