Aracılığıyla paylaş

Microsoft.Network networkWatchers/packetCaptures

  • Makale

Bicep kaynak tanımı

networkWatchers/packetCaptures kaynak türü, aşağıdakileri hedefleyen işlemlerle dağıtılabilir:

Her API sürümünde değiştirilen özelliklerin listesi için bkz. değişiklik günlüğü.

Kaynak biçimi

Microsoft.Network/networkWatchers/packetCaptures kaynağı oluşturmak için şablonunuza aşağıdaki Bicep'i ekleyin.

resource symbolicname 'Microsoft.Network/networkWatchers/packetCaptures@2023-11-01' = {
  name: 'string'
  parent: resourceSymbolicName
  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
  }
}

Özellik değerleri

networkWatchers/packetCaptures

Ad Açıklama Değer
name Kaynak adı

Bicep'te alt kaynaklar için adları ve türleri ayarlamayı öğrenin.		 dize (gerekli)
Üst Bicep'te bir alt kaynağın üst kaynağını belirtebilirsiniz. Bu özelliği yalnızca alt kaynak üst kaynağın dışında bildirildiğinde eklemeniz gerekir.

Daha fazla bilgi için bkz . Üst kaynağın dışındaki alt kaynak.		 Kaynak türü için sembolik ad: networkWatchers
properties Paket yakalamanın özellikleri. PacketCaptureParametersOrPacketCaptureResultProperti... (gerekli)

PacketCaptureParametersOrPacketCaptureResultProperti...

Ad Açıklama Değer
bytesToCapturePerPacket Paket başına yakalanan bayt sayısı; kalan baytlar kesilir. int

Kısıtlama -ları:
Min değer = 0
Maksimum değer = 4294967295
captureSettings Yakalama ayarı 'FileCount', 'FileSizeInBytes', 'SessionTimeLimitInSeconds' değerlerini tutar. PacketCaptureSettings
continuousCapture Bu sürekli yakalama, 'null', 'true' veya 'false' değerini tutabilen null atanabilir bir boole değeridir. Bu parametreyi geçirmezsek 'null' olarak değerlendirilir, varsayılan değer 'null' olur. bool
filtreler Paket yakalama filtrelerinin listesi. PacketCaptureFilter[]
scope Paket yakalamayı çalıştırmak için dahil edilebilen veya dışlanabilen AzureVMSS örneklerinin listesi. Hem dahil edilen hem de dışlananlar boşsa, paket yakalama tüm AzureVMSS örneklerinde çalıştırılır. PacketCaptureMachineScope
Storagelocation Paket yakalama oturumu için depolama konumu. PacketCaptureStorageLocation (gerekli)
Hedef Hedeflenen kaynağın kimliği, şu anda yalnızca AzureVM ve AzureVMSS hedef türü olarak desteklenmektedir. dize (gerekli)
Targettype Sağlanan kaynağın hedef türü. 'AzureVM'
'AzureVMSS'
timeLimitInSeconds Yakalama oturumunun saniye cinsinden en uzun süresi. int

Kısıtlama -ları:
Min değer = 0
Maksimum değer = 18000
totalBytesPerSession Yakalama çıkışının en büyük boyutu. int

Kısıtlama -ları:
Min değer = 0
Maksimum değer = 4294967295

PacketCaptureSettings

Ad Açıklama Değer
fileCount Dosya sayısı. Varsayılan sayı değeri 10, maksimum sayı ise 10000'dir. int

Kısıtlama -ları:
Min değer = 0
Maksimum değer = 10000
fileSizeInBytes Paket başına yakalanan bayt sayısı. Bayt 104857600 (100 MB) ve bayt 4294967295 (4 GB) cinsinden en büyük varsayılan değer. int

Kısıtlama -ları:
Min değer = 0
Maksimum değer = 4294967295
sessionTimeLimitInSeconds Bir dosya için yakalama oturumunun saniye cinsinden en uzun süresi 604800s (7 gündür). İkinci 86400'lerde varsayılan değer (1 gün). int

Kısıtlama -ları:
Min değer = 0
Maksimum değer = 604800

PacketCaptureFilter

