Rediger

Del via


Request access to an Azure extended zone

To create Azure resources in Azure Extended Zones locations, you need to explicitly register your subscription with the respective Azure extended zone. You use a subscription owner account because this capability isn't enabled by default. After 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 by using PowerShell or the 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 Cloud Shell. To run the cmdlets in 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 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 the Get-Module -ListAvailable Az.EdgeZones cmdlet to find the installed version. Run the Install-Module Az.EdgeZones cmdlet to install the Az.EdgeZones module. If you run PowerShell locally, sign in to Azure by using the Connect-AzAccount cmdlet.

Register your subscription for the Microsoft.EdgeZones resource provider

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

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

    Set-AzContext -SubscriptionId 'aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e'
    
  2. Use the Register-AzResourceProvider cmdlet to register the Microsoft.EdgeZones resource provider.

    Register-AzResourceProvider -ProviderNamespace 'Microsoft.EdgeZones'
    
  3. Use the Get-AzResourceProvider cmdlet to check the registration state.

    Get-AzResourceProvider –ProviderNamespace 'Microsoft.EdgeZones'
    

    Wait until the registration state becomes Registered. If it's still PendingRegister, attempting to show, list, register, or unregister the Azure extended zone fails.

Register for an Azure extended zone

To register for an Azure extended zone, select the subscription for which you want to register Azure Extended Zones, 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 the Get-AzEdgeZonesExtendedZone cmdlet to list all the Azure extended zones that are available to your subscription.

    Get-AzEdgeZonesExtendedZone
    
  2. Use the Register-AzEdgeZonesExtendedZone cmdlet to register for an Azure extended zone. The following example registers Los Angeles as an extended zone.

    Register-AzEdgeZonesExtendedZone -Name 'losangeles'
    
  3. Use the Get-AzEdgeZonesExtendedZone cmdlet to check the registration state of an Azure extended zone. The following example checks the registration state of the Los Angeles extended zone.

    Get-AzEdgeZonesExtendedZone -Name 'losangeles'
    

    After 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 the Unregister-AzEdgeZonesExtendedZone cmdlet to unregister your subscription for an Azure extended zone. The following example unregisters Los Angeles as an extended zone.

    Unregister-AzEdgeZonesExtendedZone -Name 'losangeles'
    
  2. Use the Get-AzEdgeZonesExtendedZone cmdlet to check the registration state of an Azure extended zone. The following example checks the registration state of the Los Angeles extended zone.

    Get-AzEdgeZonesExtendedZone -Name 'losangeles'
    

    Note

    Unregistering an Azure extended zone shows the registration state as PendingUnregister. The extended zone stays in your subscription until the registration state becomes NotRegistered.