다음을 통해 공유


Microsoft.Network networkWatchers/packetCaptures 2023-11-01

Bicep 리소스 정의

networkWatchers/packetCaptures 리소스 종류는 다음을 대상으로 하는 작업을 사용하여 배포할 수 있습니다.

각 API 버전에서 변경된 속성 목록은 변경 로그를 참조하세요.

리소스 형식

Microsoft.Network/networkWatchers/packetCaptures 리소스를 만들려면 템플릿에 다음 Bicep을 추가합니다.

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
  }
}

속성 값

networkWatchers/packetCaptures

Name Description
name 리소스 이름

Bicep에서 자식 리소스의 이름과 형식을 설정하는 방법을 참조하세요.
string(필수)
부모(parent) Bicep에서 자식 리소스에 대한 부모 리소스를 지정할 수 있습니다. 자식 리소스가 부모 리소스 외부에서 선언된 경우에만 이 속성을 추가하면 됩니다.

자세한 내용은 부모 리소스 외부의 자식 리소스를 참조하세요.
형식의 리소스에 대한 기호화된 이름: networkWatchers
properties 패킷 캡처의 속성입니다. PacketCaptureParametersOrPacketCaptureResultProperti... (필수)

PacketCaptureParametersOrPacketCaptureResultProperti...

Name Description
bytesToCapturePerPacket 패킷당 캡처된 바이트 수이며 나머지 바이트는 잘립니다. int

제약 조건:
최소값 = 0
최대값 = 4294967295
captureSettings 캡처 설정에는 'FileCount', 'FileSizeInBytes', 'SessionTimeLimitInSeconds' 값이 있습니다. PacketCaptureSettings
continuousCapture 이 연속 캡처는 'null', 'true' 또는 'false' 값을 보유할 수 있는 null 허용 부울입니다. 이 매개 변수를 전달하지 않으면 'null'로 간주되고 기본값은 'null'입니다. bool
filters 패킷 캡처 필터 목록입니다. PacketCaptureFilter[]
scope 패킷 캡처를 실행하기 위해 포함하거나 제외할 수 있는 AzureVMSS 인스턴스 목록입니다. 포함된 인스턴스와 제외된 항목이 모두 비어 있으면 AzureVMSS의 모든 인스턴스에서 패킷 캡처가 실행됩니다. PacketCaptureMachineScope
storageLocation 패킷 캡처 세션의 스토리지 위치입니다. PacketCaptureStorageLocation (필수)
대상 대상 리소스의 ID이며, 대상 유형인 AzureVM 및 AzureVMSS만 현재 지원됩니다. string(필수)
targetType 제공된 리소스의 대상 유형입니다. 'AzureVM'
'AzureVMSS'
timeLimitInSeconds 캡처 세션의 최대 기간(초)입니다. int

제약 조건:
최소값 = 0
최대값 = 18000
totalBytesPerSession 캡처 출력의 최대 크기입니다. int

제약 조건:
최소값 = 0
최대값 = 4294967295

PacketCaptureSettings

Name Description
fileCount 파일 수입니다. 개수의 기본값은 10이고 최대 수는 10000입니다. int

