Azure 리소스의 배열 속성에 대한 작성자 정책
Azure Resource Manager 속성은 일반적으로 문자열 및 부울로 정의됩니다. 일 대 다 관계가 있는 경우 복합 속성이 배열로 대신 정의됩니다. Azure Policy에서는 배열이 여러 가지 방법으로 사용됩니다.
- 여러 옵션을 제공하기 위한 정의 매개 변수 유형
- in 또는 notIn 조건을 사용하는 정책 규칙의 일부
- 조건에 맞는 배열 멤버의 수를 계산하는 정책 규칙의 일부
- 추가 및 수정 효과에서 기존 배열을 업데이트
이 문서에서는 Azure Policy의 각 사용법을 설명하고 몇 가지 예제 정의를 제공합니다.
매개 변수 배열
매개 변수 배열 정의
매개 변수를 배열로 정의하면 둘 이상의 값이 필요한 경우 유연한 정책이 가능합니다. 이 정책 정의를 사용하면 매개 변수 allowedLocations에 단일 위치를 사용할 수 있으며 기본값은 eastus2입니다.
"parameters": {
"allowedLocations": {
"type": "string",
"metadata": {
"description": "The list of allowed locations for resources.",
"displayName": "Allowed locations",
"strongType": "location"
},
"defaultValue": "eastus2"
}
}
type이 string이었으므로 정책을 할당할 때 하나의 값만 설정할 수 있습니다. 이 정책이 할당되면 범위의 리소스가 단일 Azure 지역 내에서만 허용됩니다. 대부분의 정책 정의는 eastus2, eastus 및 westus2 허용 같은 승인된 옵션 목록을 허용해야 합니다.
여러 옵션을 허용하는 정책 정의를 만들려면 arraytype을 사용합니다. 동일한 정책을 다음과 같이 다시 작성할 수 있습니다.
"parameters": {
"allowedLocations": {
"type": "array",
"metadata": {
"description": "The list of allowed locations for resources.",
"displayName": "Allowed locations",
"strongType": "location"
},
"defaultValue": [
"eastus2"
],
"allowedValues": [
"eastus2",
"eastus",
"westus2"
]
}
}
참고 항목
정책 정의를 저장한 후에는 매개 변수의 type 속성을 변경할 수 없습니다.
이 새 매개 변수 정의는 정책 할당 중에 둘 이상의 값을 사용합니다. allowedValues라는 배열 속성을 정의하면 할당 중에 사용 가능한 값이 미리 정의된 옵션 목록으로 추가 제한됩니다. allowedValues 사용은 선택 사항입니다.
할당 중에 매개 변수 배열에 값 전달
Azure Portal을 통해 정책을 할당하는 경우 typearray의 매개 변수가 단일 텍스트 상자로 표시됩니다. 힌트에는 "값을 구분하려면 ;을 사용하세요. (예: 런던;뉴욕)"라고 표시됩니다. eastus2, eastus 및 westus2의 허용되는 위치 값을 매개 변수에 전달하려면 다음 문자열을 사용합니다.
eastus2;eastus;westus2
Azure CLI, Azure PowerShell 또는 REST API를 사용하는 경우 매개 변수 값의 형식이 다릅니다. 값은 매개 변수의 이름도 포함하는 JSON 문자열을 통해 전달됩니다.
{
"allowedLocations": {
"value": [
"eastus2",
"eastus",
"westus2"
]
}
}
각 SDK에서 이 문자열을 사용하려면 다음 명령을 사용합니다.
- Azure CLI: params 매개 변수가 포함된 az policy assignment create 명령
- Azure PowerShell: PolicyParameter 매개 변수가 있는 Cmdlet New-AzPolicyAssignment
- REST API: 요청 본문에 properties.parameters 속성 값으로 포함된 PUTcreate 작업
조건에서 배열 사용
In 및 notIn
in 및 notIn 조건은 배열 값에만 적용됩니다. 배열에 값이 있는지 확인합니다. 배열은 리터럴 JSON 배열이거나 배열 매개 변수에 대한 참조일 수 있습니다. 예시:
{
"field": "tags.environment",
"in": [ "dev", "test" ]
}
{
"field": "location",
"notIn": "[parameters('allowedLocations')]"
}
값 개수
값 개수 식은 조건을 충족하는 배열 멤버 수를 계산합니다. 각 반복에 서로 다른 값을 사용하여 동일한 조건을 여러 번 평가하는 방법을 제공합니다. 예를 들어 다음 조건은 리소스 이름이 패턴 배열에서 패턴과 일치하는지를 확인합니다.
{
"count": {
"value": [ "test*", "dev*", "prod*" ],
"name": "pattern",
"where": {
"field": "name",
"like": "[current('pattern')]"
}
},
"greater": 0
}
식을 계산하기 위해 Azure Policy는 [ "test*", "dev*", "prod*" ]의 각 멤버에 대해 한 번씩 where 조건을 세 번 평가하여 true로 평가된 횟수를 계산합니다. 모든 반복에서 현재 배열 멤버의 값은 count.name에 정의된 pattern 인덱스 이름과 쌍을 이룹니다. 그런 다음 이 값은 특수 템플릿 함수인 current('pattern')를 호출하여 where 조건 내에서 참조할 수 있습니다.
| 반복 | current('pattern') 반환 값 |
|---|---|
| 1 | "test*" |
| 2 | "dev*" |
| 3 | "prod*" |
조건은 결과 수가 0보다 큰 경우에만 true입니다.
조건을 더 일반화하려면 리터럴 배열 대신 매개 변수 참조를 사용합니다.
{
"count": {
"value": "[parameters('patterns')]",
"name": "pattern",
"where": {
"field": "name",
"like": "[current('pattern')]"
}
},
"greater": 0
}
값 개수 식이 다른 개수 식 아래에 있지 않은 경우 count.name은 선택 사항이며 인수 없이 current() 함수를 사용할 수 있습니다.
{
"count": {
"value": "[parameters('patterns')]",
"where": {
"field": "name",
"like": "[current()]"
}
},
"greater": 0
}
값 개수도 복잡한 개체의 배열만 지원하므로 복잡한 조건을 허용합니다. 예를 들어 다음 조건은 각 이름 패턴에 원하는 태그 값을 정의하고, 리소스 이름이 패턴과 일치하는지를 확인하지만 필요한 태그 값은 포함하지 않습니다.
{
"count": {
"value": [
{ "pattern": "test*", "envTag": "dev" },
{ "pattern": "dev*", "envTag": "dev" },
{ "pattern": "prod*", "envTag": "prod" },
],
"name": "namePatternRequiredTag",
"where": {
"allOf": [
{
"field": "name",
"like": "[current('namePatternRequiredTag').pattern]"
},
{
"field": "tags.env",
"notEquals": "[current('namePatternRequiredTag').envTag]"
}
]
}
},
"greater": 0
}
유용한 예제는 값 개수 예를 참조하세요.
배열 리소스 속성 참조
많은 사용 사례에서 계산된 리소스의 배열 속성 작업을 수행해야 합니다. 일부 시나리오에서는 전체 배열을 참조해야 합니다(예: 길이 확인). 다른 경우에는 개별 배열 멤버에 조건을 적용해야 합니다. 예를 들어 모든 방화벽 규칙이 인터넷에서 액세스를 차단하는지 확인합니다. Azure Policy가 리소스 속성을 참조하는 다양한 방법과 참조가 배열 속성을 참조할 때 동작하는 방식을 이해해야만 해당 시나리오를 포함하는 조건을 작성할 수 있습니다.
리소스 속성 참조
리소스 속성은 별칭을 사용하여 Azure Policy에서 참조할 수 있으며, Azure Policy 내에서 리소스 속성의 값을 참조하는 방법은 두 가지가 있습니다.
필드 조건을 사용하여 선택한 모든 리소스 속성이 조건을 충족하는지 확인합니다. 예시:
{ "field" : "Microsoft.Test/resourceType/property", "equals": "value" }field()기능을 사용하여 속성 값에 액세스합니다. 예시:{ "value": "[take(field('Microsoft.Test/resourceType/property'), 7)]", "equals": "prefix_" }
필드 조건에는 암시적인 "모두" 동작이 포함됩니다. 별칭이 값의 컬렉션을 나타내는 경우 모든 개별 값이 조건을 충족하는지 확인합니다. field() 함수는 별칭이 나타내는 값을 있는 그대로 반환합니다. 이 값은 다른 템플릿 함수에 의해 조작될 수 있습니다.
배열 필드 참조
배열 리소스 속성은 두 가지 다른 형식의 별칭으로 표시됩니다. 하나의 '정상' 별칭 및 [*]가 연결된 배열 별칭:
Microsoft.Test/resourceType/stringArrayMicrosoft.Test/resourceType/stringArray[*]
배열 참조
첫 번째 별칭은 요청 콘텐츠의 stringArray 속성 값인 단일 값을 나타냅니다. 해당 속성의 값은 배열이므로 정책 조건에서는 유용하지 않습니다. 예시:
{
"field": "Microsoft.Test/resourceType/stringArray",
"equals": "..."
}
이 조건은 전체 stringArray 배열을 단일 문자열 값과 비교합니다. equals를 비롯한 대부분의 조건은 문자열 값만 허용하므로, 배열을 문자열과 비교하는 것이 큰 의미가 없습니다. 배열 속성을 참조하는 주요 시나리오는 존재 여부를 확인하는 경우에 유용합니다.
{
"field": "Microsoft.Test/resourceType/stringArray",
"exists": "true"
}
field() 함수를 사용하면 반환되는 값은 요청 콘텐츠의 배열이며, 이 배열은 배열 인수를 허용하는 지원되는 템플릿 함수에 사용할 수 있습니다. 예를 들어 다음 조건은 stringArray의 길이가 0보다 큰지를 확인합니다.
{
"value": "[length(field('Microsoft.Test/resourceType/stringArray'))]",
"greater": 0
}
배열 멤버 컬렉션 참조
[*] 구문을 사용하는 별칭은 배열 속성에서 선택한 속성 값의 컬렉션을 나타내며, 이는 배열 속성을 선택하는 것과는 다릅니다. Microsoft.Test/resourceType/stringArray[*]의 경우, stringArray의 모든 멤버가 포함된 컬렉션을 반환합니다. 앞서 언급했듯이, field 조건은 선택한 모든 리소스 속성이 조건을 충족하는지 확인하므로 모든stringArray 멤버가 "값"과 같은 경우에만 다음 조건이 충족됩니다.
{
"field": "Microsoft.Test/resourceType/stringArray[*]",
"equals": "value"
}
배열이 비어 있으면 배열의 어떤 멤버도 위반하지 않으므로 조건이 true로 평가됩니다. 이 시나리오에서는 대신 count 식을 사용하는 것이 좋습니다. 배열에 개체가 포함된 경우 [*] 별칭을 사용하여 각 배열 멤버의 특정 속성 값을 선택할 수 있습니다. 예시:
{
"field": "Microsoft.Test/resourceType/objectArray[*].property",
"equals": "value"
}
이 조건은 objectArray의 모든 property 속성 값이 "value"와 같으면 true입니다. 추가 예제는 추가 [*] 별칭 예제를 참조하세요.
field() 함수를 사용하여 배열 별칭을 참조하는 경우 반환되는 값은 선택한 모든 값의 배열입니다. 이 동작은 field() 함수의 일반적인 사용 사례, 즉 리소스 속성 값에 템플릿 함수를 적용하는 기능이 제한되어 있음을 의미합니다. 이 경우에 사용할 수 있는 유일한 템플릿 함수는 배열 인수를 허용하는 함수입니다. 예를 들어[length(field('Microsoft.Test/resourceType/objectArray[*].property'))]를 사용하여 배열의 길이를 가져올 수 있습니다. 그러나 각 배열 멤버에 템플릿 함수를 적용하고 원하는 값과 비교하는 등의 복잡한 시나리오는 count 식을 사용하는 경우에만 가능합니다. 자세한 내용은 필드 개수 식을 참조하세요.
요약하자면, 다음 예제 리소스 콘텐츠와 다양한 별칭에서 반환된 선택된 값을 참조하세요.
{
"tags": {
"env": "prod"
},
"properties":
{
"stringArray": [ "a", "b", "c" ],
"objectArray": [
{
"property": "value1",
"nestedArray": [ 1, 2 ]
},
{
"property": "value2",
"nestedArray": [ 3, 4 ]
}
]
}
}
예제 리소스 콘텐츠에서 필드 조건을 사용하는 경우 결과는 다음과 같습니다.
| Alias | 선택한 값 |
|---|---|
Microsoft.Test/resourceType/missingArray |
null |
Microsoft.Test/resourceType/missingArray[*] |
값의 빈 컬렉션. |
Microsoft.Test/resourceType/missingArray[*].property |
값의 빈 컬렉션. |
Microsoft.Test/resourceType/stringArray |
["a", "b", "c"] |
Microsoft.Test/resourceType/stringArray[*] |
"a", "b", "c" |
Microsoft.Test/resourceType/objectArray[*] |
{ "property": "value1", "nestedArray": [ 1, 2 ] },{ "property": "value2", "nestedArray": [ 3, 4 ] } |
Microsoft.Test/resourceType/objectArray[*].property |
"value1", "value2" |
Microsoft.Test/resourceType/objectArray[*].nestedArray |
[ 1, 2 ], [ 3, 4 ] |
Microsoft.Test/resourceType/objectArray[*].nestedArray[*] |
1, 2, 3, 4 |
예제 리소스 콘텐츠에서 field() 함수를 사용하는 경우에 결과는 다음과 같습니다.
| 식 | 반환 값 |
|---|---|
[field('Microsoft.Test/resourceType/missingArray')] |
"" |
[field('Microsoft.Test/resourceType/missingArray[*]')] |
[] |
[field('Microsoft.Test/resourceType/missingArray[*].property')] |
[] |
[field('Microsoft.Test/resourceType/stringArray')] |
["a", "b", "c"] |
[field('Microsoft.Test/resourceType/stringArray[*]')] |
["a", "b", "c"] |
[field('Microsoft.Test/resourceType/objectArray[*]')] |
[{ "property": "value1", "nestedArray": [ 1, 2 ] }, { "property": "value2", "nestedArray": [ 3, 4 ] }] |
[field('Microsoft.Test/resourceType/objectArray[*].property')] |
["value1", "value2"] |
[field('Microsoft.Test/resourceType/objectArray[*].nestedArray')] |
[[ 1, 2 ], [ 3, 4 ]] |
[field('Microsoft.Test/resourceType/objectArray[*].nestedArray[*]')] |
[1, 2, 3, 4] |
필드 개수 식
필드 개수 식은 조건을 충족하는 배열 멤버 수를 계산하고 해당 개수를 대상 값과 비교합니다. 배열을 평가할 때 Count는 field 조건보다 더 직관적이고 유용합니다. 구문은 다음과 같습니다.
{
"count": {
"field": <[*] alias>,
"where": <optional policy condition expression>
},
"equals|greater|less|any other operator": <target value>
}
where 조건 없이 사용하는 경우 count는 단순히 배열의 길이를 반환합니다. 이전 섹션의 예제 리소스 콘텐츠를 사용하여 다음 count 식은 stringArray에 세 개의 멤버가 있으므로 true로 계산됩니다.
{
"count": {
"field": "Microsoft.Test/resourceType/stringArray[*]"
},
"equals": 3
}
이 동작은 중첩된 배열에서도 작동합니다. 예를 들어 nestedArray 배열에 4개의 배열 멤버가 있으므로 다음 count 식은 true로 계산됩니다.
{
"count": {
"field": "Microsoft.Test/resourceType/objectArray[*].nestedArray[*]"
},
"greaterOrEquals": 4
}
count의 거듭제곱은 where 조건에 있습니다. 지정된 경우 Azure Policy는 배열 멤버를 열거하고 각 조건에 대해 평가하여 true로 평가된 배열 멤버 수를 계산합니다. 특히, where 조건 평가를 반복할 때마다 Azure Policy는 단일 배열 멤버 i를 선택하고 i가 마치 배열의 유일한 멤버인 것처럼where 조건에 대해 리소스 콘텐츠를 평가합니다. 반복할 때마다 배열 멤버를 하나만 사용할 수 있는 경우, 개별 배열 멤버에 복잡한 조건을 적용하는 방법이 제공됩니다.
예시:
{
"count": {
"field": "Microsoft.Test/resourceType/stringArray[*]",
"where": {
"field": "Microsoft.Test/resourceType/stringArray[*]",
"equals": "a"
}
},
"equals": 1
}
count 식을 계산하기 위해 Azure Policy는 stringArray의 각 멤버에 대해 where 조건을 세 번 평가하여 true로 평가된 횟수를 계산합니다.
where 조건이 Microsoft.Test/resourceType/stringArray[*] 배열 멤버를 참조하는 경우 stringArray의 모든 멤버를 선택하는 대신 항상 단일 배열 멤버를 선택합니다.
| 반복 | 선택한 Microsoft.Test/resourceType/stringArray[*] 값 |
where 평가 결과 |
|---|---|---|
| 1 | "a" |
true |
| 2 | "b" |
false |
| 3 | "c" |
false |
count는 1을 반환합니다.
보다 복잡한 식:
{
"count": {
"field": "Microsoft.Test/resourceType/objectArray[*]",
"where": {
"allOf": [
{
"field": "Microsoft.Test/resourceType/objectArray[*].property",
"equals": "value2"
},
{
"field": "Microsoft.Test/resourceType/objectArray[*].nestedArray[*]",
"greater": 2
}
]
}
},
"equals": 1
}
| 반복 | 선택한 값 | where 평가 결과 |
|---|---|---|
| 1 | Microsoft.Test/resourceType/objectArray[*].property =>"value1"Microsoft.Test/resourceType/objectArray[*].nestedArray[*] =>1, 2 |
false |
| 2 | Microsoft.Test/resourceType/objectArray[*].property =>"value2"Microsoft.Test/resourceType/objectArray[*].nestedArray[*] =>3, 4 |
true |
count는 1을 반환합니다.
where 식이 전체 요청 내용에 대해 계산된다는 것(현재 열거되는 배열 멤버만 변경됨)은 where 조건이 배열 외부의 필드를 참조할 수도 있음을 의미합니다.
{
"count": {
"field": "Microsoft.Test/resourceType/objectArray[*]",
"where": {
"field": "tags.env",
"equals": "prod"
}
},
"equals": 0
}
| 반복 | 선택한 값 | where 평가 결과 |
|---|---|---|
| 1 | tags.env =>"prod" |
true |
| 2 | tags.env =>"prod" |
true |
중첩된 개수 식은 중첩된 배열 필드에 조건을 적용하는 데 사용할 수 있습니다. 예를 들어 다음 조건은 objectArray[*] 배열에 하나 이상의 멤버가 포함된 nestedArray[*]와 정확히 두 개의 멤버가 있는지 확인합니다.
{
"count": {
"field": "Microsoft.Test/resourceType/objectArray[*]",
"where": {
"count": {
"field": "Microsoft.Test/resourceType/objectArray[*].nestedArray[*]"
},
"greaterOrEquals": 1
}
},
"equals": 2
}
| 반복 | 선택한 값 | 중첩된 개수 평가 결과 |
|---|---|---|
| 1 | Microsoft.Test/resourceType/objectArray[*].nestedArray[*] =>1, 2 |
nestedArray[*]에 2개 멤버 =>true가 있음 |
| 2 | Microsoft.Test/resourceType/objectArray[*].nestedArray[*] =>3, 4 |
nestedArray[*]에 2개 멤버 =>true가 있음 |
objectArray[*]의 두 멤버에는 두 개의 멤버가 있는 자식 배열 nestedArray[*]가 있으므로 외부 개수 식은 2를 반환합니다.
더 복잡한 예제: objectArray[*] 배열에 2 또는 3와 같은 멤버를 가진 nestedArray[*]를 포함하는 멤버가 정확히 2개인지 확인합니다.
{
"count": {
"field": "Microsoft.Test/resourceType/objectArray[*]",
"where": {
"count": {
"field": "Microsoft.Test/resourceType/objectArray[*].nestedArray[*]",
"where": {
"field": "Microsoft.Test/resourceType/objectArray[*].nestedArray[*]",
"in": [ 2, 3 ]
}
},
"greaterOrEquals": 1
}
},
"equals": 2
}
| 반복 | 선택한 값 | 중첩된 개수 평가 결과 |
|---|---|---|
| 1 | Microsoft.Test/resourceType/objectArray[*].nestedArray[*] =>1, 2 |
nestedArray[*]에 2 =>true가 있음 |
| 2 | Microsoft.Test/resourceType/objectArray[*].nestedArray[*] =>3, 4 |
nestedArray[*]에 3 =>true가 있음 |
objectArray[*]의 두 멤버에 2 또는 3를 포함하는 자식 배열 nestedArray[*]가 있으므로 외부 개수 식은 2를 반환합니다.
참고 항목
중첩된 필드 개수 식은 중첩된 배열만 참조할 수 있습니다. 예를 들어 Microsoft.Test/resourceType/objectArray[*]를 참조하는 개수 식에 중첩된 배열 Microsoft.Test/resourceType/objectArray[*].nestedArray[*]를 대상으로 하는 중첩된 개수가 있을 수 있지만 이 경우 Microsoft.Test/resourceType/stringArray[*]를 대상으로 하는 중첩된 개수 식을 가질 수 없습니다.
템플릿 함수를 사용하여 현재 배열 멤버 액세스
템플릿 함수를 사용하는 경우 current() 함수를 사용하여 현재 배열 멤버의 값 또는 해당 속성의 값에 액세스합니다. 현재 배열 멤버의 값에 액세스하려면 count.field에 정의된 별칭 또는 해당 자식 별칭을 current() 함수에 대한 인수로 전달합니다. 예시:
{
"count": {
"field": "Microsoft.Test/resourceType/objectArray[*]",
"where": {
"value": "[current('Microsoft.Test/resourceType/objectArray[*].property')]",
"like": "value*"
}
},
"equals": 2
}
| 반복 | current() 반환 값 |
where 평가 결과 |
|---|---|---|
| 1 | objectArray[*]의 첫 번째 멤버에 있는 property 값: value1 |
true |
| 2 | objectArray[*]의 첫 번째 멤버에 있는 property 값: value2 |
true |
Where 조건 내의 필드 함수
또한, field() 함수를 사용하여 개수 식이 존재 조건에 포함되지 않는 한 현재 배열 멤버의 값에 액세스할 수 있습니다. field() 함수는 항상 if 조건에서 계산된 리소스를 참조합니다. 평가된 배열을 참조할 때의 field() 동작은 다음 개념을 기반으로 합니다.
- 배열 별칭은 모든 배열 멤버에서 선택한 값의 컬렉션으로 확인됩니다.
- 배열 별칭을 참조하는
field()함수는 선택한 값이 포함된 배열을 반환합니다. where조건 내에서 계산된 배열 별칭을 참조하면 현재 반복에서 계산되는 배열 멤버에서 선택된 단일 값을 포함하는 컬렉션이 반환됩니다.
이 동작은 계산된 배열 멤버를 where 조건 내에서 field() 함수로 참조할 때 단일 멤버를 포함하는 배열을 반환함을 의미합니다. 이 동작은 직관적이지 않을 수 있지만 배열 별칭이 항상 선택된 속성의 컬렉션을 반환한다는 것과 일치합니다. 예를 들면 다음과 같습니다.
{
"count": {
"field": "Microsoft.Test/resourceType/stringArray[*]",
"where": {
"field": "Microsoft.Test/resourceType/stringArray[*]",
"equals": "[field('Microsoft.Test/resourceType/stringArray[*]')]"
}
},
"equals": 0
}
| 반복 | 식 값 | where 평가 결과 |
|---|---|---|
| 1 | Microsoft.Test/resourceType/stringArray[*] =>"a"[field('Microsoft.Test/resourceType/stringArray[*]')] =>[ "a" ] |
false |
| 2 | Microsoft.Test/resourceType/stringArray[*] =>"b"[field('Microsoft.Test/resourceType/stringArray[*]')] =>[ "b" ] |
false |
| 3 | Microsoft.Test/resourceType/stringArray[*] =>"c"[field('Microsoft.Test/resourceType/stringArray[*]')] =>[ "c" ] |
false |
따라서 field() 함수를 사용하여 계산된 배열 별칭의 값에 액세스해야 하는 경우, 해당 작업을 수행하는 방법은 first() 템플릿 함수를 사용하여 래핑하는 것입니다.
{
"count": {
"field": "Microsoft.Test/resourceType/stringArray[*]",
"where": {
"field": "Microsoft.Test/resourceType/stringArray[*]",
"equals": "[first(field('Microsoft.Test/resourceType/stringArray[*]'))]"
}
}
}
| 반복 | 식 값 | where 평가 결과 |
|---|---|---|
| 1 | Microsoft.Test/resourceType/stringArray[*] =>"a"[first(field('Microsoft.Test/resourceType/stringArray[*]'))] =>"a" |
true |
| 2 | Microsoft.Test/resourceType/stringArray[*] =>"b"[first(field('Microsoft.Test/resourceType/stringArray[*]'))] =>"b" |
true |
| 3 | Microsoft.Test/resourceType/stringArray[*] =>"c"[first(field('Microsoft.Test/resourceType/stringArray[*]'))] =>"c" |
true |
유용한 예제를 확인하시려면 필드 개수 예를 참조하세요.
배열 수정
추가 및 수정은 만들거나 업데이트하는 동안 리소스에 대한 속성을 변경합니다. 배열 속성으로 작업할 때 이런 효과의 동작은 해당 작업이 [*] 별칭을 수정하려고 하는지 여부에 따라 달라집니다.
참고 항목
modify 효과와 별칭을 사용하는 것은 현재 미리 보기상태입니다.
| Alias | 효과 | 결과 |
|---|---|---|
Microsoft.Storage/storageAccounts/networkAcls.ipRules |
append |
Azure Policy는 효과 세부 정보에 지정된 전체 배열이 누락되어 있으면 해당 배열을 추가합니다. |
Microsoft.Storage/storageAccounts/networkAcls.ipRules |
add 및 modify 작업 |
Azure Policy는 효과 세부 정보에 지정된 전체 배열이 누락되어 있으면 해당 배열을 추가합니다. |
Microsoft.Storage/storageAccounts/networkAcls.ipRules |
addOrReplace 및 modify 작업 |
Azure Policy는 효과 세부 정보에 지정된 전체 배열이 누락되어 있으면 해당 배열을 추가하거나 기존 배열을 바꿉니다. |
Microsoft.Storage/storageAccounts/networkAcls.ipRules[*] |
append |
Azure Policy는 효과 세부 정보에 지정된 배열 멤버를 추가합니다. |
Microsoft.Storage/storageAccounts/networkAcls.ipRules[*] |
add 및 modify 작업 |
Azure Policy는 효과 세부 정보에 지정된 배열 멤버를 추가합니다. |
Microsoft.Storage/storageAccounts/networkAcls.ipRules[*] |
addOrReplace 및 modify 작업 |
Azure Policy는 기존 배열 멤버를 모두 제거하고 효과 세부 정보에 지정된 배열 멤버를 추가합니다. |
Microsoft.Storage/storageAccounts/networkAcls.ipRules[*].action |
append |
Azure Policy는 각 배열 멤버의 action 속성에 값을 추가합니다. |
Microsoft.Storage/storageAccounts/networkAcls.ipRules[*].action |
add 및 modify 작업 |
Azure Policy는 각 배열 멤버의 action 속성에 값을 추가합니다. |
Microsoft.Storage/storageAccounts/networkAcls.ipRules[*].action |
addOrReplace 및 modify 작업 |
Azure Policy는 각 배열 멤버의 기존 action 속성을 추가하거나 바꿉니다. |
자세한 내용은 추가 예제를 참조하세요.
추가 [*] 별칭 예
요청 콘텐츠에 있는 배열의 ‘모든’ 혹은 ‘하나의’ 멤버가 조건을 충족하는지 확인하려면 필드 개수 식을 사용하는 것이 좋습니다. 그러나 일부 간단한 조건의 경우 배열 멤버 컬렉션 참조에 설명된 대로 배열 별칭과 함께 필드 접근자를 사용하여 동일한 결과를 얻을 수 있습니다. 이 패턴은 허용되는 개수 식의 제한을 초과하는 정책 규칙에서 유용할 수 있습니다. 일반적인 사용 사례에 대한 예제는 다음과 같습니다.
아래 시나리오 테이블의 정책 규칙 예:
"policyRule": {
"if": {
"allOf": [
{
"field": "Microsoft.Storage/storageAccounts/networkAcls.ipRules",
"exists": "true"
},
<-- Condition (see table below) -->
]
},
"then": {
"effect": "[parameters('effectType')]"
}
}
아래 시나리오 테이블의 ipRules 배열은 다음과 같습니다.
"ipRules": [
{
"value": "127.0.0.1",
"action": "Allow"
},
{
"value": "192.168.1.1",
"action": "Allow"
}
]
아래의 각 조건 예에서 <field>는 "field": "Microsoft.Storage/storageAccounts/networkAcls.ipRules[*].value"로 바꿉니다.
다음 결과는 이 조건 및 예제 정책 규칙과 상기 기존 값 배열의 조합에 대한 결과입니다.
| 조건 | 결과 | 시나리오 | 설명 |
|---|---|---|---|
{<field>,"notEquals":"127.0.0.1"} |
없음 | 일치 항목 없음 | 한 배열 요소가 false(127.0.0.1 != 127.0.0.1)로 평가되고, 한 배열 요소는 true(127.0.0.1 != 192.168.1.1)로 평가되므로 notEquals 조건이 false이고 효과는 트리거되지 않습니다. |
{<field>,"notEquals":"10.0.4.1"} |
정책 효과 | 일치 항목 없음 | 두 배열 요소가 true(10.0.4.1 != 127.0.0.1 및 10.0.4.1 != 192.168.1.1)로 평가되므로 notEquals 조건이 true이고 효과가 트리거됩니다. |
"not":{<field>,"notEquals":"127.0.0.1" } |
정책 효과 | 하나 이상 일치 | 한 배열 요소가 false(127.0.0.1 != 127.0.0.1)로 평가되고, 한 배열 요소는 true(127.0.0.1 != 192.168.1.1)로 평가되므로 notEquals 조건이 false입니다. 논리 연산자가 true(notfalse)로 평가되므로 효과가 트리거됩니다. |
"not":{<field>,"notEquals":"10.0.4.1"} |
없음 | 하나 이상 일치 | 두 배열 요소가 true(10.0.4.1 != 127.0.0.1 및 10.0.4.1 != 192.168.1.1)로 평가되므로 notEquals 조건이 true입니다. 논리 연산자가 false(nottrue)로 평가되므로 효과가 트리거되지 않습니다. |
"not":{<field>,"Equals":"127.0.0.1"} |
정책 효과 | 일부만 일치 | 한 배열 요소가 true(127.0.0.1 == 127.0.0.1)로 평가되고, 한 배열 요소는 false(127.0.0.1 == 192.168.1.1)로 평가되므로 Equals 조건이 false입니다. 논리 연산자가 true(notfalse)로 평가되므로 효과가 트리거됩니다. |
"not":{<field>,"Equals":"10.0.4.1"} |
정책 효과 | 일부만 일치 | 두 배열 요소가 false(10.0.4.1 == 127.0.0.1 및 10.0.4.1 == 192.168.1.1)로 평가되므로 Equals 조건이 false입니다. 논리 연산자가 true(notfalse)로 평가되므로 효과가 트리거됩니다. |
{<field>,"Equals":"127.0.0.1"} |
없음 | 모두 일치 | 한 배열 요소가 true(127.0.0.1 == 127.0.0.1)로 평가되고, 한 배열 요소는 false(127.0.0.1 == 192.168.1.1)로 평가되므로 Equals 조건이 false이고 효과는 트리거되지 않습니다. |
{<field>,"Equals":"10.0.4.1"} |
없음 | 모두 일치 | 두 배열 요소가 false(10.0.4.1 == 127.0.0.1 및 10.0.4.1 == 192.168.1.1)로 평가되므로 Equals 조건이 false이고 효과는 트리거되지 않습니다. |
다음 단계
- Azure Policy 샘플에서 예제를 검토합니다.
- Azure Policy 정의 구조를 검토합니다.
- 정책 효과 이해를 검토합니다.
- 프로그래밍 방식으로 정책을 만드는 방법을 이해합니다.
- 규정 비준수 리소스를 수정하는 방법을 알아봅니다.
- Azure 관리 그룹으로 리소스 구성을 포함하는 관리 그룹을 검토합니다.