다음을 통해 공유


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에 배포
이 템플릿은 정책 정의를 만들고 해당 정책을 대상 관리 그룹에 할당하는 관리 그룹 수준 템플릿입니다. 현재 이 템플릿은 Azure Portal을 통해 배포할 수 없습니다.
정책 Def 및 Assign to Multiple Mgmt 그룹 배포

Azure에 배포
이 템플릿은 정책 정의를 만들고 해당 정책을 여러 관리 그룹에 할당하는 관리 그룹 수준 템플릿입니다.
Azure Virtual Network Manager 및 샘플 VNET Create

Azure에 배포
이 템플릿은 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에 배포
이 템플릿은 정책 정의를 만들고 해당 정책을 대상 관리 그룹에 할당하는 관리 그룹 수준 템플릿입니다. 현재 이 템플릿은 Azure Portal을 통해 배포할 수 없습니다.
정책 Def 배포 및 여러 Mgmt 그룹 할당

Azure에 배포
이 템플릿은 정책 정의를 만들고 해당 정책을 여러 관리 그룹에 할당하는 관리 그룹 수준 템플릿입니다.
Azure Virtual Network Manager 및 샘플 VNET Create

Azure에 배포
이 템플릿은 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}