Tipos e fornecedores de recursos do Azure

Ao utilizar recursos, é frequente que recupere informações sobre os fornecedores e tipos de recursos. Por exemplo, se pretende armazenar chaves e segredos, trabalha com o fornecedor de recursos Microsoft.KeyVault. Este fornecedor de recursos oferece um tipo de recurso denominado cofres para a criação do cofre de chaves.

O nome de um tipo de recurso está no formato: {resource-provider}/{resource-type}. O tipo de recurso para um cofre chave é Microsoft.KeyVault/vaults.

Neste artigo, vai aprender a:

  • Ver todos os fornecedores de recursos em Azure
  • Verifique o estado de registo de um fornecedor de recursos
  • Registar um fornecedor de recursos
  • Ver tipos de recursos para um fornecedor de recursos
  • Ver locais válidos para um tipo de recurso
  • Ver ver versões API válidas para um tipo de recurso

Pode fazer estes passos através do portal Azure, Azure PowerShell ou 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.

Registar o fornecedor de recursos

Antes de utilizar um fornecedor de recursos, a sua assinatura Azure deve ser registada para o fornecedor de recursos. O registo configura a sua subscrição para trabalhar com o fornecedor de recursos.

Importante

Só registe um fornecedor de recursos quando estiver pronto para o utilizar. O passo de registo permite-lhe manter os privilégios mínimos dentro da sua subscrição. Um utilizador malicioso não pode usar fornecedores de recursos que não estejam registados.

Alguns fornecedores de recursos estão registados por padrão. Para obter uma lista de fornecedores de recursos registados por padrão, consulte os fornecedores de recursos para os serviços Azure.

Outros fornecedores de recursos são registados automaticamente quando toma determinadas ações. Quando implementa um modelo de Gestor de Recursos Azure, todos os fornecedores de recursos necessários são automaticamente registados. Quando cria um recurso através do portal, o fornecedor de recursos é normalmente registado para si. Para outros cenários, poderá ter de registar manualmente um fornecedor de recursos.

Importante

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. Quando regista o fornecedor de recursos, a operação é feita individualmente para cada região apoiada. Para criar recursos numa região, o registo só precisa de ser concluído naquela região. Ao não bloquear um 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.

Tem de ter autorização para fazer a /register/action operação para o fornecedor de recursos. A permissão está incluída nas funções de Contribuinte e Proprietário.

Não é possível desregistar um fornecedor de recursos quando ainda tem tipos de recursos desse fornecedor de recursos na sua subscrição.

Portal do Azure

Registar o fornecedor de recursos

Para ver todos os fornecedores de recursos e o estado de registo da sua subscrição:

  1. Inicie sessão no portal do Azure.

  2. No menu do portal Azure, procure por Assinaturas. Selecione-o nas opções disponíveis.

    subscrições de pesquisa

  3. Selecione a subscrição que pretende visualizar.

    selecionar subscrições

  4. No menu esquerdo, em Definições, selecione Fornecedores de Recursos.

    selecione fornecedores de recursos

  5. Encontre o fornecedor de recursos que pretende registar-se e selecione Registar-se. Para manter os privilégios mínimos na sua subscrição, registe apenas os fornecedores de recursos que está pronto a utilizar.

    registar fornecedores de recursos

Importante

Como já foi notado, não bloqueie a criação de recursos para um fornecedor de recursos que se encontra no estado de registo. Ao não bloquear um 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.

Ver fornecedor de recursos

Para ver informações para um determinado fornecedor de recursos:

  1. Inicie sessão no portal do Azure.

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

  3. Na caixa de todos os serviços, insira o explorador de recursos e, em seguida, selecione Resource Explorer.

    selecionar Todos os serviços

  4. Expandir fornecedores selecionando a seta direita.

    Selecione fornecedores

  5. Expanda um fornecedor de recursos e um tipo de recurso que pretende visualizar.

    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. Além disso, pode haver limitações na sua subscrição que o impedem de usar algumas regiões que suportam o recurso. O explorador de recursos apresenta locais válidos para o tipo de recurso.

    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. Como fornecedor de recursos permite novas funcionalidades, lança uma nova versão da API REST. O explorador de recursos apresenta versões API válidas para o tipo de recurso.

    Mostrar versões API

Azure PowerShell

Para ver todos os fornecedores de recursos em Azure, e o estado de registo da sua subscrição, utilize:

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 consultar todos os fornecedores de recursos registados para a sua subscrição, utilize:

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

Para manter os privilégios mínimos na sua subscrição, registe apenas os fornecedores de recursos que está pronto a utilizar. Para registar um fornecedor de recursos, utilize:

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

Como já foi notado, não bloqueie a criação de recursos para um fornecedor de recursos que se encontra no estado de registo. Ao não bloquear um 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.

Para obter informações para um determinado fornecedor de recursos, utilize:

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 recursos de um fornecedor de recursos, utilize:

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

O comando retorna:

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. Como fornecedor de recursos permite novas funcionalidades, lança uma nova versão da API REST.

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

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

O comando retorna:

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. Além disso, pode haver limitações na sua subscrição que o impedem de usar algumas regiões que suportam o recurso.

Para obter os locais suportados 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 fornecedores de recursos em Azure, e o estado de registo da sua subscrição, utilize:

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 consultar todos os fornecedores de recursos registados para a sua subscrição, utilize:

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

Para manter os privilégios mínimos na sua subscrição, registe apenas os fornecedores de recursos que está pronto a utilizar. Para registar um fornecedor de recursos, utilize:

az provider register --namespace Microsoft.Batch

O comando devolve uma mensagem de que o registo está em curso.

Para obter informações para um determinado fornecedor de recursos, utilize:

az provider show --namespace Microsoft.Batch

O comando retorna:

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

Importante

Como já foi notado, não bloqueie a criação de recursos para um fornecedor de recursos que se encontra no estado de registo. Ao não bloquear um 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.

Para ver os tipos de recursos de um fornecedor de recursos, utilize:

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

O comando retorna:

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. Como fornecedor de recursos permite novas funcionalidades, lança uma nova versão da API REST.

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

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

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. Além disso, pode haver limitações na sua subscrição que o impedem de usar algumas regiões que suportam o recurso.

Para obter os locais suportados 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
...

Passos seguintes