Freigeben über


Microsoft.Network networkWatchers/packetCaptures 2023-02-01

Bicep-Ressourcendefinition

Der Ressourcentyp "networkWatchers/packetCaptures" kann mit Vorgängen bereitgestellt werden, die auf Folgendes abzielen:

Eine Liste der geänderten Eigenschaften in jeder API-Version finden Sie unter Änderungsprotokoll.

Ressourcenformat

Um eine Microsoft.Network/networkWatchers/packetCaptures-Ressource zu erstellen, fügen Sie Der Vorlage den folgenden Bicep hinzu.

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

Eigenschaftswerte

Microsoft.Network/networkWatchers/packetCaptures

Name Beschreibung Wert
Name Der Ressourcenname Zeichenfolge (erforderlich)
Elternteil In Bicep können Sie die übergeordnete Ressource für eine untergeordnete Ressource angeben. Sie müssen diese Eigenschaft nur hinzufügen, wenn die untergeordnete Ressource außerhalb der übergeordneten Ressource deklariert wird.

Weitere Informationen finden Sie unter Untergeordnete Ressource außerhalb der übergeordneten Ressource.
Symbolischer Name für Ressource vom Typ: networkWatchers
Eigenschaften Eigenschaften der Paketerfassung. PacketCaptureParametersOrPacketCaptureResultProperties (erforderlich)

PacketCaptureFilter

Name Beschreibung Wert
localIPAddress Lokale IP-Adresse, nach der gefiltert werden soll. Notation: "127.0.0.1" für die Eingabe einer einzelnen Adresse. "127.0.0.1-127.0.0.255" für den Bereich. "127.0.0.1; 127.0.0.5"? für mehrere Einträge. Mehrere Bereiche werden derzeit nicht unterstützt. Das Mischen von Bereichen mit mehreren Einträgen wird derzeit nicht unterstützt. Default = null. Schnur
localPort Lokaler Port, nach dem gefiltert werden soll. Notation: "80" für single port entry." 80-85 Zoll für Bereich. "80; 443;" für mehrere Einträge. Mehrere Bereiche werden derzeit nicht unterstützt. Das Mischen von Bereichen mit mehreren Einträgen wird derzeit nicht unterstützt. Default = null. Schnur
Protokoll Protokoll, nach dem gefiltert werden soll. "Beliebig"
"TCP"
"UDP"
remoteIPAddress Lokale IP-Adresse, nach der gefiltert werden soll. Notation: "127.0.0.1" für die Eingabe einer einzelnen Adresse. "127.0.0.1-127.0.0.255" für den Bereich. "127.0.0.1; 127.0.0.5;" für mehrere Einträge. Mehrere Bereiche werden derzeit nicht unterstützt. Das Mischen von Bereichen mit mehreren Einträgen wird derzeit nicht unterstützt. Default = null. Schnur
remotePort Remoteport, nach dem gefiltert werden soll. Notation: "80" für single port entry." 80-85 Zoll für Bereich. "80; 443;" für mehrere Einträge. Mehrere Bereiche werden derzeit nicht unterstützt. Das Mischen von Bereichen mit mehreren Einträgen wird derzeit nicht unterstützt. Default = null. Schnur

PacketCaptureMachineScope

Name Beschreibung Wert
ausschließen Liste der AzureVMSS-Instanzen, die von der Ausführung der Paketerfassung von AzureVMSS ausgeschlossen werden müssen. string[]
einschließen Liste der AzureVMSS-Instanzen zum Ausführen der Paketerfassung. string[]

PacketCaptureParametersOrPacketCaptureResultProperties

Name Beschreibung Wert
bytesToCapturePerPacket Die Anzahl der pro Paket erfassten Bytes, die verbleibenden Bytes werden abgeschnitten. Int

Zwänge:
Min.-Wert = 0
Max. Wert = 4294967295
Filter Eine Liste der Paketerfassungsfilter. PacketCaptureFilter-[]
Umfang Eine Liste der AzureVMSS-Instanzen, die eingeschlossen oder ausgeschlossen werden können, um die Paketerfassung auszuführen. Wenn sowohl eingeschlossen als auch ausgeschlossen leer sind, wird die Paketerfassung auf allen Instanzen von AzureVMSS ausgeführt. PacketCaptureMachineScope-
storageLocation Der Speicherort für eine Paketerfassungssitzung. PacketCaptureStorageLocation- (erforderlich)
Ziel Die ID der zielbezogenen Ressource, nur AzureVM und AzureVMSS als Zieltyp werden derzeit unterstützt. Zeichenfolge (erforderlich)
targetType Zieltyp der bereitgestellten Ressource. "AzureVM"
"AzureVMSS"
timeLimitInSeconds Maximale Dauer der Aufnahmesitzung in Sekunden. Int

