Skip to content

request-access.md

Latest commit

 

History

History
192 lines (121 loc) · 10 KB

request-access.md

File metadata and controls

192 lines (121 loc) · 10 KB
title Request Access to Azure Extended Zones
description Learn how to request and gain access to an Azure extended zone by using Azure PowerShell or the Azure CLI.
author svaldesgzz
ms.author svaldes
ms.service azure-extended-zones
ms.topic how-to
ms.date 02/25/2026

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

PowerShell

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

Azure CLI

  • A billable Azure account.

  • Azure Cloud Shell or the Azure CLI.

    The steps in this article run the Azure CLI commands interactively in Cloud Shell. To run the commands 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 the Azure CLI locally to run the commands. This article requires the edgezones extension, which is available in the Azure CLI version 2.57.0 or later. Run the az --version command to find the installed version. Run the az extension add --name edgezones command to add the edgezones extension. If you run the Azure CLI locally, sign in to Azure by using the az login command.

Register your subscription for the Microsoft.EdgeZones resource provider

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

PowerShell

  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.

Azure CLI

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

    az account set --subscription 'aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e'

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

    az provider register --namespace 'Microsoft.EdgeZones'

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

    az provider show --namespace '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.

PowerShell

  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.

Azure CLI

  1. Use the az edge-zones extended-zone list command to list all Azure extended zones that are available to your subscription.

    az edge-zones extended-zone list

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

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

  3. Use the 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 Los Angeles extended zone.

    az edge-zones extended-zone show --extended-zone-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.

PowerShell

  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.

Azure CLI

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

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

  2. Use the 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 Los Angeles extended zone.

    az edge-zones extended-zone show --extended-zone-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.

Related content