Elemento de interface do usuário Microsoft.Common.TagsByResource

Um controle para associar marcas 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"
  }
}

Comentários

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

• Cada elemento em resources deve ser um tipo de recurso totalmente qualificado. Esses elementos aparecem na lista suspensa Recursos, 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 marca for atribuída ao tipo de recurso fornecido.

Próximas etapas

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