Correções do Microsoft.PolicyInsights
Definição de recurso do Bicep
O tipo de recurso de correções é um recurso de extensão, o que significa que você pode aplicá-lo a outro recurso.
Use a scope propriedade nesse recurso para definir o escopo desse recurso. Consulte Definir escopo em recursos de extensão no Bicep.
Os escopos de implantação válidos para o recurso de correções são:
- Grupos de recursos – Consulte comandos de implantação do grupo de recursos
- Assinaturas – Consulte comandos de implantação de assinatura
- Grupos de gerenciamento – Consulte comandos de implantação do grupo de gerenciamento
Para obter uma lista de propriedades alteradas em cada versão da API, consulte log de alterações.
Formato de recurso
Para criar um recurso Microsoft.PolicyInsights/remediations, adicione o seguinte Bicep ao modelo.
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 propriedade
remediations
| Nome | Descrição | Valor |
|---|---|---|
| name | O nome do recurso | cadeia de caracteres (obrigatório) |
| scope | Use ao criar um recurso de extensão em um escopo diferente do escopo de implantação. | Recurso de destino Para o Bicep, defina essa propriedade como o nome simbólico do recurso para aplicar o recurso de extensão. |
| properties | Propriedades para a correção. | RemediationProperties |
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 corrigir. | 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. | string |
| 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. | string |
| 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 |
|---|---|---|
| percentage | 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 |
RemediationFilters
| Nome | Descrição | Valor |
|---|---|---|
| Locais | Os locais de recurso que serão corrigidos. | string[] |
Definição de recurso de modelo do ARM
O tipo de recurso de correções é um recurso de extensão, o que significa que você pode aplicá-lo a outro recurso.
Use a scope propriedade nesse recurso para definir o escopo desse recurso. Consulte Definir escopo em recursos de extensão em modelos do ARM.
Os escopos de implantação válidos para o recurso de correções são:
- Grupos de recursos – Consulte comandos de implantação do grupo de recursos
- Assinaturas – Consulte comandos de implantação de assinatura
- Grupos de gerenciamento – Consulte comandos de implantação do grupo de gerenciamento
Para obter uma lista de propriedades alteradas em cada versão da API, consulte log de alterações.
Formato de recurso
Para criar um recurso Microsoft.PolicyInsights/remediations, adicione o JSON a seguir ao modelo.
{
"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 propriedade
remediations
| Nome | Descrição | Valor |
|---|---|---|
| tipo | O tipo de recurso | 'Microsoft.PolicyInsights/remediations' |
| apiVersion | A versão da API de recursos | '2021-10-01' |
| name | O nome do recurso | cadeia de caracteres (obrigatório) |
| scope | Use ao criar um recurso de extensão em um escopo diferente do escopo de implantação. | Recurso de destino Para JSON, defina o valor como o nome completo do recurso ao qual aplicar o recurso de extensão . |
| properties | Propriedades para a correção. | RemediationProperties |
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 corrigir. | 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. | string |
| 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. | string |
| 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 |
|---|---|---|
| percentage | 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 |
RemediationFilters
| Nome | Descrição | Valor |
|---|---|---|
| Locais | Os locais de recurso que serão corrigidos. | string[] |
Definição de recurso do Terraform (provedor AzAPI)
O tipo de recurso de correções é um recurso de extensão, o que significa que você pode aplicá-lo a outro recurso.
Use a parent_id propriedade nesse recurso para definir o escopo desse recurso.
Os escopos de implantação válidos para o recurso de correções são:
- Grupos de recursos
- Assinaturas
- Grupos de gerenciamento
Para obter uma lista de propriedades alteradas em cada versão da API, consulte log de alterações.
Formato de recurso
Para criar um recurso Microsoft.PolicyInsights/remediations, adicione o Terraform a seguir ao modelo.
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 propriedade
remediations
| Nome | Descrição | Valor |
|---|---|---|
| tipo | O tipo de recurso | "Microsoft.PolicyInsights/remediations@2021-10-01" |
| name | 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) |
| properties | Propriedades para a correção. | RemediationProperties |
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 corrigir. | 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. | string |
| 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. | string |
| 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 |
|---|---|---|
| percentage | 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 |
RemediationFilters
| Nome | Descrição | Valor |
|---|---|---|
| Locais | Os locais de recurso que serão corrigidos. | string[] |