Microsoft.Authorization policySetDefinitions
Bicep 資源定義
policySetDefinitions 資源類型是 延伸模塊資源，這表示您可以將它套用至另一個資源。
scope使用此資源上的 屬性來設定此資源的範圍。 請參閱 在 Bicep 中設定擴充功能資源的範圍。
policySetDefinitions 資源類型可以使用目標作業進行部署：
您可以在下列層級將此資源類型參考為唯讀資源： 租使用者
如需每個 API 版本中已變更屬性的清單，請參閱 變更記錄檔。
資源格式
若要建立 Microsoft.Authorization/policySetDefinitions 資源，請將下列 Bicep 新增至您的範本。
resource symbolicname 'Microsoft.Authorization/policySetDefinitions@2023-04-01' = {
name: 'string'
scope: resourceSymbolicName
properties: {
description: 'string'
displayName: 'string'
metadata: any()
parameters: {
{customized property}: {
allowedValues: [
any
]
defaultValue: any()
metadata: {
assignPermissions: bool
description: 'string'
displayName: 'string'
strongType: 'string'
{customized property}: any()
}
schema: any()
type: 'string'
}
}
policyDefinitionGroups: [
{
additionalMetadataId: 'string'
category: 'string'
description: 'string'
displayName: 'string'
name: 'string'
}
]
policyDefinitions: [
{
groupNames: [
'string'
]
parameters: {
{customized property}: {
value: any()
}
}
policyDefinitionId: 'string'
policyDefinitionReferenceId: 'string'
}
]
policyType: 'string'
version: 'string'
versions: [
'string'
]
}
}
屬性值
policySetDefinitions
| 名稱 | 描述 | 值 |
|---|---|---|
| NAME | 資源名稱 | 需要字串 () 字元限制：1-128 顯示名稱 1-64 (資源名稱) 合法字元： 顯示名稱可包含任何字元。 資源名稱不能使用： <>*%&:\?.+/ 或控制字元。 不能以句號或空格結尾。 |
| 範圍 | 在與部署範圍不同的範圍內建立擴充資源時，請使用 。 | 目標資源 針對 Bicep，請將此屬性設定為資源的符號名稱，以套用 延伸模組資源。 |
| properties | 原則集定義屬性。 | PolicySetDefinitionProperties |
PolicySetDefinitionProperties
| 名稱 | 描述 | 值 |
|---|---|---|
| description | 原則集定義描述。 | 字串 |
| displayName | 原則集定義的顯示名稱。 | 字串 |
| 中繼資料 | 原則集定義元數據。 元數據是開放式物件，通常是索引鍵值組的集合。 | 針對 Bicep，您可以使用 任何 () 函式。 |
| 參數 | 原則集定義參數，可用於原則定義參考。 | ParameterDefinitions |
| policyDefinitionGroups | 元數據，描述原則集定義內的原則定義參考群組。 | PolicyDefinitionGroup[] |
| policyDefinitions | 原則定義參考的陣列。 | PolicyDefinitionReference[] (必要) |
| policyType | 原則集定義的類型。 可能的值為 NotSpecified、BuiltIn、Custom 和 Static。 | 'BuiltIn' 'Custom' 'NotSpecified' 'Static' |
| version | #.#.# 格式的原則集定義版本。 | 字串 |
| versions | 此原則集定義的可用版本清單。 | string[] |
ParameterDefinitions
| 名稱 | 描述 | 值 |
|---|---|---|
| {自定義屬性} | ParameterDefinitionsValue |
ParameterDefinitionsValue
| 名稱 | 描述 | 值 |
|---|---|---|
| allowedValues | 參數的允許值。 | any[] |
| defaultValue | 如果未提供任何值，則為 參數的預設值。 | 針對 Bicep，您可以使用 任何 () 函式。 |
| 中繼資料 | 參數的一般元數據。 | ParameterDefinitionsValueMetadata |
| 結構描述 | 使用自我定義 JSON 架構在指派期間提供參數輸入的驗證。 此屬性僅支援物件類型參數，並遵循 Json.NET 結構描述 2019-09 實作。 您可以在 中深入瞭解如何使用架構 https://json-schema.org/ ，並在 測試草稿架構 https://www.jsonschemavalidator.net/. |
針對 Bicep，您可以使用 任何 () 函式。 |
| 類型 | 參數的資料類型。 | 'Array' 'Boolean' 'DateTime' 'Float' 'Integer' 'Object' 'String' |
ParameterDefinitionsValueMetadata
| 名稱 | 描述 | 值 |
|---|---|---|
| assignPermissions | 設定為 true，Azure 入口網站 原則指派期間，於此參數的資源標識符或資源範圍值上建立角色指派。 如果您想要在指派範圍之外指派權限，此屬性會很有用。 | bool |
| description | 參數的描述。 | 字串 |
| displayName | 參數的顯示名稱。 | 字串 |
| strongType | 透過入口網站指派原則定義時使用。 提供內容感知值清單，供用戶選擇。 | 字串 |
| {自定義屬性} | 針對 Bicep，您可以使用 任何 () 函式。 |
PolicyDefinitionGroup
| 名稱 | 描述 | 值 |
|---|---|---|
| additionalMetadataId | 資源的資源標識碼，其中包含群組的其他元數據。 | 字串 |
| category | 群組的類別。 | 字串 |
| description | 群組的描述。 | 字串 |
| displayName | 群組的顯示名稱。 | 字串 |
| NAME | 群組的名稱。 | 需要字串 () |
PolicyDefinitionReference
| 名稱 | 描述 | 值 |
|---|---|---|
| groupNames | 此原則定義參考所屬的組名。 | string[] |
| 參數 | 參考之原則規則的參數值。 索引鍵是參數名稱。 | ParameterValues |
| policyDefinitionId | 原則定義或原則集定義的標識碼。 | 需要字串 () |
| policyDefinitionReferenceId | 此原則定義參考的原則集定義) 內的唯一標識子 (。 | 字串 |
ParameterValues
| 名稱 | 描述 | 值 |
|---|---|---|
| {自定義屬性} | ParameterValuesValue |
ParameterValuesValue
| 名稱 | 描述 | 值 |
|---|---|---|
| 值 | 參數的值。 | 針對 Bicep，您可以使用 任何 () 函式。 |
ARM 範本資源定義
policySetDefinitions 資源類型是 延伸模塊資源，這表示您可以將它套用至另一個資源。
scope使用此資源上的 屬性來設定此資源的範圍。 請參閱 在ARM範本中設定擴充功能資源的範圍。
policySetDefinitions 資源類型可以使用目標作業進行部署：
您可以在下列層級將此資源類型參考為唯讀資源： 租使用者
如需每個 API 版本中已變更屬性的清單，請參閱 變更記錄檔。
資源格式
若要建立 Microsoft.Authorization/policySetDefinitions 資源，請將下列 JSON 新增至範本。
{
"type": "Microsoft.Authorization/policySetDefinitions",
"apiVersion": "2023-04-01",
"name": "string",
"scope": "string",
"properties": {
"description": "string",
"displayName": "string",
"metadata": {},
"parameters": {
"{customized property}": {
"allowedValues": [ object ],
"defaultValue": {},
"metadata": {
"assignPermissions": "bool",
"description": "string",
"displayName": "string",
"strongType": "string",
"{customized property}": {}
},
"schema": {},
"type": "string"
}
},
"policyDefinitionGroups": [
{
"additionalMetadataId": "string",
"category": "string",
"description": "string",
"displayName": "string",
"name": "string"
}
],
"policyDefinitions": [
{
"groupNames": [ "string" ],
"parameters": {
"{customized property}": {
"value": {}
}
},
"policyDefinitionId": "string",
"policyDefinitionReferenceId": "string"
}
],
"policyType": "string",
"version": "string",
"versions": [ "string" ]
}
}
屬性值
policySetDefinitions
| 名稱 | 描述 | 值 |
|---|---|---|
| 類型 | 資源類型 | 'Microsoft.Authorization/policySetDefinitions' |
| apiVersion | 資源 API 版本 | '2023-04-01' |
| NAME | 資源名稱 | 需要字串 () 字元限制：1-128 顯示名稱 1-64 (資源名稱) 合法字元： 顯示名稱可包含任何字元。 資源名稱不能使用： <>*%&:\?.+/ 或控制字元。 不能以句號或空格結尾。 |
| 範圍 | 在與部署範圍不同的範圍內建立擴充資源時，請使用 。 | 目標資源 針對 JSON，請將值設定為要套用 擴充資源 的資源完整名稱。 |
| properties | 原則集定義屬性。 | PolicySetDefinitionProperties |
PolicySetDefinitionProperties
| 名稱 | 描述 | 值 |
|---|---|---|
| description | 原則集定義描述。 | 字串 |
| displayName | 原則集定義的顯示名稱。 | 字串 |
| 中繼資料 | 原則集定義元數據。 元數據是開放式物件，通常是索引鍵值組的集合。 | |
| 參數 | 原則集定義參數，可用於原則定義參考。 | ParameterDefinitions |
| policyDefinitionGroups | 元數據，描述原則集定義內的原則定義參考群組。 | PolicyDefinitionGroup[] |
| policyDefinitions | 原則定義參考的陣列。 | PolicyDefinitionReference[] (必要) |
| policyType | 原則集定義的類型。 可能的值為 NotSpecified、BuiltIn、Custom 和 Static。 | 'BuiltIn' 'Custom' 'NotSpecified' 'Static' |
| version | #.#.# 格式的原則集定義版本。 | 字串 |
| versions | 此原則集定義的可用版本清單。 | string[] |
ParameterDefinitions
| 名稱 | 描述 | 值 |
|---|---|---|
| {自定義屬性} | ParameterDefinitionsValue |
ParameterDefinitionsValue
| 名稱 | 描述 | 值 |
|---|---|---|
| allowedValues | 參數的允許值。 | any[] |
| defaultValue | 如果未提供任何值，則為 參數的預設值。 | |
| 中繼資料 | 參數的一般元數據。 | ParameterDefinitionsValueMetadata |
| 結構描述 | 使用自我定義 JSON 架構在指派期間提供參數輸入的驗證。 此屬性僅支援物件類型參數，並遵循 Json.NET 結構描述 2019-09 實作。 您可以在 中深入瞭解如何使用架構 https://json-schema.org/ ，並在 測試草稿架構 https://www.jsonschemavalidator.net/. |
|
| 類型 | 參數的資料類型。 | 'Array' 'Boolean' 'DateTime' 'Float' 'Integer' 'Object' 'String' |
ParameterDefinitionsValueMetadata
| 名稱 | 描述 | 值 |
|---|---|---|
| assignPermissions | 設定為 true，Azure 入口網站 在原則指派期間，於此參數的資源標識符或資源範圍值上建立角色指派。 如果您想要在指派範圍之外指派權限，此屬性會很有用。 | bool |
| description | 參數的描述。 | 字串 |
| displayName | 參數的顯示名稱。 | 字串 |
| strongType | 透過入口網站指派原則定義時使用。 提供內容感知值清單，供用戶選擇。 | 字串 |
| {自定義屬性} |
PolicyDefinitionGroup
| 名稱 | 描述 | 值 |
|---|---|---|
| additionalMetadataId | 資源的資源標識碼，其中包含群組的其他元數據。 | 字串 |
| category | 群組的類別。 | 字串 |
| description | 群組的描述。 | 字串 |
| displayName | 群組的顯示名稱。 | 字串 |
| NAME | 群組的名稱。 | 需要字串 () |
PolicyDefinitionReference
| 名稱 | 描述 | 值 |
|---|---|---|
| groupNames | 此原則定義參考所屬的組名。 | string[] |
| 參數 | 參考之原則規則的參數值。 索引鍵是參數名稱。 | ParameterValues |
| policyDefinitionId | 原則定義或原則集定義的標識碼。 | 需要字串 () |
| policyDefinitionReferenceId | 此原則定義參考的原則集定義) 內的唯一標識子 (。 | 字串 |
ParameterValues
| 名稱 | 描述 | 值 |
|---|---|---|
| {自定義屬性} | ParameterValuesValue |
ParameterValuesValue
| 名稱 | 描述 | 值 |
|---|---|---|
| 值 | 參數的值。 |
Terraform (AzAPI 提供者) 資源定義
policySetDefinitions 資源類型是 延伸模塊資源，這表示您可以將它套用至另一個資源。
parent_id使用此資源上的 屬性來設定此資源的範圍。
policySetDefinitions 資源類型可以使用目標作業進行部署：
- 管理群組
- 訂用帳戶
您可以在下列層級將此資源類型參考為唯讀資源： 租使用者
如需每個 API 版本中已變更屬性的清單，請參閱 變更記錄檔。
資源格式
若要建立 Microsoft.Authorization/policySetDefinitions 資源，請將下列 Terraform 新增至範本。
resource "azapi_resource" "symbolicname" {
type = "Microsoft.Authorization/policySetDefinitions@2023-04-01"
name = "string"
parent_id = "string"
body = jsonencode({
properties = {
description = "string"
displayName = "string"
parameters = {
{customized property} = {
allowedValues = [ object ]
metadata = {
assignPermissions = bool
description = "string"
displayName = "string"
strongType = "string"
}
type = "string"
}
}
policyDefinitionGroups = [
{
additionalMetadataId = "string"
category = "string"
description = "string"
displayName = "string"
name = "string"
}
]
policyDefinitions = [
{
groupNames = [
"string"
]
parameters = {
{customized property} = {}
}
policyDefinitionId = "string"
policyDefinitionReferenceId = "string"
}
]
policyType = "string"
version = "string"
versions = [
"string"
]
}
})
}
屬性值
policySetDefinitions
| 名稱 | 描述 | 值 |
|---|---|---|
| 類型 | 資源類型 | “Microsoft.Authorization/policySetDefinitions@2023-04-01” |
| NAME | 資源名稱 | 需要字串 () 字元限制：1-128 顯示名稱 1-64 (資源名稱) 合法字元： 顯示名稱可包含任何字元。 資源名稱不能使用： <>*%&:\?.+/ 或控制字元。 不能以句號或空格結尾。 |
| parent_id | 要套用此擴充功能資源的資源標識碼。 | 需要字串 () |
| properties | 原則集定義屬性。 | PolicySetDefinitionProperties |
PolicySetDefinitionProperties
| 名稱 | 描述 | 值 |
|---|---|---|
| description | 原則集定義描述。 | 字串 |
| displayName | 原則集定義的顯示名稱。 | 字串 |
| 中繼資料 | 原則集定義元數據。 元數據是開放式物件，通常是索引鍵值組的集合。 | |
| 參數 | 原則集定義參數，可用於原則定義參考。 | ParameterDefinitions |
| policyDefinitionGroups | 描述原則集定義內原則定義參考群組的元數據。 | PolicyDefinitionGroup[] |
| policyDefinitions | 原則定義參考的陣列。 | PolicyDefinitionReference[] (必要) |
| policyType | 原則集定義的類型。 可能的值為 NotSpecified、BuiltIn、Custom 和 Static。 | “BuiltIn” "Custom" “NotSpecified” “Static” |
| version | #.#.# 格式的原則集定義版本。 | 字串 |
| versions | 此原則集定義的可用版本清單。 | string[] |
ParameterDefinitions
| 名稱 | 描述 | 值 |
|---|---|---|
| {自定義屬性} | ParameterDefinitionsValue |
ParameterDefinitionsValue
| 名稱 | 描述 | 值 |
|---|---|---|
| allowedValues | 參數允許的值。 | any[] |
| defaultValue | 如果未提供任何值，則為 參數的預設值。 | |
| 中繼資料 | 參數的一般元數據。 | ParameterDefinitionsValueMetadata |
| 結構描述 | 使用自我定義的 JSON 架構，在指派期間提供參數輸入的驗證。 此屬性僅支援物件類型參數，並遵循 Json.NET 結構描述 2019-09 實作。 您可以在 中深入瞭解如何使用架構 https://json-schema.org/ ，並在 測試草稿架構 https://www.jsonschemavalidator.net/. |
|
| 類型 | 參數的資料類型。 | “Array” “Boolean” “DateTime” “Float” “Integer” “Object” “String” |
ParameterDefinitionsValueMetadata
| 名稱 | 描述 | 值 |
|---|---|---|
| assignPermissions | 設定為 true，在原則指派期間，Azure 入口網站 在此參數的資源標識符或資源範圍值上建立角色指派。 如果您想要在指派範圍之外指派權限，此屬性會很有用。 | bool |
| description | 參數的描述。 | 字串 |
| displayName | 參數的顯示名稱。 | 字串 |
| strongType | 透過入口網站指派原則定義時使用。 提供可供使用者選擇的內容感知值清單。 | 字串 |
| {自定義屬性} |
PolicyDefinitionGroup
| 名稱 | 描述 | 值 |
|---|---|---|
| additionalMetadataId | 資源的資源標識碼，其中包含有關群組的其他元數據。 | 字串 |
| category | 群組的類別。 | 字串 |
| description | 群組的描述。 | 字串 |
| displayName | 群組的顯示名稱。 | 字串 |
| NAME | 群組的名稱。 | 字串 (必要) |
PolicyDefinitionReference
| 名稱 | 描述 | 值 |
|---|---|---|
| groupNames | 此原則定義參考所屬的群組名稱。 | string[] |
| 參數 | 參考之原則規則的參數值。 索引鍵是參數名稱。 | ParameterValues |
| policyDefinitionId | 原則定義或原則集定義的標識碼。 | 需要字串 () |
| policyDefinitionReferenceId | 此原則定義參考的原則集定義) 內的唯一標識子 (。 | 字串 |
ParameterValues
| 名稱 | 描述 | 值 |
|---|---|---|
| {自定義屬性} | ParameterValuesValue |
ParameterValuesValue
| 名稱 | 描述 | 值 |
|---|---|---|
| 值 | 參數的值。 |
意見反應
即將登場：在 2024 年，我們將逐步淘汰 GitHub 問題作為內容的意見反應機制，並將它取代為新的意見反應系統。 如需詳細資訊，請參閱：https://aka.ms/ContentUserFeedback。
提交並檢視相關的意見反應