Microsoft.Authorization policySetDefinitions

아티클
05/09/2024

Bicep 리소스 정의

policySetDefinitions 리소스 종류는 확장 리소스이므로 다른 리소스에 적용할 수 있습니다.

이 리소스의 scope 속성을 사용하여 이 리소스에 대한 scope 설정합니다. Bicep의 확장 리소스에 scope 설정을 참조하세요.

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	Description	값
name	리소스 이름	string(필수) 문자 제한: 1-128 표시 이름 1-64 리소스 이름 유효한 문자: 표시 이름에는 모든 문자를 사용할 수 있습니다. 다음의 리소스 이름은 사용할 수 없습니다. `<>*%&:\?.+/` 또는 제어 문자 마침표 또는 공백으로 끝날 수 없습니다.
scope	배포 scope 다른 scope 확장 리소스를 만들 때 사용합니다.	대상 리소스 Bicep의 경우 이 속성을 리소스의 기호 이름으로 설정하여 확장 리소스를 적용합니다.
properties	정책 집합 정의 속성입니다.	PolicySetDefinitionProperties

PolicySetDefinitionProperties

Name	Description	값
description	정책 집합 정의 설명입니다.	string
displayName	정책 집합 정의의 표시 이름입니다.	문자열
metadata	정책 집합 정의 메타데이터입니다. 메타데이터는 개방형 종료 개체이며 일반적으로 키 값 쌍의 컬렉션입니다.	Bicep의 경우 any() 함수를 사용할 수 있습니다.
매개 변수	정책 정의 참조에 사용할 수 있는 정책 집합 정의 매개 변수입니다.	ParameterDefinitions
policyDefinitionGroups	정책 집합 정의 내의 정책 정의 참조 그룹을 설명하는 메타데이터입니다.	PolicyDefinitionGroup[]
policyDefinitions	정책 정의 참조의 배열입니다.	PolicyDefinitionReference[] (필수)
policyType	정책 집합 정의의 형식입니다. 가능한 값은 NotSpecified, BuiltIn, Custom 및 Static입니다.	'BuiltIn' 'Custom' 'NotSpecified' 'Static'
버전	#.#.# 형식의 정책 집합 정의 버전입니다.	문자열
versions	이 정책 집합 정의에 사용 가능한 버전 목록입니다.	string[]

ParameterDefinitions

Name	Description	값
{customized property}		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	포털을 통해 정책 정의를 할당할 때 사용됩니다. 사용자가 선택할 수 있는 값의 컨텍스트 인식 목록을 제공합니다.	문자열
{사용자 지정 속성}		Bicep의 경우 any() 함수를 사용할 수 있습니다.

PolicyDefinitionGroup

Name	Description	값
additionalMetadataId	그룹에 대한 추가 메타데이터를 포함하는 리소스의 리소스 ID입니다.	문자열
category	그룹의 범주입니다.	string
description	그룹의 설명입니다.	string
displayName	그룹의 표시 이름입니다.	문자열
name	그룹의 이름입니다.	string(필수)

PolicyDefinitionReference

Name	Description	값
groupNames	이 정책 정의 참조가 속한 그룹의 이름입니다.	string[]
매개 변수	참조된 정책 규칙에 대한 매개 변수 값입니다. 키는 매개 변수 이름입니다.	ParameterValues
policyDefinitionId	정책 정의 또는 정책 집합 정의의 ID입니다.	string(필수)
policyDefinitionReferenceId	이 정책 정의 참조에 대한 고유 ID(정책 집합 정의 내)입니다.	string

ParameterValues

Name	Description	값
{사용자 지정 속성}		ParameterValuesValue

ParameterValuesValue

Name	Description	값
값	매개 변수의 값입니다.	Bicep의 경우 any() 함수를 사용할 수 있습니다.

ARM 템플릿 리소스 정의

policySetDefinitions 리소스 종류는 확장 리소스이므로 다른 리소스에 적용할 수 있습니다.

이 리소스의 scope 속성을 사용하여 이 리소스에 대한 scope 설정합니다. ARM 템플릿의 확장 리소스에 scope 설정을 참조하세요.

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

Name	Description	값
형식	리소스 종류	'Microsoft.Authorization/policySetDefinitions'
apiVersion	리소스 api 버전	'2023-04-01'
name	리소스 이름	string(필수) 문자 제한: 1-128 표시 이름 1-64 리소스 이름 유효한 문자: 표시 이름에는 모든 문자를 사용할 수 있습니다. 다음의 리소스 이름은 사용할 수 없습니다. `<>*%&:\?.+/` 또는 제어 문자 마침표 또는 공백으로 끝날 수 없습니다.
scope	배포 scope 다른 scope 확장 리소스를 만들 때 사용합니다.	대상 리소스 JSON의 경우 확장 리소스 를 적용할 리소스의 전체 이름으로 값을 설정합니다.
properties	정책 집합 정의 속성입니다.	PolicySetDefinitionProperties

PolicySetDefinitionProperties

Name	Description	값
description	정책 집합 정의 설명입니다.	string
displayName	정책 집합 정의의 표시 이름입니다.	string
metadata	정책 집합 정의 메타데이터입니다. 메타데이터는 개방형 종료 개체이며 일반적으로 키 값 쌍의 컬렉션입니다.
매개 변수	정책 정의 참조에 사용할 수 있는 정책 집합 정의 매개 변수입니다.	ParameterDefinitions
policyDefinitionGroups	정책 집합 정의 내의 정책 정의 참조 그룹을 설명하는 메타데이터입니다.	PolicyDefinitionGroup[]
policyDefinitions	정책 정의 참조의 배열입니다.	PolicyDefinitionReference[] (필수)
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	포털을 통해 정책 정의를 할당할 때 사용됩니다. 사용자가 선택할 수 있는 값의 컨텍스트 인식 목록을 제공합니다.	문자열
{customized property}

