NätverkNätverkWatchers/flowLogs 2020-04-01

Bicep-resursdefinition

Resurstypen networkWatchers/flowLogs kan distribueras med åtgärder som mål:

En lista över ändrade egenskaper i varje API-version finns i ändringsloggen.

Användningsexempel

Bicep-exempel

Ett grundläggande exempel på hur du distribuerar Network Watcher flödeslogg.

param location string = 'eastus2'
param resourceName string = 'acctest0001'

resource networkWatchers 'Microsoft.Network/networkWatchers@2023-11-01' = {
  name: resourceName
  location: location
  properties: {}
}

resource flowLog 'Microsoft.Network/networkWatchers/flowLogs@2023-11-01' = {
  name: resourceName
  location: location
  parent: networkWatchers
  properties: {
    enabled: true
    flowAnalyticsConfiguration: {
      networkWatcherFlowAnalyticsConfiguration: {
        enabled: false
      }
    }
    format: {
      type: 'JSON'
      version: 2
    }
    retentionPolicy: {
      days: 7
      enabled: true
    }
    storageId: storageAccount.id
    targetResourceId: virtualNetwork.id
  }
}

resource storageAccount 'Microsoft.Storage/storageAccounts@2021-09-01' = {
  name: resourceName
  location: location
  sku: {
    name: 'Standard_LRS'
  }
  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
  }
}

resource virtualNetwork 'Microsoft.Network/virtualNetworks@2022-07-01' = {
  name: resourceName
  location: location
  properties: {
    addressSpace: {
      addressPrefixes: [
        '10.0.0.0/16'
      ]
    }
    dhcpOptions: {
      dnsServers: []
    }
    subnets: []
  }
}

Azure-verifierade moduler

Följande Azure-verifierade moduler kan användas för att distribuera den här resurstypen.

Modul Beskrivning
Network Watcher - Flödeslogg AVM Child Module för Network Watcher - Flödeslogg

Azure-snabbstartsexempel

Följande Azure-snabbstartsmallar innehålla Bicep-exempel för distribution av den här resurstypen.

Bicep-fil Beskrivning
Aktivera Virtual Network Flow Loggar Denna mall skapar en virtuell nätverksflödesloggresurs.
NSG-flödesloggar med trafikanalys Den här mallen skapar en NSG-flödeslogg på en befintlig NSG med trafikanalys

Resursformat

Om du vill skapa en Microsoft.Network/networkWatchers/flowLogs-resurs lägger du till följande Bicep i mallen.

resource symbolicname 'Microsoft.Network/networkWatchers/flowLogs@2020-04-01' = {
  parent: resourceSymbolicName
  location: 'string'
  name: 'string'
  properties: {
    enabled: bool
    flowAnalyticsConfiguration: {
      networkWatcherFlowAnalyticsConfiguration: {
        enabled: bool
        trafficAnalyticsInterval: int
        workspaceId: 'string'
        workspaceRegion: 'string'
        workspaceResourceId: 'string'
      }
    }
    format: {
      type: 'string'
      version: int
    }
    retentionPolicy: {
      days: int
      enabled: bool
    }
    storageId: 'string'
    targetResourceId: 'string'
  }
  tags: {
    {customized property}: 'string'
  }
}

Egenskapsvärden

Microsoft.Network/networkWatchers/flowLogs

Namn Beskrivning Värde
plats Resursplats. sträng
Namn Resursnamnet sträng (krävs)
förälder I Bicep kan du ange den överordnade resursen för en underordnad resurs. Du behöver bara lägga till den här egenskapen när den underordnade resursen deklareras utanför den överordnade resursen.

Mer information finns i Underordnad resurs utanför den överordnade resursen.
Symboliskt namn för resurs av typen: networkWatchers
Egenskaper Egenskaper för flödesloggen. FlowLogPropertiesFormat (på engelska)
Taggar Resurstaggar Ordlista med taggnamn och värden. Se taggar i mallar

