Provedores e tipos de recursos do Azure

Um provedor de recursos do Azure é um conjunto de operações REST que habilitam a funcionalidade para um serviço específico do Azure. Por exemplo, o serviço Key Vault consiste em um provedor de recursos chamado Microsoft.KeyVault. O provedor de recursos define operações REST para gerenciar cofres, segredos, chaves e certificados.

O provedor de recursos define os recursos do Azure que você pode implantar em sua conta. O nome de um tipo de recurso segue o formato: {resource-provider}/{resource-type}. O tipo de recurso de um cofre de chaves é Microsoft.KeyVault/vaults.

Neste artigo, você aprenderá como:

  • Exibir todos os provedores de recursos no Azure
  • Verificar o status do registro de um provedor de recursos
  • Registrar um provedor de recursos
  • Exibir os tipos de recurso para um provedor de recursos
  • Exibir localizações válidas para um tipo de recurso
  • Exibir versões de API válidas para um tipo de recurso

Para obter uma lista que mapeia os provedores de recursos para os serviços do Azure, confira Provedores de recursos para os serviços do Azure.

Registrar provedor de recursos

Antes de usar um provedor de recursos, você deve verificar se sua assinatura do Azure está registrada para o provedor de recursos. O registro configura a assinatura para trabalhar com o provedor de recursos.

Importante

Registre um provedor de recursos somente quando estiver pronto para usá-lo. Essa etapa de registro ajuda a manter os privilégios mínimos na assinatura. Um usuário mal-intencionado não pode usar provedores de recursos não registrados.

Registrar provedores de recursos desnecessários pode resultar em aplicativos não reconhecidos que aparecem no locatário do Microsoft Entra. A Microsoft adiciona o aplicativo de um provedor de recursos quando você o registra. Esses aplicativos geralmente são adicionados pela API de Gerenciamento de Serviços do Microsoft Azure. Para evitar ter aplicativos desnecessários em seu locatário, registre apenas os provedores de recursos necessários.

Alguns provedores de recursos são registrados por padrão. Para obter uma lista de provedores de recursos registrados por padrão, confira Provedores de recursos para serviços do Azure.

Outros provedores de recursos serão registrados automaticamente quando você executar determinadas ações. Quando você cria um recurso por meio do portal, o provedor de recursos normalmente é registrado para você. Quando você implanta um modelo de Azure Resource Manager ou arquivo Bicep, os provedores de recursos definidos no modelo são registrados automaticamente. Às vezes, um recurso no modelo requer recursos de suporte que não estão no modelo. Exemplos comuns são recursos de monitoramento ou segurança. Você precisa registrar esses provedores de recursos manualmente.

Para outros cenários, talvez seja necessário registrar um provedor de recursos manualmente.

Importante

O código do aplicativo não deve bloquear a criação de recursos para um provedor de recursos que esteja no estado de registro. Quando você registra o provedor de recursos, a operação é feita individualmente para cada região com suporte. Para criar recursos em uma região, o registro precisa ser concluído apenas nessa região. Ao não bloquear um provedor de recursos no estado de registro, o aplicativo pode continuar muito antes em vez de aguardar a conclusão de todas as regiões.

Você deve ter permissão para realizar a operação /register/action para o provedor de recursos. A permissão está incluída nas funções de Colaborador e de Proprietário.

Você não poderá cancelar o registro de um provedor de recursos enquanto ainda tiver tipos de recursos desse provedor de recursos na assinatura.

Registre novamente um provedor de recursos quando o provedor de recursos dá suporte a novos locais que você precisa usar.

Portal do Azure

Registrar provedor de recursos

