Sdílet prostřednictvím

Microsoft.Network networkWatchers/packetCaptures 2024-01-01

  • Článek

Definice prostředku Bicep

Typ prostředku networkWatchers/packetCaptures je možné nasadit s operacemi, které cílí:

Seznam změněných vlastností v jednotlivých verzích rozhraní API najdete v protokolu změn.

Formát prostředku

Pokud chcete vytvořit prostředek Microsoft.Network/networkWatchers/packetCaptures, přidejte do šablony následující bicep.

resource symbolicname 'Microsoft.Network/networkWatchers/packetCaptures@2024-01-01' = {
  parent: resourceSymbolicName
  name: 'string'
  properties: {
    bytesToCapturePerPacket: int
    captureSettings: {
      fileCount: int
      fileSizeInBytes: int
      sessionTimeLimitInSeconds: int
    }
    continuousCapture: bool
    filters: [
      {
        localIPAddress: 'string'
        localPort: 'string'
        protocol: 'string'
        remoteIPAddress: 'string'
        remotePort: 'string'
      }
    ]
    scope: {
      exclude: [
        'string'
      ]
      include: [
        'string'
      ]
    }
    storageLocation: {
      filePath: 'string'
      localPath: 'string'
      storageId: 'string'
      storagePath: 'string'
    }
    target: 'string'
    targetType: 'string'
    timeLimitInSeconds: int
    totalBytesPerSession: int
  }
}

Hodnoty vlastností

Microsoft.Network/networkWatchers/packetCaptures

Jméno Popis Hodnota
Jméno Název prostředku string (povinné)
rodič V bicep můžete zadat nadřazený prostředek pro podřízený prostředek. Tuto vlastnost je potřeba přidat pouze v případě, že je podřízený prostředek deklarován mimo nadřazený prostředek.

Další informace najdete v tématu Podřízený prostředek mimo nadřazený prostředek.		 Symbolický název prostředku typu: networkWatchers
vlastnosti Vlastnosti zachytávání paketů PacketCaptureParametersOrPacketCaptureResultProperties (povinné)

PacketCaptureFilter

Jméno Popis Hodnota
localIPAddress Místní IP adresa, podle které se má filtrovat. Zápis: "127.0.0.1" pro položku s jednou adresou. "127.0.0.1-127.0.0.255" pro rozsah. "127.0.0.1; 127.0.0.5"? pro více položek. V současné době není podporováno více oblastí. Kombinování rozsahů s více položkami se aktuálně nepodporuje. Výchozí = null. řetězec
localPort Místní port, na který se má filtrovat. Zápis: "80" pro jednu položku portu. 80-85" pro rozsah. "80; 443;" pro více položek. V současné době není podporováno více oblastí. Kombinování rozsahů s více položkami se aktuálně nepodporuje. Výchozí = null. řetězec
protokol Protokol, který se má filtrovat. "Any" (Jakýkoli)
TCP
UDP
remoteIPAddress Místní IP adresa, podle které se má filtrovat. Zápis: "127.0.0.1" pro položku s jednou adresou. "127.0.0.1-127.0.0.255" pro rozsah. "127.0.0.1; 127.0.0.5;" pro více položek. V současné době není podporováno více oblastí. Kombinování rozsahů s více položkami se aktuálně nepodporuje. Výchozí = null. řetězec
remotePort Vzdálený port, na který se má filtrovat. Zápis: "80" pro jednu položku portu. 80-85" pro rozsah. "80; 443;" pro více položek. V současné době není podporováno více oblastí. Kombinování rozsahů s více položkami se aktuálně nepodporuje. Výchozí = null. řetězec

PacketCaptureMachineScope

Jméno Popis Hodnota
vyloučit Seznam instancí AzureVMSS, které musí být vyloučeny z AzureVMSS ze spouštění zachytávání paketů string[]
zahrnovat Seznam instancí AzureVMSS pro spouštění zachytávání paketů string[]

PacketCaptureParametersOrPacketCaptureResultProperties

Jméno Popis Hodnota
bytesToCapturePerPacket Počet bajtů zachycených na paket, zbývající bajty jsou zkráceny. Int

