Aracılığıyla paylaş


Microsoft.Network networkWatchers/packetCaptures

Bicep kaynak tanımı

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

  • kaynak grupları - Bkz. kaynak grubu dağıtım komutları

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@2024-07-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
  }
}

Özellik Değerleri

Microsoft.Network/networkWatchers/packetCaptures

Ad Açıklama Değer
ad Kaynak adı dize (gerekli)
ebeveyn Bicep'te bir alt kaynak için üst kaynak belirtebilirsiniz. Bu özelliği yalnızca alt kaynak üst kaynağın dışında bildirildiğinde eklemeniz gerekir.

Daha fazla bilgi için bkz. Alt kaynaküst kaynak dışında.
Kaynak türü için sembolik ad: networkWatchers
Özellikler Paket yakalamanın özellikleri. PacketCaptureParametersOrPacketCaptureResultProperties (gerekli)

PacketCaptureFilter (Paket Yakalama Filtresi)

Ad Açıklama Değer
localIPAddress Filtrelenecek yerel IP Adresi. Gösterimi: 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. dizgi
yerelPort Filtrelenecek yerel bağlantı noktası. Gösterimi: Tek bağlantı noktası girişi için "80"." Aralık için 80-85 inç. "80; 443;" birden çok girdi için. Şu anda desteklenmeyen birden çok aralık. Şu anda desteklenmeyen birden çok girişle aralıkları karıştırma. Varsayılan = null. dizgi
protokol Filtrelenecek protokol. 'Herhangi biri'
'TCP'
'UDP'
remoteIPAddress Filtrelenecek yerel IP Adresi. Gösterimi: 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. dizgi
uzak bağlantı noktası Filtrelenecek uzak bağlantı noktası. Gösterimi: Tek bağlantı noktası girişi için "80"." Aralık için 80-85 inç. "80; 443;" birden çok girdi için. Şu anda desteklenmeyen birden çok aralık. Şu anda desteklenmeyen birden çok girişle aralıkları karıştırma. Varsayılan = null. dizgi

PacketCaptureMachineScope

Ad Açıklama Değer
Dışlamak AzureVMSS'nin paket yakalamayı çalıştırmasının dışında tutulması gereken AzureVMSS örneklerinin listesi. dize[]
kapsamak Paket yakalamanın çalıştırılacak AzureVMSS örneklerinin listesi. dize[]

PacketCaptureParametersOrPacketCaptureResultProperties

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

Kısıtlama -ları:
En düşük değer = 0
En yüksek değer = 4294967295
captureSettings (YakalamaAyarları) Yakalama ayarı 'FileCount', 'FileSizeInBytes', 'SessionTimeLimitInSeconds' değerlerini tutar. PacketCaptureSettings
continuousCapture (sürekliYakalama) Bu sürekli yakalama, 'null', 'true' veya 'false' değerini tutabilen null atanabilir bir boole değeridir. Bu parametreyi geçirmezsek , 'null' olarak kabul edilir, varsayılan değer 'null' olur. Bool
Filtre Paket yakalama filtrelerinin listesi. PacketCaptureFilter[]
kapsam 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 (Depolama) 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)
hedef türü Sağlanan kaynağın hedef türü. 'AzureVM'
'AzureVMSS'
timeLimitInSeconds Yakalama oturumunun saniye cinsinden en uzun süresi. Int

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

Kısıtlama -ları:
En düşük değer = 0
En yüksek değer = 4294967295

PacketCaptureSettings (Paket Yakalama Ayarları)

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

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

Kısıtlama -ları:
En düşük değer = 0
En yüksek değer = 4294967295
sessionTimeLimitInSeconds Bir dosya için yakalama oturumunun saniye cinsinden süresi en fazla 604800s (7 gün) olur. İkinci 86400'lerde (1 gün) varsayılan değer. Int

Kısıtlama -ları:
En düşük değer = 0
Maksimum değer = 604800

PacketCaptureStorageLocation

Ad Açıklama Değer
filePath (dosya Yolu) 'Sürekli Yakalama' 'true' veya 'false' ile sağlanırsa 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şlamalıdır. Depolama kimliği sağlanmadıysa gereklidir, aksi takdirde isteğe bağlıdır. dizgi
yerel Yol Bu yol, 'Sürekli Yakalama' 'true' veya 'false' ile sağlanmışsa geçerlidir ve depolama kimliği sağlanmadıysa 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. dizgi
storageId Paket yakalama oturumunu kaydetmek için depolama hesabının kimliği. LocalPath veya filePath sağlanmadıysa gereklidir. dizgi
storagePath (depolama Yolu) Paket yakalamayı kaydetmek için depolama yolunun URI'sini. Paket yakalamanın kaydedilileceği konumu açıklayan iyi biçimlendirilmiş bir URI olmalıdır. dizgi