PolicyDefinitionGroup

Name	Description	값
additionalMetadataId	그룹에 대한 추가 메타데이터를 포함하는 리소스의 리소스 ID입니다.	문자열
category	그룹의 범주입니다.	string
description	그룹의 설명입니다.	string
displayName	그룹의 표시 이름입니다.	문자열
name	그룹의 이름입니다.	string(필수)

PolicyDefinitionReference

Name	Description	값
groupNames	이 정책 정의 참조가 속한 그룹의 이름입니다.	string[]
매개 변수	참조된 정책 규칙에 대한 매개 변수 값입니다. 키는 매개 변수 이름입니다.	ParameterValues
policyDefinitionId	정책 정의 또는 정책 집합 정의의 ID입니다.	string(필수)
policyDefinitionReferenceId	이 정책 정의 참조에 대한 고유 ID(정책 집합 정의 내)입니다.	string

ParameterValues

Name	Description	값
{customized property}		ParameterValuesValue

ParameterValuesValue

Name	Description	값
값	매개 변수의 값입니다.

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

policySetDefinitions 리소스 종류는 확장 리소스이므로 다른 리소스에 적용할 수 있습니다.

이 리소스의 parent_id 속성을 사용하여 이 리소스에 대한 scope 설정합니다.

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

Name	Description	값
형식	리소스 종류	"Microsoft.Authorization/policySetDefinitions@2023-04-01"
name	리소스 이름	string(필수) 문자 제한: 1-128 표시 이름 1-64 리소스 이름 유효한 문자: 표시 이름에는 모든 문자를 사용할 수 있습니다. 다음의 리소스 이름은 사용할 수 없습니다. `<>*%&:\?.+/` 또는 제어 문자 마침표 또는 공백으로 끝날 수 없습니다.
parent_id	이 확장 리소스를 적용할 리소스의 ID입니다.	string(필수)
properties	정책 집합 정의 속성입니다.	PolicySetDefinitionProperties

PolicySetDefinitionProperties

Name	Description	값
description	정책 집합 정의 설명입니다.	string
displayName	정책 집합 정의의 표시 이름입니다.	string
metadata	정책 집합 정의 메타데이터입니다. 메타데이터는 개방형 종료 개체이며 일반적으로 키 값 쌍의 컬렉션입니다.
매개 변수	정책 정의 참조에 사용할 수 있는 정책 집합 정의 매개 변수입니다.	ParameterDefinitions
policyDefinitionGroups	정책 집합 정의 내의 정책 정의 참조 그룹을 설명하는 메타데이터입니다.	PolicyDefinitionGroup[]
policyDefinitions	정책 정의 참조의 배열입니다.	PolicyDefinitionReference[] (필수)
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	매개 변수의 표시 이름입니다.	string
strongType	포털을 통해 정책 정의를 할당할 때 사용됩니다. 사용자가 선택할 수 있는 값의 컨텍스트 인식 목록을 제공합니다.	문자열
{사용자 지정 속성}

PolicyDefinitionGroup

Name	Description	값
additionalMetadataId	그룹에 대한 추가 메타데이터를 포함하는 리소스의 리소스 ID입니다.	문자열
category	그룹의 범주입니다.	string
description	그룹의 설명입니다.	string
displayName	그룹의 표시 이름입니다.	문자열
name	그룹의 이름입니다.	string(필수)

PolicyDefinitionReference

Name	Description	값
groupNames	이 정책 정의 참조가 속한 그룹의 이름입니다.	string[]
매개 변수	참조된 정책 규칙에 대한 매개 변수 값입니다. 키는 매개 변수 이름입니다.	ParameterValues
policyDefinitionId	정책 정의 또는 정책 집합 정의의 ID입니다.	string(필수)
policyDefinitionReferenceId	이 정책 정의 참조에 대한 고유 ID(정책 집합 정의 내)입니다.	string

ParameterValues

Name	Description	값
{customized property}		ParameterValuesValue

ParameterValuesValue

Name	Description	값
값	매개 변수의 값입니다.

다음을 통해 공유

Microsoft.Authorization policySetDefinitions

Bicep 리소스 정의

리소스 형식

속성 값

policySetDefinitions

PolicySetDefinitionProperties

ParameterDefinitions

ParameterDefinitionsValue

ParameterDefinitionsValueMetadata

PolicyDefinitionGroup

PolicyDefinitionReference

ParameterValues

ParameterValuesValue

ARM 템플릿 리소스 정의

리소스 형식

속성 값

policySetDefinitions

PolicySetDefinitionProperties

ParameterDefinitions

ParameterDefinitionsValue

ParameterDefinitionsValueMetadata

PolicyDefinitionGroup

PolicyDefinitionReference

ParameterValues

ParameterValuesValue

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

리소스 형식

속성 값

policySetDefinitions

PolicySetDefinitionProperties

ParameterDefinitions

ParameterDefinitionsValue

ParameterDefinitionsValueMetadata

PolicyDefinitionGroup

PolicyDefinitionReference

ParameterValues

ParameterValuesValue

피드백

추가 리소스