Udostępnij za pośrednictwem


Microsoft.PolicyInsights korygowania 2021-10-01

Definicja zasobu Bicep

Typ zasobu korygowania to zasób rozszerzenia, co oznacza, że można zastosować go do innego zasobu.

scope Użyj właściwości tego zasobu, aby ustawić zakres dla tego zasobu. Zobacz Ustawianie zakresu dla zasobów rozszerzeń w środowisku Bicep.

Prawidłowe zakresy wdrażania dla zasobu korygowania to:

Aby uzyskać listę zmienionych właściwości w każdej wersji interfejsu API, zobacz dziennik zmian.

Format zasobu

Aby utworzyć zasób Microsoft.PolicyInsights/remediations, dodaj następujący kod Bicep do szablonu.

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

Wartości właściwości

korygowania

Nazwa Opis Wartość
name Nazwa zasobu ciąg (wymagany)
scope Użyj polecenia podczas tworzenia zasobu rozszerzenia w zakresie innym niż zakres wdrożenia. Zasób docelowy

W przypadku elementu Bicep ustaw tę właściwość na symboliczną nazwę zasobu, aby zastosować zasób rozszerzenia.
properties Właściwości korygowania. RemediationProperties

RemediationProperties

Nazwa Opis Wartość
failureThreshold Ustawienia progu niepowodzenia korygowania RemediationPropertiesFailureThreshold
filtry Filtry, które zostaną zastosowane w celu określenia, które zasoby mają zostać skorygowane. RemediationFilters
parallelDeployments Określa liczbę zasobów do skorygowania w danym momencie. Można użyć do zwiększenia lub zmniejszenia tempa korygowania. Jeśli nie zostanie podana, zostanie użyta domyślna wartość wdrożeń równoległych. int
policyAssignmentId Identyfikator zasobu przypisania zasad, który powinien zostać skorygowany. ciąg
policyDefinitionReferenceId Identyfikator odwołania definicji zasad dla pojedynczej definicji, która powinna zostać skorygowana. Wymagane, gdy przypisanie zasad korygowane przypisuje definicję zestawu zasad. ciąg
resourceCount Określa maksymalną liczbę zasobów, które można skorygować za pomocą zadania korygowania. Jeśli nie zostanie podana, zostanie użyta domyślna liczba zasobów. int
resourceDiscoveryMode Sposób odnajdowania zasobów do korygowania. Wartość domyślna to ExistingNonCompliant, jeśli nie zostanie określona. "ExistingNonCompliant"
"ReEvaluateCompliance"

RemediationPropertiesFailureThreshold

Nazwa Opis Wartość
percentage Liczba z zakresu od 0,0 do 1,0 reprezentująca próg błędu procentowego. Korygowanie zakończy się niepowodzeniem, jeśli wartość procentowa nieudanych operacji korygowania (tj. nieudane wdrożenia) przekroczy ten próg. int

RemediationFilters

Nazwa Opis Wartość
locations Lokalizacje zasobów, które zostaną skorygowane. ciąg[]

Definicja zasobu szablonu usługi ARM

Typ zasobu korygowania to zasób rozszerzenia, co oznacza, że można zastosować go do innego zasobu.

scope Użyj właściwości tego zasobu, aby ustawić zakres dla tego zasobu. Zobacz Ustawianie zakresu dla zasobów rozszerzeń w szablonach usługi ARM.

Prawidłowe zakresy wdrażania dla zasobu korygowania to:

Aby uzyskać listę zmienionych właściwości w każdej wersji interfejsu API, zobacz dziennik zmian.

Format zasobu

Aby utworzyć zasób Microsoft.PolicyInsights/remediations, dodaj następujący kod JSON do szablonu.

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

Wartości właściwości

korygowania

Nazwa Opis Wartość
typ Typ zasobu "Microsoft.PolicyInsights/korygowania"
apiVersion Wersja interfejsu API zasobów '2021-10-01'
name Nazwa zasobu ciąg (wymagany)
scope Użyj polecenia podczas tworzenia zasobu rozszerzenia w zakresie innym niż zakres wdrożenia. Zasób docelowy

W przypadku formatu JSON ustaw wartość na pełną nazwę zasobu, aby zastosować zasób rozszerzenia do.
properties Właściwości korygowania. RemediationProperties

RemediationProperties

