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 :
- Groupes de ressources - Voir commandes de déploiement de groupes de ressources
- Abonnements - Voir Commandes de déploiement d’abonnement
- Groupes d’administration - Voir Commandes de déploiement de groupe d’administration
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 :
- Groupes de ressources - Voir commandes de déploiement de groupes de ressources
- Abonnements - Voir Commandes de déploiement d’abonnement
- Groupes d’administration - Voir Commandes de déploiement de groupe d’administration
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[] |