Azure-Ressourcenanbieter und -typen

Artikel
07/31/2023

Ein Azure-Ressourcenanbieter ist ein Satz von REST-Vorgängen, die Funktionen für einen bestimmten Azure-Dienst ermöglichen. Der Key Vault-Dienst besteht beispielsweise aus einem Ressourcenanbieter namens Microsoft.KeyVault. Der Ressourcenanbieter definiert REST-Vorgänge für die Verwaltung von Tresoren, Geheimnissen, Schlüsseln und Zertifikaten.

Der Ressourcenanbieter definiert die Azure-Ressourcen, die Sie für Ihr Konto bereitstellen können. Der Name eines Ressourcentyps hat folgendes Format: {Ressourcenanbieter}/{Ressourcentyp}. Der Ressourcentyp für einen Schlüsseltresor ist Microsoft.KeyVault/vaults.

In diesem Artikel werden folgende Vorgehensweisen behandelt:

Anzeigen aller Ressourcenanbieter in Azure
Überprüfen des Registrierungsstatus eines Ressourcenanbieters
Registrieren eines Ressourcenanbieters
Anzeigen von Ressourcentypen für einen Ressourcenanbieter
Anzeigen gültiger Standorte für einen Ressourcentyp
Anzeigen gültiger API-Versionen für einen Ressourcentyp

Eine Liste, die Ressourcenanbieter zu Azure-Diensten zuordnet, finden Sie unter Ressourcenanbieter für Azure-Dienste.

Registrieren des Ressourcenanbieters

Bevor Sie einen Ressourcenanbieter verwenden, müssen Sie sicherstellen, dass Ihr Azure-Abonnement für den Ressourcenanbieter registriert ist. Durch die Registrierung wird Ihr Abonnement für die Verwendung mit dem Ressourcenanbieter konfiguriert.

Wichtig

Registrieren Sie einen Ressourcenanbieter nur dann, wenn Sie ihn nutzen möchten. Dieser Registrierungsschritt ermöglicht es Ihnen, die geringstmöglichen Berechtigungen innerhalb Ihres Abonnements beizubehalten. Böswillige Benutzer*innen können keine nicht registrierten Ressourcenanbieter verwenden.

Das Registrieren unnötiger Ressourcenanbieter kann dazu führen, dass nicht erkannte Apps in Ihrem Microsoft Entra-Mandanten angezeigt werden. Microsoft fügt die App für einen Ressourcenanbieter hinzu, wenn Sie sie registrieren. Diese Apps werden in der Regel von der Windows Azure-Dienstverwaltungs-API hinzugefügt. Um unnötige Apps in Ihrem Mandanten zu vermeiden, registrieren Sie nur erforderliche Ressourcenanbieter.

Einige Ressourcenanbieter sind standardmäßig registriert. Eine Liste der standardmäßig registrierten Anbieter von Azure-Ressourcen finden Sie unter Ressourcenanbieter für Azure-Dienste.

Andere werden bei bestimmten Aktionen automatisch registriert. Beim Erstellen einer Ressource über das Portal wird der Ressourcenanbieter in der Regel für Sie registriert. Wenn Sie eine Azure Resource Manager-Vorlage oder Bicep-Datei bereitstellen, werden in der Vorlage definierte Ressourcenanbieter automatisch registriert. Manchmal erfordert eine Ressource in der Vorlage unterstützende Ressourcen, die nicht in der Vorlage enthalten sind. Gängige Beispiele sind Überwachungs- oder Sicherheitsressourcen. Sie müssen diese Ressourcenanbieter manuell registrieren.

In anderen Szenarien müssen Sie den Ressourcenanbieter unter Umständen manuell registrieren.

Wichtig

Ihr Anwendungscode sollte nicht die Erstellung von Ressourcen für einen Ressourcenanbieter blockieren, der sich im Status Wird registriert befindet. Wenn Sie den Ressourcenanbieter registrieren, wird der Vorgang für jede unterstützte Region einzeln ausgeführt. Um Ressourcen in einer Region zu erstellen, muss die Registrierung nur in dieser Region abgeschlossen werden. Indem Sie den Ressourcenanbieter im Status „Wird registriert“ nicht blockieren, kann die Anwendung viel früher fortfahren und muss nicht auf den Abschluss aller Regionen warten.