Ad Açıklama Değer
localIPAddress Filtrelenecek yerel IP Adresi. Notasyon: Tek adres girişi için "127.0.0.1". Aralık için "127.0.0.1-127.0.0.255". "127.0.0.1; 127.0.0.5"? birden çok giriş için. Şu anda desteklenmeyen birden çok aralık. Şu anda desteklenmeyen birden çok girişle aralıkları karıştırma. Varsayılan = null. string
localPort Filtrelenecek yerel bağlantı noktası. Notasyon: Tek bağlantı noktası girişi için "80"." Aralık için 80-85 inç. "80; 443;" birden çok giriş için. Şu anda desteklenmeyen birden çok aralık. Şu anda desteklenmeyen birden çok girişle aralıkları karıştırma. Varsayılan = null. string
protokol Filtrelenecek protokol. 'Herhangi biri'
'TCP'
'UDP'
remoteIPAddress Filtrelenecek yerel IP Adresi. Notasyon: Tek adres girişi için "127.0.0.1". Aralık için "127.0.0.1-127.0.0.255". "127.0.0.1; Birden çok giriş için 127.0.0.5;". Şu anda desteklenmeyen birden çok aralık. Şu anda desteklenmeyen birden çok girişle aralıkları karıştırma. Varsayılan = null. string
remotePort Filtrelenecek uzak bağlantı noktası. Notasyon: Tek bağlantı noktası girişi için "80"." Aralık için 80-85 inç. "80; 443;" birden çok giriş için. Şu anda desteklenmeyen birden çok aralık. Şu anda desteklenmeyen birden çok girişle aralıkları karıştırma. Varsayılan = null. string

PacketCaptureMachineScope

Ad Açıklama Değer
dışlama AzureVMSS'nin paket yakalamayı çalıştırmasından dışlanması gereken AzureVMSS örneklerinin listesi. string[]
include Paket yakalamanın çalıştırılacak AzureVMSS örneklerinin listesi. string[]

PacketCaptureStorageLocation

Ad Açıklama Değer
Filepath 'Sürekli Yakalama' 'true' veya 'false' ile sağlanmışsa bu yol geçersizdir. Hedefleme VM'sinde geçerli bir yerel yol. Yakalama dosyasının adını (*.cap) içermelidir. Linux sanal makinesi için /var/captures ile başlaması gerekir. Depolama kimliği sağlanmadıysa gereklidir, aksi takdirde isteğe bağlıdır. string
localPath Bu yol, 'Sürekli Yakalama' 'true' veya 'false' ile sağlanmışsa geçerlidir ve depolama kimliği sağlanmazsa gereklidir, aksi takdirde isteğe bağlıdır. Yakalama dosyasının adını (*.cap) içermelidir. Linux sanal makinesi için /var/captures ile başlaması gerekir. string
storageId Paket yakalama oturumunu kaydetmek için depolama hesabının kimliği. LocalPath veya filePath sağlanmazsa gereklidir. string
storagePath Paket yakalamayı kaydetmek için depolama yolunun URI'si. Paket yakalamayı kaydetmek için konumu açıklayan iyi biçimlendirilmiş bir URI olmalıdır. string

ARM şablonu kaynak tanımı

networkWatchers/packetCaptures kaynak türü, aşağıdakileri hedefleyen işlemlerle dağıtılabilir:

Her API sürümünde değiştirilen özelliklerin listesi için bkz. değişiklik günlüğü.

Kaynak biçimi

Microsoft.Network/networkWatchers/packetCaptures kaynağı oluşturmak için şablonunuza aşağıdaki JSON'u ekleyin.

{
  "type": "Microsoft.Network/networkWatchers/packetCaptures",
  "apiVersion": "2023-11-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"
  }
}

Özellik değerleri

networkWatchers/packetCaptures

Ad Açıklama Değer
tür Kaynak türü 'Microsoft.Network/networkWatchers/packetCaptures'
apiVersion Kaynak API'sinin sürümü '2023-11-01'
name Kaynak adı

Bkz. JSON ARM şablonlarında alt kaynaklar için adları ve türleri ayarlama.		 dize (gerekli)
properties Paket yakalamanın özellikleri. PacketCaptureParametersOrPacketCaptureResultProperti... (gerekli)

PacketCaptureParametersOrPacketCaptureResultProperti...

