Correcciones de Microsoft.PolicyInsights
Definición de recursos de Bicep
El tipo de recurso de corrección es un recurso de extensión, lo que significa que puede aplicarlo a otro recurso.
Use la scope propiedad de este recurso para establecer el ámbito de este recurso. Consulte Establecimiento del ámbito en los recursos de extensión en Bicep.
Los ámbitos de implementación válidos para el recurso de corrección son:
- Grupos de recursos: consulte los comandos de implementación del grupo de recursos.
- Suscripciones: consulte los comandos de implementación de suscripciones.
- Grupos de administración: consulte comandos de implementación de grupos de administración.
Para obtener una lista de las propiedades modificadas en cada versión de api, consulte registro de cambios.
Formato de los recursos
Para crear un recurso Microsoft.PolicyInsights/remediations, agregue el siguiente bicep a la plantilla.
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'
}
}
Valores de propiedades
remediations
| Nombre | Descripción | Value |
|---|---|---|
| name | El nombre del recurso | string (obligatorio) |
| scope | Use al crear un recurso de extensión en un ámbito diferente al ámbito de implementación. | Recurso de destino Para Bicep, establezca esta propiedad en el nombre simbólico del recurso para aplicar el recurso de extensión. |
| properties | Propiedades de la corrección. | RemediationProperties |
RemediationProperties
| Nombre | Descripción | Valor |
|---|---|---|
| failureThreshold | Configuración del umbral de error de corrección | RemediationPropertiesFailureThreshold |
| filters | 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. | string |
| 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. | string |
| 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 para corregirlos. El valor predeterminado es ExistingNonCompliant si no se especifica. | 'ExistingNonCompliant' "ReEvaluateCompliance" |
RemediationPropertiesFailureThreshold
| Nombre | Descripción | Valor |
|---|---|---|
| percentage | 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 |
RemediationFilters
| Nombre | Descripción | Valor |
|---|---|---|
| locations | Las ubicaciones de recursos que se corregirán. | string[] |
Definición de recursos de plantilla de ARM
El tipo de recurso de corrección es un recurso de extensión, lo que significa que puede aplicarlo a otro recurso.
Use la scope propiedad de este recurso para establecer el ámbito de este recurso. Consulte Establecimiento del ámbito en los recursos de extensión en plantillas de ARM.
Los ámbitos de implementación válidos para el recurso de corrección son:
- Grupos de recursos: consulte los comandos de implementación del grupo de recursos.
- Suscripciones: consulte los comandos de implementación de suscripciones.
- Grupos de administración: consulte comandos de implementación de grupos de administración.
Para obtener una lista de las propiedades modificadas en cada versión de api, consulte registro de cambios.
Formato de los recursos
Para crear un recurso Microsoft.PolicyInsights/remediations, agregue el siguiente json a la plantilla.
{
"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"
}
}
Valores de propiedades
remediations
| Nombre | Descripción | Value |
|---|---|---|
| type | Tipo de recurso | "Microsoft.PolicyInsights/remediations" |
| apiVersion | La versión de la API de recursos | '2021-10-01' |
| name | El nombre del recurso | string (obligatorio) |
| scope | Use al crear un recurso de extensión en un ámbito diferente del ámbito de implementación. | Recurso de destino En JSON, establezca el valor en el nombre completo del recurso al que se va a aplicar el recurso de extensión . |
| properties | Propiedades de la corrección. | RemediationProperties |
RemediationProperties
| Nombre | Descripción | Valor |
|---|---|---|
| failureThreshold | La configuración del umbral de error de corrección | RemediationPropertiesFailureThreshold |
| filters | 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. | string |
| policyDefinitionReferenceId | Identificador de referencia de definición de directiva de la definición individual que se debe corregir. Se requiere cuando la asignación de directiva que se va a corregir asigna una definición de conjunto de directivas. | string |
| 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 para corregirlos. El valor predeterminado es ExistingNonCompliant si no se especifica. | 'ExistingNonCompliant' 'ReEvaluateCompliance' |
RemediationPropertiesFailureThreshold
| Nombre | Descripción | Valor |
|---|---|---|
| percentage | 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 |
RemediationFilters
| Nombre | Descripción | Valor |
|---|---|---|
| locations | Ubicaciones de recursos que se corregirán. | string[] |
Definición de recursos de Terraform (proveedor AzAPI)
El tipo de recurso de corrección es un recurso de extensión, lo que significa que puede aplicarlo a otro recurso.
Use la parent_id propiedad de este recurso para establecer el ámbito de este recurso.
Los ámbitos de implementación válidos para el recurso de corrección son:
- Grupos de recursos
- Suscripciones
- Grupos de administración
Para obtener una lista de las propiedades modificadas en cada versión de API, consulte registro de cambios.
Formato de los recursos
Para crear un recurso Microsoft.PolicyInsights/remediations, agregue el siguiente terraform a la plantilla.
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"
}
})
}
Valores de propiedades
remediations
| Nombre | Descripción | Value |
|---|---|---|
| type | Tipo de recurso | "Microsoft.PolicyInsights/remediations@2021-10-01" |
| name | El nombre del recurso | string (obligatorio) |
| parent_id | Identificador del recurso al que se va a aplicar este recurso de extensión. | string (obligatorio) |
| properties | Propiedades de la corrección. | RemediationProperties |
RemediationProperties
| Nombre | Descripción | Valor |
|---|---|---|
| failureThreshold | La configuración del umbral de error de corrección | RemediationPropertiesFailureThreshold |
| filters | 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. | string |
| 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. | string |
| 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 para corregirlos. El valor predeterminado es ExistingNonCompliant si no se especifica. | "ExistingNonCompliant" "ReEvaluateCompliance" |
RemediationPropertiesFailureThreshold
| Nombre | Descripción | Valor |
|---|---|---|
| percentage | 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 |
RemediationFilters
| Nombre | Descripción | Valor |
|---|---|---|
| locations | Las ubicaciones de recursos que se corregirán. | string[] |