Freigeben über

Lernprogramm: Hinzufügen von Tags zu Ressourcen in Ihrer Azure Resource Manager-Vorlage

In diesem Lernprogramm erfahren Sie, wie Sie Ressourcen in Ihrer Azure Resource Manager-Vorlage (ARM-Vorlage) Tags hinzufügen. Tags sind Metadatenelemente, die aus Schlüssel-Wert-Paaren bestehen, die Ihnen helfen, Ressourcen zu identifizieren und in Kostenberichten anzuzeigen. Diese Anleitung dauert 8 Minuten.

Voraussetzungen

Es wird empfohlen, das Lernprogramm zu Schnellstartvorlagen abzuschließen, aber es ist nicht erforderlich.

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

Vorlage überprüfen

Ihre vorherige Vorlage hat ein Speicherkonto, einen App Service-Plan und eine Web-App bereitgestellt:

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "storagePrefix": {
      "type": "string",
      "minLength": 3,
      "maxLength": 11
    },
    "storageSKU": {
      "type": "string",
      "defaultValue": "Standard_LRS",
      "allowedValues": [
        "Standard_LRS",
        "Standard_GRS",
        "Standard_RAGRS",
        "Standard_ZRS",
        "Premium_LRS",
        "Premium_ZRS",
        "Standard_GZRS",
        "Standard_RAGZRS"
      ]
    },
    "location": {
      "type": "string",
      "defaultValue": "[resourceGroup().location]"
    },
    "appServicePlanName": {
      "type": "string",
      "defaultValue": "exampleplan"
    },
    "webAppName": {
      "type": "string",
      "metadata": {
        "description": "Base name of the resource such as web app name and app service plan "
      },
      "minLength": 2
    },
    "linuxFxVersion": {
      "type": "string",
      "defaultValue": "php|7.0",
      "metadata": {
        "description": "The Runtime stack of current web app"
      }
    }
  },
  "variables": {
    "uniqueStorageName": "[concat(parameters('storagePrefix'), uniqueString(resourceGroup().id))]",
    "webAppPortalName": "[concat(parameters('webAppName'), uniqueString(resourceGroup().id))]"
  },
  "resources": [
    {
      "type": "Microsoft.Storage/storageAccounts",
      "apiVersion": "2025-06-01",
      "name": "[variables('uniqueStorageName')]",
      "location": "[parameters('location')]",
      "sku": {
        "name": "[parameters('storageSKU')]"
      },
      "kind": "StorageV2",
      "properties": {
        "supportsHttpsTrafficOnly": true
      }
    },
    {
      "type": "Microsoft.Web/serverfarms",
      "apiVersion": "2025-03-01",
      "name": "[parameters('appServicePlanName')]",
      "location": "[parameters('location')]",
      "sku": {
        "name": "B1",
        "tier": "Basic",
        "size": "B1",
        "family": "B",
        "capacity": 1
      },
      "kind": "linux",
      "properties": {
        "perSiteScaling": false,
        "reserved": true,
        "targetWorkerCount": 0,
        "targetWorkerSizeId": 0
      }
    },
    {
      "type": "Microsoft.Web/sites",
      "apiVersion": "2025-03-01",
      "name": "[variables('webAppPortalName')]",
      "location": "[parameters('location')]",
      "dependsOn": [
        "[resourceId('Microsoft.Web/serverfarms', parameters('appServicePlanName'))]"
      ],
      "kind": "app",
      "properties": {
        "serverFarmId": "[resourceId('Microsoft.Web/serverfarms', parameters('appServicePlanName'))]",
        "siteConfig": {
          "linuxFxVersion": "[parameters('linuxFxVersion')]"
        }
      }
    }
  ],
  "outputs": {
    "storageEndpoint": {
      "type": "object",
      "value": "[reference(variables('uniqueStorageName')).primaryEndpoints]"
    }
  }
}

Nachdem Sie diese Ressourcen bereitgestellt haben, müssen Sie möglicherweise Kosten nachverfolgen und Ressourcen finden, die zu einer Kategorie gehören. Sie können Tags hinzufügen, um diese Probleme zu lösen.

Hinzufügen von Tags

Sie kategorisieren Ressourcen, um Werte hinzuzufügen, die Ihnen helfen, deren Verwendung zu identifizieren. Sie können Tags hinzufügen, die die Umgebung und das Projekt auflisten. Sie können sie auch hinzufügen, um eine Kostenstelle oder das Team zu identifizieren, das die Ressource besitzt. Fügen Sie alle Werte hinzu, die für Ihre Organisation sinnvoll sind.

