last sync: 2020-Jul-15 14:17:33 UTC

Azure Policy

Append a tag and its value to resource groups

Policy DisplayName Append a tag and its value to resource groups
Policy Id 49c88fc8-6fd1-46fd-a676-f12d1d3a4c71
Policy Category Tags
Policy Description Appends the specified tag and value when any resource group which is missing this tag is created or updated. Does not modify the tags of resource groups created before this policy was applied until those resource groups are changed. New 'modify' effect policies are available that support remediation of tags on existing resources (see https://aka.ms/modifydoc).
Policy Mode All
Policy Type BuiltIn
Policy in Preview FALSE
Policy Deprecated FALSE
Policy Effect Fixed: append
Roles used none
Policy Changes
Date/Time (UTC ymd) (i) Change Change detail
2020-03-10 16:29:49 change: DisplayName previous DisplayName: Append tag and its default value to resource groups
Used in Policy Initiative(s) none
Policy Rule
{
  "properties": {
    "displayName": "Append a tag and its value to resource groups",
    "policyType": "BuiltIn",
    "mode": "All",
    "description": "Appends the specified tag and value when any resource group which is missing this tag is created or updated. Does not modify the tags of resource groups created before this policy was applied until those resource groups are changed. New 'modify' effect policies are available that support remediation of tags on existing resources (see https://aka.ms/modifydoc).",
    "metadata": {
      "version": "1.0.0",
      "category": "Tags"
    },
    "parameters": {
      "tagName": {
        "type": "String",
        "metadata": {
          "displayName": "Tag Name",
          "description": "Name of the tag, such as 'environment'"
        }
      },
      "tagValue": {
        "type": "String",
        "metadata": {
          "displayName": "Tag Value",
          "description": "Value of the tag, such as 'production'"
        }
      }
    },
    "policyRule": {
      "if": {
        "allOf": [
          {
            "field": "type",
            "equals": "Microsoft.Resources/subscriptions/resourceGroups"
          },
          {
          "field": "[concat('tags[', parameters('tagName'), ']')]",
            "exists": "false"
          }
        ]
      },
      "then": {
        "effect": "append",
        "details": [
          {
          "field": "[concat('tags[', parameters('tagName'), ']')]",
          "value": "[parameters('tagValue')]"
          }
        ]
      }
    }
  },
  "id": "/providers/Microsoft.Authorization/policyDefinitions/49c88fc8-6fd1-46fd-a676-f12d1d3a4c71",
  "type": "Microsoft.Authorization/policyDefinitions",
  "name": "49c88fc8-6fd1-46fd-a676-f12d1d3a4c71"
}