제약 조건:
최소값 = 0
최대값 = 10000
fileSizeInBytes 패킷당 캡처된 바이트 수입니다. 기본값(바이트 104857600(100MB) 및 최대 바이트 4294967295(4GB)입니다. int

제약 조건:
최소값 = 0
최대값 = 4294967295
sessionTimeLimitInSeconds 캡처 세션의 최대 시간(초)은 파일의 경우 604800s(7일)입니다. 두 번째 86400s(1일)의 기본값입니다. int

제약 조건:
최소값 = 0
최대값 = 604800

PacketCaptureFilter

Name Description
localIPAddress 필터링할 로컬 IP 주소입니다. 표기법: 단일 주소 항목의 경우 "127.0.0.1"입니다. 범위의 경우 "127.0.0.1-127.0.0.255"입니다. "127.0.0.1; 127.0.0.5"? 여러 항목에 대한 입니다. 현재 지원되지 않는 여러 범위입니다. 현재 지원되지 않는 여러 항목과 범위를 혼합합니다. 기본값 = null입니다. 문자열
localPort 필터링할 로컬 포트입니다. 표기법: 단일 포트 항목의 경우 "80"입니다." 범위의 경우 80-85"입니다. "80; 여러 항목의 경우 443;"입니다. 현재 지원되지 않는 여러 범위입니다. 현재 지원되지 않는 여러 항목과 범위를 혼합합니다. 기본값 = null입니다. 문자열
protocol 필터링할 프로토콜입니다. 'Any'
'TCP'
'UDP'
remoteIPAddress 필터링할 로컬 IP 주소입니다. 표기법: 단일 주소 항목의 경우 "127.0.0.1"입니다. 범위의 경우 "127.0.0.1-127.0.0.255"입니다. "127.0.0.1; 여러 항목의 경우 127.0.0.5;"입니다. 현재 지원되지 않는 여러 범위입니다. 현재 지원되지 않는 여러 항목과 범위를 혼합합니다. 기본값 = null입니다. string
remotePort 필터링할 원격 포트입니다. 표기법: 단일 포트 항목의 경우 "80"입니다." 범위의 경우 80-85"입니다. "80; 여러 항목의 경우 443;"입니다. 현재 지원되지 않는 여러 범위입니다. 현재 지원되지 않는 여러 항목과 범위를 혼합합니다. 기본값 = null입니다. 문자열

PacketCaptureMachineScope

Name Description
제외 패킷 캡처 실행에서 AzureVMSS에서 제외해야 하는 AzureVMSS 인스턴스 목록입니다. string[]
include 패킷 캡처를 실행할 AzureVMSS 인스턴스 목록입니다. string[]

PacketCaptureStorageLocation

Name Description
filePath '연속 캡처'가 'true' 또는 'false'와 함께 제공되면 이 경로가 잘못되었습니다. 대상 VM의 유효한 로컬 경로입니다. 캡처 파일의 이름(*.cap)을 포함해야 합니다. Linux 가상 머신의 경우 /var/captures로 시작해야 합니다. 스토리지 ID가 제공되지 않은 경우 필수이고, 그렇지 않으면 선택 사항입니다. 문자열
Localpath 이 경로는 '연속 캡처'가 'true' 또는 'false'와 함께 제공되고 스토리지 ID가 제공되지 않은 경우 필수이고, 그렇지 않으면 선택 사항인 경우 유효합니다. 캡처 파일의 이름(*.cap)을 포함해야 합니다. Linux 가상 머신의 경우 /var/captures로 시작해야 합니다. 문자열
storageId 패킷 캡처 세션을 저장할 스토리지 계정의 ID입니다. localPath 또는 filePath가 제공되지 않은 경우 필수입니다. 문자열
storagePath 패킷 캡처를 저장할 스토리지 경로의 URI입니다. 패킷 캡처를 저장할 위치를 설명하는 올바른 형식의 URI여야 합니다. 문자열

ARM 템플릿 리소스 정의

networkWatchers/packetCaptures 리소스 종류는 다음을 대상으로 하는 작업을 사용하여 배포할 수 있습니다.

각 API 버전에서 변경된 속성 목록은 변경 로그를 참조하세요.

리소스 형식

Microsoft.Network/networkWatchers/packetCaptures 리소스를 만들려면 템플릿에 다음 JSON을 추가합니다.

{
  "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"
  }
}

속성 값

networkWatchers/packetCaptures

Name Description
형식 리소스 종류 'Microsoft.Network/networkWatchers/packetCaptures'
apiVersion 리소스 api 버전 '2023-11-01'
name 리소스 이름

JSON ARM 템플릿에서 자식 리소스의 이름 및 형식을 설정하는 방법을 참조하세요.
string(필수)
properties 패킷 캡처의 속성입니다. PacketCaptureParametersOrPacketCaptureResultProperti... (필수)

PacketCaptureParametersOrPacketCaptureResultProperti...

Name Description
bytesToCapturePerPacket 패킷당 캡처된 바이트 수이며 나머지 바이트는 잘립니다. int