Omezení:
Minimální hodnota = 0
Maximální hodnota = 4294967295
captureSettings Nastavení zachycení obsahuje hodnoty FileCount, FileSizeInBytes, SessionTimeLimitInSeconds. packetCaptureSettings
continuousCapture Tento průběžný záznam je logická hodnota s možnou hodnotou null, která může obsahovat hodnotu null, true nebo false. Pokud tento parametr nepředáme, je vhodné ho považovat za null, výchozí hodnota je null. Bool
filtruje Seznam filtrů zachytávání paketů PacketCaptureFilter[]
rozsah Seznam instancí AzureVMSS, které je možné zahrnout nebo vyloučit za účelem spuštění zachytávání paketů. Pokud jsou zahrnuté i vyloučené prázdné, zachytávání paketů se spustí ve všech instancích AzureVMSS. PacketCaptureMachineScope
storageLocation Umístění úložiště pro relaci zachytávání paketů. PacketCaptureStorageLocation (povinné)
cíl ID cílového prostředku, aktuálně se podporuje pouze AzureVM a AzureVMSS jako cílový typ. string (povinné)
targetType Cílový typ poskytnutého prostředku. AzureVM
AzureVMSS
timeLimitInSeconds Maximální doba trvání relace zachycení v sekundách. Int

Omezení:
Minimální hodnota = 0
Maximální hodnota = 18000
totalBytesPerSession Maximální velikost výstupu zachytávání Int

Omezení:
Minimální hodnota = 0
Maximální hodnota = 4294967295

PacketCaptureSettings

Jméno Popis Hodnota
fileCount Početsouborůch Výchozí hodnota počtu je 10 a maximální počet je 1 0000. Int

Omezení:
Minimální hodnota = 0
Maximální hodnota = 1 0000
fileSizeInBytes Počet bajtů zachycených na paket Výchozí hodnota v bajtech 104857600 (100 MB) a maximální hodnota v bajtech 4294967295 (4 GB). Int

Omezení:
Minimální hodnota = 0
Maximální hodnota = 4294967295
sessionTimeLimitInSeconds Maximální doba trvání relace zachycení v sekundách je 604800s (7 dní) pro soubor. Výchozí hodnota ve druhém 86400s (1 den). Int

Omezení:
Minimální hodnota = 0
Maximální hodnota = 604800

PacketCaptureStorageLocation

Jméno Popis Hodnota
filePath Tato cesta je neplatná, pokud je k dispozici hodnota Continuous Capture s "true" nebo "false". Platná místní cesta na cílovém virtuálním počítači. Musí obsahovat název souboru zachytávání (*.cap). Pro virtuální počítač s Linuxem musí začínat /var/captures. Vyžaduje se, pokud není zadané ŽÁDNÉ ID úložiště, jinak volitelné. řetězec
localPath Tato cesta je platná, pokud je k dispozici hodnota Continuous Capture s true nebo false a vyžaduje se, pokud není zadané ŽÁDNÉ ID úložiště, jinak volitelné. Musí obsahovat název souboru zachytávání (*.cap). Pro virtuální počítač s Linuxem musí začínat /var/captures. řetězec
storageId ID účtu úložiště pro uložení relace zachytávání paketů. Vyžaduje se, pokud není k dispozici žádná cesta localPath nebo filePath. řetězec
storagePath Identifikátor URI cesty k úložišti pro uložení zachytávání paketů. Musí se jednat o identifikátor URI ve správném formátu popisující umístění pro uložení zachytávání paketů. řetězec

Definice prostředku šablony ARM

Typ prostředku networkWatchers/packetCaptures je možné nasadit s operacemi, které cílí:

Seznam změněných vlastností v jednotlivých verzích rozhraní API najdete v protokolu změn.

Formát prostředku

Pokud chcete vytvořit prostředek Microsoft.Network/networkWatchers/packetCaptures, přidejte do šablony následující JSON.

{
  "type": "Microsoft.Network/networkWatchers/packetCaptures",
  "apiVersion": "2024-01-01",
  "name": "string",
  "properties": {
    "bytesToCapturePerPacket": "int",
    "captureSettings": {
      "fileCount": "int",
      "fileSizeInBytes": "int",
      "sessionTimeLimitInSeconds": "int"
    },
    "continuousCapture": "bool",
    "filters": [
      {
        "localIPAddress": "string",
        "localPort": "string",
        "protocol": "string",
        "remoteIPAddress": "string",
        "remotePort": "string"
      }
    ],
    "scope": {
      "exclude": [ "string" ],
      "include": [ "string" ]
    },
    "storageLocation": {
      "filePath": "string",
      "localPath": "string",
      "storageId": "string",
      "storagePath": "string"
    },
    "target": "string",
    "targetType": "string",
    "timeLimitInSeconds": "int",
    "totalBytesPerSession": "int"
  }
}

