Compartir a través de

Correcciones de Microsoft.PolicyInsights

  • Artículo

Definición de recursos de Bicep

El tipo de recurso de corrección se puede implementar con operaciones que tienen como destino:

Para obtener una lista de las propiedades modificadas en cada versión de API, consulte registro de cambios.

Formato de recurso

Para crear un recurso Microsoft.PolicyInsights/remediations, agregue el siguiente bicep a la plantilla.

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 propiedad

Microsoft.PolicyInsights/remediations

Nombre Descripción Valor
nombre El nombre del recurso string (obligatorio)
Propiedades Propiedades de la corrección. De correcciónPropiedades
alcance Use al crear un recurso en un ámbito diferente del ámbito de implementación. Establezca esta propiedad en el nombre simbólico de un recurso para aplicar el recurso de extensión .

RemediationFilters

Nombre Descripción Valor
Ubicaciones Ubicaciones de recursos que se corregirán. string[]
resourceIds Identificadores de los recursos que se corregirán. Puede especificar como máximo 100 identificadores. Este filtro no se puede usar cuando ReEvaluateCompliance está establecido en ReEvaluateCompliance y no se puede vaciar si se proporciona. string[]

RemediationProperties

Nombre Descripción Valor
failureThreshold Configuración del umbral de error de corrección RemediationPropertiesFailureThreshold
filtros Filtros que se aplicarán para determinar qué recursos corregir. RemediationFilters
parallelDeployments Determina cuántos recursos corregir en un momento dado. Se puede usar para aumentar o reducir el ritmo de la corrección. Si no se proporciona, se usa el valor predeterminado de implementaciones paralelas. Int
policyAssignmentId Identificador de recurso de la asignación de directiva que se debe corregir. cuerda
policyDefinitionReferenceId Identificador de referencia de definición de directiva de la definición individual que se debe corregir. Obligatorio cuando la asignación de directiva que se va a corregir asigna una definición de conjunto de directivas. cuerda
resourceCount Determina el número máximo de recursos que el trabajo de corrección puede corregir. Si no se proporciona, se usa el recuento de recursos predeterminado. Int
resourceDiscoveryMode Se detecta la forma en que se detectan los recursos que se deben corregir. El valor predeterminado es ExistingNonCompliant si no se especifica. 'ExistingNonCompliant'
'ReEvaluateCompliance'

RemediationPropertiesFailureThreshold

Nombre Descripción Valor
porcentaje Número comprendido entre 0,0 y 1,0 que representa el umbral de error porcentual. Se producirá un error en la corrección si el porcentaje de operaciones de corrección con errores (es decir, implementaciones con errores) supera este umbral. Int

Definición de recursos de plantilla de ARM

El tipo de recurso de corrección se puede implementar con operaciones que tienen como destino:

Para obtener una lista de las propiedades modificadas en cada versión de API, consulte registro de cambios.

Formato de recurso

Para crear un recurso Microsoft.PolicyInsights/remediations, agregue el siguiente JSON a la plantilla.

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

Microsoft.PolicyInsights/remediations

Nombre Descripción Valor
apiVersion La versión de api '2024-10-01'
nombre El nombre del recurso string (obligatorio)
Propiedades Propiedades de la corrección. De correcciónPropiedades
tipo El tipo de recurso "Microsoft.PolicyInsights/remediations"

RemediationFilters

Nombre Descripción Valor
Ubicaciones Ubicaciones de recursos que se corregirán. string[]
resourceIds Identificadores de los recursos que se corregirán. Puede especificar como máximo 100 identificadores. Este filtro no se puede usar cuando ReEvaluateCompliance está establecido en ReEvaluateCompliance y no se puede vaciar si se proporciona. string[]

RemediationProperties