Sie benötigen Berechtigungen zum Ausführen des /register/action-Vorgangs für den Ressourcenanbieter. Die Berechtigung ist in den Rollen „Mitwirkender“ und „Besitzer“ enthalten.

Sie können die Registrierung eines Ressourcenanbieters nicht aufheben, wenn in Ihrem Abonnement noch Ressourcentypen von diesem Ressourcenanbieter vorhanden sind.

Registrieren Sie einen Ressourcenanbieter erneut, wenn der Ressourcenanbieter neue Standorte unterstützt, die Sie verwenden müssen.

Azure-Portal

Registrieren des Ressourcenanbieters

So zeigen Sie alle Ressourcenanbieter und den Registrierungsstatus für Ihr Abonnement an

Melden Sie sich beim Azure-Portal an.
Suchen Sie im Menü im Azure-Portal nach Abonnements. Wählen Sie es aus den verfügbaren Optionen aus.
Wählen Sie das Abonnement aus, das Sie anzeigen möchten.
Wählen Sie im linken Menü unter Einstellungen die Option Ressourcenanbieter aus.
Suchen Sie den Ressourcenanbieter, den Sie registrieren möchten, und wählen Sie Registrieren aus. Um die geringstmöglichen Berechtigungen innerhalb Ihres Abonnements beizubehalten, registrieren Sie nur die Ressourcenanbieter, die Sie bereit sind zu verwenden.

Wichtig

Wie bereits erwähnt, sollten Sie die Erstellung von Ressourcen für einen Ressourcenanbieter, der sich im Status Wird registriert befindet, nicht blockieren. Indem Sie den Ressourcenanbieter im Status „Wird registriert“ nicht blockieren, kann die Anwendung viel früher fortfahren und muss nicht auf den Abschluss aller Regionen warten.
Sie müssen einen Ressourcenanbieter erneut registrieren, um Standorte verwenden zu können, die seit der vorherigen Registrierung hinzugefügt wurden.

Anzeigen des Ressourcenanbieters

So zeigen Sie Informationen für einen bestimmten Ressourcenanbieter an

Melden Sie sich beim Azure-Portal an.
Wählen Sie im Menü des Azure-Portals die Option Alle Dienste aus.
Geben Sie im Feld Alle DiensteRessourcen-Explorer ein, und wählen Sie dann Ressourcen-Explorer aus.
Erweitern Sie Anbieter, indem Sie den Pfeil nach rechts auswählen.
Erweitern Sie einen Ressourcenanbieter und Ressourcentyp, die Sie anzeigen möchten.
Der Ressourcen-Manager wird in allen Regionen unterstützt, aber die Ressourcen, die Sie bereitstellen, werden möglicherweise nicht in allen Regionen unterstützt. Darüber hinaus liegen möglicherweise Einschränkungen Ihres Abonnements vor, die die Verwendung einiger Regionen verhindern, die die Ressource unterstützen. Der Ressourcen-Explorer zeigt gültige Standorte für den Ressourcentyp an.
Die API-Version entspricht einer Version der REST-API-Vorgänge vom Ressourcenanbieter. Wenn ein Ressourcenanbieter neue Features aktiviert, wird eine neue Version der REST-API veröffentlicht. Der Ressourcen-Explorer zeigt gültige API-Versionen für den Ressourcentyp an.

Azure PowerShell

Verwenden Sie Folgendes, um alle Ressourcenanbieter in Azure und den Registrierungsstatus für Ihr Abonnement anzuzeigen:

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

Der Befehl gibt Folgendes zurück:

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

Verwenden Sie zum Anzeigen aller für Ihr Abonnement registrierten Ressourcenanbieter Folgendes:

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

