Provedores e tipos de recursos do AzureAzure resource providers and types

Ao implantar recursos, com frequência você precisa recuperar informações sobre os provedores e tipos de recursos.When deploying resources, you frequently need to retrieve information about the resource providers and types. Por exemplo, se você quer armazenar chaves e segredos, trabalhe com o provedor de recursos Microsoft.KeyVault .For example, if you want to store keys and secrets, you work with the Microsoft.KeyVault resource provider. Este provedor de recursos oferece um tipo de recurso denominado cofres para criar o cofre da chave.This resource provider offers a resource type called vaults for creating the key vault.

O nome de um tipo de recurso está no formato: {provedor-de-recursos}/{tipo-de-recurso}.The name of a resource type is in the format: {resource-provider}/{resource-type}. O tipo de recurso de um cofre de chaves é Microsoft.KeyVault/vaults.The resource type for a key vault is Microsoft.KeyVault/vaults.

Neste artigo, você aprenderá como:In this article, you learn how to:

  • Exibir todos os provedores de recursos no AzureView all resource providers in Azure
  • Verificar o status do registro de um provedor de recursosCheck registration status of a resource provider
  • Registrar um provedor de recursosRegister a resource provider
  • Exibir os tipos de recurso para um provedor de recursosView resource types for a resource provider
  • Exibir localizações válidas para um tipo de recursoView valid locations for a resource type
  • Exibir versões de API válidas para um tipo de recursoView valid API versions for a resource type

Você pode executar essas etapas por meio do portal do Azure, Azure PowerShell ou CLI do Azure.You can do these steps through the Azure portal, Azure PowerShell, or Azure CLI.

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.For a list that maps resource providers to Azure services, see Resource providers for Azure services.

Registrar provedor de recursosRegister resource provider

Antes de usar um provedor de recursos, sua assinatura do Azure deve ser registrada para o provedor de recursos.Before using a resource provider, your Azure subscription must be registered for the resource provider. O Registro configura sua assinatura para trabalhar com o provedor de recursos.Registration configures your subscription to work with the resource provider. Alguns provedores de recursos são registrados por padrão.Some resource providers are registered by default. Outros provedores de recursos são registrados automaticamente quando você executar determinadas ações.Other resource providers are registered automatically when you take certain actions. Por exemplo, quando você cria um recurso por meio do portal, o provedor de recursos normalmente é registrado para você.For example, when you create a resource through the portal, the resource provider is typically registered for you. Para outros cenários, talvez seja necessário registrar manualmente um provedor de recursos.For other scenarios, you may need to manually register a resource provider. Para obter uma lista de provedores de recursos registrados por padrão, consulte provedores de recursos para serviços do Azure.For a list of resource providers registered by default, see Resource providers for Azure services.

Este artigo mostra como verificar o status de registro de um provedor de recursos e registrá-lo conforme necessário.This article shows you how to check the registration status of a resource provider, and register it as needed. Você deve ter permissão para realizar a /register/action operação para o provedor de recursos.You must have permission to do the /register/action operation for the resource provider. A permissão está incluída nas funções colaborador e proprietário.The permission is included in the Contributor and Owner roles.

Importante

Somente registre um provedor de recursos quando estiver pronto para usá-lo.Only register a resource provider when you're ready to use it. A etapa de registro permite que você mantenha os privilégios mínimos em sua assinatura.The registration step enables you to maintain least privileges within your subscription. Um usuário mal-intencionado não pode usar provedores de recursos que não estão registrados.A malicious user can't use resource providers that aren't registered.

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 .Your application code shouldn't block the creation of resources for a resource provider that is in the registering state. Quando você registra o provedor de recursos, a operação é feita individualmente para cada região com suporte.When you register the resource provider, the operation is done individually for each supported region. Para criar recursos em uma região, o registro precisa ser concluído apenas nessa região.To create resources in a region, the registration only needs to be completed in that region. Por não bloquear o provedor de recursos no estado de registro, seu aplicativo pode continuar muito antes de esperar que todas as regiões sejam concluídas.By not blocking resource provider in the registering state, your application can continue much sooner than waiting for all regions to complete.

Não é possível cancelar o registro de um provedor de recursos quando você ainda tem tipos de recursos desse provedor de recursos em sua assinatura.You can't unregister a resource provider when you still have resource types from that resource provider in your subscription.

Portal do AzureAzure portal

Para ver todos os provedores de recursos e o status do registro para a sua assinatura:To see all resource providers, and the registration status for your subscription:

  1. Entre no portal do Azure.Sign in to the Azure portal.

  2. No menu do portal do Azure, selecione Todos os serviços.On the Azure portal menu, select All services.

    selecionar assinaturas

  3. Na caixa Todos os serviços , digite assinatura e, em seguida, selecione Assinaturas.In the All services box, enter subscription, and then select Subscriptions.

  4. Selecione a assinatura na lista de assinaturas para visualizá-la.Select the subscription from the subscription list to view.

  5. Selecione Provedores de recursos e exiba a lista de provedores de recursos disponíveis.Select Resource providers and view the list of available resource providers.

    mostrar provedores de recursos

  6. Para registrar um provedor de recursos, selecione Registrar.To register a resource provider, select Register. Na captura de tela anterior, o link Registrar é destacado para Microsoft.Blueprint.In the previous screenshot, the Register link is highlighted for Microsoft.Blueprint. Para manter os privilégios mínimos em sua assinatura, registre apenas os provedores de recursos que você está pronto para usar.To maintain least privileges in your subscription, only register those resource providers that you're ready to use.