ARM şablonu kaynak tanımı

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

  • kaynak grupları - Bkz. kaynak grubu dağıtım komutları

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 dosyasını ekleyin.

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

Microsoft.Network/networkWatchers/packetCaptures

Ad Açıklama Değer
apiVersiyonu API sürümü '2024-07-01'
ad Kaynak adı dize (gerekli)
Özellikler Paket yakalamanın özellikleri. PacketCaptureParametersOrPacketCaptureResultProperties (gerekli)
tür Kaynak türü 'Microsoft.Network/networkWatchers/packetCaptures'

PacketCaptureFilter (Paket Yakalama Filtresi)

Ad Açıklama Değer
localIPAddress Filtrelenecek yerel IP Adresi. Gösterimi: 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. dizgi
yerelPort Filtrelenecek yerel bağlantı noktası. Gösterimi: Tek bağlantı noktası girişi için "80"." Aralık için 80-85 inç. "80; 443;" birden çok girdi için. Şu anda desteklenmeyen birden çok aralık. Şu anda desteklenmeyen birden çok girişle aralıkları karıştırma. Varsayılan = null. dizgi
protokol Filtrelenecek protokol. 'Herhangi biri'
'TCP'
'UDP'
remoteIPAddress Filtrelenecek yerel IP Adresi. Gösterimi: 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. dizgi
uzak bağlantı noktası Filtrelenecek uzak bağlantı noktası. Gösterimi: Tek bağlantı noktası girişi için "80"." Aralık için 80-85 inç. "80; 443;" birden çok girdi için. Şu anda desteklenmeyen birden çok aralık. Şu anda desteklenmeyen birden çok girişle aralıkları karıştırma. Varsayılan = null. dizgi

PacketCaptureMachineScope

Ad Açıklama Değer
Dışlamak AzureVMSS'nin paket yakalamayı çalıştırmasının dışında tutulması gereken AzureVMSS örneklerinin listesi. dize[]
kapsamak Paket yakalamanın çalıştırılacak AzureVMSS örneklerinin listesi. dize[]

PacketCaptureParametersOrPacketCaptureResultProperties

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

Kısıtlama -ları:
En düşük değer = 0
En yüksek değer = 4294967295
captureSettings (YakalamaAyarları) Yakalama ayarı 'FileCount', 'FileSizeInBytes', 'SessionTimeLimitInSeconds' değerlerini tutar. PacketCaptureSettings
continuousCapture (sürekliYakalama) Bu sürekli yakalama, 'null', 'true' veya 'false' değerini tutabilen null atanabilir bir boole değeridir. Bu parametreyi geçirmezsek , 'null' olarak kabul edilir, varsayılan değer 'null' olur. Bool
Filtre Paket yakalama filtrelerinin listesi. PacketCaptureFilter[]
kapsam 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 (Depolama) 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)
hedef türü Sağlanan kaynağın hedef türü. 'AzureVM'
'AzureVMSS'
timeLimitInSeconds Yakalama oturumunun saniye cinsinden en uzun süresi. Int

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

Kısıtlama -ları:
En düşük değer = 0
En yüksek değer = 4294967295

PacketCaptureSettings (Paket Yakalama Ayarları)

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

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

Kısıtlama -ları:
En düşük değer = 0
En yüksek değer = 4294967295
sessionTimeLimitInSeconds Bir dosya için yakalama oturumunun saniye cinsinden süresi en fazla 604800s (7 gün) olur. İkinci 86400'lerde (1 gün) varsayılan değer. Int

Kısıtlama -ları:
En düşük değer = 0
Maksimum değer = 604800

PacketCaptureStorageLocation

Ad Açıklama Değer
filePath (dosya Yolu) 'Sürekli Yakalama' 'true' veya 'false' ile sağlanırsa 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şlamalıdır. Depolama kimliği sağlanmadıysa gereklidir, aksi takdirde isteğe bağlıdır. dizgi
yerel Yol Bu yol, 'Sürekli Yakalama' 'true' veya 'false' ile sağlanmışsa geçerlidir ve depolama kimliği sağlanmadıysa 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. dizgi
storageId Paket yakalama oturumunu kaydetmek için depolama hesabının kimliği. LocalPath veya filePath sağlanmadıysa gereklidir. dizgi
storagePath (depolama Yolu) Paket yakalamayı kaydetmek için depolama yolunun URI'sini. Paket yakalamanın kaydedilileceği konumu açıklayan iyi biçimlendirilmiş bir URI olmalıdır. dizgi

