Tipos e fornecedores de recursos do AzureAzure resource providers and types

Ao utilizar recursos, é frequente que recupere informações sobre os fornecedores e tipos de recursos.When deploying resources, you frequently need to retrieve information about the resource providers and types. Por exemplo, se pretende armazenar chaves e segredos, trabalha com o fornecedor de recursos Microsoft.KeyVault.For example, if you want to store keys and secrets, you work with the Microsoft.KeyVault resource provider. Este fornecedor de recursos oferece um tipo de recurso denominado cofres para a criação do cofre de chaves.This resource provider offers a resource type called vaults for creating the key vault.

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

Neste artigo, vai aprender a:In this article, you learn how to:

  • Ver todos os fornecedores de recursos em AzureView all resource providers in Azure
  • Verifique o estado de registo de um fornecedor de recursosCheck registration status of a resource provider
  • Registar um fornecedor de recursosRegister a resource provider
  • Ver tipos de recursos para um fornecedor de recursosView resource types for a resource provider
  • Ver locais válidos para um tipo de recursoView valid locations for a resource type
  • Ver ver versões API válidas para um tipo de recursoView valid API versions for a resource type

Pode fazer estes passos através do portal Azure PowerShell ou Azure CLI.You can do these steps through the Azure portal, Azure PowerShell, or Azure CLI.

Para obter uma lista que mapeia os fornecedores de recursos para os serviços Azure, consulte os fornecedores de recursos para os serviços Azure.For a list that maps resource providers to Azure services, see Resource providers for Azure services.

Registar o fornecedor de recursosRegister resource provider

Antes de utilizar um fornecedor de recursos, a sua assinatura Azure deve ser registada para o fornecedor de recursos.Before using a resource provider, your Azure subscription must be registered for the resource provider. O registo configura a sua subscrição para trabalhar com o fornecedor de recursos.Registration configures your subscription to work with the resource provider. Alguns fornecedores de recursos estão registados por padrão.Some resource providers are registered by default. Outros fornecedores de recursos são registados automaticamente quando toma determinadas ações.Other resource providers are registered automatically when you take certain actions. Por exemplo, quando cria um recurso através do portal, o fornecedor de recursos é normalmente registado para si.For example, when you create a resource through the portal, the resource provider is typically registered for you. Para outros cenários, poderá ter de registar manualmente um fornecedor de recursos.For other scenarios, you may need to manually register a resource provider.

Este artigo mostra-lhe como verificar o estado de registo de um fornecedor de recursos e registá-lo conforme necessário.This article shows you how to check the registration status of a resource provider, and register it as needed. Tem de ter autorização para fazer a /register/action operação para o fornecedor 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 de Contribuinte e Proprietário.The permission is included in the Contributor and Owner roles.

O seu código de aplicação não deve bloquear a criação de recursos para um fornecedor de recursos que se encontra no estado de registo.Your application code shouldn't block the creation of resources for a resource provider that is in the registering state. Quando regista o fornecedor de recursos, a operação é feita individualmente para cada região apoiada.When you register the resource provider, the operation is done individually for each supported region. Para criar recursos numa região, o registo só precisa de ser concluído naquela região.To create resources in a region, the registration only needs to be completed in that region. Ao não bloquear o fornecedor de recursos no estado de registo, a sua aplicação pode continuar muito mais cedo do que esperar que todas as regiões completem.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 desregistar um fornecedor de recursos quando ainda tem tipos de recursos desse fornecedor de recursos na sua subscrição.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 fornecedores de recursos e o estado de registo da sua subscrição:To see all resource providers, and the registration status for your subscription:

  1. Inicie sessão 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 subscrições

  3. Na caixa de todos os serviços, introduza a subscrição e, em seguida, selecione Subscrições.In the All services box, enter subscription , and then select Subscriptions.

  4. Selecione a subscrição da lista de subscrição para visualizar.Select the subscription from the subscription list to view.

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

    mostrar fornecedores de recursos

  6. Para registar um fornecedor de recursos, selecione Registar-se.To register a resource provider, select Register. Na imagem anterior, o link Register é destacado para microsoft.Blueprint.In the previous screenshot, the Register link is highlighted for Microsoft.Blueprint.