Ad Açıklama Değer
bytesToCapturePerPacket Paket başına yakalanan bayt sayısı; kalan baytlar kesilir. int

Kısıtlama -ları:
Min değer = 0
Maksimum değer = 4294967295
captureSettings Yakalama ayarı 'FileCount', 'FileSizeInBytes', 'SessionTimeLimitInSeconds' değerlerini tutar. PacketCaptureSettings
continuousCapture Bu sürekli yakalama, 'null', 'true' veya 'false' değerini tutabilen null atanabilir bir boole değeridir. Bu parametreyi geçirmezsek 'null' olarak değerlendirilir, varsayılan değer 'null' olur. bool
filtreler Paket yakalama filtrelerinin listesi. PacketCaptureFilter[]
scope Paket yakalamayı çalıştırmak için dahil edilebilen veya dışlanabilen AzureVMSS örneklerinin listesi. Hem dahil edilen hem de dışlananlar boşsa, paket yakalama tüm AzureVMSS örneklerinde çalıştırılır. PacketCaptureMachineScope
Storagelocation Paket yakalama oturumu için depolama konumu. PacketCaptureStorageLocation (gerekli)
Hedef Hedeflenen kaynağın kimliği, şu anda yalnızca AzureVM ve AzureVMSS hedef türü olarak desteklenmektedir. dize (gerekli)
Targettype Sağlanan kaynağın hedef türü. 'AzureVM'
'AzureVMSS'
timeLimitInSeconds Yakalama oturumunun saniye cinsinden en uzun süresi. int

Kısıtlama -ları:
Min değer = 0
Maksimum değer = 18000
totalBytesPerSession Yakalama çıkışının en büyük boyutu. int

Kısıtlama -ları:
Min değer = 0
Maksimum değer = 4294967295

PacketCaptureSettings

Ad Açıklama Değer
fileCount Dosya sayısı. Varsayılan sayı değeri 10, maksimum sayı ise 10000'dir. int

Kısıtlama -ları:
Min değer = 0
Maksimum değer = 10000
fileSizeInBytes Paket başına yakalanan bayt sayısı. Bayt 104857600 (100 MB) ve bayt 4294967295 (4 GB) cinsinden en büyük varsayılan değer. int

Kısıtlama -ları:
Min değer = 0
Maksimum değer = 4294967295
sessionTimeLimitInSeconds Bir dosya için yakalama oturumunun saniye cinsinden en uzun süresi 604800s (7 gündür). İkinci 86400'lerde varsayılan değer (1 gün). int

Kısıtlama -ları:
Min değer = 0
Maksimum değer = 604800

PacketCaptureFilter

Ad Açıklama Değer
localIPAddress Filtrelenecek yerel IP Adresi. Notasyon: Tek adres girişi için "127.0.0.1". Aralık için "127.0.0.1-127.0.0.255". "127.0.0.1; 127.0.0.5"? birden çok giriş için. Şu anda desteklenmeyen birden çok aralık. Şu anda desteklenmeyen birden çok girişle aralıkları karıştırma. Varsayılan = null. string
localPort Filtrelenecek yerel bağlantı noktası. Notasyon: Tek bağlantı noktası girişi için "80"." Aralık için 80-85 inç. "80; 443;" birden çok giriş için. Şu anda desteklenmeyen birden çok aralık. Şu anda desteklenmeyen birden çok girişle aralıkları karıştırma. Varsayılan = null. string
protokol Filtrelenecek protokol. 'Herhangi biri'
'TCP'
'UDP'
remoteIPAddress Filtrelenecek yerel IP Adresi. Notasyon: Tek adres girişi için "127.0.0.1". Aralık için "127.0.0.1-127.0.0.255". "127.0.0.1; Birden çok giriş için 127.0.0.5;". Şu anda desteklenmeyen birden çok aralık. Şu anda desteklenmeyen birden çok girişle aralıkları karıştırma. Varsayılan = null. string
remotePort Filtrelenecek uzak bağlantı noktası. Notasyon: Tek bağlantı noktası girişi için "80"." Aralık için 80-85 inç. "80; 443;" birden çok giriş için. Şu anda desteklenmeyen birden çok aralık. Şu anda desteklenmeyen birden çok girişle aralıkları karıştırma. Varsayılan = null. string

