Corrections de Microsoft.PolicyInsights
Définition de ressource Bicep
Le type de ressource de corrections peut être déployé avec les opérations qui ciblent :
Pour obtenir la liste des propriétés modifiées dans chaque version de l’API, consultez journal des modifications.
Format de ressource
Pour créer une ressource Microsoft.PolicyInsights/corrections, ajoutez le bicep suivant à votre modèle.
resource symbolicname 'Microsoft.PolicyInsights/remediations@2024-10-01' = {
scope: resourceSymbolicName or scope
name: 'string'
properties: {
failureThreshold: {
percentage: int
}
filters: {
locations: [
'string'
]
resourceIds: [
'string'
]
}
parallelDeployments: int
policyAssignmentId: 'string'
policyDefinitionReferenceId: 'string'
resourceCount: int
resourceDiscoveryMode: 'string'
}
}
Valeurs de propriété
Microsoft.PolicyInsights/corrections
| Nom | Description | Valeur |
|---|---|---|
| nom | Nom de la ressource | chaîne (obligatoire) |
| Propriétés | Propriétés de la correction. | RemediationProperties |
| portée | Utilisez-la lors de la création d’une ressource dans une étendue différente de l’étendue de déploiement. | Définissez cette propriété sur le nom symbolique d’une ressource pour appliquer la ressource d’extension . |
RemediationFilters
| Nom | Description | Valeur |
|---|---|---|
| Lieux | Emplacements des ressources qui seront corrigés. | string[] |
| resourceIds | ID des ressources qui seront corrigées. Peut spécifier au maximum 100 ID. Ce filtre ne peut pas être utilisé lorsque ReEvaluateCompliance est défini sur ReEvaluateCompliance et ne peut pas être vide s’il est fourni. | string[] |
RemediationProperties
| Nom | Description | Valeur |
|---|---|---|
| failureThreshold | Paramètres de seuil d’échec de correction | RemediationPropertiesFailureThreshold |
| Filtres | Filtres qui seront appliqués pour déterminer les ressources à corriger. | remediationFilters |
| parallelDeployments | Détermine le nombre de ressources à corriger à un moment donné. Peut être utilisé pour augmenter ou réduire le rythme de la correction. S’il n’est pas fourni, la valeur des déploiements parallèles par défaut est utilisée. | Int |
| policyAssignmentId | ID de ressource de l’affectation de stratégie qui doit être corrigé. | corde |
| policyDefinitionReferenceId | ID de référence de définition de stratégie de la définition individuelle à corriger. Obligatoire lorsque l’attribution de stratégie en cours de correction affecte une définition d’ensemble de stratégies. | corde |
| resourceCount | Détermine le nombre maximal de ressources qui peuvent être corrigées par le travail de correction. S’il n’est pas fourni, le nombre de ressources par défaut est utilisé. | Int |
| resourceDiscoveryMode | La façon dont les ressources à corriger sont découvertes. La valeur par défaut est ExistingNonCompliant si elle n’est pas spécifiée. | 'ExistingNonCompliant' 'ReEvaluateCompliance' |
RemediationPropertiesFailureThreshold
| Nom | Description | Valeur |
|---|---|---|
| pourcentage | Nombre compris entre 0,0 et 1,0 représentant le seuil d’échec du pourcentage. La correction échoue si le pourcentage d’opérations de correction ayant échoué (c’est-à-dire les déploiements ayant échoué) dépasse ce seuil. | Int |
Définition de ressource de modèle ARM
Le type de ressource de corrections peut être déployé avec les opérations qui ciblent :
Pour obtenir la liste des propriétés modifiées dans chaque version de l’API, consultez journal des modifications.
Format de ressource
Pour créer une ressource Microsoft.PolicyInsights/corrections, ajoutez le code JSON suivant à votre modèle.
{
"type": "Microsoft.PolicyInsights/remediations",
"apiVersion": "2024-10-01",
"name": "string",
"properties": {
"failureThreshold": {
"percentage": "int"
},
"filters": {
"locations": [ "string" ],
"resourceIds": [ "string" ]
},
"parallelDeployments": "int",
"policyAssignmentId": "string",
"policyDefinitionReferenceId": "string",
"resourceCount": "int",
"resourceDiscoveryMode": "string"
}
}
Valeurs de propriété
Microsoft.PolicyInsights/corrections
| Nom | Description | Valeur |
|---|---|---|
| apiVersion | Version de l’API | '2024-10-01' |
| nom | Nom de la ressource | chaîne (obligatoire) |
| Propriétés | Propriétés de la correction. | RemediationProperties |
| type | Type de ressource | 'Microsoft.PolicyInsights/remediations' |
RemediationFilters
| Nom | Description | Valeur |
|---|---|---|
| Lieux | Emplacements des ressources qui seront corrigés. | string[] |
| resourceIds | ID des ressources qui seront corrigées. Peut spécifier au maximum 100 ID. Ce filtre ne peut pas être utilisé lorsque ReEvaluateCompliance est défini sur ReEvaluateCompliance et ne peut pas être vide s’il est fourni. | string[] |
RemediationProperties
| Nom | Description | Valeur |
|---|---|---|
| failureThreshold | Paramètres de seuil d’échec de correction | RemediationPropertiesFailureThreshold |
| Filtres | Filtres qui seront appliqués pour déterminer les ressources à corriger. | remediationFilters |
| parallelDeployments | Détermine le nombre de ressources à corriger à un moment donné. Peut être utilisé pour augmenter ou réduire le rythme de la correction. S’il n’est pas fourni, la valeur des déploiements parallèles par défaut est utilisée. | Int |
| policyAssignmentId | ID de ressource de l’affectation de stratégie qui doit être corrigé. | corde |
| policyDefinitionReferenceId | ID de référence de définition de stratégie de la définition individuelle à corriger. Obligatoire lorsque l’attribution de stratégie en cours de correction affecte une définition d’ensemble de stratégies. | corde |
| resourceCount | Détermine le nombre maximal de ressources qui peuvent être corrigées par le travail de correction. S’il n’est pas fourni, le nombre de ressources par défaut est utilisé. | Int |
| resourceDiscoveryMode | La façon dont les ressources à corriger sont découvertes. La valeur par défaut est ExistingNonCompliant si elle n’est pas spécifiée. | 'ExistingNonCompliant' 'ReEvaluateCompliance' |
RemediationPropertiesFailureThreshold
| Nom | Description | Valeur |
|---|---|---|
| pourcentage | Nombre compris entre 0,0 et 1,0 représentant le seuil d’échec du pourcentage. La correction échoue si le pourcentage d’opérations de correction ayant échoué (c’est-à-dire les déploiements ayant échoué) dépasse ce seuil. | Int |
Définition de ressource Terraform (fournisseur AzAPI)
Le type de ressource de corrections peut être déployé avec les opérations qui ciblent :
Pour obtenir la liste des propriétés modifiées dans chaque version de l’API, consultez journal des modifications.
Format de ressource
Pour créer une ressource Microsoft.PolicyInsights/corrections, ajoutez le terraform suivant à votre modèle.
resource "azapi_resource" "symbolicname" {
type = "Microsoft.PolicyInsights/remediations@2024-10-01"
name = "string"
parent_id = "string"
body = jsonencode({
properties = {
failureThreshold = {
percentage = int
}
filters = {
locations = [
"string"
]
resourceIds = [
"string"
]
}
parallelDeployments = int
policyAssignmentId = "string"
policyDefinitionReferenceId = "string"
resourceCount = int
resourceDiscoveryMode = "string"
}
})
}
Valeurs de propriété
Microsoft.PolicyInsights/corrections
| Nom | Description | Valeur |
|---|---|---|
| nom | Nom de la ressource | chaîne (obligatoire) |
| parent_id | ID de la ressource à laquelle appliquer cette ressource d’extension. | chaîne (obligatoire) |
| Propriétés | Propriétés de la correction. | RemediationProperties |
| type | Type de ressource | « Microsoft.PolicyInsights/remediations@2024-10-01 » |
RemediationFilters
| Nom | Description | Valeur |
|---|---|---|
| Lieux | Emplacements des ressources qui seront corrigés. | string[] |
| resourceIds | ID des ressources qui seront corrigées. Peut spécifier au maximum 100 ID. Ce filtre ne peut pas être utilisé lorsque ReEvaluateCompliance est défini sur ReEvaluateCompliance et ne peut pas être vide s’il est fourni. | string[] |
RemediationProperties
| Nom | Description | Valeur |
|---|---|---|
| failureThreshold | Paramètres de seuil d’échec de correction | RemediationPropertiesFailureThreshold |
| Filtres | Filtres qui seront appliqués pour déterminer les ressources à corriger. | remediationFilters |
| parallelDeployments | Détermine le nombre de ressources à corriger à un moment donné. Peut être utilisé pour augmenter ou réduire le rythme de la correction. S’il n’est pas fourni, la valeur des déploiements parallèles par défaut est utilisée. | Int |
| policyAssignmentId | ID de ressource de l’affectation de stratégie qui doit être corrigé. | corde |
| policyDefinitionReferenceId | ID de référence de définition de stratégie de la définition individuelle à corriger. Obligatoire lorsque l’attribution de stratégie en cours de correction affecte une définition d’ensemble de stratégies. | corde |
| resourceCount | Détermine le nombre maximal de ressources qui peuvent être corrigées par le travail de correction. S’il n’est pas fourni, le nombre de ressources par défaut est utilisé. | Int |
| resourceDiscoveryMode | La façon dont les ressources à corriger sont découvertes. La valeur par défaut est ExistingNonCompliant si elle n’est pas spécifiée. | 'ExistingNonCompliant' 'ReEvaluateCompliance' |
RemediationPropertiesFailureThreshold
| Nom | Description | Valeur |
|---|---|---|
| pourcentage | Nombre compris entre 0,0 et 1,0 représentant le seuil d’échec du pourcentage. La correction échoue si le pourcentage d’opérations de correction ayant échoué (c’est-à-dire les déploiements ayant échoué) dépasse ce seuil. | Int |