Provedores e tipos de recursos do Azure

Artigo
07/27/2022
7 minutos para o fim da leitura

Ao implantar recursos, com frequência você precisa recuperar informações sobre os provedores e tipos de recursos. Por exemplo, se você quer armazenar chaves e segredos, trabalhe com o provedor de recursos Microsoft.KeyVault . Este provedor de recursos oferece um tipo de recurso denominado cofres para criar o cofre da chave.

O nome de um tipo de recurso está no formato: {provedor-de-recursos}/{tipo-de-recurso}. 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

Você pode executar essas etapas por meio do portal do Azure, do Azure PowerShell ou da CLI do Azure.

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, a assinatura do Azure deve ser registrada para o provedor de recursos. O registro configura a assinatura para trabalhar com o provedor de recursos.

Importante

Somente registre um provedor de recursos quando estiver pronto para usá-lo. A etapa de registro permite que você mantenha os privilégios mínimos na assinatura. Um usuário mal-intencionado não poderá usar provedores de recursos que não estejam registrados.

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. No entanto, se um recurso no modelo criar recursos de suporte que não estejam no modelo, como recursos de monitoramento ou de segurança, você precisará registrar manualmente esses provedores de recursos.

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.

Portal do Azure

Registrar provedor de recursos

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

Entre no portal do Azure.
No menu do portal do Azure, procure Assinaturas. Selecione-as entre as opções disponíveis.
Selecione a assinatura que você deseja exibir.
No menu à esquerda, em Configurações, selecione Provedores de recursos.
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.

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.

Exibir o provedor de recursos

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

Entre no portal do Azure.
No menu do portal do Azure, selecione Todos os serviços.
Na caixa Todos os serviços, digite gerenciador de recursos e, em seguida, selecione Gerenciador de Recursos.
Expanda provedores selecionando a seta para a direita.
Expanda o provedor de recursos e o tipo de recurso que você deseja exibir.
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.
A versão disponível da API corresponde a uma versão das operações da API REST lançadas pelo 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.

Azure PowerShell

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

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 disponível da API corresponde a uma versão das operações da API REST lançadas pelo 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:

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

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

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
---------------
2017-05-01
2017-01-01
2015-12-01
2015-09-01
2015-07-01

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

Próximas etapas

Para saber mais sobre a criação de modelos do Gerenciador de Recursos, confira Criando modelos do Gerenciador de Recursos do Azure.
Para exibir os esquemas de modelo de provedor de recursos, confira Referência de modelo.
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.
Para exibir as operações para um provedor de recursos, consulte API REST do Azure.