Correzioni di Microsoft.PolicyInsights
Definizione di risorsa Bicep
Il tipo di risorsa correzioni è una risorsa di estensione, che significa che è possibile applicarla a un'altra risorsa.
Utilizzare la proprietà in questa risorsa per impostare l'ambito scope per questa risorsa. Vedere Impostare l'ambito sulle risorse di estensione in Bicep.
Gli ambiti di distribuzione validi per la risorsa di correzione sono:
- Gruppi di risorse - Vedere i comandi di distribuzione del gruppo di risorse
- Sottoscrizioni - Vedere i comandi di distribuzione delle sottoscrizioni
- Gruppi di gestione - Vedere i comandi di distribuzione dei gruppi di gestione
Per un elenco delle proprietà modificate in ogni versione dell'API, vedere log delle modifiche.
Formato di risorsa
Per creare una risorsa Microsoft.PolicyInsights/correzioni, aggiungere il bicep seguente al modello.
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'
}
}
Valori delle proprietà
remediations
| Nome | Descrizione | valore |
|---|---|---|
| name | Nome della risorsa | stringa (obbligatoria) |
| ambito | Usare quando si crea una risorsa di estensione in un ambito diverso dall'ambito di distribuzione. | Risorsa di destinazione Per Bicep, impostare questa proprietà sul nome simbolico della risorsa per applicare la risorsa di estensione. |
| properties | Proprietà per la correzione. | Proprietà di correzione |
Proprietà di correzione
| Nome | Descrizione | valore |
|---|---|---|
| failureThreshold | Impostazioni di soglia degli errori di correzione | CorrezionePropertiesFailureThreshold |
| filters | Filtri che verranno applicati per determinare quali risorse correggere. | CorrezioneFilters |
| parallelDeployments | Determina il numero di risorse da correggere in qualsiasi momento. Può essere usato per aumentare o ridurre il ritmo della correzione. Se non specificato, viene usato il valore predefinito delle distribuzioni parallele. | INT |
| policyAssignmentId | ID risorsa dell'assegnazione di criteri da correggere. | string |
| policyDefinitionReferenceId | ID di riferimento alla definizione dei criteri della singola definizione che deve essere correzionato. Obbligatorio quando l'assegnazione di criteri da correggere assegna una definizione del set di criteri. | string |
| resourceCount | Determina il numero massimo di risorse che possono essere correttive dal processo di correzione. Se non specificato, viene usato il conteggio delle risorse predefinito. | INT |
| resourceDiscoveryMode | Il modo in cui vengono individuate le risorse da correggere. Il valore predefinito è EsistenteNonCompliant se non specificato. | 'ExistingNonCompliant' 'ReEvaluateCompliance' |
CorrezionePropertiesFailureThreshold
| Nome | Descrizione | valore |
|---|---|---|
| percentuale | Numero compreso tra 0,0 e 1,0 che rappresenta la soglia di errore percentuale. La correzione avrà esito negativo se la percentuale di operazioni di correzione non riuscite (ovvero distribuzioni non riuscite) supera questa soglia. | INT |
CorrezioneFilters
| Nome | Descrizione | valore |
|---|---|---|
| locations | Percorsi delle risorse che verranno risolti. | string[] |
Definizione della risorsa modello di Resource Manager
Il tipo di risorsa correzioni è una risorsa di estensione, che significa che è possibile applicarla a un'altra risorsa.
Utilizzare la proprietà in questa risorsa per impostare l'ambito scope per questa risorsa. Vedere Impostare l'ambito sulle risorse di estensione nei modelli di Resource Manager.
Gli ambiti di distribuzione validi per la risorsa di correzione sono:
- Gruppi di risorse - Vedere i comandi di distribuzione del gruppo di risorse
- Sottoscrizioni - Vedere i comandi di distribuzione delle sottoscrizioni
- Gruppi di gestione - Vedere i comandi di distribuzione dei gruppi di gestione
Per un elenco delle proprietà modificate in ogni versione dell'API, vedere log delle modifiche.
Formato di risorsa
Per creare una risorsa Microsoft.PolicyInsights/correzioni, aggiungere il codice JSON seguente al modello.
{
"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"
}
}
Valori delle proprietà
remediations
| Nome | Descrizione | valore |
|---|---|---|
| tipo | Tipo di risorsa | 'Microsoft.PolicyInsights/remediations' |
| apiVersion | Versione dell'API della risorsa | '2021-10-01' |
| name | Nome della risorsa | stringa (obbligatorio) |
| ambito | Usare quando si crea una risorsa di estensione in un ambito diverso dall'ambito di distribuzione. | Risorsa di destinazione Per JSON, impostare il valore sul nome completo della risorsa a cui applicare la risorsa di estensione . |
| properties | Proprietà per la correzione. | RemediationProperties |
RemediationProperties
| Nome | Descrizione | valore |
|---|---|---|
| failureThreshold | Impostazioni di soglia degli errori di correzione | RemediationPropertiesFailureThreshold |
| filters | Filtri che verranno applicati per determinare le risorse da correggere. | RemediationFilters |
| parallelDeployments | Determina il numero di risorse da correggere in qualsiasi momento. Può essere usato per aumentare o ridurre il ritmo della correzione. Se non specificato, viene usato il valore predefinito delle distribuzioni parallele. | INT |
| policyAssignmentId | ID risorsa dell'assegnazione dei criteri da correggere. | string |
| policyDefinitionReferenceId | ID riferimento alla definizione dei criteri della singola definizione da correggere. Obbligatorio quando l'assegnazione dei criteri da correggere assegna una definizione di set di criteri. | string |
| resourceCount | Determina il numero massimo di risorse che è possibile correggere dal processo di correzione. Se non specificato, viene usato il numero di risorse predefinito. | INT |
| resourceDiscoveryMode | Viene individuato il modo in cui vengono individuate le risorse da correggere. Il valore predefinito è ExistingNonCompliant se non specificato. | 'ExistingNonCompliant' 'ReEvaluateCompliance' |
RemediationPropertiesFailureThreshold
| Nome | Descrizione | valore |
|---|---|---|
| percentuale | Numero compreso tra 0,0 e 1,0 che rappresenta la soglia di errore percentuale. La correzione avrà esito negativo se la percentuale di operazioni di correzione non riuscite (ad esempio le distribuzioni non riuscite) supera questa soglia. | INT |
RemediationFilters
| Nome | Descrizione | valore |
|---|---|---|
| locations | Percorsi delle risorse che verranno corretti. | string[] |
Definizione della risorsa Terraform (provider AzAPI)
Il tipo di risorsa correzioni è una risorsa di estensione, che significa che è possibile applicarla a un'altra risorsa.
Usare la parent_id proprietà in questa risorsa per impostare l'ambito per questa risorsa.
Gli ambiti di distribuzione validi per la risorsa di correzione sono:
- Gruppi di risorse
- Sottoscrizioni
- Gruppi di gestione
Per un elenco delle proprietà modificate in ogni versione dell'API, vedere Log delle modifiche.
Formato di risorsa
Per creare una risorsa Microsoft.PolicyInsights/remediations, aggiungere il codice Terraform seguente al modello.
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"
}
})
}
Valori delle proprietà
remediations
| Nome | Descrizione | valore |
|---|---|---|
| tipo | Tipo di risorsa | "Microsoft.PolicyInsights/remediations@2021-10-01" |
| name | Nome della risorsa | stringa (obbligatorio) |
| parent_id | ID della risorsa a cui applicare questa risorsa di estensione. | stringa (obbligatorio) |
| properties | Proprietà per la correzione. | RemediationProperties |
RemediationProperties
| Nome | Descrizione | valore |
|---|---|---|
| failureThreshold | Impostazioni di soglia degli errori di correzione | RemediationPropertiesFailureThreshold |
| filters | Filtri che verranno applicati per determinare le risorse da correggere. | RemediationFilters |
| parallelDeployments | Determina il numero di risorse da correggere in qualsiasi momento. Può essere usato per aumentare o ridurre il ritmo della correzione. Se non specificato, viene usato il valore predefinito delle distribuzioni parallele. | INT |
| policyAssignmentId | ID risorsa dell'assegnazione dei criteri da correggere. | string |
| policyDefinitionReferenceId | ID riferimento alla definizione dei criteri della singola definizione da correggere. Obbligatorio quando l'assegnazione dei criteri da correggere assegna una definizione di set di criteri. | string |
| resourceCount | Determina il numero massimo di risorse che è possibile correggere dal processo di correzione. Se non specificato, viene usato il numero di risorse predefinito. | INT |
| resourceDiscoveryMode | Viene individuato il modo in cui vengono individuate le risorse da correggere. Il valore predefinito è ExistingNonCompliant se non specificato. | "ExistingNonCompliant" "ReEvaluateCompliance" |
RemediationPropertiesFailureThreshold
| Nome | Descrizione | valore |
|---|---|---|
| percentuale | Numero compreso tra 0,0 e 1,0 che rappresenta la soglia di errore percentuale. La correzione avrà esito negativo se la percentuale di operazioni di correzione non riuscite (ad esempio le distribuzioni non riuscite) supera questa soglia. | INT |
RemediationFilters
| Nome | Descrizione | valore |
|---|---|---|
| locations | Percorsi delle risorse che verranno corretti. | string[] |