Compartir a través de

Microsoft.Network networkWatchers/packetCaptures 2024-03-01

  • Artículo

Definición de recursos de Bicep

El tipo de recurso networkWatchers/packetCaptures se puede implementar con operaciones destinadas a:

Para obtener una lista de las propiedades modificadas en cada versión de API, consulte registro de cambios.

Formato de recurso

Para crear un recurso Microsoft.Network/networkWatchers/packetCaptures, agregue el siguiente bicep a la plantilla.

resource symbolicname 'Microsoft.Network/networkWatchers/packetCaptures@2024-03-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
  }
}

Valores de propiedad

Microsoft.Network/networkWatchers/packetCaptures

Nombre Descripción Valor
nombre El nombre del recurso string (obligatorio)
padre En Bicep, puede especificar el recurso primario para un recurso secundario. Solo tiene que agregar esta propiedad cuando el recurso secundario se declara fuera del recurso primario.

Para obtener más información, consulte recurso secundario fuera del recurso primario.		 Nombre simbólico del recurso de tipo: networkWatchers
Propiedades Propiedades de la captura de paquetes. PacketCaptureParametersOrPacketCaptureResultProperties (obligatorio)

PacketCaptureFilter

Nombre Descripción Valor
localIPAddress Dirección IP local en la que se va a filtrar. Notación: "127.0.0.1" para la entrada de dirección única. "127.0.0.1-127.0.0.255" para el rango. "127.0.0.1; 127.0.0.5"? para varias entradas. Actualmente no se admiten varios intervalos. Actualmente no se admite la combinación de intervalos con varias entradas. Valor predeterminado = null. cuerda
localPort Puerto local en el que se va a filtrar. Notación: "80" para la entrada de puerto único". 80-85" para rango. "80; 443;" para varias entradas. Actualmente no se admiten varios intervalos. Actualmente no se admite la combinación de intervalos con varias entradas. Valor predeterminado = null. cuerda
protocolo Protocolo en el que se va a filtrar. "Any"
'TCP'
'UDP'
remoteIPAddress Dirección IP local en la que se va a filtrar. Notación: "127.0.0.1" para la entrada de dirección única. "127.0.0.1-127.0.0.255" para el rango. "127.0.0.1; 127.0.0.5;" para varias entradas. Actualmente no se admiten varios intervalos. Actualmente no se admite la combinación de intervalos con varias entradas. Valor predeterminado = null. cuerda
remotePort Puerto remoto en el que se va a filtrar. Notación: "80" para la entrada de puerto único". 80-85" para rango. "80; 443;" para varias entradas. Actualmente no se admiten varios intervalos. Actualmente no se admite la combinación de intervalos con varias entradas. Valor predeterminado = null. cuerda

PacketCaptureMachineScope

Nombre Descripción Valor
excluir Lista de instancias de AzureVMSS que se deben excluir de AzureVMSS de la captura de paquetes en ejecución. string[]
incluír Lista de instancias de AzureVMSS en las que ejecutar la captura de paquetes. string[]

PacketCaptureParametersOrPacketCaptureResultProperties

Nombre Descripción Valor
bytesToCapturePerPacket Número de bytes capturados por paquete, se truncan los bytes restantes. Int

Restricciones:
Valor mínimo = 0
Valor máximo = 4294967295
captureSettings La configuración de captura contiene los valores "FileCount", "FileSizeInBytes", "SessionTimeLimitInSeconds". packetCaptureSettings
continuousCapture Esta captura continua es un valor booleano que acepta valores NULL, que puede contener 'null', 'true' o 'false'. Si no se pasa este parámetro, se consideraría como 'null', el valor predeterminado es 'null'. Bool
filtros Una lista de filtros de captura de paquetes. PacketCaptureFilter[]
alcance Lista de instancias de AzureVMSS que se pueden incluir o excluir para ejecutar la captura de paquetes. Si ambos incluidos y excluidos están vacíos, la captura de paquetes se ejecutará en todas las instancias de AzureVMSS. PacketCaptureMachineScope
storageLocation Ubicación de almacenamiento de una sesión de captura de paquetes. PacketCaptureStorageLocation (obligatorio)
blanco El identificador del recurso de destino, actualmente solo se admiten AzureVM y AzureVMSS como tipo de destino. string (obligatorio)
targetType Tipo de destino del recurso proporcionado. "AzureVM"
"AzureVMSS"
timeLimitInSeconds Duración máxima de la sesión de captura en segundos. Int

Restricciones:
Valor mínimo = 0
Valor máximo = 18000
totalBytesPerSession Tamaño máximo de la salida de captura. Int

Restricciones:
Valor mínimo = 0
Valor máximo = 4294967295

PacketCaptureSettings