Zwänge:
Min.-Wert = 0
Maximalwert = 18000
totalBytesPerSession Maximale Größe der Aufnahmeausgabe. Int

Zwänge:
Min.-Wert = 0
Max. Wert = 4294967295

PacketCaptureStorageLocation

Name Beschreibung Wert
filePath Ein gültiger lokaler Pfad auf der Ziel-VM. Muss den Namen der Aufnahmedatei (*.cap) enthalten. Für den virtuellen Linux-Computer muss er mit /var/captures beginnen. Erforderlich, wenn keine Speicher-ID angegeben wird, andernfalls optional. Schnur
storageId Die ID des Speicherkontos zum Speichern der Paketerfassungssitzung. Erforderlich, wenn kein lokaler Dateipfad angegeben wird. Schnur
storagePath Der URI des Speicherpfads zum Speichern der Paketerfassung. Muss ein wohlgeformter URI sein, der den Speicherort beschreibt, um die Paketerfassung zu speichern. Schnur

ARM-Vorlagenressourcendefinition

Der Ressourcentyp "networkWatchers/packetCaptures" kann mit Vorgängen bereitgestellt werden, die auf Folgendes abzielen:

Eine Liste der geänderten Eigenschaften in jeder API-Version finden Sie unter Änderungsprotokoll.

Ressourcenformat

Um eine Microsoft.Network/networkWatchers/packetCaptures-Ressource zu erstellen, fügen Sie Ihrer Vorlage den folgenden JSON-Code hinzu.

{
  "type": "Microsoft.Network/networkWatchers/packetCaptures",
  "apiVersion": "2023-02-01",
  "name": "string",
  "properties": {
    "bytesToCapturePerPacket": "int",
    "filters": [
      {
        "localIPAddress": "string",
        "localPort": "string",
        "protocol": "string",
        "remoteIPAddress": "string",
        "remotePort": "string"
      }
    ],
    "scope": {
      "exclude": [ "string" ],
      "include": [ "string" ]
    },
    "storageLocation": {
      "filePath": "string",
      "storageId": "string",
      "storagePath": "string"
    },
    "target": "string",
    "targetType": "string",
    "timeLimitInSeconds": "int",
    "totalBytesPerSession": "int"
  }
}

Eigenschaftswerte

Microsoft.Network/networkWatchers/packetCaptures

Name Beschreibung Wert
apiVersion Die API-Version '2023-02-01'
Name Der Ressourcenname Zeichenfolge (erforderlich)
Eigenschaften Eigenschaften der Paketerfassung. PacketCaptureParametersOrPacketCaptureResultProperties (erforderlich)
Art Der Ressourcentyp "Microsoft.Network/networkWatchers/packetCaptures"

PacketCaptureFilter

Name Beschreibung Wert
localIPAddress Lokale IP-Adresse, nach der gefiltert werden soll. Notation: "127.0.0.1" für die Eingabe einer einzelnen Adresse. "127.0.0.1-127.0.0.255" für den Bereich. "127.0.0.1; 127.0.0.5"? für mehrere Einträge. Mehrere Bereiche werden derzeit nicht unterstützt. Das Mischen von Bereichen mit mehreren Einträgen wird derzeit nicht unterstützt. Default = null. Schnur
localPort Lokaler Port, nach dem gefiltert werden soll. Notation: "80" für single port entry." 80-85 Zoll für Bereich. "80; 443;" für mehrere Einträge. Mehrere Bereiche werden derzeit nicht unterstützt. Das Mischen von Bereichen mit mehreren Einträgen wird derzeit nicht unterstützt. Default = null. Schnur
Protokoll Protokoll, nach dem gefiltert werden soll. "Beliebig"
"TCP"
"UDP"
remoteIPAddress Lokale IP-Adresse, nach der gefiltert werden soll. Notation: "127.0.0.1" für die Eingabe einer einzelnen Adresse. "127.0.0.1-127.0.0.255" für den Bereich. "127.0.0.1; 127.0.0.5;" für mehrere Einträge. Mehrere Bereiche werden derzeit nicht unterstützt. Das Mischen von Bereichen mit mehreren Einträgen wird derzeit nicht unterstützt. Default = null. Schnur
remotePort Remoteport, nach dem gefiltert werden soll. Notation: "80" für single port entry." 80-85 Zoll für Bereich. "80; 443;" für mehrere Einträge. Mehrere Bereiche werden derzeit nicht unterstützt. Das Mischen von Bereichen mit mehreren Einträgen wird derzeit nicht unterstützt. Default = null. Schnur

