Grundlegendes zu Azure-Ressourcen
Alle Azure-Ressourcen werden mit einem bestimmten Typ bereitgestellt. Der Typ gibt die Art der Ressource an. Eine Ressourcen-ID ist die Art und Weise, wie Azure eine bestimmte Instanz einer Ressource identifiziert. Es ist wichtig zu verstehen, wie Ressourcentypen und Ressourcen-IDs strukturiert sind, da sie wichtige Informationen beim Schreiben von Bicep-Vorlagen bereitstellen.
Ressourcenanbieter
Azure Resource Manager ist so konzipiert, dass viele verschiedene Ressourcenanbieter über Resource Manager-APIs und ARM-Vorlagen verwaltet werden können. Ein Ressourcenanbieter ist eine logische Gruppierung von Ressourcentypen, die sich in der Regel auf einen oder ein paar Azure-Dienste beziehen. Beispiele für Ressourcenanbieter sind unter anderem:
Microsoft.Compute
: Wird für virtuelle Computer verwendet.Microsoft.Network
: Wird für Netzwerkressourcen wie virtuelle Netzwerke, Netzwerksicherheitsgruppen und Routingtabellen verwendet.Microsoft.Cache
: Wird für Azure Cache for Redis verwendet.Microsoft.Sql
: Wird für Azure SQL verwendet.Microsoft.Web
: Wird für Azure App Service und Azure Functions verwendet.Microsoft.DocumentDB
: Wird für Azure Cosmos DB verwendet.
Hinweis
Die Namen der Ressourcenanbieter und der Ressourcentypen stimmen gelegentlich nicht mit den Namen der Azure-Dienste überein, für die sie vorgesehen sind, wobei es sich auch um alte Produkt- oder Ressourcennamen handeln kann. Der Ressourcenanbieter für Log Analytics-Arbeitsbereiche ist beispielsweise Microsoft.OperationalInsights
.
Die Dokumentation für die ARM-Vorlagensyntax jedes Ressourcentyps ist nach Ressourcenanbieter organisiert.
Ressourcenanbieter müssen für Ihr Abonnement registriert werden, bevor Sie die von ihnen verfügbar gemachten Ressourcentypen verwenden können. Die Registrierung ist in der Regel ein einmaliger Prozess. Wenn Sie eine Bicep-Bereitstellung übermitteln, registriert der Resource Manager automatisch die in der Datei verwendeten Ressourcenanbieter. Sie können auch mithilfe des Azure-Portals, der Azure CLI oder mit Azure PowerShell einen Ressourcenanbieter registrieren.
Ressourcentypen
Ein Ressourcenanbieter macht mehrere verschiedene Typen verfügbar. Jeder Ressourcentyp verfügt über einen eigenen Satz von Eigenschaften und Verhaltensweisen, die die Ressource und ihre Funktionsmöglichkeiten definieren. Beispielsweise gibt es innerhalb des Ressourcenanbieters Microsoft.Web
mehrere Ressourcentypen, darunter:
sites
: Definiert eine App Service-Anwendung oder Azure Functions-Anwendung. Zu den Eigenschaften gehören die Umgebungsvariablen, die ihre Anwendung verwendet, und die unterstützten Protokolle (HTTP und HTTPS), um auf die Anwendung zuzugreifen.serverFarms
: Definiert einen App Service-Plan, die Infrastruktur, in der Ihre Anwendungen ausgeführt wird. Zu den Eigenschaften gehören die Größe und SKU der Server sowie die Anzahl der Instanzen Ihres Plans, die Sie bereitstellen möchten.
Wenn Sie Ressourcen in Bicep definieren, müssen Sie deren Ressourcentyp und die Version der API des Ressourcenanbieters angeben, die Bicep für die Ressource verwenden soll. Diese Informationen teilen den Bicep-Tools und dem Resource Manager mit, welche Eigenschaften mit der Ressourcendefinition bereitgestellt werden sollten.
Tipp
Es ist eine gute Idee, eine aktuelle API-Version für jede Ressource zu verwenden. Neue Features in Azure-Diensten sind manchmal nur in neueren API-Versionen verfügbar.
Sie kombinieren den Ressourcenanbieter und den Typnamen, um einen vollqualifizierten Ressourcentypnamen zu erhalten. Der vollqualifizierte Typname besteht aus dem Namen des Ressourcenanbieters, einem Schrägstrich (/
) und dem Ressourcentyp. Beispielsweise lautet der vollqualifizierte Typname eines Speicherkontos Microsoft.Storage/storageAccounts
. In diesem Fall ist der Name des Ressourcenanbieters Microsoft.Storage
, und der Ressourcentyp ist storageAccounts
.
Ressourcen-IDs
Jede Azure-Ressource besitzt eine eindeutige Ressourcen-ID. Diese ID enthält Informationen, die dabei helfen, die Ressource von jeder anderen Ressource desselben Typs oder sogar von anderen Ressourcen zu unterscheiden, die möglicherweise denselben Namen haben. Eine Ressourcen-ID für ein Speicherkonto sieht aus wie folgt:
/subscriptions/A123b4567c-1234-1a2b-2b1a-1234abc12345/resourceGroups/ToyDevelopment/providers/Microsoft.Storage/storageAccounts/secrettoys
Sehen wir uns eine visuelle Darstellung derselben Informationen an:
Sie sehen, dass eine Ressourcen-ID Informationen über den Ressourcentyp und die spezifische Ressource, die Sie bereitgestellt haben, kombiniert. Lassen Sie uns diese Beispielressourcen-ID in ihre Komponenten zerlegen:
subscriptions/A123b4567c-1234-1a2b-2b1a-1234abc12345
gibt an, dass sich diese Ressource in dem Azure-Abonnement mit folgender ID befindet:A123b4567c-1234-1a2b-2b1a-1234abc12345
.resourceGroups/ToyDevelopment
gibt an, dass sich die Ressource innerhalb der Ressourcengruppe namensToyDevelopment
befindet.providers/Microsoft.Storage
gibt an, dass die Ressource einen Typ des RessourcenanbietersMicrosoft.Storage
verwendet.storageAccounts
ist der Ressourcentyp.secrettoys
ist der Name des Speicherkontos.
Tipp
Sie können auf die ID einer beliebigen Ressource in Bicep zugreifen, indem Sie den symbolischen Namen und die Eigenschaft id
verwenden. Wenn Sie beispielsweise ein Speicherkonto mit dem symbolischen Namen toyDesignDocumentsStorageAccount
definieren, können Sie mithilfe des Ausdrucks toyDesignDocumentsStorageAccount.id
auf die Ressourcen-ID des Namens zugreifen.
Nachdem Sie nun die Grundlagen von Ressourcentypen und Ressourcen-IDs verstanden haben, sehen wir uns untergeordnete Ressourcen an.