Para ver todos os provedores de recursos e o status do registro para a sua assinatura:

  1. Entre no portal do Azure.

  2. No menu do portal do Azure, procure Assinaturas. Selecione-as entre as opções disponíveis.

    Screenshot of searching for subscriptions in the Azure portal.

  3. Selecione a assinatura que você deseja exibir.

    Screenshot of selecting a subscription in the Azure portal.

  4. No menu à esquerda, em Configurações, selecione Provedores de recursos.

    Screenshot of selecting resource providers in the Azure portal.

  5. Localize o provedor de recursos que você deseja registrar e selecione Registrar. Para manter os privilégios mínimos na assinatura, registre apenas os provedores de recursos que você está pronto para usar.

    Screenshot of registering a resource provider in the Azure portal.

    Importante

    Conforme observado anteriormente, não bloqueie a criação de recursos para um provedor de recursos que está no estado de registro. Ao não bloquear um provedor de recursos no estado de registro, o aplicativo pode continuar muito antes em vez de aguardar a conclusão de todas as regiões.

  6. Registre novamente um provedor de recursos para usar locais que foram adicionados desde o registro anterior.

    Screenshot of reregistering a resource provider in the Azure portal.

Exibir o provedor de recursos

Para obter informações para um provedor de recursos específico:

  1. Entre no portal do Azure.

  2. No menu do portal do Azure, selecione Todos os serviços.

  3. Na caixa Todos os serviços, digite gerenciador de recursos e, em seguida, selecione Gerenciador de Recursos.

    Screenshot of selecting All services in the Azure portal to access Resource Explorer.

  4. Expanda provedores selecionando a seta para a direita.

    Screenshot of expanding the Providers section in the Azure Resource Explorer.

  5. Expanda o provedor de recursos e o tipo de recurso que você deseja exibir.

    Screenshot of expanding a resource provider and resource type in the Azure Resource Explorer.

  6. O Gerenciador de Recursos tem suporte em todas as regiões, mas os recursos que você implanta talvez não tenham suporte em todas as regiões. Além disso, pode haver limitações em sua assinatura que impedem o uso de algumas regiões que oferecem suporte aos recursos. O Resource Explorer mostra localizações válidas para o tipo de recurso.

    Screenshot of displaying valid locations for a resource type in the Azure Resource Explorer.

  7. A versão da API corresponde a uma versão das operações da API REST do provedor de recursos. Conforme um provedor de recursos habilita novos recursos, ele lança uma nova versão da API REST. O Resource Explorer mostra versões de API válidas para o tipo de recurso.

    Screenshot of displaying valid API versions for a resource type in the Azure Resource Explorer.

PowerShell do Azure

Para ver todos os provedores de recursos no Azure e o status do registro para a sua assinatura, use:

Get-AzResourceProvider -ListAvailable | Select-Object ProviderNamespace, RegistrationState

O comando retorna:

ProviderNamespace                RegistrationState
-------------------------------- ------------------
Microsoft.ClassicCompute         Registered
Microsoft.ClassicNetwork         Registered
Microsoft.ClassicStorage         Registered
Microsoft.CognitiveServices      Registered
...

Para conferir todos os provedores de recursos registrados para a assinatura, use:

 Get-AzResourceProvider -ListAvailable | Where-Object RegistrationState -eq "Registered" | Select-Object ProviderNamespace, RegistrationState | Sort-Object ProviderNamespace

Para manter os privilégios mínimos na assinatura, registre apenas os provedores de recursos que você está pronto para usar. Para registrar um provedor de recursos, use:

Register-AzResourceProvider -ProviderNamespace Microsoft.Batch

O comando retorna:

ProviderNamespace : Microsoft.Batch
RegistrationState : Registering
ResourceTypes     : {batchAccounts, operations, locations, locations/quotas}
Locations         : {West Europe, East US, East US 2, West US...}

Importante

Conforme observado anteriormente, não bloqueie a criação de recursos para um provedor de recursos que está no estado de registro. Ao não bloquear um provedor de recursos no estado de registro, o aplicativo pode continuar muito antes em vez de aguardar a conclusão de todas as regiões.

Registre novamente um provedor de recursos para usar locais adicionados desde o registro anterior. Para registrar novamente, execute o comando de registro novamente.

Para obter informações para um provedor de recursos específico, use:

