Azure 原則 定義結構別名
您可以使用屬性別名來存取資源類型的特定屬性。 別名可讓您針對資源上的屬性限制所允許的值或條件。 每個別名會對應至指定資源類型之不同 API 版本中的路徑。 在原則評估期間,原則引擎會取得該 API 版本的屬性路徑。
別名清單一律會成長。 若要尋找 Azure 原則 支援的別名,請使用下列其中一種方法:
適用於 Visual Studio Code 的 Azure 原則 延伸模組(建議)
使用適用於 Visual Studio Code 的 Azure 原則 延伸模組來檢視和探索資源屬性的別名。
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 |
action 陣列中每個元素的 ipRules 屬性值。 |
在欄位條件中使用時,陣列別名可讓您比較每個個別數位元素與目標值。 搭配 count 運算式使用時,可以:
- 檢查陣列的大小。
- 檢查所有\any\none 陣列元素是否符合複雜條件。
- 檢查陣列
n
元素是否符合複雜條件。
如需詳細資訊和範例,請參閱參考陣列資源屬性。
下一步
- 如需原則定義結構的詳細資訊,請移至 基本概念、 參數和 原則規則。
- 針對計劃,請移至 方案定義結構。
- 在 Azure 原則範例檢閱範例。
- 檢閱了解原則效果。
- 了解如何以程式設計方式建立原則。
- 了解如何取得合規性資料。
- 了解如何補救不符合規範的資源。
- 透過使用 Azure 管理群組來組織資源來檢閱何謂管理群組。