PacketCaptureMachineScope

Name Beschreibung Wert
ausschließen Liste der AzureVMSS-Instanzen, die von der Ausführung der Paketerfassung von AzureVMSS ausgeschlossen werden müssen. string[]
einschließen Liste der AzureVMSS-Instanzen zum Ausführen der Paketerfassung. string[]

PacketCaptureParametersOrPacketCaptureResultProperties

Name Beschreibung Wert
bytesToCapturePerPacket Die Anzahl der pro Paket erfassten Bytes, die verbleibenden Bytes werden abgeschnitten. Int

Zwänge:
Min.-Wert = 0
Max. Wert = 4294967295
Filter Eine Liste der Paketerfassungsfilter. PacketCaptureFilter-[]
Umfang Eine Liste der AzureVMSS-Instanzen, die eingeschlossen oder ausgeschlossen werden können, um die Paketerfassung auszuführen. Wenn sowohl eingeschlossen als auch ausgeschlossen leer sind, wird die Paketerfassung auf allen Instanzen von AzureVMSS ausgeführt. PacketCaptureMachineScope-
storageLocation Der Speicherort für eine Paketerfassungssitzung. PacketCaptureStorageLocation- (erforderlich)
Ziel Die ID der zielbezogenen Ressource, nur AzureVM und AzureVMSS als Zieltyp werden derzeit unterstützt. Zeichenfolge (erforderlich)
targetType Zieltyp der bereitgestellten Ressource. "AzureVM"
"AzureVMSS"
timeLimitInSeconds Maximale Dauer der Aufnahmesitzung in Sekunden. Int

Zwänge:
Min.-Wert = 0
Maximalwert = 18000
totalBytesPerSession Maximale Größe der Aufnahmeausgabe. Int

Zwänge:
Min.-Wert = 0
Max. Wert = 4294967295

PacketCaptureStorageLocation

Name Beschreibung Wert
filePath Ein gültiger lokaler Pfad auf der Ziel-VM. Muss den Namen der Aufnahmedatei (*.cap) enthalten. Für den virtuellen Linux-Computer muss er mit /var/captures beginnen. Erforderlich, wenn keine Speicher-ID angegeben wird, andernfalls optional. Schnur
storageId Die ID des Speicherkontos zum Speichern der Paketerfassungssitzung. Erforderlich, wenn kein lokaler Dateipfad angegeben wird. Schnur
storagePath Der URI des Speicherpfads zum Speichern der Paketerfassung. Muss ein wohlgeformter URI sein, der den Speicherort beschreibt, um die Paketerfassung zu speichern. Schnur

Terraform -Ressourcendefinition (AzAPI-Anbieter)

Der Ressourcentyp "networkWatchers/packetCaptures" kann mit Vorgängen bereitgestellt werden, die auf Folgendes abzielen:

  • Ressourcengruppen

Eine Liste der geänderten Eigenschaften in jeder API-Version finden Sie unter Änderungsprotokoll.

Ressourcenformat

Um eine Microsoft.Network/networkWatchers/packetCaptures-Ressource zu erstellen, fügen Sie Ihrer Vorlage die folgende Terraform hinzu.

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

Eigenschaftswerte

Microsoft.Network/networkWatchers/packetCaptures

Name Beschreibung Wert
Name Der Ressourcenname Zeichenfolge (erforderlich)
parent_id Die ID der Ressource, die das übergeordnete Element für diese Ressource ist. ID für Ressource vom Typ: networkWatchers
Eigenschaften Eigenschaften der Paketerfassung. PacketCaptureParametersOrPacketCaptureResultProperties (erforderlich)
Art Der Ressourcentyp "Microsoft.Network/networkWatchers/packetCaptures@2023-02-01"

PacketCaptureFilter

