Request access to an Azure Extended Zone

Important

Azure Extended Zones service is currently in PREVIEW. See the Supplemental Terms of Use for Microsoft Azure Previews for legal terms that apply to Azure features that are in beta, preview, or otherwise not yet released into general availability.

To create Azure resources in Azure Extended Zone locations, you need to explicitly register your subscription with the respective Azure Extended Zone, using an account that is a subscription owner, as this capability isn't enabled by default. Once the subscription is registered with the Azure Extended Zone, you can create and manage resources within that specific Azure Extended Zone.

In this article, you learn how to request and gain access to an Azure Extended Zone using PowerShell or Azure CLI.

Prerequisites

PowerShell

• An Azure account with an active subscription. Create an account for free.

• Azure Cloud Shell or Azure PowerShell.

  The steps in this article run the Azure PowerShell cmdlets interactively in Azure Cloud Shell. To run the cmdlets in the Cloud Shell, select Open Cloud Shell at the upper-right corner of a code block. Select Copy to copy the code and then paste it into Cloud Shell to run it. You can also run the Cloud Shell from within the Azure portal.

  You can also install Azure PowerShell locally to run the cmdlets. This article requires the Az.EdgeZones module version 0.1.0 or later. Run Get-Module -ListAvailable Az.EdgeZones cmdlet to find the installed version. Run Install-Module Az.EdgeZones cmdlet to install Az.EdgeZones module. If you run PowerShell locally, sign in to Azure using the Connect-AzAccount cmdlet.

Azure CLI

• An Azure account with an active subscription. Create an account for free.

• Azure Cloud Shell or Azure CLI.

  The steps in this article run the Azure CLI commands interactively in Azure Cloud Shell. To run the commands in the Cloud Shell, select Open Cloud Shell at the upper-right corner of a code block. Select Copy to copy the code, and paste it into Cloud Shell to run it. You can also run the Cloud Shell from within the Azure portal.

  You can also install Azure CLI locally to run the commands. This article requires the edgezones extension, which is available in Azure CLI version 2.57.0 or higher. Run az --version command to find the installed version. Run az extension add --name edgezones command to add edgezones extension. If you run Azure CLI locally, sign in to Azure using the az login command.

Register your subscription for resource provider Microsoft.EdgeZones

In this section, you register resource provider Microsoft.EdgeZones to your subscription.

PowerShell

1. Use Select-AzContext cmdlet to select the subscription that you want to register Azure Extended Zones for.

   Set-AzContext -SubscriptionId '00000000-0000-0000-0000-000000000000'
   

2. Use Register-AzResourceProvider cmdlet to register Microsoft.EdgeZones resource provider.

   Register-AzResourceProvider -ProviderNamespace 'Microsoft.EdgeZones'
   

3. Use Get-AzResourceProvider cmdlet to check the registration state.

   Get-AzResourceProvider –ProviderNamespace 'Microsoft.EdgeZones'
   

   You should wait until the registration state becomes Registered. If it's still PendingRegister, attempting to show, list, register, and unregister the Azure Extended Zones will fail.

Azure CLI

1. Use az account set command to select the subscription that you want to register Azure Extended Zones for.

   az account set --subscription '00000000-0000-0000-0000-000000000000'
   

2. Use az provider register command to register Microsoft.EdgeZones resource provider.

   az provider register --namespace 'Microsoft.EdgeZones'
   

3. Use az provider show command to check the registration state.

   az provider show --namespace 'Microsoft.EdgeZones'
   

   You should wait until the registration state becomes Registered. If it's still PendingRegister, attempting to show, list, register, and unregister the Azure Extended Zones will fail.

Register for an Azure Extended Zone

To register for an Azure Extended Zone, you must select the subscription that you wish to register Azure Extended Zones for and specify the Extended Zone name.

PowerShell

1. Use Get-AzEdgeZonesExtendedZone cmdlet to list all Azure Extended Zones available to your subscription.

   Get-AzEdgeZonesExtendedZone
   

2. Use Register-AzEdgeZonesExtendedZone cmdlet to register for an Azure Extended Zone. The following example registers for Los Angeles as an Extended Zone.

   Register-AzEdgeZonesExtendedZone -Name 'losangeles'
   

3. Use Get-AzEdgeZonesExtendedZone cmdlet to check the registration state of an Azure Extended Zone. The following example checks the registration state of the Extended Zone Los Angeles.

   Get-AzEdgeZonesExtendedZone -Name 'losangeles'
   

   Once your request is approved, the registration state becomes Registered.

   Note

   You can't use an Azure Extended Zone until its registration state becomes Registered.

Azure CLI

1. Use az edge-zones extended-zone list command to list all Azure Extended Zones available to your subscription.

   az edge-zones extended-zone list
   

2. Use az edge-zones extended-zone register command to register for an Azure Extended Zone. The following example registers for Los Angeles as an Extended Zone.

   az edge-zones extended-zone register --extended-zone-name 'losangeles'
   

3. Use az edge-zones extended-zone show command to check the registration state of an Azure Extended Zone. The following example checks the registration state of the Extended Zone Los Angeles.

   az edge-zones extended-zone show --extended-zone-name 'losangeles'
   

   Once your request is approved, the registration state becomes Registered.

   Note

   You can't use an Azure Extended Zone until its registration state becomes Registered.

Unregister for an Azure Extended Zone

In this section, you learn how to unregister your subscription for an Azure Extended Zone.

PowerShell

1. Use Unregister-AzEdgeZonesExtendedZone cmdlet to unregister your subscription for an Azure Extended Zone. The following example unregisters for Los Angeles as an Extended Zone.

   Unregister-AzEdgeZonesExtendedZone -Name 'losangeles'
   

2. Use Get-AzEdgeZonesExtendedZone cmdlet to check the registration state of an Azure Extended Zone. The following example checks the registration state of the Extended Zone Los Angeles.

   Get-AzEdgeZonesExtendedZone -Name 'losangeles'
   

   Note

   Unregistering an Azure Extended Zone will show registration state as PendingUnregister. The Extended Zone stays in your subscription until the registration state becomes NotRegistered.

Azure CLI

1. Use az edge-zones extended-zone unregister command to unregister your subscription for an Azure Extended Zone. The following example unregisters for Los Angeles as an Extended Zone.

   az edge-zones extended-zone unregister --extended-zone-name 'losangeles'
   

2. Use az edge-zones extended-zone show command to check the registration state of an Azure Extended Zone. The following example checks the registration state of the Extended Zone Los Angeles.

   az edge-zones extended-zone show --extended-zone-name 'losangeles'
   

   Note

   Unregistering an Azure Extended Zone will show registration state as PendingUnregister. The Extended Zone stays in your subscription until the registration state becomes NotRegistered.

Related content

• Deploy a virtual machine in an Extended Zone
• Back up an Azure Extended Zone virtual machine
• Frequently asked questions