Исправления Microsoft.PolicyInsights
Определение ресурса Bicep
Тип ресурса remediations является ресурсом расширения, что означает, что его можно применить к другому ресурсу.
scope Используйте свойство этого ресурса, чтобы задать область для этого ресурса. См . раздел Установка области для ресурсов расширения в Bicep.
Допустимые области развертывания для ресурса исправлений:
- Группы ресурсов — см. команды развертывания группы ресурсов.
- Подписки — см. команды развертывания подписки.
- Группы управления — см. статью Команды развертывания группы управления.
Список измененных свойств в каждой версии API см. в журнале изменений.
Формат ресурсов
Чтобы создать ресурс Microsoft.PolicyInsights/remediations, добавьте следующий Bicep в шаблон.
resource symbolicname 'Microsoft.PolicyInsights/remediations@2021-10-01' = {
name: 'string'
scope: resourceSymbolicName
properties: {
failureThreshold: {
percentage: int
}
filters: {
locations: [
'string'
]
}
parallelDeployments: int
policyAssignmentId: 'string'
policyDefinitionReferenceId: 'string'
resourceCount: int
resourceDiscoveryMode: 'string'
}
}
Значения свойств
remediations
| Имя | Описание | Значение |
|---|---|---|
| name | имя ресурса. | строка (обязательно) |
| область | Используйте при создании ресурса расширения в области, отличной от области развертывания. | Целевой ресурс Для Bicep задайте для этого свойства символьное имя ресурса, чтобы применить ресурс расширения. |
| properties | Свойства для исправления. | RemediationProperties |
RemediationProperties
| Имя | Описание | Значение |
|---|---|---|
| failureThreshold | Параметры порогового значения сбоя исправления | RemediationPropertiesFailureThreshold |
| filters | Фильтры, которые будут применены для определения ресурсов для исправления. | RemediationFilters |
| parallelDeployments | Определяет, сколько ресурсов необходимо исправить в любой момент времени. Можно использовать для увеличения или уменьшения скорости исправления. Если значение не указано, используется значение параллельных развертываний по умолчанию. | INT |
| policyAssignmentId | Идентификатор ресурса назначения политики, которое должно быть исправлено. | строка |
| policyDefinitionReferenceId | Идентификатор ссылки на определение политики отдельного определения, которое необходимо исправить. Требуется, если исправленное назначение политики назначает определение набора политик. | строка |
| resourceCount | Определяет максимальное количество ресурсов, которые могут быть исправлены заданием исправления. Если значение не указано, используется число ресурсов по умолчанию. | INT |
| resourceDiscoveryMode | Способ обнаружения ресурсов для исправления. По умолчанию — ExistingNonCompliant, если не указано. | ExistingNonCompliant ReEvaluateCompliance |
RemediationPropertiesFailureThreshold
| Имя | Описание | Значение |
|---|---|---|
| процент | Число от 0,0 до 1,0, представляющее пороговое значение сбоя в процентах. Исправление завершится ошибкой, если процент неудачных операций исправления (т. е. неудачных развертываний) превышает это пороговое значение. | INT |
RemediationFilters
| Имя | Описание | Значение |
|---|---|---|
| Расположения | Расположения ресурсов, которые будут исправлены. | string[] |
Определение ресурса шаблона ARM
Тип ресурса remediations является ресурсом расширения, что означает, что его можно применить к другому ресурсу.
scope Используйте свойство этого ресурса, чтобы задать область для этого ресурса. См . раздел Установка области для ресурсов расширения в шаблонах ARM.
Допустимые области развертывания для ресурса исправлений:
- Группы ресурсов — см. команды развертывания группы ресурсов.
- Подписки — см. команды развертывания подписки.
- Группы управления — см. статью Команды развертывания группы управления.
Список измененных свойств в каждой версии API см. в журнале изменений.
Формат ресурсов
Чтобы создать ресурс Microsoft.PolicyInsights/remediations, добавьте следующий код JSON в шаблон.
{
"type": "Microsoft.PolicyInsights/remediations",
"apiVersion": "2021-10-01",
"name": "string",
"scope": "string",
"properties": {
"failureThreshold": {
"percentage": "int"
},
"filters": {
"locations": [ "string" ]
},
"parallelDeployments": "int",
"policyAssignmentId": "string",
"policyDefinitionReferenceId": "string",
"resourceCount": "int",
"resourceDiscoveryMode": "string"
}
}
Значения свойств
remediations
| Имя | Описание | Значение |
|---|---|---|
| тип | Тип ресурса | Microsoft.PolicyInsights/remediations |
| версия_API | Версия API ресурсов | '2021-10-01' |
| name | имя ресурса. | string (обязательно) |
| область | Используется при создании ресурса расширения в области, отличной от области развертывания. | Целевой ресурс Для JSON задайте полное имя ресурса, к который будет применяться ресурс расширения . |
| properties | Свойства для исправления. | Свойства remediationProperties |
Свойства remediationProperties
| Имя | Описание | Значение |
|---|---|---|
| failureThreshold | Параметры порогового значения ошибки исправления | RemediationPropertiesFailureThreshold |
| filters | Фильтры, которые будут применяться для определения ресурсов для исправления. | ИсправлениеФильтры |
| parallelDeployments | Определяет, сколько ресурсов необходимо исправить в любой момент времени. Можно использовать для увеличения или уменьшения скорости исправления. Если этот параметр не указан, используется значение параллельных развертываний по умолчанию. | INT |
| policyAssignmentId | Идентификатор ресурса назначения политики, который необходимо исправить. | строка |
| policyDefinitionReferenceId | Идентификатор ссылки на определение политики отдельного определения, которое необходимо исправить. Требуется, если исправленное назначение политики назначает определение набора политик. | строка |
| resourceCount | Определяет максимальное количество ресурсов, которые могут быть исправлены заданием исправления. Если этот параметр не указан, используется число ресурсов по умолчанию. | INT |
| resourceDiscoveryMode | Способ обнаружения ресурсов для исправления. Значение по умолчанию — ExistingNonCompliant, если не указано. | ExistingNonCompliant 'ReEvaluateCompliance' |
RemediationPropertiesFailureThreshold
| Имя | Описание | Значение |
|---|---|---|
| процент | Число от 0,0 до 1,0, представляющее пороговое значение сбоя в процентах. Исправление завершится ошибкой, если процент неудачных операций исправления (т. е. неудачных развертываний) превысит это пороговое значение. | INT |
ИсправлениеФильтры
| Имя | Описание | Значение |
|---|---|---|
| Расположения | Расположения ресурсов, которые будут исправлены. | string[] |
Определение ресурса Terraform (поставщик AzAPI)
Тип ресурса remediations является ресурсом расширения, что означает, что его можно применить к другому ресурсу.
parent_id Используйте свойство этого ресурса, чтобы задать область для этого ресурса.
Допустимые области развертывания для ресурса исправлений:
- Группы ресурсов
- Подписки
- Группы управления
Список измененных свойств в каждой версии API см. в журнале изменений.
Формат ресурсов
Чтобы создать ресурс Microsoft.PolicyInsights/remediations, добавьте следующую terraform в шаблон.
resource "azapi_resource" "symbolicname" {
type = "Microsoft.PolicyInsights/remediations@2021-10-01"
name = "string"
parent_id = "string"
body = jsonencode({
properties = {
failureThreshold = {
percentage = int
}
filters = {
locations = [
"string"
]
}
parallelDeployments = int
policyAssignmentId = "string"
policyDefinitionReferenceId = "string"
resourceCount = int
resourceDiscoveryMode = "string"
}
})
}
Значения свойств
remediations
| Имя | Описание | Значение |
|---|---|---|
| тип | Тип ресурса | "Microsoft.PolicyInsights/remediations@2021-10-01" |
| name | имя ресурса. | string (обязательно) |
| parent_id | Идентификатор ресурса, к который применяется этот ресурс расширения. | string (обязательно) |
| properties | Свойства для исправления. | Свойства remediationProperties |
Свойства remediationProperties
| Имя | Описание | Значение |
|---|---|---|
| failureThreshold | Параметры порогового значения ошибки исправления | RemediationPropertiesFailureThreshold |
| filters | Фильтры, которые будут применяться для определения ресурсов для исправления. | ИсправлениеФильтры |
| parallelDeployments | Определяет, сколько ресурсов необходимо исправить в любой момент времени. Можно использовать для увеличения или уменьшения скорости исправления. Если этот параметр не указан, используется значение параллельных развертываний по умолчанию. | INT |
| policyAssignmentId | Идентификатор ресурса назначения политики, который необходимо исправить. | строка |
| policyDefinitionReferenceId | Идентификатор ссылки на определение политики отдельного определения, которое необходимо исправить. Требуется, если исправленное назначение политики назначает определение набора политик. | строка |
| resourceCount | Определяет максимальное количество ресурсов, которые могут быть исправлены заданием исправления. Если этот параметр не указан, используется число ресурсов по умолчанию. | INT |
| resourceDiscoveryMode | Способ обнаружения ресурсов для исправления. Значение по умолчанию — ExistingNonCompliant, если не указано. | "ExistingNonCompliant" "ReEvaluateCompliance" |
RemediationPropertiesFailureThreshold
| Имя | Описание | Значение |
|---|---|---|
| процент | Число от 0,0 до 1,0, представляющее пороговое значение сбоя в процентах. Исправление завершится ошибкой, если процент неудачных операций исправления (т. е. неудачных развертываний) превысит это пороговое значение. | INT |
ИсправлениеФильтры
| Имя | Описание | Значение |
|---|---|---|
| Расположения | Расположения ресурсов, которые будут исправлены. | string[] |