Para ver informações para um determinado fornecedor de recursos:To see information for a particular resource provider:

  1. Inicie sessão 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 de todos os serviços, insira o explorador de recursos e, em seguida, selecione Resource Explorer.In the All services box, enter resource explorer , and then select Resource Explorer.

    selecionar Todos os serviços

  4. Expandir fornecedores selecionando a seta direita.Expand Providers by selecting the right arrow.

    Selecione fornecedores

  5. Expanda um fornecedor de recursos e um tipo de recurso que pretende visualizar.Expand a resource provider and resource type that you want to view.

    Selecione o tipo de recurso

  6. O Gestor de Recursos é apoiado em todas as regiões, mas os recursos que você implanta podem não ser suportados 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 subscrição que o impedem de usar algumas regiões que suportam o recurso.Also, there may be limitations on your subscription that prevent you from using some regions that support the resource. O explorador de recursos apresenta locais válidos para o tipo de recurso.The resource explorer displays valid locations for the resource type.

    Mostrar locais

  7. A versão API corresponde a uma versão das operações rest API que são lançadas pelo fornecedor de recursos.The API version corresponds to a version of REST API operations that are released by the resource provider. Como fornecedor de recursos permite novas funcionalidades, 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 explorador de recursos apresenta versões API válidas para o tipo de recurso.The resource explorer displays valid API versions for the resource type.

    Mostrar versões API

Azure PowerShellAzure PowerShell

Para ver todos os fornecedores de recursos em Azure, e o estado de registo da sua subscrição, utilize:To see all resource providers in Azure, and the registration status for your subscription, use:

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

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

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

Para consultar todos os fornecedores de recursos registados para a sua subscrição, utilize: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 registar um fornecedor de recursos, utilize:To register a resource provider, use:

Register-AzResourceProvider -ProviderNamespace Microsoft.Batch

Que devolve 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 determinado fornecedor de recursos, utilize:To see information for a particular resource provider, use:

Get-AzResourceProvider -ProviderNamespace Microsoft.Batch

Que devolve 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 recursos de um fornecedor de recursos, utilize:To see the resource types for a resource provider, use:

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

Que devolve:Which returns:

batchAccounts
operations
locations
locations/quotas

A versão API corresponde a uma versão das operações rest API que são lançadas pelo fornecedor de recursos.The API version corresponds to a version of REST API operations that are released by the resource provider. Como fornecedor de recursos permite novas funcionalidades, 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 as versões API disponíveis para um tipo de recurso, utilize:To get the available API versions for a resource type, use:

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

Que devolve:Which returns:

2017-05-01
2017-01-01
2015-12-01
2015-09-01
2015-07-01

O Gestor de Recursos é apoiado em todas as regiões, mas os recursos que você implanta podem não ser suportados 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 subscrição que o impedem de usar algumas regiões que suportam o recurso.Also, there may be limitations on your subscription that prevent you from using some regions that support the resource.

Para obter os locais suportados 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 devolve:Which returns:

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

CLI do AzureAzure CLI

Para ver todos os fornecedores de recursos em Azure, e o estado de registo da sua subscrição, utilize: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 devolve resultados semelhantes a:Which returns results similar to:

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

Para consultar todos os fornecedores de recursos registados para a sua subscrição, utilize: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 registar um fornecedor de recursos, utilize:To register a resource provider, use:

az provider register --namespace Microsoft.Batch

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

Para obter informações para um determinado fornecedor de recursos, utilize:To see information for a particular resource provider, use:

az provider show --namespace Microsoft.Batch

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

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

Para ver os tipos de recursos de um fornecedor de recursos, utilize:To see the resource types for a resource provider, use:

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

Que devolve:Which returns:

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

A versão API corresponde a uma versão das operações rest API que são lançadas pelo fornecedor de recursos.The API version corresponds to a version of REST API operations that are released by the resource provider. Como fornecedor de recursos permite novas funcionalidades, 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 as versões API disponíveis para um tipo de recurso, utilize: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 devolve:Which returns:

Result
---------------
2017-05-01
2017-01-01
2015-12-01
2015-09-01
2015-07-01

O Gestor de Recursos é apoiado em todas as regiões, mas os recursos que você implanta podem não ser suportados 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 subscrição que o impedem de usar algumas regiões que suportam o recurso.Also, there may be limitations on your subscription that prevent you from using some regions that support the resource.

Para obter os locais suportados 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 devolve:Which returns:

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

Passos seguintesNext steps