FlowLogFormatParameters (på engelska)

Namn Beskrivning Värde
typ Filtypen för flödesloggen. "JSON"
version Version (revision) av flödesloggen. Int

FlowLogPropertiesFormat (på engelska)

Namn Beskrivning Värde
Aktiverat Flagga för att aktivera/inaktivera flödesloggning. Bool
flowAnalyticsConfiguration Parametrar som definierar konfigurationen av trafikanalys. TrafficAnalyticsProperties (på engelska)
format Parametrar som definierar flödesloggformatet. FlowLogFormatParameters (på engelska)
kvarhållningspolicy Parametrar som definierar kvarhållningsprincipen för flödesloggen. RetentionPolicyParameters
storageId ID för lagringskontot som används för att lagra flödesloggen. sträng (krävs)
målresursId ID för den nätverkssäkerhetsgrupp som flödesloggen ska tillämpas på. sträng (krävs)

Resurstaggar

Namn Beskrivning Värde

RetentionPolicyParameters

Namn Beskrivning Värde
Dagar Antal dagar för att behålla flödesloggposter. Int
Aktiverat Flagga för att aktivera/inaktivera kvarhållning. Bool

TrafficAnalyticsConfigurationProperties (på engelska)

Namn Beskrivning Värde
Aktiverat Flagga för att aktivera/inaktivera trafikanalys. Bool
trafficAnalyticsInterval Intervallet i minuter som avgör hur ofta TA-tjänsten ska utföra flödesanalyser. Int
arbetsyta-id Resurs-GUID för den anslutna arbetsytan. sträng
arbetsområdesregion Platsen för den anslutna arbetsytan. sträng
arbetsytaResursId Resurs-ID för den anslutna arbetsytan. sträng

TrafficAnalyticsProperties (på engelska)

Namn Beskrivning Värde
networkWatcherFlowAnalyticsConfiguration Parametrar som definierar konfigurationen av trafikanalys. TrafficAnalyticsConfigurationProperties (på engelska)

Resursdefinition för ARM-mall

Resurstypen networkWatchers/flowLogs kan distribueras med åtgärder som mål:

Användningsexempel

Azure-snabbstartsmallar

Följande Azure-snabbstartsmallar distribuera den här resurstypen.

Mall Beskrivning
Aktivera Virtual Network Flow Loggar

Distribuera till Azure
Denna mall skapar en virtuell nätverksflödesloggresurs.
NSG-flödesloggar med trafikanalys

Distribuera till Azure
Den här mallen skapar en NSG-flödeslogg på en befintlig NSG med trafikanalys

Resursformat

Om du vill skapa en Microsoft.Network/networkWatchers/flowLogs-resurs lägger du till följande JSON i mallen.

{
  "type": "Microsoft.Network/networkWatchers/flowLogs",
  "apiVersion": "2020-04-01",
  "name": "string",
  "location": "string",
  "properties": {
    "enabled": "bool",
    "flowAnalyticsConfiguration": {
      "networkWatcherFlowAnalyticsConfiguration": {
        "enabled": "bool",
        "trafficAnalyticsInterval": "int",
        "workspaceId": "string",
        "workspaceRegion": "string",
        "workspaceResourceId": "string"
      }
    },
    "format": {
      "type": "string",
      "version": "int"
    },
    "retentionPolicy": {
      "days": "int",
      "enabled": "bool"
    },
    "storageId": "string",
    "targetResourceId": "string"
  },
  "tags": {
    "{customized property}": "string"
  }
}

Egenskapsvärden

Microsoft.Network/networkWatchers/flowLogs

Namn Beskrivning Värde
apiVersion API-versionen '2020-04-01'
plats Resursplats. sträng
Namn Resursnamnet sträng (krävs)
Egenskaper Egenskaper för flödesloggen. FlowLogPropertiesFormat (på engelska)
Taggar Resurstaggar Ordlista med taggnamn och värden. Se taggar i mallar
typ Resurstypen "Microsoft.Network/networkWatchers/flowLogs"

