Azure-Ressourcenanbieter und -typen
Ein Azure-Ressourcenanbieter ist ein Satz von REST-Vorgängen, die Funktionen für einen bestimmten Azure-Dienst unterstützen. Der Azure 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:
- Zeigen Sie alle Ressourcenanbieter in Azure an.
- Überprüfen Sie den Registrierungsstatus eines Ressourcenanbieters.
- Registrieren eines Ressourcenanbieters.
- Zeigen Sie Ressourcentypen für einen Ressourcenanbieter an.
- Zeigen Sie gültige Standorte für einen Ressourcentyp an.
- Zeigen Sie gültige API-Versionen für einen Ressourcentyp an.
Eine Liste, die Ressourcenanbieter zu Azure-Diensten zuordnet, finden Sie unter Azure-Ressourcenanbieter und -typen.
Registrieren des Ressourcenanbieters
Stellen Sie vor Verwendung eines Ressourcenanbieters sicher, 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.
Wenn Sie einen Ressourcenanbieter registrieren, fügt Microsoft eine App für den Ressourcenanbieter hinzu. Das Registrieren unnötiger Ressourcenanbieter kann dazu führen, dass Apps, die Sie nicht erkennen, in Ihrem Microsoft Entra-Mandanten angezeigt werden. Die Windows-Azure-Dienstverwaltungs-API fügt diese Apps in der Regel hinzu. Um unnötige Apps in Ihrem Mandanten zu vermeiden, registrieren Sie nur die Ressourcenanbieter, die Sie benötigen.
Einige Ressourcenanbieter sind standardmäßig registriert. Eine Liste der Beispiele finden Sie unter Ressourcenanbieter für Azure-Dienste.
Bei bestimmten Aktionen werden andere automatisch registriert. Beim Erstellen einer Ressource über das Azure-Portal, registriert das Portal den Ressourcenanbieter in der Regel für Sie. Wenn Sie eine Azure Resource Manager-Vorlage oder Bicep-Datei bereitstellen, registriert Azure die in der Vorlage definierten Ressourcenanbieter automatisch. 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 die Erstellung von Ressourcen für einen Ressourcenanbieter nicht blockieren, wenn er 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. Wenn Sie den Ressourcenanbieter im Status „Wird registriert“ nicht blockieren, kann er 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.
Wählen Sie den Ressourcenanbieter aus, um die Details des Ressourcenanbieters anzuzeigen.
Wählen Sie den Ressourcenanbieter aus, und klicken Sie auf Registrieren. 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 nicht blockieren, wenn er sich im Status Wird registriert befindet. Wenn Sie den Ressourcenanbieter im Status „Wird registriert“ nicht blockieren, kann er früher fortfahren und muss nicht auf den Abschluss aller Regionen warten.
Registrieren Sie einen Ressourcenanbieter erneut, um Standorte verwenden zu können, die Sie seit der vorherigen Registrierung hinzugefügt haben.
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 Alle Dienste aus.
Geben Sie im Feld Alle DiensteRessourcen-Explorer ein, und wählen Sie Ressourcen-Explorer aus.
Wählen Sie die Nach-Rechts-Taste aus, um den Abschnitt Anbieter zu erweitern.
Erweitern Sie den Ressourcenanbieter und den 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
Um alle Ressourcenanbieter in Azure und den Registrierungsstatus für Ihr Abonnement anzuzeigen, verwenden Sie Folgendes:
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 nicht blockieren, wenn er sich im Status Wird registriert befindet. Wenn Sie den Ressourcenanbieter im Status „Wird registriert“ nicht blockieren, kann er früher fortfahren und muss nicht auf den Abschluss aller Regionen warten.
Um Standorte verwenden zu können, die Azure seit der vorherigen Registrierung hinzugefügt hat, registrieren Sie einen Ressourcenanbieter erneut. 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.
Um die unterstützten Standorte für einen Ressourcentyp abzurufen, verwenden Sie Folgendes:
((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-Befehlszeilenschnittstelle
Um alle Ressourcenanbieter in Azure und den Registrierungsstatus für Ihr Abonnement anzuzeigen, verwenden Sie Folgendes:
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
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:
az provider register --namespace Microsoft.Batch
Der Befehl gibt eine Meldung zurück, dass die Registrierung noch 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
Wie bereits erwähnt, sollten Sie die Erstellung von Ressourcen für einen Ressourcenanbieter nicht blockieren, wenn er sich im Status Wird registriert befindet. Wenn Sie den Ressourcenanbieter im Status „Wird registriert“ nicht blockieren, kann er früher fortfahren und muss nicht auf den Abschluss aller Regionen warten.
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
...
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.
Um die unterstützten Standorte für einen Ressourcentyp abzurufen, verwenden Sie Folgendes:
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
Um alle Ressourcenanbieter in Azure und den Registrierungsstatus für Ihr Abonnement anzuzeigen, verwenden Sie Folgendes:
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}")
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:
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
Wie bereits erwähnt, sollten Sie die Erstellung von Ressourcen für einen Ressourcenanbieter nicht blockieren, wenn er sich im Status Wird registriert befindet. Wenn Sie den Ressourcenanbieter im Status „Wird registriert“ nicht blockieren, kann er früher fortfahren und muss nicht auf den Abschluss aller Regionen warten.
Registrieren Sie einen Ressourcenanbieter erneut, um Standorte verwenden zu können, die Azure seit der vorherigen Registrierung hinzugefügt hat. Führen Sie den Registrierungsbefehl erneut aus, um die erneute Registrierung durchzuführen.
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
...
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.
Um die unterstützten Standorte für einen Ressourcentyp abzurufen, verwenden Sie Folgendes:
# 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 Resource Manager-Vorlagen finden Sie unter Verstehen der Struktur und Syntax von ARM-Vorlagen.
- Weitere Informationen zum Anzeigen von Vorlagenschemas für Ressourcenanbieter finden Sie unter Definieren von Ressourcen mit Bicep, ARM-Vorlagen und dem Terraform AzAPI-Anbieter.
- 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.