Azure-resourceproviders en -typen

Bij het implementeren van resources moet u vaak informatie ophalen over de resourceproviders en -typen. Als u bijvoorbeeld sleutels en geheimen wilt opslaan, werkt u met de resourceprovider Microsoft.KeyVault. Deze resourceprovider biedt een resourcetype kluizen voor het maken van de sleutelkluis.

De naam van een resourcetype heeft deze syntaxis: {resourceprovider}/{resourcetype}. Het resourcetype voor een sleutelkluis is Microsoft.keyvault\vaults.

In dit artikel leert u het volgende:

• Alles weergeven-resourceproviders in Azure
• De registratiestatus van een resourceprovider controleren
• Registreer een resourceprovider
• Resourcetypen voor een resourceprovider weergeven
• Geldige locaties voor een resourcetype weergeven
• Geldige API-versies voor een resourcetype weergeven

U kunt deze stappen uitvoeren via de Azure Portal, Azure PowerShell of Azure CLI.

Zie Resourceproviders voor Azure-services voor een lijst met resourceproviders aan Azure-services.

Resourceprovider registreren

Voordat u een resourceprovider gebruikt, moet uw Azure-abonnement zijn geregistreerd voor de resourceprovider. Registratie configureert uw abonnement om te werken met de resourceprovider.

Sommige resourceproviders worden standaard geregistreerd. Zie Resourceproviders voor Azure-servicesvoor een lijst met resourceproviders die standaard zijn geregistreerd.

Andere resourceproviders worden automatisch geregistreerd wanneer u bepaalde acties ondernomen. Wanneer u een resource maakt via de portal, wordt de resourceprovider doorgaans voor u geregistreerd. Wanneer u een sjabloon Azure Resource Manager Bicep implementeert, worden resourceproviders die in de sjabloon zijn gedefinieerd, automatisch geregistreerd. Als een resource in de sjabloon echter ondersteunende resources maakt die niet in de sjabloon staan, zoals bewakings- of beveiligingsresources, moet u deze resourceproviders handmatig registreren.

Voor andere scenario's moet u mogelijk handmatig een resourceprovider registreren.

U moet machtigingen hebben om de bewerking /register/action voor de resourceprovider uit te voeren. De machtiging is opgenomen in de rollen Inzender en Eigenaar.

U kunt de registratie van een resourceprovider niet ongedaan maken wanneer u nog steeds resourcetypen van die resourceprovider in uw abonnement hebt.

Azure Portal

Resourceprovider registreren

Alle resourceproviders en de registratiestatus voor uw abonnement weergeven:

1. Meld u aan bij de Azure-portal.

2. Zoek in het menu Azure Portal naar Abonnementen. Selecteer Tags bij de beschikbare opties.

   

3. Selecteer het abonnement dat u wilt bekijken.

   

4. Selecteer onder Instellingen in het menu links de optie Resourceproviders.

   

5. Zoek de resourceprovider die u wilt registreren en selecteer Registreren. Als u de minste bevoegdheden in uw abonnement wilt behouden, registreert u alleen de resourceproviders die u klaar bent voor gebruik.

   

Resourceprovider weergeven

Informatie voor een bepaalde resourceprovider bekijken:

1. Meld u aan bij Azure Portal.

2. Selecteer Alle services in het menu van Azure Portal.

3. Voer in het vak Alle services resourceverkenner in en selecteer vervolgens Resourceverkenner.

   

4. Vouw Providers uit door de pijl-rechts te selecteren.

   

5. Vouw een resourceprovider en resourcetype uit die u wilt weergeven.

   

6. Resource Manager wordt ondersteund in alle regio's, maar de resources die u implementeert, worden mogelijk niet in alle regio's ondersteund. Er kunnen ook beperkingen zijn voor uw abonnement die verhinderen dat u bepaalde regio's gebruikt die ondersteuning bieden voor de resource. In resourceverkenner worden geldige locaties voor het resourcetype weergegeven.

   