Get-AzResourceProvider -ProviderNamespace Microsoft.Batch

O comando retorna:

{ProviderNamespace : Microsoft.Batch
RegistrationState : Registered
ResourceTypes     : {batchAccounts}
Locations         : {West Europe, East US, East US 2, West US...}

...

Para ver os tipos de recurso para um provedor de recursos, use:

(Get-AzResourceProvider -ProviderNamespace Microsoft.Batch).ResourceTypes.ResourceTypeName

O comando retorna:

batchAccounts
operations
locations
locations/quotas

A versão da API corresponde a uma versão das operações da API REST do provedor de recursos. Conforme um provedor de recursos habilita novos recursos, ele lança uma nova versão da API REST.

Para obter versões de API disponíveis para um tipo de recurso, use:

((Get-AzResourceProvider -ProviderNamespace Microsoft.Batch).ResourceTypes | Where-Object ResourceTypeName -eq batchAccounts).ApiVersions

O comando retorna:

2023-05-01
2022-10-01
2022-06-01
2022-01-01
2021-06-01
2021-01-01
...

O Gerenciador de Recursos tem suporte em todas as regiões, mas os recursos que você implanta talvez não tenham suporte em todas as regiões. Além disso, pode haver limitações em sua assinatura que impedem o uso de algumas regiões que oferecem suporte aos recursos.

Para obter as localizações com suporte para um tipo de recurso, use.

((Get-AzResourceProvider -ProviderNamespace Microsoft.Batch).ResourceTypes | Where-Object ResourceTypeName -eq batchAccounts).Locations

O comando retorna:

West Europe
East US
East US 2
West US
...

CLI do Azure

Para ver todos os provedores de recursos no Azure e o status do registro para a sua assinatura, use:

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

O comando retorna:

Provider                         Status
-------------------------------- ----------------
Microsoft.ClassicCompute         Registered
Microsoft.ClassicNetwork         Registered
Microsoft.ClassicStorage         Registered
Microsoft.CognitiveServices      Registered
...

Para conferir todos os provedores de recursos registrados para a assinatura, use:

az provider list --query "sort_by([?registrationState=='Registered'].{Provider:namespace, Status:registrationState}, &Provider)" --out table

Para manter os privilégios mínimos na assinatura, registre apenas os provedores de recursos que você está pronto para usar. Para registrar um provedor de recursos, use:

az provider register --namespace Microsoft.Batch

O comando retorna uma mensagem indicando que o registro está em andamento.

Para obter informações para um provedor de recursos específico, use:

az provider show --namespace Microsoft.Batch

O comando retorna:

{
    "id": "/subscriptions/####-####/providers/Microsoft.Batch",
    "namespace": "Microsoft.Batch",
    "registrationsState": "Registering",
    "resourceTypes:" [
        ...
    ]
}

Importante

Conforme observado anteriormente, não bloqueie a criação de recursos para um provedor de recursos que está no estado de registro. Ao não bloquear um provedor de recursos no estado de registro, o aplicativo pode continuar muito antes em vez de aguardar a conclusão de todas as regiões.

Para ver os tipos de recurso para um provedor de recursos, use:

az provider show --namespace Microsoft.Batch --query "resourceTypes[*].resourceType" --out table

O comando retorna:

Result
---------------
batchAccounts
operations
locations
locations/quotas

A versão da API corresponde a uma versão das operações da API REST do provedor de recursos. Conforme um provedor de recursos habilita novos recursos, ele lança uma nova versão da API REST.

Para obter versões de API disponíveis para um tipo de recurso, use:

az provider show --namespace Microsoft.Batch --query "resourceTypes[?resourceType=='batchAccounts'].apiVersions | [0]" --out table

O comando retorna:

Result
---------------
2023-05-01
2022-10-01
2022-06-01
2022-01-01
...

O Gerenciador de Recursos tem suporte em todas as regiões, mas os recursos que você implanta talvez não tenham suporte em todas as regiões. Além disso, pode haver limitações em sua assinatura que impedem o uso de algumas regiões que oferecem suporte aos recursos.

Para obter as localizações com suporte para um tipo de recurso, use.

az provider show --namespace Microsoft.Batch --query "resourceTypes[?resourceType=='batchAccounts'].locations | [0]" --out table

O comando retorna:

Result
---------------
West Europe
East US
East US 2
West US
...

Python

Para ver todos os provedores de recursos no Azure e o status do registro para a sua assinatura, use:

import os  
from azure.identity import DefaultAzureCredential  
from azure.mgmt.resource import ResourceManagementClient  
  
# Authentication  
credential = DefaultAzureCredential()  
subscription_id = os.environ["AZURE_SUBSCRIPTION_ID"]  
  
# Initialize Resource Management client  
resource_management_client = ResourceManagementClient(credential, subscription_id)  
  
# List available resource providers and select ProviderNamespace and RegistrationState  
providers = resource_management_client.providers.list()  
  
for provider in providers:  
    print(f"ProviderNamespace: {provider.namespace}, RegistrationState: {provider.registration_state}")  

O comando retorna:

ProviderNamespace: Microsoft.AlertsManagement, RegistrationState: Registered
ProviderNamespace: Microsoft.AnalysisServices, RegistrationState: Registered
ProviderNamespace: Microsoft.ApiManagement, RegistrationState: Registered
ProviderNamespace: Microsoft.Authorization, RegistrationState: Registered
ProviderNamespace: Microsoft.Batch, RegistrationState: Registered
...

Para conferir todos os provedores de recursos registrados para a assinatura, use:

# List available resource providers with RegistrationState "Registered" and select ProviderNamespace and RegistrationState  
providers = resource_management_client.providers.list()  
registered_providers = [provider for provider in providers if provider.registration_state == "Registered"]  
  
# Sort by ProviderNamespace  
sorted_registered_providers = sorted(registered_providers, key=lambda x: x.namespace)  
  
for provider in sorted_registered_providers:  
    print(f"ProviderNamespace: {provider.namespace}, RegistrationState: {provider.registration_state}")  

Para manter os privilégios mínimos na assinatura, registre apenas os provedores de recursos que você está pronto para usar. Para registrar um provedor de recursos, use:

import os  
from azure.identity import DefaultAzureCredential  
from azure.mgmt.resource import ResourceManagementClient  
  
# Authentication  
credential = DefaultAzureCredential()  
subscription_id = os.environ["AZURE_SUBSCRIPTION_ID"]  
  
# Initialize Resource Management client  
resource_management_client = ResourceManagementClient(credential, subscription_id)  
  
# Register resource provider  
provider_namespace = "Microsoft.Batch"  
registration_result = resource_management_client.providers.register(provider_namespace)  
  
print(f"ProviderNamespace: {registration_result.namespace}, RegistrationState: {registration_result.registration_state}")  

O comando retorna:

ProviderNamespace: Microsoft.Batch, RegistrationState: Registered

Importante

Conforme observado anteriormente, não bloqueie a criação de recursos para um provedor de recursos que está no estado de registro. Ao não bloquear um provedor de recursos no estado de registro, o aplicativo pode continuar muito antes em vez de aguardar a conclusão de todas as regiões.

Registre novamente um provedor de recursos para usar locais adicionados desde o registro anterior. Para registrar novamente, execute o comando de registro novamente.

Para obter informações para um provedor de recursos específico, use:

import os  
from azure.identity import DefaultAzureCredential  
from azure.mgmt.resource import ResourceManagementClient  
  
# Authentication  
credential = DefaultAzureCredential()  
subscription_id = os.environ["AZURE_SUBSCRIPTION_ID"]  
  
# Initialize Resource Management client  
resource_management_client = ResourceManagementClient(credential, subscription_id)  
  
# Get resource provider by ProviderNamespace  
provider_namespace = "Microsoft.Batch"  
provider = resource_management_client.providers.get(provider_namespace)  
  
print(f"ProviderNamespace: {provider.namespace}, RegistrationState: {provider.registration_state}\n")  
  
# Add resource types, locations, and API versions with new lines to separate results  
for resource_type in provider.resource_types:  
    print(f"ResourceType: {resource_type.resource_type}\nLocations: {', '.join(resource_type.locations)}\nAPIVersions: {', '.join(resource_type.api_versions)}\n")  

O comando retorna:

ProviderNamespace: Microsoft.Batch, RegistrationState: Registered

ResourceType: batchAccounts
Locations: West Europe, East US, East US 2, West US, North Central US, Brazil South, North Europe, Central US, East Asia, Japan East, Australia Southeast, Japan West, Korea South, Korea Central, Southeast Asia, South Central US, Australia East, Jio India West, South India, Central India, West India, Canada Central, Canada East, UK South, UK West, West Central US, West US 2, France Central, South Africa North, UAE North, Australia Central, Germany West Central, Switzerland North, Norway East, Brazil Southeast, West US 3, Sweden Central, Qatar Central, Poland Central, East US 2 EUAP, Central US EUAP
APIVersions: 2023-05-01, 2022-10-01, 2022-06-01, 2022-01-01, 2021-06-01, 2021-01-01, 2020-09-01, 2020-05-01, 2020-03-01-preview, 2020-03-01, 2019-08-01, 2019-04-01, 2018-12-01, 2017-09-01, 2017-05-01, 2017-01-01, 2015-12-01, 2015-09-01, 2015-07-01, 2014-05-01-privatepreview

...

Para ver os tipos de recurso para um provedor de recursos, use:

# Get resource provider by ProviderNamespace  
provider_namespace = "Microsoft.Batch"  
provider = resource_management_client.providers.get(provider_namespace)  
  
# Get ResourceTypeName of the resource types  
resource_type_names = [resource_type.resource_type for resource_type in provider.resource_types]  
  
for resource_type_name in resource_type_names:  
    print(resource_type_name)  

O comando retorna:

batchAccounts
batchAccounts/pools
batchAccounts/detectors
batchAccounts/certificates
operations
locations
locations/quotas
locations/checkNameAvailability
locations/accountOperationResults
locations/virtualMachineSkus
locations/cloudServiceSkus

A versão da API corresponde a uma versão das operações da API REST do provedor de recursos. Conforme um provedor de recursos habilita novos recursos, ele lança uma nova versão da API REST.

Para obter versões de API disponíveis para um tipo de recurso, use:

# Get resource provider by ProviderNamespace  
provider_namespace = "Microsoft.Batch"  
provider = resource_management_client.providers.get(provider_namespace)  
  
# Filter resource type by ResourceTypeName and get its ApiVersions  
resource_type_name = "batchAccounts"  
api_versions = [  
    resource_type.api_versions  
    for resource_type in provider.resource_types  
    if resource_type.resource_type == resource_type_name  
]  
  
for api_version in api_versions[0]:  
    print(api_version)  

O comando retorna:

2023-05-01
2022-10-01
2022-06-01
2022-01-01
...

O Gerenciador de Recursos tem suporte em todas as regiões, mas os recursos que você implanta talvez não tenham suporte em todas as regiões. Além disso, pode haver limitações em sua assinatura que impedem o uso de algumas regiões que oferecem suporte aos recursos.

Para obter as localizações com suporte para um tipo de recurso, use.

# Get resource provider by ProviderNamespace  
provider_namespace = "Microsoft.Batch"  
provider = resource_management_client.providers.get(provider_namespace)  
  
# Filter resource type by ResourceTypeName and get its Locations  
resource_type_name = "batchAccounts"  
locations = [  
    resource_type.locations  
    for resource_type in provider.resource_types  
    if resource_type.resource_type == resource_type_name  
]  
  
for location in locations[0]:  
    print(location)  

O comando retorna:

West Europe
East US
East US 2
West US
...

Próximas etapas