Benutzeroberflächenelement „Microsoft.Common.TagsByResource“

Ein Steuerelement, um den Ressourcen in einer Bereitstellung Tags zuzuordnen.

Benutzeroberflächenbeispiel

Schema

{
  "name": "element1",
  "type": "Microsoft.Common.TagsByResource",
  "resources": [
    "Microsoft.Storage/storageAccounts",
    "Microsoft.Compute/virtualMachines"
  ]
}

Beispielausgabe

{
  "Microsoft.Storage/storageAccounts": {
    "Dept": "Finance",
    "Environment": "Production"
  },
  "Microsoft.Compute/virtualMachines": {
    "Dept": "Finance"
  }
}

Bemerkungen

• Mindestens ein Element im resources-Array muss angegeben sein.

• Jedes Element in resources muss ein vollqualifizierter Ressourcentyp sein. Diese Elemente werden in der Dropdownliste Ressourcen angezeigt und können vom Benutzer mit Tags versehen werden.

• Die Ausgabe des Steuerelements wird für die einfache Zuweisung von Tagwerten in einer Azure Resource Manager-Vorlage formatiert. Um die Ausgabe des Steuerelements in einer Vorlage zu empfangen, fügen Sie einen Parameter in Ihre Vorlage ein, wie im folgenden Beispiel gezeigt:

  "parameters": {
    "tagsByResource": { "type": "object", "defaultValue": {} }
  }
  

  Weisen Sie für jede markierbare Ressource die Tags-Eigenschaft dem Parameterwert für diesen Ressourcentyp zu:

  {
    "name": "saName1",
    "type": "Microsoft.Storage/storageAccounts",
    "tags": "[ if(contains(parameters('tagsByResource'), 'Microsoft.Storage/storageAccounts'), parameters('tagsByResource')['Microsoft.Storage/storageAccounts'], json('{}')) ]",
    ...
  

• Verwenden Sie die if-Funktion, wenn Sie auf den „tagsByResource“-Parameter zugreifen. Dies ermöglicht Ihnen, ein leeres Objekt zuzuweisen, wenn dem angegebenen Ressourcentyp keine Tags zugewiesen sind.

Nächste Schritte

• Eine Einführung zum Erstellen von Benutzeroberflächendefinitionen finden Sie unter Erste Schritte mit „CreateUiDefinition“.
• Eine Beschreibung der allgemeinen Eigenschaften in Benutzeroberflächenelementen finden Sie unter CreateUiDefinition-Elemente.