다음을 통해 공유


Microsoft.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'
  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
  }
}

속성 값

Microsoft.Network/networkWatchers/packetCaptures

이름 묘사
이름 리소스 이름 string(필수)
부모 Bicep에서 자식 리소스에 대한 부모 리소스를 지정할 수 있습니다. 자식 리소스가 부모 리소스 외부에서 선언된 경우에만 이 속성을 추가해야 합니다.

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

PacketCaptureFilter

이름 묘사
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입니다. 문자열
프로토콜 필터링할 프로토콜입니다. '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입니다. 문자열
remotePort 필터링할 원격 포트입니다. 표기법: 단일 포트 항목의 경우 "80"입니다." 범위의 경우 80-85"입니다. "80; 여러 항목의 경우 443;"입니다. 현재 지원되지 않는 여러 범위입니다. 현재 지원되지 않는 여러 항목과 범위를 혼합합니다. 기본값 = null입니다. 문자열

PacketCaptureMachineScope

이름 묘사
몰아내다 AzureVMSS에서 패킷 캡처 실행에서 제외해야 하는 AzureVMSS 인스턴스 목록입니다. string[]
포함하다 패킷 캡처를 실행할 AzureVMSS 인스턴스 목록입니다. string[]

PacketCaptureParametersOrPacketCaptureResultProperties

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

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

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

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

PacketCaptureSettings

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

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

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

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

PacketCaptureStorageLocation

이름 묘사
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"
  }
}

속성 값

Microsoft.Network/networkWatchers/packetCaptures

이름 묘사
apiVersion api 버전 '2023-11-01'
이름 리소스 이름 string(필수)
속성 패킷 캡처의 속성입니다. PacketCaptureParametersOrPacketCaptureResultProperties(필수)
리소스 종류 'Microsoft.Network/networkWatchers/packetCaptures'

PacketCaptureFilter

이름 묘사
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입니다. 문자열
프로토콜 필터링할 프로토콜입니다. '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입니다. 문자열
remotePort 필터링할 원격 포트입니다. 표기법: 단일 포트 항목의 경우 "80"입니다." 범위의 경우 80-85"입니다. "80; 여러 항목의 경우 443;"입니다. 현재 지원되지 않는 여러 범위입니다. 현재 지원되지 않는 여러 항목과 범위를 혼합합니다. 기본값 = null입니다. 문자열

PacketCaptureMachineScope

이름 묘사
몰아내다 AzureVMSS에서 패킷 캡처 실행에서 제외해야 하는 AzureVMSS 인스턴스 목록입니다. string[]
포함하다 패킷 캡처를 실행할 AzureVMSS 인스턴스 목록입니다. string[]

PacketCaptureParametersOrPacketCaptureResultProperties

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

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

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

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

PacketCaptureSettings

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

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

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

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

PacketCaptureStorageLocation

이름 묘사
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"
  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
    }
  })
}

속성 값

Microsoft.Network/networkWatchers/packetCaptures

이름 묘사
이름 리소스 이름 string(필수)
parent_id 이 리소스의 부모인 리소스의 ID입니다. 유형의 리소스 ID: networkWatchers
속성 패킷 캡처의 속성입니다. PacketCaptureParametersOrPacketCaptureResultProperties(필수)
리소스 종류 "Microsoft.Network/networkWatchers/packetCaptures@2023-11-01"

PacketCaptureFilter

이름 묘사
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입니다. 문자열
프로토콜 필터링할 프로토콜입니다. '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입니다. 문자열
remotePort 필터링할 원격 포트입니다. 표기법: 단일 포트 항목의 경우 "80"입니다." 범위의 경우 80-85"입니다. "80; 여러 항목의 경우 443;"입니다. 현재 지원되지 않는 여러 범위입니다. 현재 지원되지 않는 여러 항목과 범위를 혼합합니다. 기본값 = null입니다. 문자열

PacketCaptureMachineScope

이름 묘사
몰아내다 AzureVMSS에서 패킷 캡처 실행에서 제외해야 하는 AzureVMSS 인스턴스 목록입니다. string[]
포함하다 패킷 캡처를 실행할 AzureVMSS 인스턴스 목록입니다. string[]

PacketCaptureParametersOrPacketCaptureResultProperties

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

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

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

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

PacketCaptureSettings

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

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

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

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

PacketCaptureStorageLocation

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