Grundlegendes zu Azure-Ressourcen

Abgeschlossen

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:

Ressourcen-ID für ein Speicherkonto, aufgeteilt mit einem Schlüssel-Wert-Paar auf eine separate Zeile.

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 namens ToyDevelopment befindet.
  • providers/Microsoft.Storage gibt an, dass die Ressource einen Typ des Ressourcenanbieters Microsoft.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.