Hodnoty vlastností

Microsoft.Network/networkWatchers/packetCaptures

Jméno Popis Hodnota
apiVersion Verze rozhraní API '2024-01-01'
Jméno Název prostředku string (povinné)
vlastnosti Vlastnosti zachytávání paketů PacketCaptureParametersOrPacketCaptureResultProperties (povinné)
typ Typ prostředku Microsoft.Network/networkWatchers/packetCaptures

PacketCaptureFilter

Jméno Popis Hodnota
localIPAddress Místní IP adresa, podle které se má filtrovat. Zápis: "127.0.0.1" pro položku s jednou adresou. "127.0.0.1-127.0.0.255" pro rozsah. "127.0.0.1; 127.0.0.5"? pro více položek. V současné době není podporováno více oblastí. Kombinování rozsahů s více položkami se aktuálně nepodporuje. Výchozí = null. řetězec
localPort Místní port, na který se má filtrovat. Zápis: "80" pro jednu položku portu. 80-85" pro rozsah. "80; 443;" pro více položek. V současné době není podporováno více oblastí. Kombinování rozsahů s více položkami se aktuálně nepodporuje. Výchozí = null. řetězec
protokol Protokol, který se má filtrovat. "Any" (Jakýkoli)
TCP
UDP
remoteIPAddress Místní IP adresa, podle které se má filtrovat. Zápis: "127.0.0.1" pro položku s jednou adresou. "127.0.0.1-127.0.0.255" pro rozsah. "127.0.0.1; 127.0.0.5;" pro více položek. V současné době není podporováno více oblastí. Kombinování rozsahů s více položkami se aktuálně nepodporuje. Výchozí = null. řetězec
remotePort Vzdálený port, na který se má filtrovat. Zápis: "80" pro jednu položku portu. 80-85" pro rozsah. "80; 443;" pro více položek. V současné době není podporováno více oblastí. Kombinování rozsahů s více položkami se aktuálně nepodporuje. Výchozí = null. řetězec

PacketCaptureMachineScope

Jméno Popis Hodnota
vyloučit Seznam instancí AzureVMSS, které musí být vyloučeny z AzureVMSS ze spouštění zachytávání paketů string[]
zahrnovat Seznam instancí AzureVMSS pro spouštění zachytávání paketů string[]

PacketCaptureParametersOrPacketCaptureResultProperties

Jméno Popis Hodnota
bytesToCapturePerPacket Počet bajtů zachycených na paket, zbývající bajty jsou zkráceny. Int

Omezení:
Minimální hodnota = 0
Maximální hodnota = 4294967295
captureSettings Nastavení zachycení obsahuje hodnoty FileCount, FileSizeInBytes, SessionTimeLimitInSeconds. packetCaptureSettings
continuousCapture Tento průběžný záznam je logická hodnota s možnou hodnotou null, která může obsahovat hodnotu null, true nebo false. Pokud tento parametr nepředáme, je vhodné ho považovat za null, výchozí hodnota je null. Bool
filtruje Seznam filtrů zachytávání paketů PacketCaptureFilter[]
rozsah Seznam instancí AzureVMSS, které je možné zahrnout nebo vyloučit za účelem spuštění zachytávání paketů. Pokud jsou zahrnuté i vyloučené prázdné, zachytávání paketů se spustí ve všech instancích AzureVMSS. PacketCaptureMachineScope
storageLocation Umístění úložiště pro relaci zachytávání paketů. PacketCaptureStorageLocation (povinné)
cíl ID cílového prostředku, aktuálně se podporuje pouze AzureVM a AzureVMSS jako cílový typ. string (povinné)
targetType Cílový typ poskytnutého prostředku. AzureVM
AzureVMSS
timeLimitInSeconds Maximální doba trvání relace zachycení v sekundách. Int

Omezení:
Minimální hodnota = 0
Maximální hodnota = 18000
totalBytesPerSession Maximální velikost výstupu zachytávání Int

Omezení:
Minimální hodnota = 0
Maximální hodnota = 4294967295

PacketCaptureSettings

Jméno Popis Hodnota
fileCount Početsouborůch Výchozí hodnota počtu je 10 a maximální počet je 1 0000. Int

Omezení:
Minimální hodnota = 0
Maximální hodnota = 1 0000
fileSizeInBytes Počet bajtů zachycených na paket Výchozí hodnota v bajtech 104857600 (100 MB) a maximální hodnota v bajtech 4294967295 (4 GB). Int

