1.1.1 - Azure Region

When trying to determine the exact datacenter that you would like to deploy to by name, it can be hard to get up to date information as this rapidly changes. The best way to to do this is to use a tool that actively pulls the most up to date information. Microsoft has done a great job with releasing Azure CLI - and even the AZ Powershell module, these days - on multiple platforms, and both can be installed on Windows, Linux and Mac, as well as directly accessed via the Cloud Shell.

Azure Cloud Shell

One of the great things about Azure is that both of these functions are built in to the Azure Portal - Go Microsoft! By simply clicking the Cloud Shell button just to the right of the search bar in the Azure Portal - and automatically configuring a small amount of storage on the first run - you can select either BASH (Azure CLI) or Powershell (Azure Powershell) and run either of these from within the portal! Sound like too much work? You can just navigate directly to the Cloud Shell.

Azure CLI

Initial Login

If you prefer to use the Cloud Shell, then you can start immediately with the Azure CLI

If you would like to install it locally, please refer to the Microsoft docs here. You'll need to set your subscription for the local installation. It is against this subscription that all commands will be ran:

az login

This will open a browser window where you can provide the credentials for your subscription. This is cached and only needs to be done once.

Identifying Regions

Now we can just dive straight in and get a list of all the locations available to your subscription. In this case, the bit we are interested in is the "Name" field, as that corresponds directly to the value that we require when defining an explicit location within a Blueprint.

az account list-locations -o table

The output looks like this:

DisplayName               Name                 RegionalDisplayName
------------------------  -------------------  -------------------------------------
East US                   eastus               (US) East US
East US 2                 eastus2              (US) East US 2
South Central US          southcentralus       (US) South Central US
West US 2                 westus2              (US) West US 2
Australia East            australiaeast        (Asia Pacific) Australia East
Southeast Asia            southeastasia        (Asia Pacific) Southeast Asia
North Europe              northeurope          (Europe) North Europe
UK South                  uksouth              (Europe) UK South
West Europe               westeurope           (Europe) West Europe
Central US                centralus            (US) Central US
North Central US          northcentralus       (US) North Central US
West US                   westus               (US) West US
South Africa North        southafricanorth     (Africa) South Africa North
Central India             centralindia         (Asia Pacific) Central India
East Asia                 eastasia             (Asia Pacific) East Asia
Japan East                japaneast            (Asia Pacific) Japan East
Korea Central             koreacentral         (Asia Pacific) Korea Central
Canada Central            canadacentral        (Canada) Canada Central
France Central            francecentral        (Europe) France Central
Germany West Central      germanywestcentral   (Europe) Germany West Central
Norway East               norwayeast           (Europe) Norway East
Switzerland North         switzerlandnorth     (Europe) Switzerland North
UAE North                 uaenorth             (Middle East) UAE North
Brazil South              brazilsouth          (South America) Brazil South
Central US (Stage)        centralusstage       (US) Central US (Stage)
East US (Stage)           eastusstage          (US) East US (Stage)
East US 2 (Stage)         eastus2stage         (US) East US 2 (Stage)
North Central US (Stage)  northcentralusstage  (US) North Central US (Stage)
South Central US (Stage)  southcentralusstage  (US) South Central US (Stage)
West US (Stage)           westusstage          (US) West US (Stage)
West US 2 (Stage)         westus2stage         (US) West US 2 (Stage)
Asia                      asia                 Asia
Asia Pacific              asiapacific          Asia Pacific
Australia                 australia            Australia
Brazil                    brazil               Brazil
Canada                    canada               Canada
Europe                    europe               Europe
Global                    global               Global
India                     india                India
Japan                     japan                Japan
United Kingdom            uk                   United Kingdom
United States             unitedstates         United States
East Asia (Stage)         eastasiastage        (Asia Pacific) East Asia (Stage)
Southeast Asia (Stage)    southeastasiastage   (Asia Pacific) Southeast Asia (Stage)
East US 2 EUAP            eastus2euap          (US) East US 2 EUAP
West Central US           westcentralus        (US) West Central US
South Africa West         southafricawest      (Africa) South Africa West
Australia Central         australiacentral     (Asia Pacific) Australia Central
Australia Central 2       australiacentral2    (Asia Pacific) Australia Central 2
Australia Southeast       australiasoutheast   (Asia Pacific) Australia Southeast
Japan West                japanwest            (Asia Pacific) Japan West
Korea South               koreasouth           (Asia Pacific) Korea South
South India               southindia           (Asia Pacific) South India
West India                westindia            (Asia Pacific) West India
Canada East               canadaeast           (Canada) Canada East
France South              francesouth          (Europe) France South
Germany North             germanynorth         (Europe) Germany North
Norway West               norwaywest           (Europe) Norway West
Switzerland West          switzerlandwest      (Europe) Switzerland West
UK West                   ukwest               (Europe) UK West
UAE Central               uaecentral           (Middle East) UAE Central
Brazil Southeast          brazilsoutheast      (South America) Brazil Southeast

