다음을 통해 공유

Microsoft.Authorization 정책정의/버전

Bicep 리소스 정의

policyDefinitions/버전 리소스 종류는 다음을 대상으로 하는 작업으로 배포할 수 있습니다.

각 API 버전에서 변경된 속성 목록은 변경 로그참조하세요.

리소스 형식

Microsoft.Authorization/policyDefinitions/versions 리소스를 만들려면 템플릿에 다음 Bicep을 추가합니다.

resource symbolicname 'Microsoft.Authorization/policyDefinitions/versions@2025-03-01' = {
  parent: resourceSymbolicName
  name: 'string'
  properties: {
    description: 'string'
    displayName: 'string'
    externalEvaluationEnforcementSettings: {
      endpointSettings: {
        details: any(...)
        kind: 'string'
      }
      missingTokenAction: 'string'
      resultLifespan: 'string'
      roleDefinitionIds: [
        'string'
      ]
    }
    metadata: any(...)
    mode: 'string'
    parameters: {
      {customized property}: {
        allowedValues: [
          any(...)
        ]
        defaultValue: any(...)
        metadata: {
          assignPermissions: bool
          description: 'string'
          displayName: 'string'
          strongType: 'string'
        }
        schema: any(...)
        type: 'string'
      }
    }
    policyRule: any(...)
    policyType: 'string'
    version: 'string'
  }
}

속성 값

Microsoft.Authorization/policyDefinitions/versions

이름 설명 가치
이름 리소스 이름 문자열

제약 조건:
패턴 = ^\d+\.\d+\.\d+$(필수)
부모 Bicep에서 자식 리소스에 대한 부모 리소스를 지정할 수 있습니다. 자식 리소스가 부모 리소스 외부에서 선언된 경우에만 이 속성을 추가해야 합니다.

자세한 내용은 부모 리소스외부의 자식 리소스 참조하세요.		 형식 리소스의 기호 이름: policyDefinitions
속성 정책 정의 버전 속성입니다. PolicyDefinitionVersionProperties

ExternalEvaluationEndpointSettings

이름 설명 가치
세부 정보 엔드포인트의 세부 정보입니다. 어떤
친절한 엔드포인트의 종류입니다. 문자열

ExternalEvaluationEnforcementSettings (외부 평가 시행 설정)

이름 설명 가치
엔드포인트 설정 평가 결과를 제공하는 외부 엔드포인트의 설정입니다. externalEvaluationEndpointSettings
missingToken액션 외부 평가가 필요하고 토큰이 누락된 적용 정책을 평가할 때 수행할 일입니다. 가능한 값은 Audit 및 Deny이며 언어 식이 지원됩니다. 문자열
결과수명 엔드포인트 호출 결과의 수명은 더 이상 유효하지 않습니다. 값은 ISO 8601 기간 형식을 따라야 하며 언어 식이 지원됩니다. 문자열
roleDefinitionIds 엔드포인트를 호출하기 위해 할당의 MSI에 필요한 역할 정의 ID의 배열입니다. 문자열[]

파라미터 정의

이름 설명 가치

ParameterDefinitionsValue

이름 설명 가치
허용 값 매개 변수에 허용되는 값입니다. 어떤[]
기본값 값이 제공되지 않은 경우 매개 변수의 기본값입니다. 어떤
메타데이터 매개 변수에 대한 일반 메타데이터입니다. ParameterDefinitionsValueMetadata
schema(스키마) 자체 정의 JSON 스키마를 사용하여 할당하는 동안 매개 변수 입력의 유효성을 검사합니다. 이 속성은 개체 형식 매개 변수에 대해서만 지원되며 Json.NET 스키마 2019-09 구현을 따릅니다. https://json-schema.org/ 스키마를 사용하고 https://www.jsonschemavalidator.net/초안 스키마를 테스트하는 방법에 대해 자세히 알아볼 수 있습니다. 어떤
유형 매개 변수의 데이터 형식입니다. '배열'
'부울'
'날짜/시간'
'플로트'
'정수'
'개체'
'문자열'

ParameterDefinitionsValueMetadata

