Elemento Microsoft.Common.TagsByResource UI

Um controle para associar tags aos recursos em uma implantação.

Exemplo de interface do usuário

Esquema

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

Saída de exemplo

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

Observações

• Pelo menos um item na resources matriz deve ser especificado.

• Cada elemento deve resources ser um tipo de recurso totalmente qualificado. Esses elementos aparecem na lista suspensa Recurso e podem ser marcados pelo usuário.

• A saída do controle é formatada para facilitar a atribuição de valores de marca em um modelo do Azure Resource Manager. Para receber a saída do controle em um modelo, inclua um parâmetro em seu modelo, conforme mostrado no exemplo a seguir:

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

  Para cada recurso que pode ser marcado, atribua a propriedade tags ao valor do parâmetro para esse tipo de recurso:

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

• Use a função if ao acessar o parâmetro tagsByResource. Ele permite que você atribua um objeto vazio quando nenhuma tag é atribuída ao tipo de recurso determinado.

Próximos passos

• Para obter uma introdução à criação de definições de interface do usuário, consulte Introdução a CreateUiDefinition.
• Para obter uma descrição das propriedades comuns em elementos da interface do usuário, consulte Elementos CreateUiDefinition.