제약 조건:
최소값 = 0
최대값 = 4294967295
captureSettings 캡처 설정에는 'FileCount', 'FileSizeInBytes', 'SessionTimeLimitInSeconds' 값이 있습니다. PacketCaptureSettings
continuousCapture 이 연속 캡처는 'null', 'true' 또는 'false' 값을 보유할 수 있는 null 허용 부울입니다. 이 매개 변수를 전달하지 않으면 'null'으로 간주되고 기본값은 'null'입니다. bool
filters 패킷 캡처 필터 목록입니다. PacketCaptureFilter[]
scope 패킷 캡처를 실행하기 위해 포함하거나 제외할 수 있는 AzureVMSS 인스턴스 목록입니다. 포함된 인스턴스와 제외된 항목이 모두 비어 있으면 패킷 캡처가 AzureVMSS의 모든 인스턴스에서 실행됩니다. PacketCaptureMachineScope
storageLocation 패킷 캡처 세션의 스토리지 위치입니다. PacketCaptureStorageLocation (필수)
대상 대상 리소스의 ID는 현재 대상 형식인 AzureVM 및 AzureVMSS만 지원됩니다. string(필수)
targetType 제공된 리소스의 대상 유형입니다. 'AzureVM'
'AzureVMSS'
timeLimitInSeconds 캡처 세션의 최대 기간(초)입니다. int

제약 조건:
최소값 = 0
최대값 = 18000
totalBytesPerSession 캡처 출력의 최대 크기입니다. int

제약 조건:
최소값 = 0
최대값 = 4294967295

PacketCaptureSettings

Name Description
fileCount 파일 수입니다. 개수의 기본값은 10이고 최대 수는 10000입니다. int

제약 조건:
최소값 = 0
최대값 = 10000
fileSizeInBytes 패킷당 캡처된 바이트 수입니다. 기본값은 바이트 104857600(100MB) 및 최대 바이트 4294967295(4GB)입니다. int

제약 조건:
최소값 = 0
최대값 = 4294967295
sessionTimeLimitInSeconds 캡처 세션의 최대 시간(초)은 파일의 경우 604800s(7일)입니다. 두 번째 86400s(1일)의 기본값입니다. int

제약 조건:
최소값 = 0
최대값 = 604800

PacketCaptureFilter

Name Description
localIPAddress 필터링할 로컬 IP 주소입니다. 표기법: 단일 주소 항목의 경우 "127.0.0.1"입니다. 범위의 경우 "127.0.0.1-127.0.0.255"입니다. "127.0.0.1; 127.0.0.5"? 여러 항목의 경우 현재 지원되지 않는 여러 범위. 현재 지원되지 않는 여러 항목과 범위를 혼합합니다. 기본값 = null입니다. 문자열
localPort 필터링할 로컬 포트입니다. 표기법: 단일 포트 항목의 경우 "80"입니다." 범위의 경우 80-85"입니다. "80; 여러 항목의 경우 443;"입니다. 현재 지원되지 않는 여러 범위입니다. 현재 지원되지 않는 여러 항목과 범위를 혼합합니다. 기본값 = null입니다. 문자열
protocol 필터링할 프로토콜입니다. 'Any'
'TCP'
'UDP'
remoteIPAddress 필터링할 로컬 IP 주소입니다. 표기법: 단일 주소 항목의 경우 "127.0.0.1"입니다. 범위의 경우 "127.0.0.1-127.0.0.255"입니다. "127.0.0.1; 여러 항목의 경우 127.0.0.5;"입니다. 현재 지원되지 않는 여러 범위입니다. 현재 지원되지 않는 여러 항목과 범위를 혼합합니다. 기본값 = null입니다. string
remotePort 필터링할 원격 포트입니다. 표기법: 단일 포트 항목의 경우 "80"입니다." 범위의 경우 80-85"입니다. "80; 여러 항목의 경우 443;"입니다. 현재 지원되지 않는 여러 범위입니다. 현재 지원되지 않는 여러 항목과 범위를 혼합합니다. 기본값 = null입니다. 문자열

PacketCaptureMachineScope

