Microsoft.Authorization policyDefinitions
Bicep 리소스 정의
policyDefinitions 리소스 종류는 확장 리소스이므로 다른 리소스에 적용할 수 있습니다.
이 리소스의 scope
속성을 사용하여 이 리소스에 대한 scope 설정합니다. Bicep의 확장 리소스에서 scope 설정을 참조하세요.
policyDefinitions 리소스 종류는 다음을 대상으로 하는 작업으로 배포할 수 있습니다.
- 관리 그룹 - 관리 그룹 배포 명령 참조
- 구독 - 구독 배포 명령 참조
테넌트 수준에서 이 리소스 유형을 읽기 전용 리소스로 참조할 수 있습니다.
각 API 버전에서 변경된 속성 목록은 변경 로그를 참조하세요.
리소스 형식
Microsoft.Authorization/policyDefinitions 리소스를 만들려면 템플릿에 다음 Bicep을 추가합니다.
resource symbolicname 'Microsoft.Authorization/policyDefinitions@2023-04-01' = {
name: 'string'
scope: resourceSymbolicName
properties: {
description: 'string'
displayName: 'string'
metadata: any()
mode: 'string'
parameters: {
{customized property}: {
allowedValues: [
any
]
defaultValue: any()
metadata: {
assignPermissions: bool
description: 'string'
displayName: 'string'
strongType: 'string'
{customized property}: any()
}
schema: any()
type: 'string'
}
}
policyRule: any()
policyType: 'string'
version: 'string'
versions: [
'string'
]
}
}
속성 값
policyDefinitions
Name | Description | 값 |
---|---|---|
name | 리소스 이름 | string(필수) 문자 제한: 1-128 표시 이름 1-64 리소스 이름 유효한 문자: 표시 이름에는 모든 문자를 사용할 수 있습니다. 다음의 리소스 이름은 사용할 수 없습니다. <>*%&:\?+/ 또는 제어 문자 마침표 또는 공백으로 끝날 수 없습니다. |
scope | 배포 scope 다른 scope 확장 리소스를 만들 때 사용합니다. | 대상 리소스 Bicep의 경우 이 속성을 리소스의 기호 이름으로 설정하여 확장 리소스를 적용합니다. |
properties | 정책 정의 속성입니다. | PolicyDefinitionProperties |
PolicyDefinitionProperties
Name | Description | 값 |
---|---|---|
description | 정책 정의 설명입니다. | string |
displayName | 정책 정의의 표시 이름입니다. | string |
metadata | 정책 정의 메타데이터입니다. 메타데이터는 개방형 종료 개체이며 일반적으로 키 값 쌍의 컬렉션입니다. | Bicep의 경우 any() 함수를 사용할 수 있습니다. |
mode | 정책 정의 모드입니다. 일부 예는 All, Indexed, Microsoft.KeyVault.Data입니다. | string |
매개 변수 | 정책 규칙에 사용되는 매개 변수에 대한 매개 변수 정의입니다. 키는 매개 변수 이름입니다. | ParameterDefinitions |
policyRule | 정책 규칙입니다. | Bicep의 경우 any() 함수를 사용할 수 있습니다. |
policyType | 정책 정의의 유형입니다. 가능한 값은 NotSpecified, BuiltIn, Custom 및 Static입니다. | 'BuiltIn' '사용자 지정' 'NotSpecified' 'Static' |
버전 | #.#.# 형식의 정책 정의 버전입니다. | 문자열 |
versions | 이 정책 정의에 사용 가능한 버전 목록입니다. | string[] |
ParameterDefinitions
Name | Description | 값 |
---|---|---|
{사용자 지정 속성} | ParameterDefinitionsValue |
ParameterDefinitionsValue
Name | Description | 값 |
---|---|---|
allowedValues | 매개 변수에 허용되는 값입니다. | any[] |
defaultValue | 값이 제공되지 않은 경우 매개 변수의 기본값입니다. | Bicep의 경우 any() 함수를 사용할 수 있습니다. |
metadata | 매개 변수에 대한 일반 메타데이터입니다. | ParameterDefinitionsValueMetadata |
스키마 | 자체 정의 JSON 스키마를 사용하여 할당하는 동안 매개 변수 입력의 유효성 검사를 제공합니다. 이 속성은 개체 형식 매개 변수에 대해서만 지원되며 Json.NET 스키마 2019-09 구현을 따릅니다. 에서 스키마를 사용하는 방법에 대해 자세히 알아보고 에서 https://json-schema.org/ 초안 스키마를 테스트할 수 있습니다. https://www.jsonschemavalidator.net/. |
Bicep의 경우 any() 함수를 사용할 수 있습니다. |
형식 | 매개 변수의 데이터 형식입니다. | 'Array' 'Boolean' 'DateTime' 'Float' '정수' 'Object' 'String' |
ParameterDefinitionsValueMetadata
Name | Description | 값 |
---|---|---|
assignPermissions | 정책 할당 중에 이 매개 변수의 리소스 ID 또는 리소스 scope 값에 Azure Portal 역할 할당을 만들도록 하려면 true로 설정합니다. 이 속성은 할당 범위 외부에서 사용 권한을 할당하려는 경우에 유용합니다. | bool |
description | 매개 변수에 대한 설명입니다. | string |
displayName | 매개 변수의 표시 이름입니다. | string |
strongType | 포털을 통해 정책 정의를 할당할 때 사용됩니다. 사용자가 선택할 수 있는 값의 컨텍스트 인식 목록을 제공합니다. | 문자열 |
{customized property} | Bicep의 경우 any() 함수를 사용할 수 있습니다. |
빠른 시작 템플릿
다음 빠른 시작 템플릿은 이 리소스 종류를 배포합니다.
템플릿 | Description |
---|---|
정책 정의 배포 및 관리 그룹에 할당 |
이 템플릿은 정책 정의를 만들고 해당 정책을 대상 관리 그룹에 할당하는 관리 그룹 수준 템플릿입니다. 현재 이 템플릿은 Azure Portal을 통해 배포할 수 없습니다. |
정책 Def 및 Assign to Multiple Mgmt 그룹 배포 |
이 템플릿은 정책 정의를 만들고 해당 정책을 여러 관리 그룹에 할당하는 관리 그룹 수준 템플릿입니다. |
Azure Virtual Network Manager 및 샘플 VNET Create |
이 템플릿은 Azure Virtual Network Manager 및 샘플 가상 네트워크를 명명된 리소스 그룹에 배포합니다. 여러 연결 토폴로지 및 네트워크 그룹 멤버 자격 유형을 지원합니다. |
ARM 템플릿 리소스 정의
policyDefinitions 리소스 종류는 확장 리소스이므로 다른 리소스에 적용할 수 있습니다.
이 리소스의 scope
속성을 사용하여 이 리소스에 대한 scope 설정합니다. ARM 템플릿의 확장 리소스에 scope 설정을 참조하세요.
policyDefinitions 리소스 종류는 다음을 대상으로 하는 작업을 사용하여 배포할 수 있습니다.
- 관리 그룹 - 관리 그룹 배포 명령을 참조하세요.
- 구독 - 구독 배포 명령 참조
테넌트 수준에서 이 리소스 유형을 읽기 전용 리소스로 참조할 수 있습니다.
각 API 버전에서 변경된 속성 목록은 변경 로그를 참조하세요.
리소스 형식
Microsoft.Authorization/policyDefinitions 리소스를 만들려면 템플릿에 다음 JSON을 추가합니다.
{
"type": "Microsoft.Authorization/policyDefinitions",
"apiVersion": "2023-04-01",
"name": "string",
"scope": "string",
"properties": {
"description": "string",
"displayName": "string",
"metadata": {},
"mode": "string",
"parameters": {
"{customized property}": {
"allowedValues": [ object ],
"defaultValue": {},
"metadata": {
"assignPermissions": "bool",
"description": "string",
"displayName": "string",
"strongType": "string",
"{customized property}": {}
},
"schema": {},
"type": "string"
}
},
"policyRule": {},
"policyType": "string",
"version": "string",
"versions": [ "string" ]
}
}
속성 값
policyDefinitions
Name | Description | 값 |
---|---|---|
형식 | 리소스 종류 | 'Microsoft.Authorization/policyDefinitions' |
apiVersion | 리소스 api 버전 | '2023-04-01' |
name | 리소스 이름 | string(필수) 문자 제한: 1-128 표시 이름 1-64 리소스 이름 유효한 문자: 표시 이름에는 모든 문자를 사용할 수 있습니다. 다음의 리소스 이름은 사용할 수 없습니다. <>*%&:\?+/ 또는 제어 문자 마침표 또는 공백으로 끝날 수 없습니다. |
scope | 배포 scope 다른 scope 확장 리소스를 만들 때 사용합니다. | 대상 리소스 JSON의 경우 확장 리소스 를 적용할 리소스의 전체 이름으로 값을 설정합니다. |
properties | 정책 정의 속성입니다. | PolicyDefinitionProperties |
PolicyDefinitionProperties
Name | Description | 값 |
---|---|---|
description | 정책 정의 설명입니다. | string |
displayName | 정책 정의의 표시 이름입니다. | string |
metadata | 정책 정의 메타데이터입니다. 메타데이터는 개방형 종료 개체이며 일반적으로 키 값 쌍의 컬렉션입니다. | |
mode | 정책 정의 모드입니다. 일부 예는 All, Indexed, Microsoft.KeyVault.Data입니다. | 문자열 |
매개 변수 | 정책 규칙에 사용되는 매개 변수에 대한 매개 변수 정의입니다. 키는 매개 변수 이름입니다. | ParameterDefinitions |
policyRule | 정책 규칙입니다. | |
policyType | 정책 정의의 유형입니다. 가능한 값은 NotSpecified, BuiltIn, Custom 및 Static입니다. | 'BuiltIn' '사용자 지정' 'NotSpecified' 'Static' |
버전 | #.#.# 형식의 정책 정의 버전입니다. | string |
versions | 이 정책 정의에 사용 가능한 버전 목록입니다. | string[] |
ParameterDefinitions
Name | Description | 값 |
---|---|---|
{사용자 지정 속성} | ParameterDefinitionsValue |
ParameterDefinitionsValue
Name | Description | 값 |
---|---|---|
allowedValues | 매개 변수에 허용되는 값입니다. | any[] |
defaultValue | 값이 제공되지 않은 경우 매개 변수의 기본값입니다. | |
metadata | 매개 변수에 대한 일반 메타데이터입니다. | ParameterDefinitionsValueMetadata |
스키마 | 자체 정의 JSON 스키마를 사용하여 할당하는 동안 매개 변수 입력의 유효성 검사를 제공합니다. 이 속성은 개체 형식 매개 변수에 대해서만 지원되며 Json.NET 스키마 2019-09 구현을 따릅니다. 에서 스키마 https://json-schema.org/ 를 사용하는 방법에 대해 자세히 알아보고 에서 초안 스키마를 테스트할 수 있습니다. https://www.jsonschemavalidator.net/. |
|
형식 | 매개 변수의 데이터 형식입니다. | 'Array' 'Boolean' 'DateTime' 'Float' '정수' 'Object' 'String' |
ParameterDefinitionsValueMetadata
Name | Description | 값 |
---|---|---|
assignPermissions | 정책 할당 중에 이 매개 변수의 리소스 ID 또는 리소스 scope 값에 대한 역할 할당을 만들 Azure Portal 있도록 true로 설정합니다. 이 속성은 할당 범위 외부에서 사용 권한을 할당하려는 경우에 유용합니다. | bool |
description | 매개 변수에 대한 설명입니다. | string |
displayName | 매개 변수의 표시 이름입니다. | string |
strongType | 포털을 통해 정책 정의를 할당할 때 사용됩니다. 사용자가 선택할 수 있는 값의 컨텍스트 인식 목록을 제공합니다. | 문자열 |
{사용자 지정 속성} |
빠른 시작 템플릿
다음 빠른 시작 템플릿은 이 리소스 유형을 배포합니다.
템플릿 | Description |
---|---|
정책 정의 배포 및 관리 그룹에 할당 |
이 템플릿은 정책 정의를 만들고 해당 정책을 대상 관리 그룹에 할당하는 관리 그룹 수준 템플릿입니다. 현재 이 템플릿은 Azure Portal을 통해 배포할 수 없습니다. |
정책 Def 배포 및 여러 Mgmt 그룹 할당 |
이 템플릿은 정책 정의를 만들고 해당 정책을 여러 관리 그룹에 할당하는 관리 그룹 수준 템플릿입니다. |
Azure Virtual Network Manager 및 샘플 VNET Create |
이 템플릿은 Azure Virtual Network Manager 및 샘플 가상 네트워크를 명명된 리소스 그룹에 배포합니다. 여러 연결 토폴로지 및 네트워크 그룹 멤버 자격 유형을 지원합니다. |
Terraform(AzAPI 공급자) 리소스 정의
policyDefinitions 리소스 종류는 확장 리소스이므로 다른 리소스에 적용할 수 있습니다.
이 리소스의 parent_id
속성을 사용하여 이 리소스에 대한 scope 설정합니다.
policyDefinitions 리소스 종류는 다음을 대상으로 하는 작업으로 배포할 수 있습니다.
- 관리 그룹
- 구독
테넌트 수준에서 이 리소스 유형을 읽기 전용 리소스로 참조할 수 있습니다.
각 API 버전에서 변경된 속성 목록은 변경 로그를 참조하세요.
리소스 형식
Microsoft.Authorization/policyDefinitions 리소스를 만들려면 템플릿에 다음 Terraform을 추가합니다.
resource "azapi_resource" "symbolicname" {
type = "Microsoft.Authorization/policyDefinitions@2023-04-01"
name = "string"
parent_id = "string"
body = jsonencode({
properties = {
description = "string"
displayName = "string"
mode = "string"
parameters = {
{customized property} = {
allowedValues = [ object ]
metadata = {
assignPermissions = bool
description = "string"
displayName = "string"
strongType = "string"
}
type = "string"
}
}
policyType = "string"
version = "string"
versions = [
"string"
]
}
})
}
속성 값
policyDefinitions
Name | Description | 값 |
---|---|---|
형식 | 리소스 종류 | "Microsoft.Authorization/policyDefinitions@2023-04-01" |
name | 리소스 이름 | string(필수) 문자 제한: 1-128 표시 이름 1-64 리소스 이름 유효한 문자: 표시 이름에는 모든 문자를 사용할 수 있습니다. 다음의 리소스 이름은 사용할 수 없습니다. <>*%&:\?+/ 또는 제어 문자 마침표 또는 공백으로 끝날 수 없습니다. |
parent_id | 이 확장 리소스를 적용할 리소스의 ID입니다. | string(필수) |
properties | 정책 정의 속성입니다. | PolicyDefinitionProperties |
PolicyDefinitionProperties
Name | Description | 값 |
---|---|---|
description | 정책 정의 설명입니다. | string |
displayName | 정책 정의의 표시 이름입니다. | string |
metadata | 정책 정의 메타데이터입니다. 메타데이터는 개방형 종료 개체이며 일반적으로 키 값 쌍의 컬렉션입니다. | |
mode | 정책 정의 모드입니다. 일부 예는 All, Indexed, Microsoft.KeyVault.Data입니다. | string |
매개 변수 | 정책 규칙에 사용되는 매개 변수에 대한 매개 변수 정의입니다. 키는 매개 변수 이름입니다. | ParameterDefinitions |
policyRule | 정책 규칙입니다. | |
policyType | 정책 정의의 유형입니다. 가능한 값은 NotSpecified, BuiltIn, Custom 및 Static입니다. | "BuiltIn" "Custom" "NotSpecified" "Static" |
버전 | #.#.# 형식의 정책 정의 버전입니다. | string |
versions | 이 정책 정의에 사용 가능한 버전 목록입니다. | string[] |
ParameterDefinitions
Name | Description | 값 |
---|---|---|
{사용자 지정 속성} | ParameterDefinitionsValue |
ParameterDefinitionsValue
Name | Description | 값 |
---|---|---|
allowedValues | 매개 변수에 허용되는 값입니다. | any[] |
defaultValue | 값이 제공되지 않은 경우 매개 변수의 기본값입니다. | |
metadata | 매개 변수에 대한 일반 메타데이터입니다. | ParameterDefinitionsValueMetadata |
스키마 | 자체 정의 JSON 스키마를 사용하여 할당하는 동안 매개 변수 입력의 유효성 검사를 제공합니다. 이 속성은 개체 형식 매개 변수에 대해서만 지원되며 Json.NET 스키마 2019-09 구현을 따릅니다. 에서 스키마 https://json-schema.org/ 를 사용하는 방법에 대해 자세히 알아보고 에서 초안 스키마를 테스트할 수 있습니다. https://www.jsonschemavalidator.net/. |
|
형식 | 매개 변수의 데이터 형식입니다. | "Array" "Boolean" "DateTime" "Float" "정수" "개체" "String" |
ParameterDefinitionsValueMetadata
Name | Description | 값 |
---|---|---|
assignPermissions | 정책 할당 중에 이 매개 변수의 리소스 ID 또는 리소스 scope 값에 대한 역할 할당을 만들 Azure Portal 있도록 true로 설정합니다. 이 속성은 할당 범위 외부에서 사용 권한을 할당하려는 경우에 유용합니다. | bool |
description | 매개 변수에 대한 설명입니다. | string |
displayName | 매개 변수의 표시 이름입니다. | 문자열 |
strongType | 포털을 통해 정책 정의를 할당할 때 사용됩니다. 사용자가 선택할 수 있는 값의 컨텍스트 인식 목록을 제공합니다. | 문자열 |
{customized property} |