Skip to main content

Task 01: Register Resource Providers

Runbook Azure

DOCUMENT CATEGORY: Runbook
SCOPE: Azure resource provider registration
PURPOSE: Register all required Azure resource providers before cluster deployment
MASTER REFERENCE: Microsoft Learn — Register Resource Provider

Status: Active

Overview​

Azure Local requires specific resource providers to be registered before deployment can proceed. This task checks each provider's registration status and registers any that are not already registered.

Provider Registration Time

Resource provider registration typically takes 1–3 minutes per provider. Some providers may take longer during high-demand periods.

Prerequisites​

PrerequisiteDetail
Landing ZonesPhase 01 completed
PermissionsContributor or Owner role at subscription level
Authenticated Azure sessionSee Authentication
infrastructure.ymlConfigured with target subscription ID

Values from infrastructure.yml​

The values for this task come from infrastructure.yml (schema 5). Every key, with its type, default and example, is in the variables reference.


Required Providers​

Register these 13 resource providers in your Azure Local subscription:

#Provider NamespacePurpose
1Microsoft.HybridComputeAzure Arc-enabled servers
2Microsoft.GuestConfigurationAzure Policy guest configuration
3Microsoft.HybridConnectivityAzure Arc connectivity
4Microsoft.AzureStackHCIAzure Local cluster management (core)
5Microsoft.KubernetesAzure Arc-enabled Kubernetes
6Microsoft.KubernetesConfigurationKubernetes configuration
7Microsoft.ExtendedLocationCustom locations for Arc
8Microsoft.ResourceConnectorAzure Arc Resource Bridge
9Microsoft.HybridContainerServiceHybrid container workloads
10Microsoft.AttestationSecurity attestation
11Microsoft.StorageStorage accounts for deployment
12Microsoft.InsightsMonitoring and logging
13Microsoft.KeyVaultKey Vault for deployment secrets, local administrator credentials and BitLocker recovery keys

Execution Options​

Azure Portal​

When to use: Single deployment, prefer visual interface

Procedure​

  1. Navigate to Resource Providers:
  • In Azure Portal, search for Subscriptions
  • Select your target subscription (infrastructure.yml: azure.subscription_id)
  • In the left menu under Settings, click Resource providers
  1. Register each provider:

For each provider in the required list:

a. Search for the provider name (e.g., Microsoft.HybridCompute)

b. Check the Status column:

  • "Registered" → skip to next provider
  • "NotRegistered" or "Unregistered" → select the row and click Register

c. Wait for status to change to "Registered" (1–3 minutes)

  1. Complete all 13 providers:
  • Microsoft.HybridCompute
  • Microsoft.GuestConfiguration
  • Microsoft.HybridConnectivity
  • Microsoft.AzureStackHCI
  • Microsoft.Kubernetes
  • Microsoft.KubernetesConfiguration
  • Microsoft.ExtendedLocation
  • Microsoft.ResourceConnector
  • Microsoft.HybridContainerService
  • Microsoft.Attestation
  • Microsoft.Storage
  • Microsoft.Insights
  • Microsoft.KeyVault
  1. Verify: Refresh the page and confirm all 13 show "Registered" status.

Troubleshooting​

SymptomErrorResolution
Permission deniedAuthorizationFailedVerify Contributor or Owner role at subscription level — resource group-level permissions are insufficient
Provider stuck registeringStatus remains "Registering" for 10+ minutesUnregister then re-register: Unregister-AzResourceProvider -ProviderNamespace "Microsoft.X", wait 2 min, then Register-AzResourceProvider
Provider not foundNamespace not recognizedVerify spelling; check Azure status page for regional availability

Next Steps​

Proceed to Task 02: Verify Provider Registration to validate all providers are fully registered.

References​



Alternatives​

The procedures in this task use the methods shown in the tabs above. The toolkit is PowerShell 7 only and has no Bash scripts. A few tasks that act on Azure also have an Azure CLI script written in PowerShell. The script status page of the toolkit lists which task has which script.

PreviousUpNext
Phase 02 — Resource ProvidersPhase 02 — Resource ProvidersTask 02 — Verify Provider Registration

Version Control

  • Created: 2026-01-15 by Azure Local Cloud
  • Last Updated: 2026-03-02 by Azure Local Cloud
  • Version: 2.0.0
  • Tags: azure-local, phase-02, resource-providers, registration
  • Keywords: register resource providers, provider registration, Azure Local prerequisites
  • Author: Azure Local Cloud

Version Control​

VersionDateAuthorChanges
1.0.02025-03-25Azure Local CloudInitial release