이름 설명 가치
assignPermissions 정책 할당 중에 Azure Portal에서 이 매개 변수의 리소스 ID 또는 리소스 범위 값에 대한 역할 할당을 만들도록 true로 설정합니다. 이 속성은 할당 범위 외부에서 권한을 할당하려는 경우에 유용합니다. bool
설명 매개 변수에 대한 설명입니다. 문자열
디스플레이 이름 매개 변수의 표시 이름입니다. 문자열
스트롱타입 포털을 통해 정책 정의를 할당할 때 사용됩니다. 사용자가 선택할 수 있는 값의 컨텍스트 인식 목록을 제공합니다. 문자열

PolicyDefinitionVersionProperties

이름 설명 가치
설명 정책 정의 설명입니다. 문자열
디스플레이 이름 정책 정의의 표시 이름입니다. 문자열
externalEvaluationEnforcementSettings 적용 평가 중에 정책에 필요한 외부 평가 결과의 원본에 대한 세부 정보입니다. ExternalEvaluationEnforcementSettings (외부 평가 시행 설정)
메타데이터 정책 정의 메타데이터입니다. 메타데이터는 열려 있는 종료된 개체이며 일반적으로 키 값 쌍의 컬렉션입니다. 어떤
모드 정책 정의 모드입니다. 일부 예는 All, Indexed, Microsoft.KeyVault.Data입니다. 문자열
매개 변수 정책 규칙에 사용되는 매개 변수에 대한 매개 변수 정의입니다. 키는 매개 변수 이름입니다. 파라미터 정의
policyRule 정책 규칙입니다. 어떤
정책 유형 정책 정의의 형식입니다. 가능한 값은 NotSpecified, BuiltIn, Custom 및 Static입니다. '빌트인'
'맞춤형'
'지정되지 않음'
'정적'
버전 #.#.# 형식의 정책 정의 버전입니다. 문자열

ARM 템플릿 리소스 정의

policyDefinitions/버전 리소스 종류는 다음을 대상으로 하는 작업으로 배포할 수 있습니다.

각 API 버전에서 변경된 속성 목록은 변경 로그참조하세요.

리소스 형식

Microsoft.Authorization/policyDefinitions/versions 리소스를 만들려면 템플릿에 다음 JSON을 추가합니다.

{
  "type": "Microsoft.Authorization/policyDefinitions/versions",
  "apiVersion": "2025-03-01",
  "name": "string",
  "properties": {
    "description": "string",
    "displayName": "string",
    "externalEvaluationEnforcementSettings": {
      "endpointSettings": {
        "details": {},
        "kind": "string"
      },
      "missingTokenAction": "string",
      "resultLifespan": "string",
      "roleDefinitionIds": [ "string" ]
    },
    "metadata": {},
    "mode": "string",
    "parameters": {
      "{customized property}": {
        "allowedValues": [ {} ],
        "defaultValue": {},
        "metadata": {
          "assignPermissions": "bool",
          "description": "string",
          "displayName": "string",
          "strongType": "string"
        },
        "schema": {},
        "type": "string"
      }
    },
    "policyRule": {},
    "policyType": "string",
    "version": "string"
  }
}

속성 값

Microsoft.Authorization/policyDefinitions/versions

이름 설명 가치
API버전 api 버전 '2025-03-01'
이름 리소스 이름 문자열

제약 조건:
패턴 = ^\d+\.\d+\.\d+$(필수)
속성 정책 정의 버전 속성입니다. PolicyDefinitionVersionProperties
유형 리소스 종류 'Microsoft.Authorization/policyDefinitions/버전'

ExternalEvaluationEndpointSettings

이름 설명 가치
세부 정보 엔드포인트의 세부 정보입니다. 어떤
친절한 엔드포인트의 종류입니다. 문자열

ExternalEvaluationEnforcementSettings (외부 평가 시행 설정)

이름 설명 가치
엔드포인트 설정 평가 결과를 제공하는 외부 엔드포인트의 설정입니다. externalEvaluationEndpointSettings
missingToken액션 외부 평가가 필요하고 토큰이 누락된 적용 정책을 평가할 때 수행할 일입니다. 가능한 값은 Audit 및 Deny이며 언어 식이 지원됩니다. 문자열
결과수명 엔드포인트 호출 결과의 수명은 더 이상 유효하지 않습니다. 값은 ISO 8601 기간 형식을 따라야 하며 언어 식이 지원됩니다. 문자열
roleDefinitionIds 엔드포인트를 호출하기 위해 할당의 MSI에 필요한 역할 정의 ID의 배열입니다. 문자열[]