PacketCaptureMachineScope

Ad Açıklama Değer
dışlama AzureVMSS'nin paket yakalamayı çalıştırmasından dışlanması gereken AzureVMSS örneklerinin listesi. string[]
include Paket yakalamanın çalıştırılacak AzureVMSS örneklerinin listesi. string[]

PacketCaptureStorageLocation

Ad Açıklama Değer
Filepath 'Sürekli Yakalama' 'true' veya 'false' ile sağlanmışsa bu yol geçersizdir. Hedefleme VM'sinde geçerli bir yerel yol. Yakalama dosyasının adını (*.cap) içermelidir. Linux sanal makinesi için /var/captures ile başlaması gerekir. Depolama kimliği sağlanmadıysa gereklidir, aksi takdirde isteğe bağlıdır. string
localPath Bu yol, 'Sürekli Yakalama' 'true' veya 'false' ile sağlanmışsa geçerlidir ve depolama kimliği sağlanmazsa gereklidir, aksi takdirde isteğe bağlıdır. Yakalama dosyasının adını (*.cap) içermelidir. Linux sanal makinesi için /var/captures ile başlaması gerekir. string
storageId Paket yakalama oturumunu kaydetmek için depolama hesabının kimliği. LocalPath veya filePath sağlanmazsa gereklidir. string
storagePath Paket yakalamayı kaydetmek için depolama yolunun URI'si. Paket yakalamayı kaydetmek için konumu açıklayan iyi biçimlendirilmiş bir URI olmalıdır. string

Terraform (AzAPI sağlayıcısı) kaynak tanımı

networkWatchers/packetCaptures kaynak türü, aşağıdakileri hedefleyen işlemlerle dağıtılabilir:

  • Kaynak grupları

Her API sürümünde değiştirilen özelliklerin listesi için bkz. değişiklik günlüğü.

Kaynak biçimi

Microsoft.Network/networkWatchers/packetCaptures kaynağı oluşturmak için şablonunuza aşağıdaki Terraform'u ekleyin.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Network/networkWatchers/packetCaptures@2023-11-01"
  name = "string"
  parent_id = "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
    }
  })
}

Özellik değerleri

networkWatchers/packetCaptures

Ad Açıklama Değer
tür Kaynak türü "Microsoft.Network/networkWatchers/packetCaptures@2023-11-01"
name Kaynak adı dize (gerekli)
parent_id Bu kaynağın üst öğesi olan kaynağın kimliği. Şu tür kaynağın kimliği: networkWatchers
properties Paket yakalamanın özellikleri. PacketCaptureParametersOrPacketCaptureResultProperti... (gerekli)

PacketCaptureParametersOrPacketCaptureResultProperti...

Ad Açıklama Değer
bytesToCapturePerPacket Paket başına yakalanan bayt sayısı; kalan baytlar kesilir. int

Kısıtlama -ları:
Min değer = 0
Maksimum değer = 4294967295
captureSettings Yakalama ayarı 'FileCount', 'FileSizeInBytes', 'SessionTimeLimitInSeconds' değerlerini tutar. PacketCaptureSettings
continuousCapture Bu sürekli yakalama, 'null', 'true' veya 'false' değerini tutabilen null atanabilir bir boole değeridir. Bu parametreyi geçirmezsek 'null' olarak değerlendirilir, varsayılan değer 'null' olur. bool
filtreler Paket yakalama filtrelerinin listesi. PacketCaptureFilter[]
scope Paket yakalamayı çalıştırmak için dahil edilebilen veya dışlanabilen AzureVMSS örneklerinin listesi. Hem dahil edilen hem de dışlananlar boşsa, paket yakalama tüm AzureVMSS örneklerinde çalıştırılır. PacketCaptureMachineScope
Storagelocation Paket yakalama oturumu için depolama konumu. PacketCaptureStorageLocation (gerekli)
Hedef Hedeflenen kaynağın kimliği, şu anda yalnızca AzureVM ve AzureVMSS hedef türü olarak desteklenmektedir. dize (gerekli)
Targettype Sağlanan kaynağın hedef türü. "AzureVM"
"AzureVMSS"
timeLimitInSeconds Yakalama oturumunun saniye cinsinden en uzun süresi. int

