Zelfstudie: Een resource toevoegen aan uw Azure Resource Manager-sjabloon

In de vorige zelfstudie hebt u geleerd hoe u uw eerste lege Azure Resource Manager-sjabloon (ARM-sjabloon) kunt maken en implementeren. U bent nu klaar om een werkelijke resource in die sjabloon te implementeren. In dit geval een Azure-opslagaccount. Deze instructie duurt 9 minuten .

Vereiste voorwaarden

U wordt aangeraden de inleidende zelfstudie over sjablonen te voltooien, maar dit is niet vereist.

U moet Visual Studio Code hebben en Azure PowerShell of de Azure CLI. Zie sjabloonhulpprogramma's voor meer informatie.

Resource toevoegen

Als u een Definitie van een Azure-opslagaccount wilt toevoegen aan de bestaande sjabloon, bekijkt u het JSON-bestand in het volgende voorbeeld. In plaats van secties van de sjabloon te kopiëren, kopieert u het hele bestand en vervangt u de sjabloon door de inhoud ervan.

Vervang {provide-unique-name} en de accolades {} door een unieke opslagaccountnaam.

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

Het raden van een unieke naam voor een opslagaccount is niet eenvoudig en werkt niet goed voor het automatiseren van grote implementaties. Verderop in deze reeks zelfstudies gebruikt u sjabloonfuncties waarmee u gemakkelijker een unieke naam kunt maken.

Broneigenschappen

U vraagt zich misschien af hoe u de eigenschappen kunt vinden die voor elk resourcetype moeten worden gebruikt. U kunt de ARM-sjabloonreferentie gebruiken om de resourcetypen te vinden die u wilt implementeren.

Elke resource die u implementeert, heeft ten minste de volgende drie eigenschappen:

• type: Type van de resource. Deze waarde is een combinatie van de naamruimte van de resourceprovider en het resourcetype, zoals Microsoft.Storage/storageAccounts.
• apiVersion: Versie van de REST API die moet worden gebruikt voor het maken van de resource. Elke resourceprovider publiceert zijn eigen API-versies, dus deze waarde is specifiek voor het type.
• name: Naam van de resource.

De meeste resources hebben ook een location eigenschap, waarmee de regio wordt ingesteld waar u de resource implementeert.

De andere eigenschappen variëren per resourcetype en API-versie. Het is belangrijk om inzicht te hebben in de verbinding tussen de API-versie en de beschikbare eigenschappen, dus laten we dieper ingaan op meer informatie.

In deze zelfstudie voegt u een opslagaccount toe aan de sjabloon. U kunt de API-versie van het opslagaccount zien op storageAccounts 2021-09-01. U ziet dat u niet alle eigenschappen aan uw sjabloon toevoegt. Veel van de eigenschappen zijn optioneel. De Microsoft.Storage resourceprovider kan een nieuwe API-versie vrijgeven, maar de versie die u implementeert, hoeft niet te worden gewijzigd. U kunt die versie blijven gebruiken en weten dat de resultaten van uw implementatie consistent zijn.

Als u een oudere API-versie bekijkt, ziet u mogelijk dat er een kleinere set eigenschappen beschikbaar is.

Als u besluit de API-versie voor een resource te wijzigen, moet u ervoor zorgen dat u de eigenschappen voor die versie evalueert en de sjabloon op de juiste manier aanpast.

Sjabloon implementeren

U kunt de sjabloon implementeren om het opslagaccount te maken. Geef uw implementatie een andere naam, zodat u deze eenvoudig in de geschiedenis kunt vinden.

Zie Resourcegroep maken als u de resourcegroep nog niet hebt gemaakt. In het voorbeeld wordt ervan uitgegaan dat u de templateFile variabele hebt ingesteld op het pad naar het sjabloonbestand, zoals wordt weergegeven in de eerste zelfstudie.

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

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

Deze fouten zijn twee mogelijke implementatiefouten die kunnen optreden:

• Error: Code=AccountNameInvalid; Message={provide-unique-name} is geen geldige naam van het opslagaccount. De naam van het opslagaccount moet tussen de 3 en 24 tekens lang zijn en alleen cijfers en kleine letters gebruiken.

  Vervang in de sjabloon {provide-unique-name} door een unieke naam van het opslagaccount. Zie Resource toevoegen.

• Error: Code=StorageAccountAlreadyTaken; Message=The storage account named store1abc09092019 is al ingenomen.

  Probeer in de sjabloon een andere naam voor het opslagaccount.

Deze implementatie duurt langer dan uw lege sjabloonimplementatie omdat u een opslagaccount maakt. Het kan ongeveer een minuut duren.

Implementatie verifiëren

U kunt de implementatie controleren door de resourcegroep te verkennen vanuit Azure Portal.

1. Meld u aan bij het Azure-portaal.
2. Selecteer resourcegroepen in het linkermenu.
3. Schakel het selectievakje links van myResourceGroup in en selecteer myResourceGroup
4. Selecteer de resourcegroep waar u uw implementatie hebt gedaan.
5. U ziet dat er een opslagaccount is geïmplementeerd.
6. U ziet dat het implementatielabel nu zegt: Implementaties: 2 Geslaagd.

De hulpbronnen opschonen

Als u verdergaat met de volgende zelfstudie, hoeft u de resourcegroep niet te verwijderen.

Als u nu stopt, wilt u mogelijk de bronnen die u hebt uitgerold opschonen door de resourcegroep te verwijderen.

1. In de Azure-portal, selecteer de resourcegroep in het menu links.
2. Typ de naam van de resourcegroep in het vak Filter voor een veld...
3. Schakel het selectievakje naast myResourceGroup in en selecteer myResourceGroup of de naam van de resourcegroep die u hebt gekozen.
4. Selecteer Resourcegroep verwijderen in het bovenste menu.

Volgende stappen

U hebt een eenvoudige sjabloon gemaakt om een Azure-opslagaccount te implementeren. In de latere zelfstudies leert u hoe u parameters, variabelen, resources en uitvoer toevoegt aan een sjabloon. Deze functies zijn de bouwstenen voor veel complexere sjablonen.