파라미터 정의

이름 설명 가치

ParameterDefinitionsValue

이름 설명 가치
허용 값 매개 변수에 허용되는 값입니다. 어떤[]
기본값 값이 제공되지 않은 경우 매개 변수의 기본값입니다. 어떤
메타데이터 매개 변수에 대한 일반 메타데이터입니다. ParameterDefinitionsValueMetadata
schema(스키마) 자체 정의 JSON 스키마를 사용하여 할당하는 동안 매개 변수 입력의 유효성을 검사합니다. 이 속성은 개체 형식 매개 변수에 대해서만 지원되며 Json.NET 스키마 2019-09 구현을 따릅니다. https://json-schema.org/ 스키마를 사용하고 https://www.jsonschemavalidator.net/초안 스키마를 테스트하는 방법에 대해 자세히 알아볼 수 있습니다. 어떤
유형 매개 변수의 데이터 형식입니다. '배열'
'부울'
'날짜/시간'
'플로트'
'정수'
'개체'
'문자열'

ParameterDefinitionsValueMetadata

이름 설명 가치
assignPermissions 정책 할당 중에 Azure Portal에서 이 매개 변수의 리소스 ID 또는 리소스 범위 값에 대한 역할 할당을 만들도록 true로 설정합니다. 이 속성은 할당 범위 외부에서 권한을 할당하려는 경우에 유용합니다. bool
설명 매개 변수에 대한 설명입니다. 문자열
디스플레이 이름 매개 변수의 표시 이름입니다. 문자열
스트롱타입 포털을 통해 정책 정의를 할당할 때 사용됩니다. 사용자가 선택할 수 있는 값의 컨텍스트 인식 목록을 제공합니다. 문자열

PolicyDefinitionVersionProperties

이름 설명 가치
설명 정책 정의 설명입니다. 문자열
디스플레이 이름 정책 정의의 표시 이름입니다. 문자열
externalEvaluationEnforcementSettings 적용 평가 중에 정책에 필요한 외부 평가 결과의 원본에 대한 세부 정보입니다. ExternalEvaluationEnforcementSettings (외부 평가 시행 설정)
메타데이터 정책 정의 메타데이터입니다. 메타데이터는 열려 있는 종료된 개체이며 일반적으로 키 값 쌍의 컬렉션입니다. 어떤
모드 정책 정의 모드입니다. 일부 예는 All, Indexed, Microsoft.KeyVault.Data입니다. 문자열
매개 변수 정책 규칙에 사용되는 매개 변수에 대한 매개 변수 정의입니다. 키는 매개 변수 이름입니다. 파라미터 정의
policyRule 정책 규칙입니다. 어떤
정책 유형 정책 정의의 형식입니다. 가능한 값은 NotSpecified, BuiltIn, Custom 및 Static입니다. '빌트인'
'맞춤형'
'지정되지 않음'
'정적'
버전 #.#.# 형식의 정책 정의 버전입니다. 문자열

사용 예제

Terraform(AzAPI 공급자) 리소스 정의

policyDefinitions/버전 리소스 종류는 다음을 대상으로 하는 작업으로 배포할 수 있습니다.

  • 구독테넌트관리 그룹

각 API 버전에서 변경된 속성 목록은 변경 로그참조하세요.

리소스 형식

Microsoft.Authorization/policyDefinitions/versions 리소스를 만들려면 템플릿에 다음 Terraform을 추가합니다.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Authorization/policyDefinitions/versions@2025-03-01"
  name = "string"
  parent_id = "string"
  body = {
    properties = {
      description = "string"
      displayName = "string"
      externalEvaluationEnforcementSettings = {
        endpointSettings = {
          details = ?
          kind = "string"
        }
        missingTokenAction = "string"
        resultLifespan = "string"
        roleDefinitionIds = [
          "string"
        ]
      }
      metadata = ?
      mode = "string"
      parameters = {
        {customized property} = {
          allowedValues = [
            ?
          ]
          defaultValue = ?
          metadata = {
            assignPermissions = bool
            description = "string"
            displayName = "string"
            strongType = "string"
          }
          schema = ?
          type = "string"
        }
      }
      policyRule = ?
      policyType = "string"
      version = "string"
    }
  }
}

속성 값

Microsoft.Authorization/policyDefinitions/versions

이름 설명 가치
이름 리소스 이름 문자열