Um die geringstmöglichen Berechtigungen innerhalb Ihres Abonnements beizubehalten, registrieren Sie nur die Ressourcenanbieter, die Sie bereit sind zu verwenden. Verwenden Sie zum Registrieren eines Ressourcenanbieters Folgendes:

Register-AzResourceProvider -ProviderNamespace Microsoft.Batch

Der Befehl gibt Folgendes zurück:

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

Wichtig

Wie bereits erwähnt, sollten Sie die Erstellung von Ressourcen für einen Ressourcenanbieter, der sich im Status Wird registriert befindet, nicht blockieren. Indem Sie den Ressourcenanbieter im Status „Wird registriert“ nicht blockieren, kann die Anwendung viel früher fortfahren und muss nicht auf den Abschluss aller Regionen warten.

Sie müssen einen Ressourcenanbieter erneut registrieren, um Standorte verwenden zu können, die seit der vorherigen Registrierung hinzugefügt wurden. Führen Sie den Registrierungsbefehl erneut aus, um die erneute Registrierung durchzuführen.

Verwenden Sie Folgendes, um Informationen für einen bestimmten Ressourcenanbieter anzuzeigen:

Get-AzResourceProvider -ProviderNamespace Microsoft.Batch

Der Befehl gibt Folgendes zurück:

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

...

Verwenden Sie Folgendes, um die Ressourcentypen für einen Ressourcenanbieter anzuzeigen:

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

Der Befehl gibt Folgendes zurück:

batchAccounts
operations
locations
locations/quotas

Die API-Version entspricht einer Version der REST-API-Vorgänge vom Ressourcenanbieter. Wenn ein Ressourcenanbieter neue Features aktiviert, wird eine neue Version der REST-API veröffentlicht.

Verwenden Sie Folgendes, um die verfügbaren API-Versionen für einen Ressourcentyp abzurufen:

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

Der Befehl gibt Folgendes zurück:

2023-05-01
2022-10-01
2022-06-01
2022-01-01
2021-06-01
2021-01-01
...

Der Ressourcen-Manager wird in allen Regionen unterstützt, aber die Ressourcen, die Sie bereitstellen, werden möglicherweise nicht in allen Regionen unterstützt. Darüber hinaus liegen möglicherweise Einschränkungen Ihres Abonnements vor, die die Verwendung einiger Regionen verhindern, die die Ressource unterstützen.

Verwenden Sie Folgendes, um die unterstützten Standorte für einen Ressourcentyp abzurufen:

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

Der Befehl gibt Folgendes zurück:

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

Azure CLI

Verwenden Sie Folgendes, um alle Ressourcenanbieter in Azure und den Registrierungsstatus für Ihr Abonnement anzuzeigen:

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

Der Befehl gibt Folgendes zurück:

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

Verwenden Sie zum Anzeigen aller für Ihr Abonnement registrierten Ressourcenanbieter Folgendes:

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

az provider register --namespace Microsoft.Batch

Der Befehl gibt eine Meldung zurück, dass die Registrierung durchgeführt wird.

Verwenden Sie Folgendes, um Informationen für einen bestimmten Ressourcenanbieter anzuzeigen:

az provider show --namespace Microsoft.Batch

Der Befehl gibt Folgendes zurück:

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

Wichtig

Verwenden Sie Folgendes, um die Ressourcentypen für einen Ressourcenanbieter anzuzeigen:

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

Der Befehl gibt Folgendes zurück:

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

Die API-Version entspricht einer Version der REST-API-Vorgänge vom Ressourcenanbieter. Wenn ein Ressourcenanbieter neue Features aktiviert, wird eine neue Version der REST-API veröffentlicht.

Verwenden Sie Folgendes, um die verfügbaren API-Versionen für einen Ressourcentyp abzurufen:

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

Der Befehl gibt Folgendes zurück:

Result
---------------
2023-05-01
2022-10-01
2022-06-01
2022-01-01
...

Verwenden Sie Folgendes, um die unterstützten Standorte für einen Ressourcentyp abzurufen:

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

Der Befehl gibt Folgendes zurück:

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

Python

