通过

你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

Azure Policy 定义结构别名

  • 项目

可以使用属性别名来访问资源类型的特定属性。 通过别名，可限制允许用于资源属性的值和条件。 每个别名会映射到给定资源类型不同 API 版本的路径。 在策略评估期间，策略引擎会获取该 API 版本的属性路径。

别名列表始终不断增长。 若要确定 Azure Policy 支持哪些别名，请使用以下方法之一：

  • 适用于 Visual Studio Code 的 Azure Policy 扩展（推荐）

    使用适用于 Visual Studio Code 的 Azure Policy 扩展来查看和发现资源属性的别名。

    Visual Studio Code 的 Azure Policy 扩展的屏幕截图，其中的鼠标悬停在属性上以显示别名。

  • 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

    注意

    若要查找可用于修改效果的别名，请在 Azure PowerShell 4.6.0 或更高版本中使用以下命令：

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

  • 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

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

了解数组别名

多个可用别名都有一个显示为正常名称的版本，以及一个附加有 [*] 的版本，即数组别名。 例如：

  • Microsoft.Storage/storageAccounts/networkAcls.ipRules

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

  • 正常别名将字段表示为单个值。 当整个值集必须与定义的完全一致时，此字段适用于精确匹配的比较方案。

  • 数组别名 [*] 表示从数组资源属性的元素中所选的值的集合。 例如：

Alias 选定值
Microsoft.Storage/storageAccounts/networkAcls.ipRules[*] ipRules 数组的元素。
Microsoft.Storage/storageAccounts/networkAcls.ipRules[*].action ipRules 数组的每个元素中的 action 属性的值。

在字段条件中使用数组别名时，可以将每个单独的数组元素与目标值进行比较。 与 count 表达式结合使用时，可以执行以下操作：

  • 检查数组的大小。
  • 检查是否所有/任意/没有任何数组元素满足复杂条件。
  • 检查是否恰好有 n 个数组元素满足复杂条件。

有关详细信息和示例，请参阅引用数组资源属性。

后续步骤