Nombre Descripción Valor
fileCount Número de recuento de archivos. El valor predeterminado de count es 10 y el número máximo es 10000. Int

Restricciones:
Valor mínimo = 0
Valor máximo = 10000
fileSizeInBytes Número de bytes capturados por paquete. Valor predeterminado en bytes 104857600 (100 MB) y máximo en bytes 4294967295 (4 GB). Int

Restricciones:
Valor mínimo = 0
Valor máximo = 4294967295
sessionTimeLimitInSeconds La duración máxima de la sesión de captura en segundos es de 604800s (7 días) para un archivo. Valor predeterminado en segundo 86400s (1 día). Int

Restricciones:
Valor mínimo = 0
Valor máximo = 604800

PacketCaptureStorageLocation

Nombre Descripción Valor
filePath Esta ruta de acceso no es válida si se proporciona "Captura continua" con "true" o "false". Ruta de acceso local válida en la máquina virtual de destino. Debe incluir el nombre del archivo de captura (*.cap). Para la máquina virtual Linux, debe comenzar con /var/captures. Obligatorio si no se proporciona ningún identificador de almacenamiento; de lo contrario, es opcional. cuerda
localPath Esta ruta de acceso es válida si se proporciona "Captura continua" con "true" o "false" y es necesario si no se proporciona ningún identificador de almacenamiento; de lo contrario, es opcional. Debe incluir el nombre del archivo de captura (*.cap). Para la máquina virtual Linux, debe comenzar con /var/captures. cuerda
storageId Identificador de la cuenta de almacenamiento para guardar la sesión de captura de paquetes. Obligatorio si no se proporciona localPath o filePath. cuerda
storagePath URI de la ruta de acceso de almacenamiento para guardar la captura de paquetes. Debe ser un URI bien formado que describa la ubicación para guardar la captura de paquetes. cuerda

Definición de recursos de plantilla de ARM

El tipo de recurso networkWatchers/packetCaptures se puede implementar con operaciones destinadas a:

Para obtener una lista de las propiedades modificadas en cada versión de API, consulte registro de cambios.

Formato de recurso

Para crear un recurso Microsoft.Network/networkWatchers/packetCaptures, agregue el siguiente JSON a la plantilla.

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

Valores de propiedad

Microsoft.Network/networkWatchers/packetCaptures

Nombre Descripción Valor
apiVersion La versión de api '2024-03-01'
nombre El nombre del recurso string (obligatorio)
Propiedades Propiedades de la captura de paquetes. PacketCaptureParametersOrPacketCaptureResultProperties (obligatorio)
tipo El tipo de recurso 'Microsoft.Network/networkWatchers/packetCaptures'

PacketCaptureFilter

Nombre Descripción Valor
localIPAddress Dirección IP local en la que se va a filtrar. Notación: "127.0.0.1" para la entrada de dirección única. "127.0.0.1-127.0.0.255" para el rango. "127.0.0.1; 127.0.0.5"? para varias entradas. Actualmente no se admiten varios intervalos. Actualmente no se admite la combinación de intervalos con varias entradas. Valor predeterminado = null. cuerda
localPort Puerto local en el que se va a filtrar. Notación: "80" para la entrada de puerto único". 80-85" para rango. "80; 443;" para varias entradas. Actualmente no se admiten varios intervalos. Actualmente no se admite la combinación de intervalos con varias entradas. Valor predeterminado = null. cuerda
protocolo Protocolo en el que se va a filtrar. "Any"
'TCP'
'UDP'
remoteIPAddress Dirección IP local en la que se va a filtrar. Notación: "127.0.0.1" para la entrada de dirección única. "127.0.0.1-127.0.0.255" para el rango. "127.0.0.1; 127.0.0.5;" para varias entradas. Actualmente no se admiten varios intervalos. Actualmente no se admite la combinación de intervalos con varias entradas. Valor predeterminado = null. cuerda
remotePort Puerto remoto en el que se va a filtrar. Notación: "80" para la entrada de puerto único". 80-85" para rango. "80; 443;" para varias entradas. Actualmente no se admiten varios intervalos. Actualmente no se admite la combinación de intervalos con varias entradas. Valor predeterminado = null. cuerda

PacketCaptureMachineScope

Nombre Descripción Valor
excluir Lista de instancias de AzureVMSS que se deben excluir de AzureVMSS de la captura de paquetes en ejecución. string[]
incluír Lista de instancias de AzureVMSS en las que ejecutar la captura de paquetes. string[]

PacketCaptureParametersOrPacketCaptureResultProperties

Nombre Descripción Valor
bytesToCapturePerPacket Número de bytes capturados por paquete, se truncan los bytes restantes. Int