Name Description
제외 패킷 캡처 실행에서 AzureVMSS에서 제외해야 하는 AzureVMSS 인스턴스 목록입니다. string[]
include 패킷 캡처를 실행할 AzureVMSS 인스턴스 목록입니다. string[]

PacketCaptureStorageLocation

Name Description
filePath '연속 캡처'가 'true' 또는 'false'와 함께 제공되면 이 경로가 잘못되었습니다. 대상 VM의 유효한 로컬 경로입니다. 캡처 파일의 이름(*.cap)을 포함해야 합니다. Linux 가상 머신의 경우 /var/captures로 시작해야 합니다. 스토리지 ID가 제공되지 않은 경우 필수이고, 그렇지 않으면 선택 사항입니다. 문자열
Localpath 이 경로는 '연속 캡처'가 'true' 또는 'false'와 함께 제공되고 스토리지 ID가 제공되지 않은 경우 필수이고, 그렇지 않으면 선택 사항인 경우 유효합니다. 캡처 파일의 이름(*.cap)을 포함해야 합니다. Linux 가상 머신의 경우 /var/captures로 시작해야 합니다. 문자열
storageId 패킷 캡처 세션을 저장할 스토리지 계정의 ID입니다. localPath 또는 filePath가 제공되지 않은 경우 필수입니다. 문자열
storagePath 패킷 캡처를 저장할 스토리지 경로의 URI입니다. 패킷 캡처를 저장할 위치를 설명하는 올바른 형식의 URI여야 합니다. 문자열

Terraform(AzAPI 공급자) 리소스 정의

networkWatchers/packetCaptures 리소스 종류는 다음을 대상으로 하는 작업을 사용하여 배포할 수 있습니다.

  • 리소스 그룹

각 API 버전에서 변경된 속성 목록은 변경 로그를 참조하세요.

리소스 형식

Microsoft.Network/networkWatchers/packetCaptures 리소스를 만들려면 템플릿에 다음 Terraform을 추가합니다.

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
    }
  })
}

속성 값

networkWatchers/packetCaptures

Name Description
형식 리소스 종류 "Microsoft.Network/networkWatchers/packetCaptures@2023-11-01"
name 리소스 이름 string(필수)
parent_id 이 리소스의 부모인 리소스의 ID입니다. 유형의 리소스에 대한 ID: networkWatchers
properties 패킷 캡처의 속성입니다. PacketCaptureParametersOrPacketCaptureResultProperti... (필수)

PacketCaptureParametersOrPacketCaptureResultProperti...

Name Description
bytesToCapturePerPacket 패킷당 캡처된 바이트 수이며 나머지 바이트는 잘립니다. int

제약 조건:
최소값 = 0
최대값 = 4294967295
captureSettings 캡처 설정에는 'FileCount', 'FileSizeInBytes', 'SessionTimeLimitInSeconds' 값이 있습니다. PacketCaptureSettings
continuousCapture 이 연속 캡처는 'null', 'true' 또는 'false' 값을 보유할 수 있는 null 허용 부울입니다. 이 매개 변수를 전달하지 않으면 'null'으로 간주되고 기본값은 'null'입니다. bool
filters 패킷 캡처 필터 목록입니다. PacketCaptureFilter[]
scope 패킷 캡처를 실행하기 위해 포함하거나 제외할 수 있는 AzureVMSS 인스턴스 목록입니다. 포함된 인스턴스와 제외된 항목이 모두 비어 있으면 패킷 캡처가 AzureVMSS의 모든 인스턴스에서 실행됩니다. PacketCaptureMachineScope
storageLocation 패킷 캡처 세션의 스토리지 위치입니다. PacketCaptureStorageLocation (필수)
대상 대상 리소스의 ID는 현재 대상 형식인 AzureVM 및 AzureVMSS만 지원됩니다. string(필수)
targetType 제공된 리소스의 대상 유형입니다. "AzureVM"
"AzureVMSS"
timeLimitInSeconds 캡처 세션의 최대 기간(초)입니다. int

제약 조건:
최소값 = 0
최대값 = 18000
totalBytesPerSession 캡처 출력의 최대 크기입니다. int

