Lernprogramm: Hinzufügen einer Ressource zu Ihrer Azure Resource Manager-Vorlage

Im vorherigen Lernprogramm haben Sie erfahren, wie Sie Ihre erste leere Azure Resource Manager-Vorlage (ARM-Vorlage) erstellen und bereitstellen. Jetzt können Sie eine tatsächliche Ressource für diese Vorlage bereitstellen. In diesem Fall ein Azure-Speicherkonto. Diese Anweisung wird in 9 Minuten abgeschlossen.

Voraussetzungen

Es wird empfohlen, das Einführungslernprogramm zu Vorlagen abzuschließen, dies ist jedoch nicht erforderlich.

Sie benötigen Visual Studio Code und entweder Azure PowerShell oder azure CLI. Weitere Informationen finden Sie unter Vorlagentools.

Ressource hinzufügen

Wenn Sie der vorhandenen Vorlage eine Azure-Speicherkontodefinition hinzufügen möchten, sehen Sie sich die JSON-Datei im folgenden Beispiel an. Anstatt zu versuchen, Abschnitte der Vorlage zu kopieren, kopieren Sie die gesamte Datei, und ersetzen Sie die Vorlage durch den Inhalt.

Ersetzen Sie {provide-unique-name} und die geschweiften Klammern {} mit einem eindeutigen Speicherkontonamen.

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "resources": [
    {
      "type": "Microsoft.Storage/storageAccounts",
      "apiVersion": "2025-06-01",
      "name": "{provide-unique-name}",
      "location": "eastus",
      "sku": {
        "name": "Standard_LRS"
      },
      "kind": "StorageV2",
      "properties": {
        "supportsHttpsTrafficOnly": true
      }
    }
  ]
}

Das Erraten eines eindeutigen Namens für ein Speicherkonto ist nicht einfach und funktioniert nicht gut für die Automatisierung großer Bereitstellungen. Später in dieser Tutorial-Serie verwenden Sie Vorlagenfunktionen, die das Erstellen eines eindeutigen Namens vereinfachen.

Ressourceneigenschaften

Möglicherweise fragen Sie sich, wie Sie die eigenschaften finden, die für jeden Ressourcentyp verwendet werden sollen. Sie können den ARM-Vorlagenverweis verwenden, um die Ressourcentypen zu finden, die Sie bereitstellen möchten.

Jede von Ihnen bereitgestellte Ressource weist mindestens die folgenden drei Eigenschaften auf:

• type: Typ der Ressource. Dieser Wert ist eine Kombination aus dem Namespace des Ressourcenanbieters und dem Ressourcentyp, wie z. B. Microsoft.Storage/storageAccounts.
• apiVersion: Version der REST-API, die zum Erstellen der Ressource verwendet werden soll. Jeder Ressourcenanbieter veröffentlicht seine eigenen API-Versionen, sodass dieser Wert spezifisch für den Typ ist.
• name: Name der Ressource.

Die meisten Ressourcen verfügen auch über eine location Eigenschaft, die die Region festlegt, in der Sie die Ressource bereitstellen.

Die anderen Eigenschaften variieren je nach Ressourcentyp und API-Version. Es ist wichtig, die Verbindung zwischen der API-Version und den verfügbaren Eigenschaften zu verstehen, sodass wir uns ausführlicher befassen.

In diesem Lernprogramm fügen Sie der Vorlage ein Speicherkonto hinzu. Sie können die API-Version des Speicherkontos unter "storageAccounts 2021-09-01" anzeigen. Beachten Sie, dass Sie ihrer Vorlage nicht alle Eigenschaften hinzufügen. Viele der Eigenschaften sind optional. Der Microsoft.Storage Ressourcenanbieter könnte eine neue API-Version freigeben, aber die bereitgestellte Version muss nicht geändert werden. Sie können diese Version weiterhin verwenden und wissen, dass die Ergebnisse Ihrer Bereitstellung konsistent sind.