제약 조건:
패턴 = ^\d+\.\d+\.\d+$(필수)
부모 ID 이 리소스의 부모인 리소스의 ID입니다. 형식 리소스의 ID: policyDefinitions
속성 정책 정의 버전 속성입니다. PolicyDefinitionVersionProperties
유형 리소스 종류 "Microsoft.Authorization/policyDefinitions/versions@2025-03-01"

ExternalEvaluationEndpointSettings

이름 설명 가치
세부 정보 엔드포인트의 세부 정보입니다. 어떤
친절한 엔드포인트의 종류입니다. 문자열

ExternalEvaluationEnforcementSettings (외부 평가 시행 설정)

이름 설명 가치
엔드포인트 설정 평가 결과를 제공하는 외부 엔드포인트의 설정입니다. externalEvaluationEndpointSettings
missingToken액션 외부 평가가 필요하고 토큰이 누락된 적용 정책을 평가할 때 수행할 일입니다. 가능한 값은 Audit 및 Deny이며 언어 식이 지원됩니다. 문자열
결과수명 엔드포인트 호출 결과의 수명은 더 이상 유효하지 않습니다. 값은 ISO 8601 기간 형식을 따라야 하며 언어 식이 지원됩니다. 문자열
roleDefinitionIds 엔드포인트를 호출하기 위해 할당의 MSI에 필요한 역할 정의 ID의 배열입니다. 문자열[]

파라미터 정의

이름 설명 가치

ParameterDefinitionsValue

이름 설명 가치
허용 값 매개 변수에 허용되는 값입니다. 어떤[]
기본값 값이 제공되지 않은 경우 매개 변수의 기본값입니다. 어떤
메타데이터 매개 변수에 대한 일반 메타데이터입니다. ParameterDefinitionsValueMetadata
schema(스키마) 자체 정의 JSON 스키마를 사용하여 할당하는 동안 매개 변수 입력의 유효성을 검사합니다. 이 속성은 개체 형식 매개 변수에 대해서만 지원되며 Json.NET 스키마 2019-09 구현을 따릅니다. https://json-schema.org/ 스키마를 사용하고 https://www.jsonschemavalidator.net/초안 스키마를 테스트하는 방법에 대해 자세히 알아볼 수 있습니다. 어떤
유형 매개 변수의 데이터 형식입니다. '배열'
'부울'
'날짜/시간'
'플로트'
'정수'
'개체'
'문자열'

ParameterDefinitionsValueMetadata

이름 설명 가치
assignPermissions 정책 할당 중에 Azure Portal에서 이 매개 변수의 리소스 ID 또는 리소스 범위 값에 대한 역할 할당을 만들도록 true로 설정합니다. 이 속성은 할당 범위 외부에서 권한을 할당하려는 경우에 유용합니다. bool
설명 매개 변수에 대한 설명입니다. 문자열
디스플레이 이름 매개 변수의 표시 이름입니다. 문자열
스트롱타입 포털을 통해 정책 정의를 할당할 때 사용됩니다. 사용자가 선택할 수 있는 값의 컨텍스트 인식 목록을 제공합니다. 문자열

PolicyDefinitionVersionProperties

이름 설명 가치
설명 정책 정의 설명입니다. 문자열
디스플레이 이름 정책 정의의 표시 이름입니다. 문자열
externalEvaluationEnforcementSettings 적용 평가 중에 정책에 필요한 외부 평가 결과의 원본에 대한 세부 정보입니다. ExternalEvaluationEnforcementSettings (외부 평가 시행 설정)
메타데이터 정책 정의 메타데이터입니다. 메타데이터는 열려 있는 종료된 개체이며 일반적으로 키 값 쌍의 컬렉션입니다. 어떤
모드 정책 정의 모드입니다. 일부 예는 All, Indexed, Microsoft.KeyVault.Data입니다. 문자열
매개 변수 정책 규칙에 사용되는 매개 변수에 대한 매개 변수 정의입니다. 키는 매개 변수 이름입니다. 파라미터 정의
policyRule 정책 규칙입니다. 어떤
정책 유형 정책 정의의 형식입니다. 가능한 값은 NotSpecified, BuiltIn, Custom 및 Static입니다. '빌트인'
'맞춤형'
'지정되지 않음'
'정적'
버전 #.#.# 형식의 정책 정의 버전입니다. 문자열