Das folgende Beispiel zeigt die Änderungen an der Vorlage. Kopieren Sie die gesamte Datei, und ersetzen Sie die Vorlage durch den Inhalt:

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "storagePrefix": {
      "type": "string",
      "minLength": 3,
      "maxLength": 11
    },
    "storageSKU": {
      "type": "string",
      "defaultValue": "Standard_LRS",
      "allowedValues": [
        "Standard_LRS",
        "Standard_GRS",
        "Standard_RAGRS",
        "Standard_ZRS",
        "Premium_LRS",
        "Premium_ZRS",
        "Standard_GZRS",
        "Standard_RAGZRS"
      ]
    },
    "location": {
      "type": "string",
      "defaultValue": "[resourceGroup().location]"
    },
    "appServicePlanName": {
      "type": "string",
      "defaultValue": "exampleplan"
    },
    "webAppName": {
      "type": "string",
      "metadata": {
        "description": "Base name of the resource such as web app name and app service plan "
      },
      "minLength": 2
    },
    "linuxFxVersion": {
      "type": "string",
      "defaultValue": "php|7.0",
      "metadata": {
        "description": "The Runtime stack of current web app"
      }
    },
    "resourceTags": {
      "type": "object",
      "defaultValue": {
        "Environment": "Dev",
        "Project": "Tutorial"
      }
    }
  },
  "variables": {
    "uniqueStorageName": "[concat(parameters('storagePrefix'), uniqueString(resourceGroup().id))]",
    "webAppPortalName": "[concat(parameters('webAppName'), uniqueString(resourceGroup().id))]"
  },
  "resources": [
    {
      "type": "Microsoft.Storage/storageAccounts",
      "apiVersion": "2025-06-01",
      "name": "[variables('uniqueStorageName')]",
      "location": "[parameters('location')]",
      "tags": "[parameters('resourceTags')]",
      "sku": {
        "name": "[parameters('storageSKU')]"
      },
      "kind": "StorageV2",
      "properties": {
        "supportsHttpsTrafficOnly": true
      }
    },
    {
      "type": "Microsoft.Web/serverfarms",
      "apiVersion": "2025-03-01",
      "name": "[parameters('appServicePlanName')]",
      "location": "[parameters('location')]",
      "tags": "[parameters('resourceTags')]",
      "sku": {
        "name": "B1",
        "tier": "Basic",
        "size": "B1",
        "family": "B",
        "capacity": 1
      },
      "kind": "linux",
      "properties": {
        "perSiteScaling": false,
        "reserved": true,
        "targetWorkerCount": 0,
        "targetWorkerSizeId": 0
      }
    },
    {
      "type": "Microsoft.Web/sites",
      "apiVersion": "2025-03-01",
      "name": "[variables('webAppPortalName')]",
      "location": "[parameters('location')]",
      "dependsOn": [
        "[parameters('appServicePlanName')]"
      ],
      "tags": "[parameters('resourceTags')]",
      "kind": "app",
      "properties": {
        "serverFarmId": "[resourceId('Microsoft.Web/serverfarms', parameters('appServicePlanName'))]",
        "siteConfig": {
          "linuxFxVersion": "[parameters('linuxFxVersion')]"
        }
      }
    }
  ],
  "outputs": {
    "storageEndpoint": {
      "type": "object",
      "value": "[reference(variables('uniqueStorageName')).primaryEndpoints]"
    }
  }
}

Bereitstellen der Vorlage

Es ist an der Zeit, die Vorlage bereitzustellen und die Ergebnisse zu betrachten.

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 addtags `
  -ResourceGroupName myResourceGroup `
  -TemplateFile $templateFile `
  -storagePrefix "store" `
  -storageSKU Standard_LRS `
  -webAppName demoapp

Hinweis

Wenn die Bereitstellung fehlschlägt, verwenden Sie den verbose Switch, um Informationen zu den Ressourcen abzurufen, die Sie erstellen. Verwenden Sie die debug Option, um weitere Informationen zum Debuggen zu erhalten.

Ü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. Wählen Sie die Ressourcengruppe aus, in der Sie die Vorlage bereitgestellt haben.

  4. Wählen Sie eine der Ressourcen aus, z. B. die Speicherkonto-Ressource. Sie sehen, dass sie jetzt Tags enthält.

    Screenshot des Azure-Portals mit Tags in einer Speicherkontoressource.

Bereinigen von Ressourcen

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

Wenn Sie den Vorgang jetzt beenden, möchten Sie vielleicht die Ressourcengruppe löschen.

  1. Wählen Sie im Azure-Portal im linken Menü Ressourcengruppen aus.
  2. Geben Sie den Ressourcengruppennamen im Filter für alle Felder... Textfeld ein.
  3. Aktivieren Sie das Kontrollkästchen neben "myResourceGroup ", und wählen Sie "myResourceGroup" oder ihren Ressourcengruppennamen aus.
  4. Wählen Sie Ressourcengruppe löschen aus dem Menü ganz oben aus.

Nächste Schritte

In diesem Tutorial fügen Sie Tags zu den Ressourcen hinzu. Im nächsten Lernprogramm erfahren Sie, wie Sie Parameterdateien verwenden, um das Übergeben von Werten an die Vorlage zu vereinfachen.

Parameterdatei verwenden

  • Last updated on