Alias de estructura de definición de Azure Policy

Los alias de propiedad se usan para tener acceso a propiedades específicas de un tipo de recurso. Los alias le permiten restringir los valores o condiciones que se permiten para una propiedad en un recurso. Cada alias se asigna a las rutas de acceso en las diferentes versiones de la API para un tipo de recurso determinado. Durante la evaluación de directivas, el motor de directiva obtiene la ruta de acceso de propiedad para esa versión de la API.

La lista de alias siempre está en aumento. Para buscar qué alias admite Azure Policy, usa uno de los métodos siguientes:

• Extensión de Azure Policy para Visual Studio Code (recomendado)

  Use la extensión de Azure Policy para Visual Studio Code a fin de ver y detectar alias para las propiedades de recursos.

  

• Azure PowerShell

  Azure PowerShell

  # Login first with Connect-AzAccount if not using Cloud Shell
  
  # Use Get-AzPolicyAlias to list available providers
  Get-AzPolicyAlias -ListAvailable
  
  # Use Get-AzPolicyAlias to list aliases for a Namespace (such as Azure Compute -- Microsoft.Compute)
  (Get-AzPolicyAlias -NamespaceMatch 'compute').Aliases
  

  Nota

  Para buscar alias que se puedan usar con el efecto modificar, use el siguiente comando en Azure PowerShell 4.6.0 o superior:

  Azure PowerShell

  Get-AzPolicyAlias | Select-Object -ExpandProperty 'Aliases' | Where-Object { $_.DefaultMetadata.Attributes -eq 'Modifiable' }
  

• CLI de Azure

  Azure CLI

  # Login first with az login if not using Cloud Shell
  
  # List namespaces
  az provider list --query [*].namespace
  
  # Get Azure Policy aliases for a specific Namespace (such as Azure Compute -- Microsoft.Compute)
  az provider show --namespace Microsoft.Compute --expand "resourceTypes/aliases" --query "resourceTypes[].aliases[].name"
  

• REST API

  HTTP

  GET https://management.azure.com/providers/?api-version=2019-10-01&$expand=resourceTypes/aliases
  

Descripción del alias de matriz

Algunos de los alias disponibles tienen una versión que aparece como un nombre normal y otra que tiene agregado [*], que es un alias de matriz. Por ejemplo:

• Microsoft.Storage/storageAccounts/networkAcls.ipRules

• Microsoft.Storage/storageAccounts/networkAcls.ipRules[*]

• El alias normal representa el campo como un valor único. Este campo se utiliza en escenarios de comparación de coincidencia exacta, cuando todo el conjunto de valores debe ser exactamente como se define.

• El alias de matriz [*] representa una colección de valores seleccionados de los elementos de una propiedad de recurso de matriz. Por ejemplo:

Alias	Valores seleccionados
Microsoft.Storage/storageAccounts/networkAcls.ipRules[*]	Los elementos de la matriz ipRules.
Microsoft.Storage/storageAccounts/networkAcls.ipRules[*].action	Los valores de la propiedad action de cada elemento de la matriz ipRules.

Cuando se usan en una condición de campo, los alias de matriz permiten comparar cada elemento individual de la matriz con un valor de destino. Cuando se usan con la expresión count, se pueden realizar las siguientes comprobaciones:

• Comprobar el tamaño de una matriz
• Comprobar si todos, alguno o ninguno de los elementos de la matriz cumple una condición compleja.
• Comprobar si exactamente n elementos de la matriz cumplen una condición compleja.

Para obtener más información y acceder a ejemplos, consulte Referencia a las propiedades de recursos de matriz.

Pasos siguientes

• Para obtener más información sobre la estructura de definición de directiva, vaya a los conceptos básicos, los parámetros y la regla de directiva.
• Para las iniciativas, ve a la estructura de definición de iniciativa.
• Puede consultar ejemplos en Ejemplos de Azure Policy.
• Vea la Descripción de los efectos de directivas.
• Obtenga información acerca de cómo se pueden crear directivas mediante programación.
• Obtenga información sobre cómo obtener datos de cumplimiento.
• Obtenga información sobre cómo corregir recursos no compatibles.
• En Organización de los recursos con grupos de administración de Azure, obtendrá información sobre lo que es un grupo de administración.