Nombre Descripción Valor
failureThreshold Configuración del umbral de error de corrección RemediationPropertiesFailureThreshold
filtros Filtros que se aplicarán para determinar qué recursos corregir. RemediationFilters
parallelDeployments Determina cuántos recursos corregir en un momento dado. Se puede usar para aumentar o reducir el ritmo de la corrección. Si no se proporciona, se usa el valor predeterminado de implementaciones paralelas. Int
policyAssignmentId Identificador de recurso de la asignación de directiva que se debe corregir. cuerda
policyDefinitionReferenceId Identificador de referencia de definición de directiva de la definición individual que se debe corregir. Obligatorio cuando la asignación de directiva que se va a corregir asigna una definición de conjunto de directivas. cuerda
resourceCount Determina el número máximo de recursos que el trabajo de corrección puede corregir. Si no se proporciona, se usa el recuento de recursos predeterminado. Int
resourceDiscoveryMode Se detecta la forma en que se detectan los recursos que se deben corregir. El valor predeterminado es ExistingNonCompliant si no se especifica. 'ExistingNonCompliant'
'ReEvaluateCompliance'

RemediationPropertiesFailureThreshold

Nombre Descripción Valor
porcentaje Número comprendido entre 0,0 y 1,0 que representa el umbral de error porcentual. Se producirá un error en la corrección si el porcentaje de operaciones de corrección con errores (es decir, implementaciones con errores) supera este umbral. Int

Definición de recursos de Terraform (proveedor AzAPI)

El tipo de recurso de corrección se puede implementar con operaciones que tienen como destino:

Para obtener una lista de las propiedades modificadas en cada versión de API, consulte registro de cambios.

Formato de recurso

Para crear un recurso Microsoft.PolicyInsights/remediations, agregue el siguiente terraform a la plantilla.

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 propiedad

Microsoft.PolicyInsights/remediations

Nombre Descripción Valor
nombre El nombre del recurso string (obligatorio)
parent_id Identificador del recurso al que se va a aplicar este recurso de extensión. string (obligatorio)
Propiedades Propiedades de la corrección. De correcciónPropiedades
tipo El tipo de recurso "Microsoft.PolicyInsights/remediations@2024-10-01"

RemediationFilters

Nombre Descripción Valor
Ubicaciones Ubicaciones de recursos que se corregirán. string[]
resourceIds Identificadores de los recursos que se corregirán. Puede especificar como máximo 100 identificadores. Este filtro no se puede usar cuando ReEvaluateCompliance está establecido en ReEvaluateCompliance y no se puede vaciar si se proporciona. string[]

RemediationProperties

Nombre Descripción Valor
failureThreshold Configuración del umbral de error de corrección RemediationPropertiesFailureThreshold
filtros Filtros que se aplicarán para determinar qué recursos corregir. RemediationFilters
parallelDeployments Determina cuántos recursos corregir en un momento dado. Se puede usar para aumentar o reducir el ritmo de la corrección. Si no se proporciona, se usa el valor predeterminado de implementaciones paralelas. Int
policyAssignmentId Identificador de recurso de la asignación de directiva que se debe corregir. cuerda
policyDefinitionReferenceId Identificador de referencia de definición de directiva de la definición individual que se debe corregir. Obligatorio cuando la asignación de directiva que se va a corregir asigna una definición de conjunto de directivas. cuerda
resourceCount Determina el número máximo de recursos que el trabajo de corrección puede corregir. Si no se proporciona, se usa el recuento de recursos predeterminado. Int
resourceDiscoveryMode Se detecta la forma en que se detectan los recursos que se deben corregir. El valor predeterminado es ExistingNonCompliant si no se especifica. 'ExistingNonCompliant'
'ReEvaluateCompliance'

RemediationPropertiesFailureThreshold

Nombre Descripción Valor
porcentaje Número comprendido entre 0,0 y 1,0 que representa el umbral de error porcentual. Se producirá un error en la corrección si el porcentaje de operaciones de corrección con errores (es decir, implementaciones con errores) supera este umbral. Int