Omezení:
Minimální hodnota = 0
Maximální hodnota = 4294967295
sessionTimeLimitInSeconds Maximální doba trvání relace zachycení v sekundách je 604800s (7 dní) pro soubor. Výchozí hodnota ve druhém 86400s (1 den). Int

Omezení:
Minimální hodnota = 0
Maximální hodnota = 604800

PacketCaptureStorageLocation

Jméno Popis Hodnota
filePath Tato cesta je neplatná, pokud je k dispozici hodnota Continuous Capture s "true" nebo "false". Platná místní cesta na cílovém virtuálním počítači. Musí obsahovat název souboru zachytávání (*.cap). Pro virtuální počítač s Linuxem musí začínat /var/captures. Vyžaduje se, pokud není zadané ŽÁDNÉ ID úložiště, jinak volitelné. řetězec
localPath Tato cesta je platná, pokud je k dispozici hodnota Continuous Capture s true nebo false a vyžaduje se, pokud není zadané ŽÁDNÉ ID úložiště, jinak volitelné. Musí obsahovat název souboru zachytávání (*.cap). Pro virtuální počítač s Linuxem musí začínat /var/captures. řetězec
storageId ID účtu úložiště pro uložení relace zachytávání paketů. Vyžaduje se, pokud není k dispozici žádná cesta localPath nebo filePath. řetězec
storagePath Identifikátor URI cesty k úložišti pro uložení zachytávání paketů. Musí se jednat o identifikátor URI ve správném formátu popisující umístění pro uložení zachytávání paketů. řetězec

Definice prostředku Terraformu (poskytovatel AzAPI)

Typ prostředku networkWatchers/packetCaptures je možné nasadit s operacemi, které cílí:

  • skupiny prostředků

Seznam změněných vlastností v jednotlivých verzích rozhraní API najdete v protokolu změn.

Formát prostředku

Pokud chcete vytvořit prostředek Microsoft.Network/networkWatchers/packetCaptures, přidejte do šablony následující Terraform.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Network/networkWatchers/packetCaptures@2024-01-01"
  name = "string"
  body = jsonencode({
    properties = {
      bytesToCapturePerPacket = int
      captureSettings = {
        fileCount = int
        fileSizeInBytes = int
        sessionTimeLimitInSeconds = int
      }
      continuousCapture = bool
      filters = [
        {
          localIPAddress = "string"
          localPort = "string"
          protocol = "string"
          remoteIPAddress = "string"
          remotePort = "string"
        }
      ]
      scope = {
        exclude = [
          "string"
        ]
        include = [
          "string"
        ]
      }
      storageLocation = {
        filePath = "string"
        localPath = "string"
        storageId = "string"
        storagePath = "string"
      }
      target = "string"
      targetType = "string"
      timeLimitInSeconds = int
      totalBytesPerSession = int
    }
  })
}

Hodnoty vlastností

Microsoft.Network/networkWatchers/packetCaptures

Jméno Popis Hodnota
Jméno Název prostředku string (povinné)
parent_id ID prostředku, který je nadřazený pro tento prostředek. ID prostředku typu: networkWatchers
vlastnosti Vlastnosti zachytávání paketů PacketCaptureParametersOrPacketCaptureResultProperties (povinné)
typ Typ prostředku Microsoft.Network/networkWatchers/packetCaptures@2024-01-01"

PacketCaptureFilter

Jméno Popis Hodnota
localIPAddress Místní IP adresa, podle které se má filtrovat. Zápis: "127.0.0.1" pro položku s jednou adresou. "127.0.0.1-127.0.0.255" pro rozsah. "127.0.0.1; 127.0.0.5"? pro více položek. V současné době není podporováno více oblastí. Kombinování rozsahů s více položkami se aktuálně nepodporuje. Výchozí = null. řetězec
localPort Místní port, na který se má filtrovat. Zápis: "80" pro jednu položku portu. 80-85" pro rozsah. "80; 443;" pro více položek. V současné době není podporováno více oblastí. Kombinování rozsahů s více položkami se aktuálně nepodporuje. Výchozí = null. řetězec
protokol Protokol, který se má filtrovat. "Any" (Jakýkoli)
TCP
UDP
remoteIPAddress Místní IP adresa, podle které se má filtrovat. Zápis: "127.0.0.1" pro položku s jednou adresou. "127.0.0.1-127.0.0.255" pro rozsah. "127.0.0.1; 127.0.0.5;" pro více položek. V současné době není podporováno více oblastí. Kombinování rozsahů s více položkami se aktuálně nepodporuje. Výchozí = null. řetězec
remotePort Vzdálený port, na který se má filtrovat. Zápis: "80" pro jednu položku portu. 80-85" pro rozsah. "80; 443;" pro více položek. V současné době není podporováno více oblastí. Kombinování rozsahů s více položkami se aktuálně nepodporuje. Výchozí = null. řetězec