Wenn Sie eine ältere API-Version anzeigen, sehen Sie möglicherweise, dass ein kleinerer Satz von Eigenschaften verfügbar ist.

Wenn Sie die API-Version für eine Ressource ändern möchten, stellen Sie sicher, dass Sie die Eigenschaften für diese Version auswerten und Die Vorlage entsprechend anpassen.

Bereitstellen der Vorlage

Sie können die Vorlage bereitstellen, um das Speicherkonto zu erstellen. Verwenden Sie einen anderen Namen für Ihre Bereitstellung, damit Sie sie problemlos im Verlauf finden können.

Wenn Sie die Ressourcengruppe nicht erstellt haben, lesen Sie " Erstellen einer Ressourcengruppe". Im Beispiel wird davon ausgegangen, dass Sie die templateFile Variable auf den Pfad zur Vorlagendatei festgelegt haben, wie im ersten Tutorial gezeigt.

New-AzResourceGroupDeployment `
  -Name addstorage `
  -ResourceGroupName myResourceGroup `
  -TemplateFile $templateFile

az deployment group create \
  --name addstorage \
  --resource-group myResourceGroup \
  --template-file $templateFile

Diese Fehler sind zwei mögliche Bereitstellungsfehler, die auftreten können:

• Error: Code=AccountNameInvalid; Message={provide-unique-name} ist kein gültiger Speicherkontoname. Der Name des Speicherkontos muss zwischen 3 und 24 Zeichen lang sein und nur Zahlen und Kleinbuchstaben verwenden.

  Ersetzen Sie {provide-unique-name} in der Vorlage durch einen eindeutigen Speicherkontonamen. Siehe "Ressource hinzufügen".

• Error: Code=StorageAccountAlreadyTaken; Message=The storage account named store1abc09092019 wird bereits verwendet.

  Probieren Sie in der Vorlage einen anderen Speicherkontonamen aus.

Diese Bereitstellung dauert länger als die Bereitstellung einer leeren Vorlage, da Sie ein Speicherkonto erstellen. Es kann etwa eine Minute dauern.

Überprüfen der Bereitstellung

Sie können die Bereitstellung überprüfen, indem Sie die Ressourcengruppe aus dem Azure-Portal erkunden.

1. Melden Sie sich beim Azure-Portal an.
2. Wählen Sie im linken Menü "Ressourcengruppen" aus.
3. Aktivieren Sie das Kontrollkästchen links neben myResourceGroup, und wählen Sie "myResourceGroup" aus.
4. Wählen Sie die Ressourcengruppe aus, in der Sie die Vorlage bereitgestellt haben.
5. Sie sehen, dass ein Speicherkonto bereitgestellt wurde.
6. Beachten Sie, dass die Bereitstellungsbezeichnung jetzt wie folgt lautet: Bereitstellungen: 2 erfolgreich.

Bereinigen von Ressourcen

Wenn Sie zum nächsten Lernprogramm wechseln, müssen Sie die Ressourcengruppe nicht löschen.

Falls Sie keine weiteren Tutorials durchführen möchten, können Sie die bereitgestellten Ressourcen bereinigen, indem Sie die Ressourcengruppe löschen.

1. Wählen Sie im Azure-Portal im linken Menü die Ressourcengruppe aus.
2. Geben Sie den Ressourcengruppennamen in das Feld "Filter" für ein beliebiges Feld ... ein.
3. Aktivieren Sie das Kontrollkästchen neben "myResourceGroup", und wählen Sie "myResourceGroup" oder den ausgewählten Ressourcengruppennamen aus.
4. Wählen Sie Ressourcengruppe löschen aus dem Menü ganz oben aus.

Nächste Schritte

Sie haben eine einfache Vorlage zum Bereitstellen eines Azure-Speicherkontos erstellt. In den späteren Lernprogrammen erfahren Sie, wie Sie einer Vorlage Parameter, Variablen, Ressourcen und Ausgaben hinzufügen. Diese Features sind die Bausteine für viel komplexere Vorlagen.