FlowLogFormatParameters (på engelska)

Namn Beskrivning Värde
typ Filtypen för flödesloggen. "JSON"
version Version (revision) av flödesloggen. Int

FlowLogPropertiesFormat (på engelska)

Namn Beskrivning Värde
Aktiverat Flagga för att aktivera/inaktivera flödesloggning. Bool
flowAnalyticsConfiguration Parametrar som definierar konfigurationen av trafikanalys. TrafficAnalyticsProperties (på engelska)
format Parametrar som definierar flödesloggformatet. FlowLogFormatParameters (på engelska)
kvarhållningspolicy Parametrar som definierar kvarhållningsprincipen för flödesloggen. RetentionPolicyParameters
storageId ID för lagringskontot som används för att lagra flödesloggen. sträng (krävs)
målresursId ID för den nätverkssäkerhetsgrupp som flödesloggen ska tillämpas på. sträng (krävs)

Resurstaggar

Namn Beskrivning Värde

RetentionPolicyParameters

Namn Beskrivning Värde
Dagar Antal dagar för att behålla flödesloggposter. Int
Aktiverat Flagga för att aktivera/inaktivera kvarhållning. Bool

TrafficAnalyticsConfigurationProperties (på engelska)

Namn Beskrivning Värde
Aktiverat Flagga för att aktivera/inaktivera trafikanalys. Bool
trafficAnalyticsInterval Intervallet i minuter som avgör hur ofta TA-tjänsten ska utföra flödesanalyser. Int
arbetsyta-id Resurs-GUID för den anslutna arbetsytan. sträng
arbetsområdesregion Platsen för den anslutna arbetsytan. sträng
arbetsytaResursId Resurs-ID för den anslutna arbetsytan. sträng

TrafficAnalyticsProperties (på engelska)

Namn Beskrivning Värde
networkWatcherFlowAnalyticsConfiguration Parametrar som definierar konfigurationen av trafikanalys. TrafficAnalyticsConfigurationProperties (på engelska)

Resursdefinition för Terraform (AzAPI-provider)

Resurstypen networkWatchers/flowLogs kan distribueras med åtgärder som mål:

  • Resursgrupper För en lista över ändrade egenskaper i varje API-version, se ändringslogg.

Användningsexempel

Terraform-exempel

Ett grundläggande exempel på hur du distribuerar Network Watcher flödeslogg.

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

provider "azapi" {
  skip_provider_registration = false
}

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

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

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

resource "azapi_resource" "virtualNetwork" {
  type      = "Microsoft.Network/virtualNetworks@2022-07-01"
  parent_id = azapi_resource.resourceGroup.id
  name      = var.resource_name
  location  = var.location
  body = {
    properties = {
      addressSpace = {
        addressPrefixes = [
          "10.0.0.0/16",
        ]
      }
      dhcpOptions = {
        dnsServers = [
        ]
      }
      subnets = [
      ]
    }
  }
  schema_validation_enabled = false
  response_export_values    = ["*"]
  lifecycle {
    ignore_changes = [body.properties.subnets]
  }
}

resource "azapi_resource" "networkWatchers" {
  type      = "Microsoft.Network/networkWatchers@2023-11-01"
  parent_id = azapi_resource.resourceGroup.id
  name      = var.resource_name
  location  = var.location
  body = {
    properties = {
    }
  }
  schema_validation_enabled = false
  response_export_values    = ["*"]
}

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_LRS"
    }
  }
  schema_validation_enabled = false
  response_export_values    = ["*"]
}