Name Beschreibung Wert
localIPAddress Lokale IP-Adresse, nach der gefiltert werden soll. Notation: "127.0.0.1" für die Eingabe einer einzelnen Adresse. "127.0.0.1-127.0.0.255" für den Bereich. "127.0.0.1; 127.0.0.5"? für mehrere Einträge. Mehrere Bereiche werden derzeit nicht unterstützt. Das Mischen von Bereichen mit mehreren Einträgen wird derzeit nicht unterstützt. Default = null. Schnur
localPort Lokaler Port, nach dem gefiltert werden soll. Notation: "80" für single port entry." 80-85 Zoll für Bereich. "80; 443;" für mehrere Einträge. Mehrere Bereiche werden derzeit nicht unterstützt. Das Mischen von Bereichen mit mehreren Einträgen wird derzeit nicht unterstützt. Default = null. Schnur
Protokoll Protokoll, nach dem gefiltert werden soll. "Beliebig"
"TCP"
"UDP"
remoteIPAddress Lokale IP-Adresse, nach der gefiltert werden soll. Notation: "127.0.0.1" für die Eingabe einer einzelnen Adresse. "127.0.0.1-127.0.0.255" für den Bereich. "127.0.0.1; 127.0.0.5;" für mehrere Einträge. Mehrere Bereiche werden derzeit nicht unterstützt. Das Mischen von Bereichen mit mehreren Einträgen wird derzeit nicht unterstützt. Default = null. Schnur
remotePort Remoteport, nach dem gefiltert werden soll. Notation: "80" für single port entry." 80-85 Zoll für Bereich. "80; 443;" für mehrere Einträge. Mehrere Bereiche werden derzeit nicht unterstützt. Das Mischen von Bereichen mit mehreren Einträgen wird derzeit nicht unterstützt. Default = null. Schnur

PacketCaptureMachineScope

Name Beschreibung Wert
ausschließen Liste der AzureVMSS-Instanzen, die von der Ausführung der Paketerfassung von AzureVMSS ausgeschlossen werden müssen. string[]
einschließen Liste der AzureVMSS-Instanzen zum Ausführen der Paketerfassung. string[]

PacketCaptureParametersOrPacketCaptureResultProperties

Name Beschreibung Wert
bytesToCapturePerPacket Die Anzahl der pro Paket erfassten Bytes, die verbleibenden Bytes werden abgeschnitten. Int

Zwänge:
Min.-Wert = 0
Max. Wert = 4294967295
Filter Eine Liste der Paketerfassungsfilter. PacketCaptureFilter-[]
Umfang Eine Liste der AzureVMSS-Instanzen, die eingeschlossen oder ausgeschlossen werden können, um die Paketerfassung auszuführen. Wenn sowohl eingeschlossen als auch ausgeschlossen leer sind, wird die Paketerfassung auf allen Instanzen von AzureVMSS ausgeführt. PacketCaptureMachineScope-
storageLocation Der Speicherort für eine Paketerfassungssitzung. PacketCaptureStorageLocation- (erforderlich)
Ziel Die ID der zielbezogenen Ressource, nur AzureVM und AzureVMSS als Zieltyp werden derzeit unterstützt. Zeichenfolge (erforderlich)
targetType Zieltyp der bereitgestellten Ressource. "AzureVM"
"AzureVMSS"
timeLimitInSeconds Maximale Dauer der Aufnahmesitzung in Sekunden. Int

Zwänge:
Min.-Wert = 0
Maximalwert = 18000
totalBytesPerSession Maximale Größe der Aufnahmeausgabe. Int

Zwänge:
Min.-Wert = 0
Max. Wert = 4294967295

PacketCaptureStorageLocation

Name Beschreibung Wert
filePath Ein gültiger lokaler Pfad auf der Ziel-VM. Muss den Namen der Aufnahmedatei (*.cap) enthalten. Für den virtuellen Linux-Computer muss er mit /var/captures beginnen. Erforderlich, wenn keine Speicher-ID angegeben wird, andernfalls optional. Schnur
storageId Die ID des Speicherkontos zum Speichern der Paketerfassungssitzung. Erforderlich, wenn kein lokaler Dateipfad angegeben wird. Schnur
storagePath Der URI des Speicherpfads zum Speichern der Paketerfassung. Muss ein wohlgeformter URI sein, der den Speicherort beschreibt, um die Paketerfassung zu speichern. Schnur