Partilhar via

Correções do Microsoft.PolicyInsights

  • Artigo

Definição de recursos do bíceps

O tipo de recurso de remediações pode ser implantado com operações que visam:

Para obter uma lista de propriedades alteradas em cada versão da API, consulte log de alterações.

Formato do recurso

Para criar um recurso Microsoft.PolicyInsights/remediations, adicione o seguinte Bicep ao seu modelo.

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

Valores de propriedade

Microsoft.PolicyInsights/remediações

Designação Descrição Valor
Designação O nome do recurso string (obrigatório)
propriedades Propriedades para a remediação. RemediationProperties
Âmbito de aplicação Use ao criar um recurso em um escopo diferente do escopo de implantação. Defina essa propriedade como o nome simbólico de um recurso para aplicar o recurso de extensão .

RemediaçãoFiltros

Designação Descrição Valor
Locais Os locais de recursos que serão corrigidos. string[]
resourceIds As IDs dos recursos que serão corrigidos. Pode especificar no máximo 100 IDs. Esse filtro não pode ser usado quando ReEvaluateCompliance está definido como ReEvaluateCompliance e não pode ser vazio se fornecido. string[]

RemediaçãoPropriedades

Designação Descrição Valor
failureThreshold As configurações de limite de falha de correção RemediaationPropertiesFailureThreshold
filtros Os filtros que serão aplicados para determinar quais recursos corrigir. RemediationFilters
parallelDeployments Determina quantos recursos devem ser corrigidos em um determinado momento. Pode ser usado para aumentar ou reduzir o ritmo da remediação. Se não for fornecido, o valor padrão de implantações paralelas será usado. Int
policyAssignmentId A ID do recurso da atribuição de política que deve ser corrigida. string
policyDefinitionReferenceId O ID de referência da definição de política da definição individual que deve ser corrigida. Necessário quando a atribuição de política que está sendo remediada atribui uma definição de conjunto de políticas. string
resourceCount Determina o número máximo de recursos que podem ser remediados pelo trabalho de correção. Se não for fornecida, a contagem de recursos padrão será usada. Int
resourceDiscoveryMode A forma como os recursos para remediar são descobertos. O padrão é ExistingNonCompliant se não for especificado. 'Existentenão conforme'
'ReavaliarCompliance'

RemediaationPropertiesFailureThreshold

Designação Descrição Valor
percentagem Um número entre 0,0 e 1,0 que representa o limiar percentual de falha. A correção falhará se a porcentagem de operações de correção com falha (ou seja, implantações com falha) exceder esse limite. Int

Definição de recurso de modelo ARM

O tipo de recurso de remediações pode ser implantado com operações que visam:

Para obter uma lista de propriedades alteradas em cada versão da API, consulte log de alterações.

Formato do recurso

Para criar um recurso Microsoft.PolicyInsights/remediations, adicione o seguinte JSON ao seu modelo.

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

Valores de propriedade

Microsoft.PolicyInsights/remediações

Designação Descrição Valor
apiVersion A versão api '2024-10-01'
Designação O nome do recurso string (obrigatório)
propriedades Propriedades para a remediação. RemediationProperties
tipo O tipo de recurso 'Microsoft.PolicyInsights/remediações'

RemediaçãoFiltros

Designação Descrição Valor
Locais Os locais de recursos que serão corrigidos. string[]
resourceIds As IDs dos recursos que serão corrigidos. Pode especificar no máximo 100 IDs. Esse filtro não pode ser usado quando ReEvaluateCompliance está definido como ReEvaluateCompliance e não pode ser vazio se fornecido. string[]

RemediaçãoPropriedades

Designação Descrição Valor
failureThreshold As configurações de limite de falha de correção RemediaationPropertiesFailureThreshold
filtros Os filtros que serão aplicados para determinar quais recursos corrigir. RemediationFilters
parallelDeployments Determina quantos recursos devem ser corrigidos em um determinado momento. Pode ser usado para aumentar ou reduzir o ritmo da remediação. Se não for fornecido, o valor padrão de implantações paralelas será usado. Int
policyAssignmentId A ID do recurso da atribuição de política que deve ser corrigida. string
policyDefinitionReferenceId O ID de referência da definição de política da definição individual que deve ser corrigida. Necessário quando a atribuição de política que está sendo remediada atribui uma definição de conjunto de políticas. string
resourceCount Determina o número máximo de recursos que podem ser remediados pelo trabalho de correção. Se não for fornecida, a contagem de recursos padrão será usada. Int
resourceDiscoveryMode A forma como os recursos para remediar são descobertos. O padrão é ExistingNonCompliant se não for especificado. 'Existentenão conforme'
'ReavaliarCompliance'

RemediaationPropertiesFailureThreshold

Designação Descrição Valor
percentagem Um número entre 0,0 e 1,0 que representa o limiar percentual de falha. A correção falhará se a porcentagem de operações de correção com falha (ou seja, implantações com falha) exceder esse limite. Int

Definição de recursos Terraform (provedor AzAPI)

O tipo de recurso de remediações pode ser implantado com operações que visam:

Para obter uma lista de propriedades alteradas em cada versão da API, consulte log de alterações.

Formato do recurso

Para criar um recurso Microsoft.PolicyInsights/remediations, adicione o seguinte Terraform ao seu modelo.

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

Valores de propriedade

Microsoft.PolicyInsights/remediações

Designação Descrição Valor
Designação O nome do recurso string (obrigatório)
parent_id A ID do recurso ao qual aplicar esse recurso de extensão. string (obrigatório)
propriedades Propriedades para a remediação. RemediationProperties
tipo O tipo de recurso "Microsoft.PolicyInsights/remediations@2024-10-01"

RemediaçãoFiltros

Designação Descrição Valor
Locais Os locais de recursos que serão corrigidos. string[]
resourceIds As IDs dos recursos que serão corrigidos. Pode especificar no máximo 100 IDs. Esse filtro não pode ser usado quando ReEvaluateCompliance está definido como ReEvaluateCompliance e não pode ser vazio se fornecido. string[]

RemediaçãoPropriedades

Designação Descrição Valor
failureThreshold As configurações de limite de falha de correção RemediaationPropertiesFailureThreshold
filtros Os filtros que serão aplicados para determinar quais recursos corrigir. RemediationFilters
parallelDeployments Determina quantos recursos devem ser corrigidos em um determinado momento. Pode ser usado para aumentar ou reduzir o ritmo da remediação. Se não for fornecido, o valor padrão de implantações paralelas será usado. Int
policyAssignmentId A ID do recurso da atribuição de política que deve ser corrigida. string
policyDefinitionReferenceId O ID de referência da definição de política da definição individual que deve ser corrigida. Necessário quando a atribuição de política que está sendo remediada atribui uma definição de conjunto de políticas. string
resourceCount Determina o número máximo de recursos que podem ser remediados pelo trabalho de correção. Se não for fornecida, a contagem de recursos padrão será usada. Int
resourceDiscoveryMode A forma como os recursos para remediar são descobertos. O padrão é ExistingNonCompliant se não for especificado. 'Existentenão conforme'
'ReavaliarCompliance'

RemediaationPropertiesFailureThreshold

Designação Descrição Valor
percentagem Um número entre 0,0 e 1,0 que representa o limiar percentual de falha. A correção falhará se a porcentagem de operações de correção com falha (ou seja, implantações com falha) exceder esse limite. Int