resource "azapi_resource" "flowLog" {
  type      = "Microsoft.Network/networkWatchers/flowLogs@2023-11-01"
  name      = var.resource_name
  location  = var.location
  parent_id = azapi_resource.networkWatchers.id

  body = {
    properties = {
      enabled = true
      flowAnalyticsConfiguration = {
        networkWatcherFlowAnalyticsConfiguration = {
          enabled = false
        }
      }
      format = {
        type    = "JSON"
        version = 2
      }
      retentionPolicy = {
        days    = 7
        enabled = true
      }
      storageId        = azapi_resource.storageAccount.id
      targetResourceId = azapi_resource.virtualNetwork.id
    }
  }
}

Resursformat

Om du vill skapa en Microsoft.Network/networkWatchers/flowLogs-resurs lägger du till följande Terraform i mallen.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Network/networkWatchers/flowLogs@2020-04-01"
  name = "string"
  parent_id = "string"
  location = "string"
  tags = {
    {customized property} = "string"
  }
  body = {
    properties = {
      enabled = bool
      flowAnalyticsConfiguration = {
        networkWatcherFlowAnalyticsConfiguration = {
          enabled = bool
          trafficAnalyticsInterval = int
          workspaceId = "string"
          workspaceRegion = "string"
          workspaceResourceId = "string"
        }
      }
      format = {
        type = "string"
        version = int
      }
      retentionPolicy = {
        days = int
        enabled = bool
      }
      storageId = "string"
      targetResourceId = "string"
    }
  }
}

Egenskapsvärden

Microsoft.Network/networkWatchers/flowLogs

Namn Beskrivning Värde
plats Resursplats. sträng
Namn Resursnamnet sträng (krävs)
föräldra_id ID för resursen som är överordnad för den här resursen. ID för resurs av typen: networkWatchers
Egenskaper Egenskaper för flödesloggen. FlowLogPropertiesFormat (på engelska)
Taggar Resurstaggar Ordlista med taggnamn och värden.
typ Resurstypen "Microsoft.Network/networkWatchers/flowLogs@2020-04-01"

FlowLogFormatParameters (på engelska)

Namn Beskrivning Värde
typ Filtypen för flödesloggen. "JSON"
version Version (revision) av flödesloggen. Int

FlowLogPropertiesFormat (på engelska)

Namn Beskrivning Värde
Aktiverat Flagga för att aktivera/inaktivera flödesloggning. Bool
flowAnalyticsConfiguration Parametrar som definierar konfigurationen av trafikanalys. TrafficAnalyticsProperties (på engelska)
format Parametrar som definierar flödesloggformatet. FlowLogFormatParameters (på engelska)
kvarhållningspolicy Parametrar som definierar kvarhållningsprincipen för flödesloggen. RetentionPolicyParameters
storageId ID för lagringskontot som används för att lagra flödesloggen. sträng (krävs)
målresursId ID för den nätverkssäkerhetsgrupp som flödesloggen ska tillämpas på. sträng (krävs)

Resurstaggar

Namn Beskrivning Värde

RetentionPolicyParameters

Namn Beskrivning Värde
Dagar Antal dagar för att behålla flödesloggposter. Int
Aktiverat Flagga för att aktivera/inaktivera kvarhållning. Bool

TrafficAnalyticsConfigurationProperties (på engelska)

Namn Beskrivning Värde
Aktiverat Flagga för att aktivera/inaktivera trafikanalys. Bool
trafficAnalyticsInterval Intervallet i minuter som avgör hur ofta TA-tjänsten ska utföra flödesanalyser. Int
arbetsyta-id Resurs-GUID för den anslutna arbetsytan. sträng
arbetsområdesregion Platsen för den anslutna arbetsytan. sträng
arbetsytaResursId Resurs-ID för den anslutna arbetsytan. sträng

TrafficAnalyticsProperties (på engelska)

Namn Beskrivning Värde
networkWatcherFlowAnalyticsConfiguration Parametrar som definierar konfigurationen av trafikanalys. TrafficAnalyticsConfigurationProperties (på engelska)