Condividi tramite


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:

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:

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[]