Logprofiles do Microsoft.Insights

Definição de recurso do Bicep

O tipo de recurso logprofiles 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.

Exemplos de uso

Exemplos de Bicep

Um exemplo básico de implantação de perfis de log do Insights.

targetScope = 'subscription'

param resourceName string = 'acctest0001'
param location string = 'westeurope'

resource resourceGroup 'Microsoft.Resources/resourceGroups@2020-06-01' = {
  name: resourceName
  location: location
}

resource logProfile 'Microsoft.Insights/logProfiles@2016-03-01' = {
  name: resourceName
  properties: {
    categories: [
      'Action'
    ]
    locations: [
      'westeurope'
      'westeurope'
    ]
    retentionPolicy: {
      days: 7
      enabled: true
    }
    storageAccountId: module1.outputs.storageAccountId
  }
}

module module1 'main-rg-module.bicep' = {
  name: 'deploy-rg-resources'
  scope: resourceGroup
  params: {
    resourceName: resourceName
    location: location
  }
}

Um exemplo básico de implantação de perfis de log do Insights.

param resourceName string = 'acctest0001'
param location string = 'westeurope'

resource storageAccount 'Microsoft.Storage/storageAccounts@2021-09-01' = {
  name: resourceName
  location: location
  sku: {
    name: 'Standard_GRS'
  }
  kind: 'StorageV2'
  properties: {
    accessTier: 'Hot'
    allowBlobPublicAccess: true
    allowCrossTenantReplication: true
    allowSharedKeyAccess: true
    defaultToOAuthAuthentication: false
    encryption: {
      keySource: 'Microsoft.Storage'
      services: {
        queue: {
          keyType: 'Service'
        }
        table: {
          keyType: 'Service'
        }
      }
    }
    isHnsEnabled: false
    isNfsV3Enabled: false
    isSftpEnabled: false
    minimumTlsVersion: 'TLS1_2'
    networkAcls: {
      defaultAction: 'Allow'
    }
    publicNetworkAccess: 'Enabled'
    supportsHttpsTrafficOnly: true
  }
}

// Module outputs for cross-scope references
output storageAccountId string = storageAccount.id

Formato de recurso

Para criar um recurso Microsoft.Insights/logprofiles, adicione o Bicep a seguir ao seu modelo.

resource symbolicname 'Microsoft.Insights/logprofiles@2016-03-01' = {
  location: 'string'
  name: 'string'
  properties: {
    categories: [
      'string'
    ]
    locations: [
      'string'
    ]
    retentionPolicy: {
      days: int
      enabled: bool
    }
    serviceBusRuleId: 'string'
    storageAccountId: 'string'
  }
  tags: {
    {customized property}: 'string'
  }
}

Valores da propriedade

Microsoft.Insights/logprofiles

Nome Descrição Valor
local A localização geográfica onde o recurso reside cadeia de caracteres (obrigatório)
nome O nome do recurso cadeia de caracteres (obrigatório)
Propriedades As propriedades do perfil de log do recurso. LogProfileProperties (obrigatório)
Tags Marcas de recurso Dicionário de nomes e valores de marca. Consulte Marcas em modelos

Propriedades do perfil de log

Nome Descrição Valor
Categorias as categorias dos logs. Essas categorias são criadas conforme conveniente para o usuário. Alguns valores são: "Gravar", "Excluir" e/ou "Ação". string[] (obrigatório)
Locais Lista de regiões para as quais os eventos do Log de Atividades devem ser armazenados ou transmitidos. É uma lista separada por vírgulas de locais válidos do ARM, incluindo o local 'global'. string[] (obrigatório)
política de retenção a política de retenção para os eventos no log. MicrosoftCommonRetentionPolicy (obrigatório)
serviceBusRuleId A ID da regra do barramento de serviço do namespace do barramento de serviço no qual você gostaria de ter os Hubs de Eventos criados para transmitir o Log de Atividades. A ID da regra é do formato: '{ID do recurso do barramento de serviço}/authorizationrules/{nome da chave}'. cadeia
ID da conta de armazenamento a ID do recurso da conta de armazenamento para a qual você gostaria de enviar o Log de Atividades. cadeia