Nazwa Opis Wartość
failureThreshold Ustawienia progu niepowodzenia korygowania RemediationPropertiesFailureThreshold
filtry Filtry, które zostaną zastosowane w celu określenia, które zasoby mają zostać skorygowane. RemediationFilters
parallelDeployments Określa liczbę zasobów do skorygowania w danym momencie. Można użyć do zwiększenia lub zmniejszenia tempa korygowania. Jeśli nie zostanie podana, zostanie użyta domyślna wartość wdrożeń równoległych. int
policyAssignmentId Identyfikator zasobu przypisania zasad, który powinien zostać skorygowany. ciąg
policyDefinitionReferenceId Identyfikator odwołania definicji zasad dla pojedynczej definicji, która powinna zostać skorygowana. Wymagane, gdy przypisanie zasad korygowane przypisuje definicję zestawu zasad. ciąg
resourceCount Określa maksymalną liczbę zasobów, które można skorygować za pomocą zadania korygowania. Jeśli nie zostanie podana, zostanie użyta domyślna liczba zasobów. int
resourceDiscoveryMode Sposób odnajdowania zasobów do korygowania. Wartość domyślna to ExistingNonCompliant, jeśli nie zostanie określona. "ExistingNonCompliant"
"ReEvaluateCompliance"

RemediationPropertiesFailureThreshold

Nazwa Opis Wartość
percentage Liczba z zakresu od 0,0 do 1,0 reprezentująca próg błędu procentowego. Korygowanie zakończy się niepowodzeniem, jeśli wartość procentowa nieudanych operacji korygowania (tj. nieudane wdrożenia) przekroczy ten próg. int

RemediationFilters

Nazwa Opis Wartość
locations Lokalizacje zasobów, które zostaną skorygowane. ciąg[]

Definicja zasobu narzędzia Terraform (dostawcy AzAPI)

Typ zasobu korygowania to zasób rozszerzenia, co oznacza, że można zastosować go do innego zasobu.

parent_id Użyj właściwości tego zasobu, aby ustawić zakres dla tego zasobu.

Prawidłowe zakresy wdrażania dla zasobu korygowania to:

  • Grupy zasobów
  • Subskrypcje
  • Grupy zarządzania

Aby uzyskać listę zmienionych właściwości w każdej wersji interfejsu API, zobacz dziennik zmian.

Format zasobu

Aby utworzyć zasób Microsoft.PolicyInsights/remediations, dodaj następujący program Terraform do szablonu.

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

Wartości właściwości

korygowania

Nazwa Opis Wartość
typ Typ zasobu "Microsoft.PolicyInsights/remediations@2021-10-01"
name Nazwa zasobu ciąg (wymagany)
parent_id Identyfikator zasobu, do który ma być stosowany ten zasób rozszerzenia. ciąg (wymagany)
properties Właściwości korygowania. RemediationProperties

RemediationProperties

Nazwa Opis Wartość
failureThreshold Ustawienia progu niepowodzenia korygowania RemediationPropertiesFailureThreshold
filtry Filtry, które zostaną zastosowane w celu określenia, które zasoby mają zostać skorygowane. RemediationFilters
parallelDeployments Określa liczbę zasobów do skorygowania w danym momencie. Można użyć do zwiększenia lub zmniejszenia tempa korygowania. Jeśli nie zostanie podana, zostanie użyta domyślna wartość wdrożeń równoległych. int
policyAssignmentId Identyfikator zasobu przypisania zasad, który należy skorygować. ciąg
policyDefinitionReferenceId Identyfikator odwołania definicji zasad dla pojedynczej definicji, która powinna zostać skorygowana. Wymagane, gdy korygowane przypisanie zasad przypisuje definicję zestawu zasad. ciąg
resourceCount Określa maksymalną liczbę zasobów, które można skorygować za pomocą zadania korygowania. Jeśli nie zostanie podana, zostanie użyta domyślna liczba zasobów. int
resourceDiscoveryMode Sposób odnajdowania zasobów do skorygowania. Wartość domyślna to ExistingNonCompliant, jeśli nie zostanie określona. "ExistingNonCompliant"
"ReEvaluateCompliance"

RemediationPropertiesFailureThreshold

Nazwa Opis Wartość
percentage Liczba z zakresu od 0,0 do 1,0 reprezentująca próg awarii procentowej. Korygowanie zakończy się niepowodzeniem, jeśli wartość procentowa nieudanych operacji korygowania (tj. nieudane wdrożenia) przekroczy ten próg. int

RemediationFilters

Nazwa Opis Wartość
locations Lokalizacje zasobów, które zostaną skorygowane. ciąg[]