Request access to an Azure Extended Zone

  • Article

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

  • A billable Azure account.

  • 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.

Register your subscription for resource provider Microsoft.EdgeZones

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

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

    Set-AzContext -SubscriptionId 'aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e'

  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.

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.

Note

The Azure account that you're using to register for Azure Extended Zones must be a billable account. To share your feedback or ask questions about Azure Extended Zones, contact Azure Extended Zones support.

  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.

Unregister for an Azure Extended Zone

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

  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.

Related content