Edit

Register Microsoft Discovery resource providers

Register Microsoft.Discovery and its dependencies before creating Discovery resources. This article covers manual registration through the Azure portal, Azure CLI, Azure PowerShell, or REST. If you use the onboarding tool, Stage 2 performs registration for its deployment scope.

Prerequisites

  • An active Azure subscription enabled by the Microsoft Discovery team for Microsoft.Discovery. Registration doesn't replace service enablement.
  • Contributor or Owner at subscription scope, or a custom role permitting provider registration (Microsoft.Resources/subscriptions/providers/register/action) and the reads needed to verify it.
  • For command-line methods, the relevant Azure CLI or Azure PowerShell installation and a signed-in context for the intended subscription.

What is a resource provider?

An Azure resource provider is a set of REST operations that enable functionality for a specific Azure service. The Microsoft Discovery service uses a resource provider named Microsoft.Discovery, which defines REST operations for managing Discovery resources.

Resource types in Microsoft Discovery follow the format Microsoft.Discovery/{resource-type}, for example:

  • Microsoft.Discovery/workspaces
  • Microsoft.Discovery/storages
  • Microsoft.Discovery/supercomputers
  • Microsoft.Discovery/bookshelves

Registering a resource provider configures your Azure subscription to work with that service. You need to register Microsoft.Discovery and its dependent providers before you can deploy any Discovery resources.

Important

Only register resource providers when you're ready to use them, to maintain least-privilege access within your subscription.

Registration methods

You can register the Microsoft.Discovery resource provider using the Azure portal, Azure CLI, Azure PowerShell, or the REST API.

Azure portal

  1. Sign in to the Azure portal.
  2. Search for and select Subscriptions.
  3. Select the subscription enabled for Microsoft Discovery.
  4. In the left menu under Settings, select Resource providers.
  5. In the search box, type Microsoft.Discovery.
  6. Select the Microsoft.Discovery provider from the list.
  7. Select Register.

The registration status changes from Not Registered to Registering, and then to Registered. Registration can take a few minutes. It runs in parallel across supported regions, so you don't need to wait for all regions to finish before you create resources.

After registering Microsoft.Discovery, review and register the dependent providers for your planned services by using the same steps. This list covers the broader Discovery deployment guidance. The onboarding tool's Stage 2 registers its own implementation-defined subset and doesn't deploy every optional capability.

  • Microsoft.Network
  • Microsoft.Compute
  • Microsoft.Storage
  • Microsoft.ManagedIdentity
  • Microsoft.AlertsManagement
  • Microsoft.Authorization
  • Microsoft.CognitiveServices
  • Microsoft.ContainerInstance
  • Microsoft.ContainerRegistry
  • Microsoft.ContainerService
  • Microsoft.DocumentDB
  • Microsoft.Features
  • Microsoft.KeyVault
  • Microsoft.MachineLearningServices
  • Microsoft.NetApp
  • Microsoft.OperationalInsights
  • Microsoft.ResourceGraph
  • Microsoft.Search
  • Microsoft.Web
  • Microsoft.Insights
  • Microsoft.Resources
  • Microsoft.Sql
  • Microsoft.App
  • Microsoft.Bing

Verify registration in the portal

Refresh the Resource providers page and confirm that the providers needed for your deployment show Registered.

Azure CLI

Prerequisites

Register the resource provider

az provider register --namespace Microsoft.Discovery

Select the subscription you want to use with az account set --subscription "<subscription-id>" before registration. Repeat registration for each required dependent provider.

Verify registration

az provider show --namespace Microsoft.Discovery --query "registrationState"

The command returns "Registered" when registration is complete.

List all resource providers and their status

az provider list --query "[].{Provider:namespace, Status:registrationState}" --out table

Azure PowerShell

Prerequisites

Register the resource provider

Register-AzResourceProvider -ProviderNamespace Microsoft.Discovery

Use Set-AzContext -SubscriptionId "<subscription-id>" to select the subscription you want. Repeat for the required dependent providers.

Verify registration

Get-AzResourceProvider -ProviderNamespace Microsoft.Discovery

REST API

For programmatic registration, use the Azure Resource Manager REST API.

Request

POST https://management.azure.com/subscriptions/{subscription-id}/providers/Microsoft.Discovery/register?api-version=2021-04-01

Required headers

Header Value
Authorization Bearer {access-token}
Content-Type application/json

Post-registration steps

For REST verification, use a GET request to the subscription's provider endpoint and confirm that registrationState is Registered:

GET https://management.azure.com/subscriptions/{subscription-id}/providers/Microsoft.Discovery?api-version=2021-04-01

Use an Azure Resource Manager access token in the Authorization header as Bearer <access-token>; don't put real tokens in source files or reports.

After registration is complete:

  1. Verify the registration status. Confirm that Microsoft.Discovery shows Registered in the portal, or run the CLI or PowerShell verification commands.

  2. Check available resource types. In the Azure portal search bar, type Microsoft Discovery to see all available Microsoft Discovery resource types in your subscription.

  3. Proceed with resource creation. You can now create the following Microsoft Discovery resources:

    • Workspaces
    • Projects
    • Investigations
    • Supercomputers
    • Nodepools
    • Bookshelves
    • Storage Containers
    • Tools
    • Agents

Related content

  • Last updated on