Restricciones:
Valor mínimo = 0
Valor máximo = 4294967295
captureSettings La configuración de captura contiene los valores "FileCount", "FileSizeInBytes", "SessionTimeLimitInSeconds". packetCaptureSettings
continuousCapture Esta captura continua es un valor booleano que acepta valores NULL, que puede contener 'null', 'true' o 'false'. Si no se pasa este parámetro, se consideraría como 'null', el valor predeterminado es 'null'. Bool
filtros Una lista de filtros de captura de paquetes. PacketCaptureFilter[]
alcance Lista de instancias de AzureVMSS que se pueden incluir o excluir para ejecutar la captura de paquetes. Si ambos incluidos y excluidos están vacíos, la captura de paquetes se ejecutará en todas las instancias de AzureVMSS. PacketCaptureMachineScope
storageLocation Ubicación de almacenamiento de una sesión de captura de paquetes. PacketCaptureStorageLocation (obligatorio)
blanco El identificador del recurso de destino, actualmente solo se admiten AzureVM y AzureVMSS como tipo de destino. string (obligatorio)
targetType Tipo de destino del recurso proporcionado. "AzureVM"
"AzureVMSS"
timeLimitInSeconds Duración máxima de la sesión de captura en segundos. Int

Restricciones:
Valor mínimo = 0
Valor máximo = 18000
totalBytesPerSession Tamaño máximo de la salida de captura. Int

Restricciones:
Valor mínimo = 0
Valor máximo = 4294967295

PacketCaptureSettings

Nombre Descripción Valor
fileCount Número de recuento de archivos. El valor predeterminado de count es 10 y el número máximo es 10000. Int

Restricciones:
Valor mínimo = 0
Valor máximo = 10000
fileSizeInBytes Número de bytes capturados por paquete. Valor predeterminado en bytes 104857600 (100 MB) y máximo en bytes 4294967295 (4 GB). Int

Restricciones:
Valor mínimo = 0
Valor máximo = 4294967295
sessionTimeLimitInSeconds La duración máxima de la sesión de captura en segundos es de 604800s (7 días) para un archivo. Valor predeterminado en segundo 86400s (1 día). Int

Restricciones:
Valor mínimo = 0
Valor máximo = 604800

PacketCaptureStorageLocation

Nombre Descripción Valor
filePath Esta ruta de acceso no es válida si se proporciona "Captura continua" con "true" o "false". Ruta de acceso local válida en la máquina virtual de destino. Debe incluir el nombre del archivo de captura (*.cap). Para la máquina virtual Linux, debe comenzar con /var/captures. Obligatorio si no se proporciona ningún identificador de almacenamiento; de lo contrario, es opcional. cuerda
localPath Esta ruta de acceso es válida si se proporciona "Captura continua" con "true" o "false" y es necesario si no se proporciona ningún identificador de almacenamiento; de lo contrario, es opcional. Debe incluir el nombre del archivo de captura (*.cap). Para la máquina virtual Linux, debe comenzar con /var/captures. cuerda
storageId Identificador de la cuenta de almacenamiento para guardar la sesión de captura de paquetes. Obligatorio si no se proporciona localPath o filePath. cuerda
storagePath URI de la ruta de acceso de almacenamiento para guardar la captura de paquetes. Debe ser un URI bien formado que describa la ubicación para guardar la captura de paquetes. cuerda

Definición de recursos de Terraform (proveedor AzAPI)

El tipo de recurso networkWatchers/packetCaptures se puede implementar con operaciones destinadas a:

  • grupos de recursos de

Para obtener una lista de las propiedades modificadas en cada versión de API, consulte registro de cambios.

Formato de recurso

Para crear un recurso Microsoft.Network/networkWatchers/packetCaptures, agregue el siguiente terraform a la plantilla.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Network/networkWatchers/packetCaptures@2024-03-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
    }
  })
}

Valores de propiedad

Microsoft.Network/networkWatchers/packetCaptures

Nombre Descripción Valor
nombre El nombre del recurso string (obligatorio)
parent_id Identificador del recurso que es el elemento primario de este recurso. Identificador del recurso de tipo: networkWatchers
Propiedades Propiedades de la captura de paquetes. PacketCaptureParametersOrPacketCaptureResultProperties (obligatorio)
tipo El tipo de recurso "Microsoft.Network/networkWatchers/packetCaptures@2024-03-01"

PacketCaptureFilter

