Microsoft.PolicyInsights korygowania
Definicja zasobu Bicep
Typ zasobu korygowania można wdrożyć przy użyciu operacji docelowych:
Aby uzyskać listę zmienionych właściwości w każdej wersji interfejsu API, zobacz dziennika zmian.
Format zasobu
Aby utworzyć zasób Microsoft.PolicyInsights/remediations, dodaj następujący kod Bicep do szablonu.
resource symbolicname 'Microsoft.PolicyInsights/remediations@2024-10-01' = {
scope: resourceSymbolicName or scope
name: 'string'
properties: {
failureThreshold: {
percentage: int
}
filters: {
locations: [
'string'
]
resourceIds: [
'string'
]
}
parallelDeployments: int
policyAssignmentId: 'string'
policyDefinitionReferenceId: 'string'
resourceCount: int
resourceDiscoveryMode: 'string'
}
}
Wartości właściwości
Microsoft.PolicyInsights/korygowania
| Nazwa | Opis | Wartość |
|---|---|---|
| nazwa | Nazwa zasobu | ciąg (wymagany) |
| Właściwości | Właściwości korygowania. | RemediationProperties |
| zakres | Użyj polecenia podczas tworzenia zasobu w zakresie innym niż zakres wdrożenia. | Ustaw tę właściwość na symboliczną nazwę zasobu, aby zastosować zasób rozszerzenia . |
RemediationFilters
| Nazwa | Opis | Wartość |
|---|---|---|
| Lokalizacje | Lokalizacje zasobów, które zostaną skorygowane. | string[] |
| resourceIds | Identyfikatory zasobów, które zostaną skorygowane. Może określać co najwyżej 100 identyfikatorów. Nie można użyć tego filtru, gdy właściwość ReEvaluateCompliance jest ustawiona na Wartość ReEvaluateCompliance i nie może być pusta, jeśli zostanie podana wartość . | string[] |
Właściwości korygowania
| 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że sł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. | struna |
| policyDefinitionReferenceId | Identyfikator odwołania definicji zasad dla pojedynczej definicji, która powinna zostać skorygowana. Wymagane, gdy przypisanie zasad jest korygowane, przypisuje definicję zestawu zasad. | struna |
| 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ść |
|---|---|---|
| procent | Liczba z zakresu od 0,0 do 1,0 reprezentująca próg niepowodzenia procentowego. Korygowanie zakończy się niepowodzeniem, jeśli wartość procentowa nieudanych operacji korygowania (tj. nieudanych wdrożeń) przekroczy ten próg. | Int |
Definicja zasobu szablonu usługi ARM
Typ zasobu korygowania można wdrożyć przy użyciu operacji docelowych:
Aby uzyskać listę zmienionych właściwości w każdej wersji interfejsu API, zobacz dziennika zmian.
Format zasobu
Aby utworzyć zasób Microsoft.PolicyInsights/remediations, dodaj następujący kod JSON do szablonu.
{
"type": "Microsoft.PolicyInsights/remediations",
"apiVersion": "2024-10-01",
"name": "string",
"properties": {
"failureThreshold": {
"percentage": "int"
},
"filters": {
"locations": [ "string" ],
"resourceIds": [ "string" ]
},
"parallelDeployments": "int",
"policyAssignmentId": "string",
"policyDefinitionReferenceId": "string",
"resourceCount": "int",
"resourceDiscoveryMode": "string"
}
}
Wartości właściwości
Microsoft.PolicyInsights/korygowania
| Nazwa | Opis | Wartość |
|---|---|---|
| apiVersion | Wersja interfejsu API | '2024-10-01' |
| nazwa | Nazwa zasobu | ciąg (wymagany) |
| Właściwości | Właściwości korygowania. | RemediationProperties |
| typ | Typ zasobu | "Microsoft.PolicyInsights/korygowanie" |
RemediationFilters
| Nazwa | Opis | Wartość |
|---|---|---|
| Lokalizacje | Lokalizacje zasobów, które zostaną skorygowane. | string[] |
| resourceIds | Identyfikatory zasobów, które zostaną skorygowane. Może określać co najwyżej 100 identyfikatorów. Nie można użyć tego filtru, gdy właściwość ReEvaluateCompliance jest ustawiona na Wartość ReEvaluateCompliance i nie może być pusta, jeśli zostanie podana wartość . | string[] |
Właściwości korygowania
| 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że sł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. | struna |
| policyDefinitionReferenceId | Identyfikator odwołania definicji zasad dla pojedynczej definicji, która powinna zostać skorygowana. Wymagane, gdy przypisanie zasad jest korygowane, przypisuje definicję zestawu zasad. | struna |
| 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ść |
|---|---|---|
| procent | Liczba z zakresu od 0,0 do 1,0 reprezentująca próg niepowodzenia procentowego. Korygowanie zakończy się niepowodzeniem, jeśli wartość procentowa nieudanych operacji korygowania (tj. nieudanych wdrożeń) przekroczy ten próg. | Int |
Przykłady użycia
Definicja zasobu narzędzia Terraform (dostawcy AzAPI)
Typ zasobu korygowania można wdrożyć przy użyciu operacji docelowych:
Aby uzyskać listę zmienionych właściwości w każdej wersji interfejsu API, zobacz dziennika 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@2024-10-01"
name = "string"
parent_id = "string"
body = jsonencode({
properties = {
failureThreshold = {
percentage = int
}
filters = {
locations = [
"string"
]
resourceIds = [
"string"
]
}
parallelDeployments = int
policyAssignmentId = "string"
policyDefinitionReferenceId = "string"
resourceCount = int
resourceDiscoveryMode = "string"
}
})
}
Wartości właściwości
Microsoft.PolicyInsights/korygowania
| Nazwa | Opis | Wartość |
|---|---|---|
| nazwa | Nazwa zasobu | ciąg (wymagany) |
| parent_id | Identyfikator zasobu, do który ma być stosowany ten zasób rozszerzenia. | ciąg (wymagany) |
| Właściwości | Właściwości korygowania. | RemediationProperties |
| typ | Typ zasobu | "Microsoft.PolicyInsights/remediations@2024-10-01" |
RemediationFilters
| Nazwa | Opis | Wartość |
|---|---|---|
| Lokalizacje | Lokalizacje zasobów, które zostaną skorygowane. | string[] |
| resourceIds | Identyfikatory zasobów, które zostaną skorygowane. Może określać co najwyżej 100 identyfikatorów. Nie można użyć tego filtru, gdy właściwość ReEvaluateCompliance jest ustawiona na Wartość ReEvaluateCompliance i nie może być pusta, jeśli zostanie podana wartość . | string[] |
Właściwości korygowania
| 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że sł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. | struna |
| policyDefinitionReferenceId | Identyfikator odwołania definicji zasad dla pojedynczej definicji, która powinna zostać skorygowana. Wymagane, gdy przypisanie zasad jest korygowane, przypisuje definicję zestawu zasad. | struna |
| 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ść |
|---|---|---|
| procent | Liczba z zakresu od 0,0 do 1,0 reprezentująca próg niepowodzenia procentowego. Korygowanie zakończy się niepowodzeniem, jeśli wartość procentowa nieudanych operacji korygowania (tj. nieudanych wdrożeń) przekroczy ten próg. | Int |