Verwenden Sie Folgendes, um alle Ressourcenanbieter in Azure und den Registrierungsstatus für Ihr Abonnement anzuzeigen:

import os  
from azure.identity import DefaultAzureCredential  
from azure.mgmt.resource import ResourceManagementClient  
  
# Authentication  
credential = DefaultAzureCredential()  
subscription_id = os.environ["AZURE_SUBSCRIPTION_ID"]  
  
# Initialize Resource Management client  
resource_management_client = ResourceManagementClient(credential, subscription_id)  
  
# List available resource providers and select ProviderNamespace and RegistrationState  
providers = resource_management_client.providers.list()  
  
for provider in providers:  
    print(f"ProviderNamespace: {provider.namespace}, RegistrationState: {provider.registration_state}")

Der Befehl gibt Folgendes zurück:

ProviderNamespace: Microsoft.AlertsManagement, RegistrationState: Registered
ProviderNamespace: Microsoft.AnalysisServices, RegistrationState: Registered
ProviderNamespace: Microsoft.ApiManagement, RegistrationState: Registered
ProviderNamespace: Microsoft.Authorization, RegistrationState: Registered
ProviderNamespace: Microsoft.Batch, RegistrationState: Registered
...

Verwenden Sie zum Anzeigen aller für Ihr Abonnement registrierten Ressourcenanbieter Folgendes:

# List available resource providers with RegistrationState "Registered" and select ProviderNamespace and RegistrationState  
providers = resource_management_client.providers.list()  
registered_providers = [provider for provider in providers if provider.registration_state == "Registered"]  
  
# Sort by ProviderNamespace  
sorted_registered_providers = sorted(registered_providers, key=lambda x: x.namespace)  
  
for provider in sorted_registered_providers:  
    print(f"ProviderNamespace: {provider.namespace}, RegistrationState: {provider.registration_state}")

import os  
from azure.identity import DefaultAzureCredential  
from azure.mgmt.resource import ResourceManagementClient  
  
# Authentication  
credential = DefaultAzureCredential()  
subscription_id = os.environ["AZURE_SUBSCRIPTION_ID"]  
  
# Initialize Resource Management client  
resource_management_client = ResourceManagementClient(credential, subscription_id)  
  
# Register resource provider  
provider_namespace = "Microsoft.Batch"  
registration_result = resource_management_client.providers.register(provider_namespace)  
  
print(f"ProviderNamespace: {registration_result.namespace}, RegistrationState: {registration_result.registration_state}")

Der Befehl gibt Folgendes zurück:

ProviderNamespace: Microsoft.Batch, RegistrationState: Registered

Wichtig

Verwenden Sie Folgendes, um Informationen für einen bestimmten Ressourcenanbieter anzuzeigen:

import os  
from azure.identity import DefaultAzureCredential  
from azure.mgmt.resource import ResourceManagementClient  
  
# Authentication  
credential = DefaultAzureCredential()  
subscription_id = os.environ["AZURE_SUBSCRIPTION_ID"]  
  
# Initialize Resource Management client  
resource_management_client = ResourceManagementClient(credential, subscription_id)  
  
# Get resource provider by ProviderNamespace  
provider_namespace = "Microsoft.Batch"  
provider = resource_management_client.providers.get(provider_namespace)  
  
print(f"ProviderNamespace: {provider.namespace}, RegistrationState: {provider.registration_state}\n")  
  
# Add resource types, locations, and API versions with new lines to separate results  
for resource_type in provider.resource_types:  
    print(f"ResourceType: {resource_type.resource_type}\nLocations: {', '.join(resource_type.locations)}\nAPIVersions: {', '.join(resource_type.api_versions)}\n")

Der Befehl gibt Folgendes zurück:

ProviderNamespace: Microsoft.Batch, RegistrationState: Registered