Kullanım Örnekleri

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@2024-07-01"
  name = "string"
  parent_id = "string"
  body = {
    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

Microsoft.Network/networkWatchers/packetCaptures

Ad Açıklama Değer
ad Kaynak adı dize (gerekli)
ebeveyn_kimlik Bu kaynağın üst öğesi olan kaynağın kimliği. Tür kaynağı kimliği: networkWatchers
Özellikler Paket yakalamanın özellikleri. PacketCaptureParametersOrPacketCaptureResultProperties (gerekli)
tür Kaynak türü "Microsoft.Network/networkWatchers/packetCaptures@2024-07-01"

PacketCaptureFilter (Paket Yakalama Filtresi)

Ad Açıklama Değer
localIPAddress Filtrelenecek yerel IP Adresi. Gösterimi: 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. dizgi
yerelPort Filtrelenecek yerel bağlantı noktası. Gösterimi: Tek bağlantı noktası girişi için "80"." Aralık için 80-85 inç. "80; 443;" birden çok girdi için. Şu anda desteklenmeyen birden çok aralık. Şu anda desteklenmeyen birden çok girişle aralıkları karıştırma. Varsayılan = null. dizgi
protokol Filtrelenecek protokol. 'Herhangi biri'
'TCP'
'UDP'
remoteIPAddress Filtrelenecek yerel IP Adresi. Gösterimi: 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. dizgi
uzak bağlantı noktası Filtrelenecek uzak bağlantı noktası. Gösterimi: Tek bağlantı noktası girişi için "80"." Aralık için 80-85 inç. "80; 443;" birden çok girdi için. Şu anda desteklenmeyen birden çok aralık. Şu anda desteklenmeyen birden çok girişle aralıkları karıştırma. Varsayılan = null. dizgi

PacketCaptureMachineScope

Ad Açıklama Değer
Dışlamak AzureVMSS'nin paket yakalamayı çalıştırmasının dışında tutulması gereken AzureVMSS örneklerinin listesi. dize[]
kapsamak Paket yakalamanın çalıştırılacak AzureVMSS örneklerinin listesi. dize[]

PacketCaptureParametersOrPacketCaptureResultProperties

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

Kısıtlama -ları:
En düşük değer = 0
En yüksek değer = 4294967295
captureSettings (YakalamaAyarları) Yakalama ayarı 'FileCount', 'FileSizeInBytes', 'SessionTimeLimitInSeconds' değerlerini tutar. PacketCaptureSettings
continuousCapture (sürekliYakalama) Bu sürekli yakalama, 'null', 'true' veya 'false' değerini tutabilen null atanabilir bir boole değeridir. Bu parametreyi geçirmezsek , 'null' olarak kabul edilir, varsayılan değer 'null' olur. Bool
Filtre Paket yakalama filtrelerinin listesi. PacketCaptureFilter[]
kapsam 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 (Depolama) 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)
hedef türü Sağlanan kaynağın hedef türü. 'AzureVM'
'AzureVMSS'
timeLimitInSeconds Yakalama oturumunun saniye cinsinden en uzun süresi. Int

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

Kısıtlama -ları:
En düşük değer = 0
En yüksek değer = 4294967295

PacketCaptureSettings (Paket Yakalama Ayarları)

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

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

Kısıtlama -ları:
En düşük değer = 0
En yüksek değer = 4294967295
sessionTimeLimitInSeconds Bir dosya için yakalama oturumunun saniye cinsinden süresi en fazla 604800s (7 gün) olur. İkinci 86400'lerde (1 gün) varsayılan değer. Int

Kısıtlama -ları:
En düşük değer = 0
Maksimum değer = 604800

PacketCaptureStorageLocation

Ad Açıklama Değer
filePath (dosya Yolu) 'Sürekli Yakalama' 'true' veya 'false' ile sağlanırsa 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şlamalıdır. Depolama kimliği sağlanmadıysa gereklidir, aksi takdirde isteğe bağlıdır. dizgi
yerel Yol Bu yol, 'Sürekli Yakalama' 'true' veya 'false' ile sağlanmışsa geçerlidir ve depolama kimliği sağlanmadıysa 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. dizgi
storageId Paket yakalama oturumunu kaydetmek için depolama hesabının kimliği. LocalPath veya filePath sağlanmadıysa gereklidir. dizgi
storagePath (depolama Yolu) Paket yakalamayı kaydetmek için depolama yolunun URI'sini. Paket yakalamanın kaydedilileceği konumu açıklayan iyi biçimlendirilmiş bir URI olmalıdır. dizgi