MicrosoftCommonRetentionPolicy

Nome Descrição Valor
Dias o número de dias para a retenção em dias. Um valor de 0 manterá os eventos indefinidamente. int

Restrições:
Valor mínimo = 0 (obrigatório)
Habilitado um valor que indica se a política de retenção está habilitada. bool (obrigatório)

TrackedResourceTags

Nome Descrição Valor

Definição de recurso de modelo do ARM

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

Exemplos de uso

Formato de recurso

Para criar um recurso Microsoft.Insights/logprofiles, adicione o JSON a seguir ao modelo.

{
  "type": "Microsoft.Insights/logprofiles",
  "apiVersion": "2016-03-01",
  "name": "string",
  "location": "string",
  "properties": {
    "categories": [ "string" ],
    "locations": [ "string" ],
    "retentionPolicy": {
      "days": "int",
      "enabled": "bool"
    },
    "serviceBusRuleId": "string",
    "storageAccountId": "string"
  },
  "tags": {
    "{customized property}": "string"
  }
}

Valores da propriedade

Microsoft.Insights/logprofiles

Nome Descrição Valor
apiVersion A versão da API '2016-03-01'
local A localização geográfica onde o recurso reside cadeia de caracteres (obrigatório)
nome O nome do recurso cadeia de caracteres (obrigatório)
Propriedades As propriedades do perfil de log do recurso. LogProfileProperties (obrigatório)
Tags Marcas de recurso Dicionário de nomes e valores de marca. Consulte Marcas em modelos
tipo O tipo de recurso 'Microsoft.Insights/logprofiles'

Propriedades do perfil de log

Nome Descrição Valor
Categorias as categorias dos logs. Essas categorias são criadas conforme conveniente para o usuário. Alguns valores são: "Gravar", "Excluir" e/ou "Ação". string[] (obrigatório)
Locais Lista de regiões para as quais os eventos do Log de Atividades devem ser armazenados ou transmitidos. É uma lista separada por vírgulas de locais válidos do ARM, incluindo o local 'global'. string[] (obrigatório)
política de retenção a política de retenção para os eventos no log. MicrosoftCommonRetentionPolicy (obrigatório)
serviceBusRuleId A ID da regra do barramento de serviço do namespace do barramento de serviço no qual você gostaria de ter os Hubs de Eventos criados para transmitir o Log de Atividades. A ID da regra é do formato: '{ID do recurso do barramento de serviço}/authorizationrules/{nome da chave}'. cadeia
ID da conta de armazenamento a ID do recurso da conta de armazenamento para a qual você gostaria de enviar o Log de Atividades. cadeia

MicrosoftCommonRetentionPolicy

Nome Descrição Valor
Dias o número de dias para a retenção em dias. Um valor de 0 manterá os eventos indefinidamente. int

Restrições:
Valor mínimo = 0 (obrigatório)
Habilitado um valor que indica se a política de retenção está habilitada. bool (obrigatório)

TrackedResourceTags

Nome Descrição Valor

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

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

Exemplos de uso

Exemplos do Terraform

Um exemplo básico de implantação de perfis de log do Insights.

terraform {
  required_providers {
    azapi = {
      source = "Azure/azapi"
    }
    azurerm = {
      source = "hashicorp/azurerm"
    }
  }
}

provider "azurerm" {
  features {
  }
}

provider "azapi" {
  skip_provider_registration = false
}

variable "resource_name" {
  type    = string
  default = "acctest0001"
}

variable "location" {
  type    = string
  default = "westeurope"
}

data "azurerm_client_config" "current" {
}

resource "azapi_resource" "resourceGroup" {
  type     = "Microsoft.Resources/resourceGroups@2020-06-01"
  name     = var.resource_name
  location = var.location
}