ResourceType: batchAccounts
Locations: West Europe, East US, East US 2, West US, North Central US, Brazil South, North Europe, Central US, East Asia, Japan East, Australia Southeast, Japan West, Korea South, Korea Central, Southeast Asia, South Central US, Australia East, Jio India West, South India, Central India, West India, Canada Central, Canada East, UK South, UK West, West Central US, West US 2, France Central, South Africa North, UAE North, Australia Central, Germany West Central, Switzerland North, Norway East, Brazil Southeast, West US 3, Sweden Central, Qatar Central, Poland Central, East US 2 EUAP, Central US EUAP
APIVersions: 2023-05-01, 2022-10-01, 2022-06-01, 2022-01-01, 2021-06-01, 2021-01-01, 2020-09-01, 2020-05-01, 2020-03-01-preview, 2020-03-01, 2019-08-01, 2019-04-01, 2018-12-01, 2017-09-01, 2017-05-01, 2017-01-01, 2015-12-01, 2015-09-01, 2015-07-01, 2014-05-01-privatepreview

...

Verwenden Sie Folgendes, um die Ressourcentypen für einen Ressourcenanbieter anzuzeigen:

# Get resource provider by ProviderNamespace  
provider_namespace = "Microsoft.Batch"  
provider = resource_management_client.providers.get(provider_namespace)  
  
# Get ResourceTypeName of the resource types  
resource_type_names = [resource_type.resource_type for resource_type in provider.resource_types]  
  
for resource_type_name in resource_type_names:  
    print(resource_type_name)

Der Befehl gibt Folgendes zurück:

batchAccounts
batchAccounts/pools
batchAccounts/detectors
batchAccounts/certificates
operations
locations
locations/quotas
locations/checkNameAvailability
locations/accountOperationResults
locations/virtualMachineSkus
locations/cloudServiceSkus

Die API-Version entspricht einer Version der REST-API-Vorgänge vom Ressourcenanbieter. Wenn ein Ressourcenanbieter neue Features aktiviert, wird eine neue Version der REST-API veröffentlicht.

Verwenden Sie Folgendes, um die verfügbaren API-Versionen für einen Ressourcentyp abzurufen:

# Get resource provider by ProviderNamespace  
provider_namespace = "Microsoft.Batch"  
provider = resource_management_client.providers.get(provider_namespace)  
  
# Filter resource type by ResourceTypeName and get its ApiVersions  
resource_type_name = "batchAccounts"  
api_versions = [  
    resource_type.api_versions  
    for resource_type in provider.resource_types  
    if resource_type.resource_type == resource_type_name  
]  
  
for api_version in api_versions[0]:  
    print(api_version)

Der Befehl gibt Folgendes zurück:

2023-05-01
2022-10-01
2022-06-01
2022-01-01
...

Verwenden Sie Folgendes, um die unterstützten Standorte für einen Ressourcentyp abzurufen:

# Get resource provider by ProviderNamespace  
provider_namespace = "Microsoft.Batch"  
provider = resource_management_client.providers.get(provider_namespace)  
  
# Filter resource type by ResourceTypeName and get its Locations  
resource_type_name = "batchAccounts"  
locations = [  
    resource_type.locations  
    for resource_type in provider.resource_types  
    if resource_type.resource_type == resource_type_name  
]  
  
for location in locations[0]:  
    print(location)

Der Befehl gibt Folgendes zurück:

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

Nächste Schritte

Weitere Informationen zum Erstellen von Ressourcen-Manager-Vorlagen finden Sie unter Erstellen von Azure-Ressourcen-Manager-Vorlagen.
Informationen zum Anzeigen der Vorlagenschemata für Ressourcenanbieter finden Sie unter Vorlagenreferenz.
Eine Liste, die Ressourcenanbieter zu Azure-Diensten zuordnet, finden Sie unter Ressourcenanbieter für Azure-Dienste.
Informationen zum Anzeigen der Vorgänge für einen Ressourcenanbieter finden Sie unter Azure-REST-API.

Azure-Ressourcenanbieter und -typen

Registrieren des Ressourcenanbieters

Azure-Portal

Registrieren des Ressourcenanbieters

Anzeigen des Ressourcenanbieters

Azure PowerShell

Azure CLI

Python

Nächste Schritte

Zusätzliche Ressourcen