Kısıtlama -ları:
Min değer = 0
Maksimum değer = 18000
totalBytesPerSession Yakalama çıkışının en büyük boyutu. int

Kısıtlama -ları:
Min değer = 0
Maksimum değer = 4294967295

PacketCaptureSettings

Ad Açıklama Değer
fileCount Dosya sayısı. Varsayılan sayı değeri 10, maksimum sayı ise 10000'dir. int

Kısıtlama -ları:
Min değer = 0
Maksimum değer = 10000
fileSizeInBytes Paket başına yakalanan bayt sayısı. Bayt 104857600 (100 MB) ve bayt 4294967295 (4 GB) cinsinden en büyük varsayılan değer. int

Kısıtlama -ları:
Min değer = 0
Maksimum değer = 4294967295
sessionTimeLimitInSeconds Bir dosya için yakalama oturumunun saniye cinsinden en uzun süresi 604800s (7 gündür). İkinci 86400'lerde varsayılan değer (1 gün). int

Kısıtlama -ları:
Min değer = 0
Maksimum değer = 604800

PacketCaptureFilter

Ad Açıklama Değer
localIPAddress Filtrelenecek yerel IP Adresi. Notasyon: Tek adres girişi için "127.0.0.1". Aralık için "127.0.0.1-127.0.0.255". "127.0.0.1; 127.0.0.5"? birden çok giriş için. Şu anda desteklenmeyen birden çok aralık. Şu anda desteklenmeyen birden çok girişle aralıkları karıştırma. Varsayılan = null. string
localPort Filtrelenecek yerel bağlantı noktası. Notasyon: Tek bağlantı noktası girişi için "80"." Aralık için 80-85 inç. "80; 443;" birden çok giriş için. Şu anda desteklenmeyen birden çok aralık. Şu anda desteklenmeyen birden çok girişle aralıkları karıştırma. Varsayılan = null. string
protokol Filtrelenecek protokol. "Herhangi biri"
"TCP"
"UDP"
remoteIPAddress Filtrelenecek yerel IP Adresi. Notasyon: Tek adres girişi için "127.0.0.1". Aralık için "127.0.0.1-127.0.0.255". "127.0.0.1; Birden çok giriş için 127.0.0.5;". Şu anda desteklenmeyen birden çok aralık. Şu anda desteklenmeyen birden çok girişle aralıkları karıştırma. Varsayılan = null. string
remotePort Filtrelenecek uzak bağlantı noktası. Notasyon: Tek bağlantı noktası girişi için "80"." Aralık için 80-85 inç. "80; 443;" birden çok giriş için. Şu anda desteklenmeyen birden çok aralık. Şu anda desteklenmeyen birden çok girişle aralıkları karıştırma. Varsayılan = null. string

PacketCaptureMachineScope

Ad Açıklama Değer
dışlama AzureVMSS'nin paket yakalamayı çalıştırmasından dışlanması gereken AzureVMSS örneklerinin listesi. dize[]
include Paket yakalamanın çalıştırılacak AzureVMSS örneklerinin listesi. dize[]

PacketCaptureStorageLocation

Ad Açıklama Değer
Filepath 'Sürekli Yakalama' 'true' veya 'false' ile sağlanırsa bu yol geçersizdir. Hedef vm'de geçerli bir yerel yol. Yakalama dosyasının adını (*.cap) içermelidir. Linux sanal makinesi için /var/captures ile başlamalıdır. Depolama kimliği sağlanmadıysa gereklidir, aksi takdirde isteğe bağlıdır. string
localPath Bu yol, 'Sürekli Yakalama' 'true' veya 'false' ile sağlanmışsa geçerlidir ve depolama kimliği sağlanmazsa gereklidir, aksi takdirde isteğe bağlıdır. Yakalama dosyasının adını (*.cap) içermelidir. Linux sanal makinesi için /var/captures ile başlamalıdır. string
storageId Paket yakalama oturumunu kaydetmek için depolama hesabının kimliği. LocalPath veya filePath sağlanmazsa gereklidir. string
storagePath Paket yakalamayı kaydetmek için depolama yolunun URI'si. Paket yakalamayı kaydetmek için konumu açıklayan iyi biçimlendirilmiş bir URI olmalıdır. string