Para obter informações para um provedor de recursos específico:To see information for a particular resource provider:

  1. Entre no portal do Azure.Sign in to the Azure portal.

  2. No menu do portal do Azure, selecione Todos os serviços.On the Azure portal menu, select All services.

  3. Na caixa Todos os serviços, digite gerenciador de recursos e, em seguida, selecione Gerenciador de Recursos.In the All services box, enter resource explorer, and then select Resource Explorer.

    selecionar Todos os serviços

  4. Expanda provedores selecionando a seta para a direita.Expand Providers by selecting the right arrow.

    Selecionar provedores

  5. Expanda o provedor de recursos e o tipo de recurso que você deseja exibir.Expand a resource provider and resource type that you want to view.

    Selecionar tipo de recurso

  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.Resource Manager is supported in all regions, but the resources you deploy might not be supported in all regions. Além disso, pode haver limitações na sua assinatura que impeçam o uso de algumas regiões que dão suporte ao recurso.Also, there may be limitations on your subscription that prevent you from using some regions that support the resource. O Resource Explorer mostra localizações válidas para o tipo de recurso.The resource explorer displays valid locations for the resource type.

    Mostrar localizações

  7. A versão disponível da API corresponde a uma versão das operações da API REST lançadas pelo provedor de recursos.The API version corresponds to a version of REST API operations that are released by the resource provider. Conforme um provedor de recursos habilita novos recursos, ele lança uma nova versão da API REST.As a resource provider enables new features, it releases a new version of the REST API. O Resource Explorer mostra versões de API válidas para o tipo de recurso.The resource explorer displays valid API versions for the resource type.

    Mostrar versões de API

Azure PowerShellAzure PowerShell

Para ver todos os provedores de recursos no Azure e o status do registro para a sua assinatura, use:To see all resource providers in Azure, and the registration status for your subscription, use:

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

Que retorna resultados semelhantes a:Which returns results similar to:

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

Para ver todos os provedores de recursos registrados para sua assinatura, use:To see all registered resource providers for your subscription, use:

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

Para manter os privilégios mínimos em sua assinatura, registre apenas os provedores de recursos que você está pronto para usar.To maintain least privileges in your subscription, only register those resource providers that you're ready to use. Para registrar um provedor de recursos, use:To register a resource provider, use:

Register-AzResourceProvider -ProviderNamespace Microsoft.Batch

Que retorna resultados semelhantes a:Which returns results similar to:

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

Para obter informações para um provedor de recursos específico, use:To see information for a particular resource provider, use:

Get-AzResourceProvider -ProviderNamespace Microsoft.Batch

Que retorna resultados semelhantes a:Which returns results similar to:

{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:To see the resource types for a resource provider, use:

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

Que retorna:Which returns:

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.The API version corresponds to a version of REST API operations that are released by the resource provider. Conforme um provedor de recursos habilita novos recursos, ele lança uma nova versão da API REST.As a resource provider enables new features, it releases a new version of the REST API.

Para obter versões de API disponíveis para um tipo de recurso, use:To get the available API versions for a resource type, use:

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

Que retorna:Which returns:

2017-05-01
2017-01-01
2015-12-01
2015-09-01
2015-07-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.Resource Manager is supported in all regions, but the resources you deploy might not be supported in all regions. Além disso, pode haver limitações na sua assinatura que impeçam o uso de algumas regiões que dão suporte ao recurso.Also, there may be limitations on your subscription that prevent you from using some regions that support the resource.

Para obter as localizações com suporte para um tipo de recurso, use.To get the supported locations for a resource type, use.

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

Que retorna:Which returns:

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

CLI do AzureAzure CLI

Para ver todos os provedores de recursos no Azure e o status do registro para a sua assinatura, use:To see all resource providers in Azure, and the registration status for your subscription, use:

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

Que retorna resultados semelhantes a:Which returns results similar to:

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

Para ver todos os provedores de recursos registrados para sua assinatura, use:To see all registered resource providers for your subscription, use:

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

Para manter os privilégios mínimos em sua assinatura, registre apenas os provedores de recursos que você está pronto para usar.To maintain least privileges in your subscription, only register those resource providers that you're ready to use. Para registrar um provedor de recursos, use:To register a resource provider, use:

az provider register --namespace Microsoft.Batch

Que retorna uma mensagem de que o registro está em andamento.Which returns a message that registration is on-going.

Para obter informações para um provedor de recursos específico, use:To see information for a particular resource provider, use:

az provider show --namespace Microsoft.Batch

Que retorna resultados semelhantes a:Which returns results similar to:

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

Para ver os tipos de recurso para um provedor de recursos, use:To see the resource types for a resource provider, use:

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

Que retorna:Which returns:

Result
---------------
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.The API version corresponds to a version of REST API operations that are released by the resource provider. Conforme um provedor de recursos habilita novos recursos, ele lança uma nova versão da API REST.As a resource provider enables new features, it releases a new version of the REST API.

Para obter versões de API disponíveis para um tipo de recurso, use:To get the available API versions for a resource type, use:

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

Que retorna:Which returns:

Result
---------------
2017-05-01
2017-01-01
2015-12-01
2015-09-01
2015-07-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.Resource Manager is supported in all regions, but the resources you deploy might not be supported in all regions. Além disso, pode haver limitações na sua assinatura que impeçam o uso de algumas regiões que dão suporte ao recurso.Also, there may be limitations on your subscription that prevent you from using some regions that support the resource.

Para obter as localizações com suporte para um tipo de recurso, use.To get the supported locations for a resource type, use.

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

Que retorna:Which returns:

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

Próximas etapasNext steps