Edit

Microsoft Discovery resource provider registration

Registering the Microsoft Discovery resource provider is a prerequisite for creating and using Microsoft Discovery resources in your Azure subscription. This article explains what resource provider registration means, what permissions you need, and how to complete registration using the Azure portal, Azure CLI, Azure PowerShell, or the REST API.

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.

Prerequisites

Before registering the Microsoft Discovery resource provider, ensure you have:

  • An active Azure subscription enabled by the Microsoft Discovery team to use the Microsoft.Discovery resource provider.
  • One of the following roles assigned to your account at the subscription scope:
    • Contributor role (or higher)
    • Owner role
    • A custom role with the /register/action operation for resource providers

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, register the following dependent resource providers using the same steps:

  • 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 all the Resource Providers shows a Registered status.

Azure CLI

Prerequisites

Register the resource provider

az provider register --namespace Microsoft.Discovery

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

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

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