It is also possible to export this data as JSON (the default). The example of the JSON output is interesting, as it contains LAT/LONG data. If you were interested in doing this, it would be possible to do some minimal processing to pull the best datacenter based on your exact location. This is outside of the scope of this article, but interesting nonetheless:

{
   "displayName": "Brazil Southeast",
   "id": "/subscriptions/2ce25835-4a5a-4cf0-81fc-c6d7da8db10c/locations/brazilsoutheast",
   "metadata": {
     "geographyGroup": "South America",
     "latitude": "-22.90278",
     "longitude": "-43.2075",
     "pairedRegion": [
       {
         "id": "/subscriptions/2ce25835-4a5a-4cf0-81fc-c6d7da8db10c/locations/brazilsouth",
         "name": "brazilsouth",
         "subscriptionId": null
       }
     ],
     "physicalLocation": "Rio",
     "regionCategory": "Other",
     "regionType": "Physical"
   },
   "name": "brazilsoutheast",
   "regionalDisplayName": "(South America) Brazil Southeast",
   "subscriptionId": null
 }

Azure Powershell

Initial Login

As with Azure CLI, the Azure Powershell module is very simple to use.

Again, if you are working locally you'll need to log in. You can skip this for Cloud Shell.

PS /home/scott> Connect-AzAccount

Connect-AzAccount

On most system, you will then get a pop-up prompting you to log in. This needs to be done once, and is cached.

Identifying Regions

To pull the full table of available datacenters, you can simply run the command:

Get-AzLocation | Sort-Object -Property DisplayName | Format-Table

This outputs:

Location           DisplayName          Providers
--------           -----------          ---------
australiacentral   Australia Central    {Microsoft.Compute, Microsoft.Network, Microsoft.Storage, Microsoft.Web...}
australiacentral2  Australia Central 2  {Microsoft.Network, Microsoft.Security, Microsoft.Cache, Microsoft.ClassicIn...
australiaeast      Australia East       {Microsoft.Compute, Microsoft.Network, Microsoft.Storage, Microsoft.Logic...}
australiasoutheast Australia Southeast  {Microsoft.Compute, Microsoft.Network, Microsoft.ResourceHealth, Microsoft.S...
brazilsouth        Brazil South         {Microsoft.Compute, Microsoft.Network, Microsoft.Storage, Microsoft.Logic...}
brazilsoutheast    Brazil Southeast     {Microsoft.Automation, Microsoft.ContainerRegistry, Microsoft.ContainerServi...
canadacentral      Canada Central       {Microsoft.Compute, Microsoft.Network, Microsoft.Storage, Microsoft.Logic...}
canadaeast         Canada East          {Microsoft.Compute, Microsoft.Network, Microsoft.Storage, Microsoft.Logic...}
centralindia       Central India        {Microsoft.Compute, Microsoft.Network, Microsoft.Storage, Microsoft.Logic...}
centralus          Central US           {Microsoft.Compute, Microsoft.Network, Microsoft.Storage, Microsoft.Logic...}
eastasia           East Asia            {Microsoft.Compute, Microsoft.Network, Microsoft.Storage, Microsoft.Logic...}
eastus             East US              {Microsoft.Compute, Microsoft.Network, Microsoft.Storage, Microsoft.Logic...}
eastus2            East US 2            {Microsoft.Compute, Microsoft.Network, Microsoft.Storage, Microsoft.Logic...}
francecentral      France Central       {Microsoft.Compute, Microsoft.Network, Microsoft.Storage, Microsoft.Logic...}
francesouth        France South         {Microsoft.Network, Microsoft.Logic, Microsoft.Web, Microsoft.Security...}
germanynorth       Germany North        {Microsoft.Network, Microsoft.Logic, Microsoft.Web, Microsoft.Security...}
germanywestcentral Germany West Central {Microsoft.Compute, Microsoft.Network, Microsoft.Storage, Microsoft.Logic...}
japaneast          Japan East           {Microsoft.Compute, Microsoft.Network, Microsoft.Storage, Microsoft.Logic...}
japanwest          Japan West           {Microsoft.Compute, Microsoft.Network, Microsoft.Storage, Microsoft.Logic...}
koreacentral       Korea Central        {Microsoft.Compute, Microsoft.Network, Microsoft.Storage, Microsoft.Logic...}
koreasouth         Korea South          {Microsoft.Compute, Microsoft.Network, Microsoft.Storage, Microsoft.Logic...}
northcentralus     North Central US     {Microsoft.Compute, Microsoft.Network, Microsoft.Storage, Microsoft.Logic...}
northeurope        North Europe         {Microsoft.Compute, Microsoft.Network, Microsoft.Storage, Microsoft.Logic...}
norwayeast         Norway East          {Microsoft.Compute, Microsoft.Network, Microsoft.Storage, Microsoft.Logic...}
norwaywest         Norway West          {Microsoft.Network, Microsoft.Web, Microsoft.Security, Microsoft.Cache...}
southafricanorth   South Africa North   {Microsoft.Compute, Microsoft.Network, Microsoft.Storage, Microsoft.Logic...}
southafricawest    South Africa West    {Microsoft.Network, Microsoft.Logic, Microsoft.Web, Microsoft.ManagedIdentit...
southcentralus     South Central US     {Microsoft.Compute, Microsoft.Network, Microsoft.Storage, Microsoft.Logic...}
southindia         South India          {Microsoft.Compute, Microsoft.Network, Microsoft.Storage, Microsoft.Logic...}
southeastasia      Southeast Asia       {Microsoft.Compute, Microsoft.Network, Microsoft.Storage, Microsoft.Logic...}
switzerlandnorth   Switzerland North    {Microsoft.Compute, Microsoft.Network, Microsoft.Storage, Microsoft.Logic...}
switzerlandwest    Switzerland West     {Microsoft.Network, Microsoft.Security, Microsoft.Cache, Microsoft.ClassicIn...
uaecentral         UAE Central          {Microsoft.Network, Microsoft.Logic, Microsoft.Web, Microsoft.Security...}
uaenorth           UAE North            {Microsoft.Compute, Microsoft.Network, Microsoft.Storage, Microsoft.Web...}
uksouth            UK South             {Microsoft.Compute, Microsoft.Network, Microsoft.Storage, Microsoft.Logic...}
ukwest             UK West              {Microsoft.Compute, Microsoft.Network, Microsoft.Storage, Microsoft.Logic...}
westcentralus      West Central US      {Microsoft.Compute, Microsoft.Network, Microsoft.Storage, Microsoft.Logic...}
westeurope         West Europe          {Microsoft.Compute, Microsoft.Network, Microsoft.Storage, Microsoft.Logic...}
westindia          West India           {Microsoft.Compute, Microsoft.Network, Microsoft.Storage, Microsoft.Logic...}
westus             West US              {Microsoft.Compute, Microsoft.Network, Microsoft.Storage, Microsoft.Logic...}
westus2            West US 2            {Microsoft.Compute, Microsoft.Network, Microsoft.Storage, Microsoft.Logic...}

Now you have your region name, you can add it to the Blueprint. To do that, see here.

Last updated

Was this helpful?