Compartilhar via

Correções do Microsoft.PolicyInsights

  • Artigo

Definição de recurso do Bicep

O tipo de recurso de correções pode ser implantado com operações de destino:

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

Formato de recurso

Para criar um recurso Microsoft.PolicyInsights/remediações, adicione o Bicep a seguir ao 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

Nome Descrição Valor
nome O nome do recurso cadeia de caracteres (obrigatório)
Propriedades Propriedades para a correção. RemediationProperties
âmbito 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 .

RemediationFilters

Nome Descrição Valor
Locais Os locais de recurso 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 estar vazio se fornecido. string[]

RemediationProperties

Nome Descrição Valor
failureThreshold As configurações de limite de falha de correção RemediationPropertiesFailureThreshold
Filtros Os filtros que serão aplicados para determinar quais recursos serão corrigidos. RemediationFilters
parallelDeployments Determina quantos recursos serão corrigidos a qualquer momento. Pode ser usado para aumentar ou reduzir o ritmo da correção. Se não for fornecido, o valor de implantações paralelas padrão será usado. int
policyAssignmentId A ID do recurso da atribuição de política que deve ser corrigida. corda
policyDefinitionReferenceId A ID de referência de 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 corrigida atribui uma definição de conjunto de políticas. corda
resourceCount Determina o número máximo de recursos que podem ser corrigidos pelo trabalho de correção. Se não for fornecido, a contagem de recursos padrão será usada. int
resourceDiscoveryMode A maneira como os recursos a serem corrigidos são descobertos. O padrão será ExistingNonCompliant se não for especificado. 'ExistingNonCompliant'
'ReEvaluateCompliance'

RemediationPropertiesFailureThreshold

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

Definição de recurso de modelo do ARM

O tipo de recurso de correções pode ser implantado com operações de destino:

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

Formato de recurso

Para criar um recurso Microsoft.PolicyInsights/remediações, adicione o JSON a seguir ao 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

Nome Descrição Valor
apiVersion A versão da API '2024-10-01'
nome O nome do recurso cadeia de caracteres (obrigatório)
Propriedades Propriedades para a correção. RemediationProperties
tipo O tipo de recurso 'Microsoft.PolicyInsights/remediações'

RemediationFilters

Nome Descrição Valor
Locais Os locais de recurso 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 estar vazio se fornecido. string[]

RemediationProperties

Nome Descrição Valor
failureThreshold As configurações de limite de falha de correção RemediationPropertiesFailureThreshold
Filtros Os filtros que serão aplicados para determinar quais recursos serão corrigidos. RemediationFilters
parallelDeployments Determina quantos recursos serão corrigidos a qualquer momento. Pode ser usado para aumentar ou reduzir o ritmo da correção. Se não for fornecido, o valor de implantações paralelas padrão será usado. int
policyAssignmentId A ID do recurso da atribuição de política que deve ser corrigida. corda
policyDefinitionReferenceId A ID de referência de 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 corrigida atribui uma definição de conjunto de políticas. corda
resourceCount Determina o número máximo de recursos que podem ser corrigidos pelo trabalho de correção. Se não for fornecido, a contagem de recursos padrão será usada. int
resourceDiscoveryMode A maneira como os recursos a serem corrigidos são descobertos. O padrão será ExistingNonCompliant se não for especificado. 'ExistingNonCompliant'
'ReEvaluateCompliance'

RemediationPropertiesFailureThreshold

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

Definição de recurso do Terraform (provedor de AzAPI)

O tipo de recurso de correções pode ser implantado com operações de destino:

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

Formato de recurso

Para criar um recurso Microsoft.PolicyInsights/remediações, adicione o Terraform a seguir 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

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

RemediationFilters

Nome Descrição Valor
Locais Os locais de recurso 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 estar vazio se fornecido. string[]

RemediationProperties

Nome Descrição Valor
failureThreshold As configurações de limite de falha de correção RemediationPropertiesFailureThreshold
Filtros Os filtros que serão aplicados para determinar quais recursos serão corrigidos. RemediationFilters
parallelDeployments Determina quantos recursos serão corrigidos a qualquer momento. Pode ser usado para aumentar ou reduzir o ritmo da correção. Se não for fornecido, o valor de implantações paralelas padrão será usado. int
policyAssignmentId A ID do recurso da atribuição de política que deve ser corrigida. corda
policyDefinitionReferenceId A ID de referência de 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 corrigida atribui uma definição de conjunto de políticas. corda
resourceCount Determina o número máximo de recursos que podem ser corrigidos pelo trabalho de correção. Se não for fornecido, a contagem de recursos padrão será usada. int
resourceDiscoveryMode A maneira como os recursos a serem corrigidos são descobertos. O padrão será ExistingNonCompliant se não for especificado. 'ExistingNonCompliant'
'ReEvaluateCompliance'

RemediationPropertiesFailureThreshold

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