7. De API-versie komt overeen met een versie van REST API bewerkingen die worden vrijgegeven door de resourceprovider. Omdat een resourceprovider nieuwe functies mogelijk maakt, wordt er een nieuwe versie van de REST API. De resourceverkenner geeft geldige API-versies weer voor het resourcetype.

   

Azure PowerShell

Als u alle resourceproviders in Azure en de registratiestatus voor uw abonnement wilt zien, gebruikt u:

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

De opdracht retourneert:

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

Als u alle geregistreerde resourceproviders voor uw abonnement wilt zien, gebruikt u:

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

Als u de minste bevoegdheden in uw abonnement wilt behouden, registreert u alleen de resourceproviders die u klaar bent voor gebruik. Als u een resourceprovider wilt registreren, gebruikt u:

Register-AzResourceProvider -ProviderNamespace Microsoft.Batch

De opdracht retourneert:

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

Als u informatie voor een bepaalde resourceprovider wilt bekijken, gebruikt u:

Get-AzResourceProvider -ProviderNamespace Microsoft.Batch

De opdracht retourneert:

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

...

Als u de resourcetypen voor een resourceprovider wilt zien, gebruikt u:

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

De opdracht retourneert:

batchAccounts
operations
locations
locations/quotas

De API-versie komt overeen met een versie van REST API bewerkingen die worden vrijgegeven door de resourceprovider. Omdat een resourceprovider nieuwe functies mogelijk maakt, wordt er een nieuwe versie van de REST API.

Gebruik het volgende om de beschikbare API-versies voor een resourcetype op te halen:

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

De opdracht retourneert:

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

Resource Manager wordt ondersteund in alle regio's, maar de resources die u implementeert, worden mogelijk niet in alle regio's ondersteund. Er kunnen ook beperkingen zijn voor uw abonnement die verhinderen dat u bepaalde regio's gebruikt die ondersteuning bieden voor de resource.

Gebruik om de ondersteunde locaties voor een resourcetype op te halen.

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

De opdracht retourneert:

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

Azure CLI

Als u alle resourceproviders in Azure en de registratiestatus voor uw abonnement wilt zien, gebruikt u:

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

De opdracht retourneert:

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

Als u alle geregistreerde resourceproviders voor uw abonnement wilt zien, gebruikt u:

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

Als u de minste bevoegdheden in uw abonnement wilt behouden, registreert u alleen de resourceproviders die u klaar bent voor gebruik. Als u een resourceprovider wilt registreren, gebruikt u:

az provider register --namespace Microsoft.Batch

De opdracht retourneert een bericht dat de registratie wordt door gegeven.

Als u informatie voor een bepaalde resourceprovider wilt bekijken, gebruikt u:

az provider show --namespace Microsoft.Batch

De opdracht retourneert:

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

Als u de resourcetypen voor een resourceprovider wilt zien, gebruikt u:

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

De opdracht retourneert:

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

De API-versie komt overeen met een versie van REST API bewerkingen die worden vrijgegeven door de resourceprovider. Omdat een resourceprovider nieuwe functies mogelijk maakt, wordt er een nieuwe versie van de REST API.

Gebruik het volgende om de beschikbare API-versies voor een resourcetype op te halen:

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

De opdracht retourneert:

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

Resource Manager wordt ondersteund in alle regio's, maar de resources die u implementeert, worden mogelijk niet in alle regio's ondersteund. Er zijn mogelijk ook beperkingen voor uw abonnement die verhinderen dat u bepaalde regio's gebruikt die ondersteuning bieden voor de resource.

Gebruik om de ondersteunde locaties voor een resourcetype op te halen.

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

De opdracht retourneert:

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

Volgende stappen

• Zie Sjablonen Resource Manager maken voor meer informatie over het maken Azure Resource Manager sjablonen.
• Zie Sjabloonverwijzing als u de sjabloonschema's van de resourceprovider wilt weergeven.
• Zie Resourceproviders voor Azure-services voor een lijst met resourceproviders aan Azure-services.
• Zie Azure REST API om de bewerkingen voor een resourceprovider weer te REST API.