제약 조건:
최소값 = 0
최대값 = 4294967295

PacketCaptureSettings

Name Description
fileCount 파일 수입니다. 개수의 기본값은 10이고 최대 수는 10000입니다. int

제약 조건:
최소값 = 0
최대값 = 10000
fileSizeInBytes 패킷당 캡처된 바이트 수입니다. 기본값은 바이트 104857600(100MB) 및 최대 바이트 4294967295(4GB)입니다. int

제약 조건:
최소값 = 0
최대값 = 4294967295
sessionTimeLimitInSeconds 캡처 세션의 최대 시간(초)은 파일의 경우 604800s(7일)입니다. 두 번째 86400s(1일)의 기본값입니다. int

제약 조건:
최소값 = 0
최대값 = 604800

PacketCaptureFilter

Name Description
localIPAddress 필터링할 로컬 IP 주소입니다. 표기법: 단일 주소 항목의 경우 "127.0.0.1"입니다. 범위의 경우 "127.0.0.1-127.0.0.255"입니다. "127.0.0.1; 127.0.0.5"? 여러 항목의 경우 현재 지원되지 않는 여러 범위. 현재 지원되지 않는 여러 항목과 범위를 혼합합니다. 기본값 = null입니다. 문자열
localPort 필터링할 로컬 포트입니다. 표기법: 단일 포트 항목의 경우 "80"입니다." 범위의 경우 80-85"입니다. "80; 여러 항목의 경우 443;"입니다. 현재 지원되지 않는 여러 범위. 현재 지원되지 않는 여러 항목과 범위를 혼합합니다. 기본값 = null입니다. 문자열
protocol 필터링할 프로토콜입니다. "Any"
"TCP"
"UDP"
remoteIPAddress 필터링할 로컬 IP 주소입니다. 표기법: 단일 주소 항목의 경우 "127.0.0.1"입니다. 범위의 경우 "127.0.0.1-127.0.0.255"입니다. "127.0.0.1; 여러 항목의 경우 127.0.0.5;"입니다. 현재 지원되지 않는 여러 범위. 현재 지원되지 않는 여러 항목과 범위를 혼합합니다. 기본값 = null입니다. string
remotePort 필터링할 원격 포트입니다. 표기법: 단일 포트 항목의 경우 "80"입니다." 범위의 경우 80-85"입니다. "80; 여러 항목의 경우 443;"입니다. 현재 지원되지 않는 여러 범위. 현재 지원되지 않는 여러 항목과 범위를 혼합합니다. 기본값 = null입니다. 문자열

PacketCaptureMachineScope

Name Description
제외 패킷 캡처 실행에서 AzureVMSS에서 제외해야 하는 AzureVMSS 인스턴스 목록입니다. string[]
include 패킷 캡처를 실행할 AzureVMSS 인스턴스 목록입니다. string[]

PacketCaptureStorageLocation

Name Description
filePath '연속 캡처'가 'true' 또는 'false'와 함께 제공되는 경우 이 경로가 잘못되었습니다. 대상 VM의 유효한 로컬 경로입니다. 캡처 파일의 이름(*.cap)을 포함해야 합니다. Linux 가상 머신의 경우 /var/captures로 시작해야 합니다. 스토리지 ID가 제공되지 않으면 필수이고, 그렇지 않으면 선택 사항입니다. 문자열
Localpath 이 경로는 '연속 캡처'가 'true' 또는 'false'와 함께 제공되고 스토리지 ID가 제공되지 않은 경우 필요한 경우 유효하며, 그렇지 않으면 선택 사항입니다. 캡처 파일의 이름(*.cap)을 포함해야 합니다. Linux 가상 머신의 경우 /var/captures로 시작해야 합니다. string
storageId 패킷 캡처 세션을 저장할 스토리지 계정의 ID입니다. localPath 또는 filePath가 제공되지 않은 경우 필요합니다. 문자열
storagePath 패킷 캡처를 저장할 스토리지 경로의 URI입니다. 패킷 캡처를 저장할 위치를 설명하는 올바른 형식의 URI여야 합니다. string