resource "azapi_resource" "storageAccount" {
  type      = "Microsoft.Storage/storageAccounts@2021-09-01"
  parent_id = azapi_resource.resourceGroup.id
  name      = var.resource_name
  location  = var.location
  body = {
    kind = "StorageV2"
    properties = {
      accessTier                   = "Hot"
      allowBlobPublicAccess        = true
      allowCrossTenantReplication  = true
      allowSharedKeyAccess         = true
      defaultToOAuthAuthentication = false
      encryption = {
        keySource = "Microsoft.Storage"
        services = {
          queue = {
            keyType = "Service"
          }
          table = {
            keyType = "Service"
          }
        }
      }
      isHnsEnabled      = false
      isNfsV3Enabled    = false
      isSftpEnabled     = false
      minimumTlsVersion = "TLS1_2"
      networkAcls = {
        defaultAction = "Allow"
      }
      publicNetworkAccess      = "Enabled"
      supportsHttpsTrafficOnly = true
    }
    sku = {
      name = "Standard_GRS"
    }
  }
  schema_validation_enabled = false
  response_export_values    = ["*"]
}

resource "azapi_resource" "logProfile" {
  type      = "Microsoft.Insights/logProfiles@2016-03-01"
  parent_id = "/subscriptions/${data.azurerm_client_config.current.subscription_id}"
  name      = var.resource_name
  location  = ""
  body = {
    properties = {
      categories = [
        "Action",
      ]
      locations = [
        "westeurope",
        "westeurope",
      ]
      retentionPolicy = {
        days    = 7
        enabled = true
      }
      storageAccountId = azapi_resource.storageAccount.id
    }
  }
  schema_validation_enabled = false
  response_export_values    = ["*"]
}

Formato de recurso

Para criar um recurso Microsoft.Insights/logprofiles, adicione o Terraform a seguir ao seu modelo.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Insights/logprofiles@2016-03-01"
  name = "string"
  parent_id = "string"
  location = "string"
  tags = {
    {customized property} = "string"
  }
  body = {
    properties = {
      categories = [
        "string"
      ]
      locations = [
        "string"
      ]
      retentionPolicy = {
        days = int
        enabled = bool
      }
      serviceBusRuleId = "string"
      storageAccountId = "string"
    }
  }
}

Valores da propriedade

Microsoft.Insights/logprofiles

Nome Descrição Valor
local A localização geográfica onde o recurso reside cadeia de caracteres (obrigatório)
nome O nome do recurso cadeia de caracteres (obrigatório)
Propriedades As propriedades do perfil de log do recurso. LogProfileProperties (obrigatório)
Tags Marcas de recurso Dicionário de nomes e valores de marca.
tipo O tipo de recurso "Microsoft.Insights/logprofiles@2016-03-01"

Propriedades do perfil de log

Nome Descrição Valor
Categorias as categorias dos logs. Essas categorias são criadas conforme conveniente para o usuário. Alguns valores são: "Gravar", "Excluir" e/ou "Ação". string[] (obrigatório)
Locais Lista de regiões para as quais os eventos do Log de Atividades devem ser armazenados ou transmitidos. É uma lista separada por vírgulas de locais válidos do ARM, incluindo o local 'global'. string[] (obrigatório)
política de retenção a política de retenção para os eventos no log. MicrosoftCommonRetentionPolicy (obrigatório)
serviceBusRuleId A ID da regra do barramento de serviço do namespace do barramento de serviço no qual você gostaria de ter os Hubs de Eventos criados para transmitir o Log de Atividades. A ID da regra é do formato: '{ID do recurso do barramento de serviço}/authorizationrules/{nome da chave}'. cadeia
ID da conta de armazenamento a ID do recurso da conta de armazenamento para a qual você gostaria de enviar o Log de Atividades. cadeia

MicrosoftCommonRetentionPolicy

Nome Descrição Valor
Dias o número de dias para a retenção em dias. Um valor de 0 manterá os eventos indefinidamente. int

Restrições:
Valor mínimo = 0 (obrigatório)
Habilitado um valor que indica se a política de retenção está habilitada. bool (obrigatório)

TrackedResourceTags

Nome Descrição Valor