Partager via


Corrections Microsoft.PolicyInsights

Définition de ressource Bicep

Le type de ressource corrections est une ressource d’extension, ce qui signifie que vous pouvez l’appliquer à une autre ressource.

Utilisez la scope propriété sur cette ressource pour définir l’étendue de cette ressource. Consultez Définir l’étendue des ressources d’extension dans Bicep.

Les étendues de déploiement valides pour la ressource de corrections sont les suivantes :

Pour obtenir la liste des propriétés modifiées dans chaque version de l’API, consultez journal des modifications.

Format des ressources

Pour créer une ressource Microsoft.PolicyInsights/remediations, ajoutez le Bicep suivant à votre modèle.

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'
  }
}

Valeurs de propriétés

remediations

Nom Description Valeur
name Nom de la ressource chaîne (obligatoire)
scope Utilisez lors de la création d’une ressource d’extension dans une étendue différente de l’étendue du déploiement. Ressource cible

Pour Bicep, définissez cette propriété sur le nom symbolique de la ressource pour appliquer la ressource d’extension.
properties Propriétés de la correction. RemediationProperties

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. Si elle n’est pas fournie, la valeur par défaut des déploiements parallèles est utilisée. int
policyAssignmentId ID de ressource de l’affectation de stratégie qui doit être corrigée. string
policyDefinitionReferenceId ID de référence de définition de stratégie de la définition individuelle qui doit être corrigée. Obligatoire lorsque l’affectation de stratégie corrigée affecte une définition d’ensemble de stratégies. string
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
percentage Nombre compris entre 0,0 et 1,0 représentant le seuil de pourcentage d’échec. 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

RemediationFilters

Nom Description Valeur
locations Emplacements de ressources qui seront corrigés. string[]

Définition de ressources de modèle ARM

Le type de ressource corrections est une ressource d’extension, ce qui signifie que vous pouvez l’appliquer à une autre ressource.

Utilisez la scope propriété sur cette ressource pour définir l’étendue de cette ressource. Consultez Définir l’étendue des ressources d’extension dans les modèles ARM.

Les étendues de déploiement valides pour la ressource de corrections sont les suivantes :

Pour obtenir la liste des propriétés modifiées dans chaque version de l’API, consultez journal des modifications.

Format des ressources

Pour créer une ressource Microsoft.PolicyInsights/remediations, ajoutez le JSON suivant à votre modèle.

{
  "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"
  }
}

Valeurs de propriétés

remediations

Nom Description Valeur
type Type de ressource « Microsoft.PolicyInsights/remediations »
apiVersion Version de l’API de ressource '2021-10-01'
name Nom de la ressource string (obligatoire)
scope Utilisez lors de la création d’une ressource d’extension dans une étendue différente de l’étendue de déploiement. Ressource cible

Pour JSON, définissez la valeur sur le nom complet de la ressource à laquelle appliquer la ressource d’extension .
properties Propriétés de la correction. RemediationProperties

RemediationProperties

Nom Description Valeur
failureThreshold Paramètres du 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. Si elle n’est pas fournie, la valeur par défaut des déploiements parallèles est utilisée. int
policyAssignmentId ID de ressource de l’affectation de stratégie qui doit être corrigée. string
policyDefinitionReferenceId ID de référence de définition de stratégie de la définition individuelle qui doit être corrigée. Obligatoire lorsque l’affectation de stratégie en cours de correction affecte une définition de jeu de stratégies. string
resourceCount Détermine le nombre maximal de ressources pouvant ê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
percentage Nombre compris entre 0,0 et 1,0 représentant le seuil de pourcentage d’échec. 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

RemediationFilters

Nom Description Valeur
locations Emplacements des ressources qui seront corrigés. string[]

Définition de ressource Terraform (fournisseur AzAPI)

Le type de ressource corrections est une ressource d’extension, ce qui signifie que vous pouvez l’appliquer à une autre ressource.

Utilisez la parent_id propriété sur cette ressource pour définir l’étendue de cette ressource.

Les étendues de déploiement valides pour la ressource de corrections sont les suivantes :

  • Groupes de ressources
  • Abonnements
  • Groupes d’administration

Pour obtenir la liste des propriétés modifiées dans chaque version d’API, consultez journal des modifications.

Format des ressources

Pour créer une ressource Microsoft.PolicyInsights/remediations, ajoutez le Terraform suivant à votre modèle.

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"
    }
  })
}

Valeurs de propriétés

remediations

Nom Description Valeur
type Type de ressource « Microsoft.PolicyInsights/remediations@2021-10-01 »
name Nom de la ressource string (obligatoire)
parent_id ID de la ressource à laquelle appliquer cette ressource d’extension. string (obligatoire)
properties Propriétés de la correction. RemediationProperties

RemediationProperties

Nom Description Valeur
failureThreshold Paramètres du 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. Si elle n’est pas fournie, la valeur par défaut des déploiements parallèles est utilisée. int
policyAssignmentId ID de ressource de l’affectation de stratégie qui doit être corrigée. string
policyDefinitionReferenceId ID de référence de définition de stratégie de la définition individuelle qui doit être corrigée. Obligatoire lorsque l’affectation de stratégie en cours de correction affecte une définition de jeu de stratégies. string
resourceCount Détermine le nombre maximal de ressources pouvant ê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
percentage Nombre compris entre 0,0 et 1,0 représentant le seuil de pourcentage d’échec. 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

RemediationFilters

Nom Description Valeur
locations Emplacements des ressources qui seront corrigés. string[]