Skip to content

Latest commit

 

History

History
133 lines (98 loc) · 5.45 KB

az-select.md

File metadata and controls

133 lines (98 loc) · 5.45 KB
Raw

az select

The idea of az select is to select the prefix of an Azure resource ID, so that parameters like --resource-group, --account-name, --vnet-name can be automatically populated.

For instance, with prefix /subscriptions/0b1f6471-1bf0-4dda-aec3-cb9272f09590/resourceGroups/rg1/providers/Microsoft.Network/virtualNetworks/vnet1,

  • --resource-group will be populated as rg1
  • --vnet-name will be populated as vnet1

It can be considered as a manual alternative to az local-context. Difference:

  • az local-context focuses on individual argument context, like --resource-group, --vnet-name
  • az select focuses on resource ID context as a whole, like /subscriptions/0b1f6471-1bf0-4dda-aec3-cb9272f09590/resourceGroups/rg1 and leaves the parsing from resource ID to arguments to the commands
    • It has good compatibility with resource ID argument (as shown below) and JSON output passing which also focuses on resource ID

Select a resource group

# Select by resource group name
> az group select --name rg1
WARNING: Switched to /subscriptions/0b1f6471-1bf0-4dda-aec3-cb9272f09590/resourceGroups/rg1

# Select by resource ID
> az select --id /subscriptions/0b1f6471-1bf0-4dda-aec3-cb9272f09590/resourceGroups/rg1
WARNING: Switched to /subscriptions/0b1f6471-1bf0-4dda-aec3-cb9272f09590/resourceGroups/rg1

# Select by resource JSON
# $rg is the result of `az group create` or `az group show`
> az select --json "$rg"
WARNING: Switched to /subscriptions/0b1f6471-1bf0-4dda-aec3-cb9272f09590/resourceGroups/rg1

Create a resource

Creating a resource doesn't by default switch the prefix, it is still /subscriptions/0b1f6471-1bf0-4dda-aec3-cb9272f09590/resourceGroups/rg1.

--resource-group will be automatically populated from the selected prefix as rg1.

> az network vnet create --name vnet1
{
    "id": "/subscriptions/0b1f6471-1bf0-4dda-aec3-cb9272f09590/resourceGroups/rg1/providers/Microsoft.Network/virtualNetworks/vnet1",
    "name": "vnet1",
    ...
}
WARNING: To create sub-resources within this vnet, you may want to run `az network vnet select --name vnet1`

# Without prefix
> az network vnet create --resource-group rg1
                         --name vnet1

# Without prefix, use resource group id (not supported yet, only a proposal)
> az network vnet create --resource-group /subscriptions/0b1f6471-1bf0-4dda-aec3-cb9272f09590/resourceGroups/rg1
                         --name vnet1

# Without prefix, use resource group JSON (not supported yet, only a proposal)
> az network vnet create --resource-group "$rg"
                         --name vnet1

Select a resource

# Select by name, depending on the current prefix
> az network vnet select --name vnet1
WARNING: Switched to /subscriptions/0b1f6471-1bf0-4dda-aec3-cb9272f09590/resourceGroups/rg1/providers/Microsoft.Network/virtualNetworks/vnet1

# Select by absolute path
> az network vnet select --resource-group rg1
                         --name vnet1
WARNING: Switched to /subscriptions/0b1f6471-1bf0-4dda-aec3-cb9272f09590/resourceGroups/rg1/providers/Microsoft.Network/virtualNetworks/vnet1

# Select by resource ID
> az select --id /subscriptions/0b1f6471-1bf0-4dda-aec3-cb9272f09590/resourceGroups/rg1/providers/Microsoft.Network/virtualNetworks/vnet1
WARNING: Switched to /subscriptions/0b1f6471-1bf0-4dda-aec3-cb9272f09590/resourceGroups/rg1/providers/Microsoft.Network/virtualNetworks/vnet1

# Select by resource JSON
# $vnet is the result of `az vnet create` or `az vnet show`
> az select --json "$vnet"
WARNING: Switched to /subscriptions/0b1f6471-1bf0-4dda-aec3-cb9272f09590/resourceGroups/rg1/providers/Microsoft.Network/virtualNetworks/vnet1

Create a sub-resource

Creating a sub-resource doesn't by default switch the prefix either. It is still /subscriptions/0b1f6471-1bf0-4dda-aec3-cb9272f09590/resourceGroups/rg1/providers/Microsoft.Network/virtualNetworks/vnet1.

--resource-group will be automatically populated from the selected prefix as rg1. --vnet-name will be automatically populated from the selected prefix as vnet1.

> az network vnet subnet create --name subnet1
{
    "id": "/subscriptions/0b1f6471-1bf0-4dda-aec3-cb9272f09590/resourceGroups/rg1/providers/Microsoft.Network/virtualNetworks/vnet1/subnets/subnet1",
    "name": "subnet1"
}

# Without prefix
> az network vnet subnet create --resource-group rg1
                                --vnet-name vnet1
                                --name subnet1

# Without prefix, use vnet id (not supported yet, only a proposal)
> az network vnet subnet create --vnet /subscriptions/0b1f6471-1bf0-4dda-aec3-cb9272f09590/resourceGroups/rg1/providers/Microsoft.Network/virtualNetworks/vnet1
                                --name subnet1

# Without prefix, use vnet JSON (not supported yet, only a proposal)
> az network vnet subnet create --vnet "$vnet"
                                --name subnet1

Show the selected prefix

> az select show
/subscriptions/0b1f6471-1bf0-4dda-aec3-cb9272f09590/resourceGroups/rg1/providers/Microsoft.Network/virtualNetworks/vnet1

Go up

> az select up
WARNING: Switched to /subscriptions/0b1f6471-1bf0-4dda-aec3-cb9272f09590/resourceGroups/rg1

> az select up
WARNING: Switched to /subscriptions/0b1f6471-1bf0-4dda-aec3-cb9272f09590

Clear

Go back to /subscriptions (root). This may switch to /tenant in the future.

> az select clear
WARNING: Switched to /subscriptions/0b1f6471-1bf0-4dda-aec3-cb9272f09590