Nombre Descripción Valor
localIPAddress Dirección IP local en la que se va a filtrar. Notación: "127.0.0.1" para la entrada de dirección única. "127.0.0.1-127.0.0.255" para el rango. "127.0.0.1; 127.0.0.5"? para varias entradas. Actualmente no se admiten varios intervalos. Actualmente no se admite la combinación de intervalos con varias entradas. Valor predeterminado = null. cuerda
localPort Puerto local en el que se va a filtrar. Notación: "80" para la entrada de puerto único". 80-85" para rango. "80; 443;" para varias entradas. Actualmente no se admiten varios intervalos. Actualmente no se admite la combinación de intervalos con varias entradas. Valor predeterminado = null. cuerda
protocolo Protocolo en el que se va a filtrar. "Any"
'TCP'
'UDP'
remoteIPAddress Dirección IP local en la que se va a filtrar. Notación: "127.0.0.1" para la entrada de dirección única. "127.0.0.1-127.0.0.255" para el rango. "127.0.0.1; 127.0.0.5;" para varias entradas. Actualmente no se admiten varios intervalos. Actualmente no se admite la combinación de intervalos con varias entradas. Valor predeterminado = null. cuerda
remotePort Puerto remoto en el que se va a filtrar. Notación: "80" para la entrada de puerto único". 80-85" para rango. "80; 443;" para varias entradas. Actualmente no se admiten varios intervalos. Actualmente no se admite la combinación de intervalos con varias entradas. Valor predeterminado = null. cuerda

PacketCaptureMachineScope

Nombre Descripción Valor
excluir Lista de instancias de AzureVMSS que se deben excluir de AzureVMSS de la captura de paquetes en ejecución. string[]
incluír Lista de instancias de AzureVMSS en las que ejecutar la captura de paquetes. string[]

PacketCaptureParametersOrPacketCaptureResultProperties

Nombre Descripción Valor
bytesToCapturePerPacket Número de bytes capturados por paquete, se truncan los bytes restantes. Int

Restricciones:
Valor mínimo = 0
Valor máximo = 4294967295
captureSettings La configuración de captura contiene los valores "FileCount", "FileSizeInBytes", "SessionTimeLimitInSeconds". packetCaptureSettings
continuousCapture Esta captura continua es un valor booleano que acepta valores NULL, que puede contener 'null', 'true' o 'false'. Si no se pasa este parámetro, se consideraría como 'null', el valor predeterminado es 'null'. Bool
filtros Una lista de filtros de captura de paquetes. PacketCaptureFilter[]
alcance Lista de instancias de AzureVMSS que se pueden incluir o excluir para ejecutar la captura de paquetes. Si ambos incluidos y excluidos están vacíos, la captura de paquetes se ejecutará en todas las instancias de AzureVMSS. PacketCaptureMachineScope
storageLocation Ubicación de almacenamiento de una sesión de captura de paquetes. PacketCaptureStorageLocation (obligatorio)
blanco El identificador del recurso de destino, actualmente solo se admiten AzureVM y AzureVMSS como tipo de destino. string (obligatorio)
targetType Tipo de destino del recurso proporcionado. "AzureVM"
"AzureVMSS"
timeLimitInSeconds Duración máxima de la sesión de captura en segundos. Int

Restricciones:
Valor mínimo = 0
Valor máximo = 18000
totalBytesPerSession Tamaño máximo de la salida de captura. Int

Restricciones:
Valor mínimo = 0
Valor máximo = 4294967295

PacketCaptureSettings

Nombre Descripción Valor
fileCount Número de recuento de archivos. El valor predeterminado de count es 10 y el número máximo es 10000. Int

Restricciones:
Valor mínimo = 0
Valor máximo = 10000
fileSizeInBytes Número de bytes capturados por paquete. Valor predeterminado en bytes 104857600 (100 MB) y máximo en bytes 4294967295 (4 GB). Int

Restricciones:
Valor mínimo = 0
Valor máximo = 4294967295
sessionTimeLimitInSeconds La duración máxima de la sesión de captura en segundos es de 604800s (7 días) para un archivo. Valor predeterminado en segundo 86400s (1 día). Int

Restricciones:
Valor mínimo = 0
Valor máximo = 604800

PacketCaptureStorageLocation

Nombre Descripción Valor
filePath Esta ruta de acceso no es válida si se proporciona "Captura continua" con "true" o "false". Ruta de acceso local válida en la máquina virtual de destino. Debe incluir el nombre del archivo de captura (*.cap). Para la máquina virtual Linux, debe comenzar con /var/captures. Obligatorio si no se proporciona ningún identificador de almacenamiento; de lo contrario, es opcional. cuerda
localPath Esta ruta de acceso es válida si se proporciona "Captura continua" con "true" o "false" y es necesario si no se proporciona ningún identificador de almacenamiento; de lo contrario, es opcional. Debe incluir el nombre del archivo de captura (*.cap). Para la máquina virtual Linux, debe comenzar con /var/captures. cuerda
storageId Identificador de la cuenta de almacenamiento para guardar la sesión de captura de paquetes. Obligatorio si no se proporciona localPath o filePath. cuerda
storagePath URI de la ruta de acceso de almacenamiento para guardar la captura de paquetes. Debe ser un URI bien formado que describa la ubicación para guardar la captura de paquetes. cuerda