PacketCaptureMachineScope

Jméno Popis Hodnota
vyloučit Seznam instancí AzureVMSS, které musí být vyloučeny z AzureVMSS ze spouštění zachytávání paketů string[]
zahrnovat Seznam instancí AzureVMSS pro spouštění zachytávání paketů string[]

PacketCaptureParametersOrPacketCaptureResultProperties

Jméno Popis Hodnota
bytesToCapturePerPacket Počet bajtů zachycených na paket, zbývající bajty jsou zkráceny. Int

Omezení:
Minimální hodnota = 0
Maximální hodnota = 4294967295
captureSettings Nastavení zachycení obsahuje hodnoty FileCount, FileSizeInBytes, SessionTimeLimitInSeconds. packetCaptureSettings
continuousCapture Tento průběžný záznam je logická hodnota s možnou hodnotou null, která může obsahovat hodnotu null, true nebo false. Pokud tento parametr nepředáme, je vhodné ho považovat za null, výchozí hodnota je null. Bool
filtruje Seznam filtrů zachytávání paketů PacketCaptureFilter[]
rozsah Seznam instancí AzureVMSS, které je možné zahrnout nebo vyloučit za účelem spuštění zachytávání paketů. Pokud jsou zahrnuté i vyloučené prázdné, zachytávání paketů se spustí ve všech instancích AzureVMSS. PacketCaptureMachineScope
storageLocation Umístění úložiště pro relaci zachytávání paketů. PacketCaptureStorageLocation (povinné)
cíl ID cílového prostředku, aktuálně se podporuje pouze AzureVM a AzureVMSS jako cílový typ. string (povinné)
targetType Cílový typ poskytnutého prostředku. AzureVM
AzureVMSS
timeLimitInSeconds Maximální doba trvání relace zachycení v sekundách. Int

Omezení:
Minimální hodnota = 0
Maximální hodnota = 18000
totalBytesPerSession Maximální velikost výstupu zachytávání Int

Omezení:
Minimální hodnota = 0
Maximální hodnota = 4294967295

PacketCaptureSettings

Jméno Popis Hodnota
fileCount Početsouborůch Výchozí hodnota počtu je 10 a maximální počet je 1 0000. Int

Omezení:
Minimální hodnota = 0
Maximální hodnota = 1 0000
fileSizeInBytes Počet bajtů zachycených na paket Výchozí hodnota v bajtech 104857600 (100 MB) a maximální hodnota v bajtech 4294967295 (4 GB). Int

Omezení:
Minimální hodnota = 0
Maximální hodnota = 4294967295
sessionTimeLimitInSeconds Maximální doba trvání relace zachycení v sekundách je 604800s (7 dní) pro soubor. Výchozí hodnota ve druhém 86400s (1 den). Int

Omezení:
Minimální hodnota = 0
Maximální hodnota = 604800

PacketCaptureStorageLocation

Jméno Popis Hodnota
filePath Tato cesta je neplatná, pokud je k dispozici hodnota Continuous Capture s "true" nebo "false". Platná místní cesta na cílovém virtuálním počítači. Musí obsahovat název souboru zachytávání (*.cap). Pro virtuální počítač s Linuxem musí začínat /var/captures. Vyžaduje se, pokud není zadané ŽÁDNÉ ID úložiště, jinak volitelné. řetězec
localPath Tato cesta je platná, pokud je k dispozici hodnota Continuous Capture s true nebo false a vyžaduje se, pokud není zadané ŽÁDNÉ ID úložiště, jinak volitelné. Musí obsahovat název souboru zachytávání (*.cap). Pro virtuální počítač s Linuxem musí začínat /var/captures. řetězec
storageId ID účtu úložiště pro uložení relace zachytávání paketů. Vyžaduje se, pokud není k dispozici žádná cesta localPath nebo filePath. řetězec
storagePath Identifikátor URI cesty k úložišti pro uložení zachytávání paketů. Musí se jednat o identifikátor URI ve správném formátu popisující umístění pro uložení zachytávání paketů. řetězec