Microsoft.Network networkWatchers/packetCaptures 2023-04-01
Definición de recursos de Bicep
El tipo de recurso networkWatchers/packetCaptures se puede implementar con operaciones destinadas a:
- Grupos de recursos: consulte los comandos de implementación del grupo de recursos.
Para obtener una lista de las propiedades modificadas en cada versión de api, consulte registro de cambios.
Formato de los recursos
Para crear un recurso Microsoft.Network/networkWatchers/packetCaptures, agregue el siguiente bicep a la plantilla.
resource symbolicname 'Microsoft.Network/networkWatchers/packetCaptures@2023-04-01' = {
name: 'string'
parent: resourceSymbolicName
properties: {
bytesToCapturePerPacket: int
filters: [
{
localIPAddress: 'string'
localPort: 'string'
protocol: 'string'
remoteIPAddress: 'string'
remotePort: 'string'
}
]
scope: {
exclude: [
'string'
]
include: [
'string'
]
}
storageLocation: {
filePath: 'string'
storageId: 'string'
storagePath: 'string'
}
target: 'string'
targetType: 'string'
timeLimitInSeconds: int
totalBytesPerSession: int
}
}
Valores de propiedad
networkWatchers/packetCaptures
Nombre | Descripción | Value |
---|---|---|
name | El nombre del recurso Vea cómo establecer nombres y tipos para recursos secundarios en Bicep. |
string (obligatorio) |
primario | 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 más información, consulte Recurso secundario fuera del recurso primario. |
Nombre simbólico del recurso de tipo: networkWatchers |
properties | Propiedades de la captura de paquetes. | PacketCaptureParametersOrPacketCaptureResultProperti... (obligatorio) |
PacketCaptureParametersOrPacketCaptureResultProperti...
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 |
filters | Lista de filtros de captura de paquetes. | PacketCaptureFilter[] |
scope | 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) |
Destino | 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 |
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 intervalo. "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. | string |
localPort | Puerto local en el que se va a filtrar. Notación: "80" para la entrada de puerto único". 80-85" para el rango. "80; 443;" para varias entradas. Actualmente no se admiten varios intervalos. Actualmente no se admite la combinación de rangos con varias entradas. Default = null. | string |
protocol | Protocolo en el que se va a filtrar. | "Cualquiera" '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 rangos con varias entradas. Default = null. | string |
remotePort | Puerto remoto en el que se va a filtrar. Notación: "80" para una 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 rangos con varias entradas. Default = null. | string |
PacketCaptureMachineScope
Nombre | Descripción | Valor |
---|---|---|
exclude | Lista de instancias de AzureVMSS que se deben excluir de AzureVMSS de la captura de paquetes en ejecución. | string[] |
include | Lista de instancias de AzureVMSS en las que ejecutar la captura de paquetes. | string[] |
PacketCaptureStorageLocation
Nombre | Descripción | Valor |
---|---|---|
filePath | 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 empezar con /var/captures. Obligatorio si no se proporciona ningún identificador de almacenamiento; de lo contrario, es opcional. | string |
storageId | Identificador de la cuenta de almacenamiento para guardar la sesión de captura de paquetes. Obligatorio si no se proporciona ninguna ruta de acceso de archivo local. | string |
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. | string |
Definición de recursos de plantilla de ARM
El tipo de recurso networkWatchers/packetCaptures se puede implementar con operaciones destinadas a:
- Grupos de recursos: consulte los comandos de implementación del grupo de recursos.
Para obtener una lista de las propiedades modificadas en cada versión de API, consulte registro de cambios.
Formato de los recursos
Para crear un recurso Microsoft.Network/networkWatchers/packetCaptures, agregue el siguiente json a la plantilla.
{
"type": "Microsoft.Network/networkWatchers/packetCaptures",
"apiVersion": "2023-04-01",
"name": "string",
"properties": {
"bytesToCapturePerPacket": "int",
"filters": [
{
"localIPAddress": "string",
"localPort": "string",
"protocol": "string",
"remoteIPAddress": "string",
"remotePort": "string"
}
],
"scope": {
"exclude": [ "string" ],
"include": [ "string" ]
},
"storageLocation": {
"filePath": "string",
"storageId": "string",
"storagePath": "string"
},
"target": "string",
"targetType": "string",
"timeLimitInSeconds": "int",
"totalBytesPerSession": "int"
}
}
Valores de propiedad
networkWatchers/packetCaptures
Nombre | Descripción | Value |
---|---|---|
type | Tipo de recurso | 'Microsoft.Network/networkWatchers/packetCaptures' |
apiVersion | La versión de la API de recursos | '2023-04-01' |
name | El nombre del recurso Vea cómo establecer nombres y tipos para recursos secundarios en plantillas de ARM JSON. |
string (obligatorio) |
properties | Propiedades de la captura de paquetes. | PacketCaptureParametersOrPacketCaptureResultProperti... (obligatorio) |
PacketCaptureParametersOrPacketCaptureResultProperti...
Nombre | Descripción | Valor |
---|---|---|
bytesToCapturePerPacket | Número de bytes capturados por paquete, los bytes restantes se truncan. | int Restricciones: Valor mínimo = 0 Valor máximo = 4294967295 |
filters | Una lista de filtros de captura de paquetes. | PacketCaptureFilter[] |
scope | 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) |
Destino | 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 |
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 rangos con varias entradas. Default = null. | string |
localPort | Puerto local en el que se va a filtrar. Notación: "80" para una 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 rangos con varias entradas. Default = null. | string |
protocol | Protocolo en el que se va a filtrar. | "Cualquiera" '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 rangos con varias entradas. Default = null. | string |
remotePort | Puerto remoto en el que se va a filtrar. Notación: "80" para una 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 rangos con varias entradas. Default = null. | string |
PacketCaptureMachineScope
Nombre | Descripción | Valor |
---|---|---|
exclude | Lista de instancias de AzureVMSS que se deben excluir de AzureVMSS de la captura de paquetes en ejecución. | string[] |
include | Lista de instancias de AzureVMSS en las que ejecutar la captura de paquetes. | string[] |
PacketCaptureStorageLocation
Nombre | Descripción | Valor |
---|---|---|
filePath | 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 empezar con /var/captures. Obligatorio si no se proporciona ningún identificador de almacenamiento; de lo contrario, es opcional. | string |
storageId | Identificador de la cuenta de almacenamiento para guardar la sesión de captura de paquetes. Obligatorio si no se proporciona ninguna ruta de acceso de archivo local. | string |
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. | string |
Definición de recursos de Terraform (proveedor AzAPI)
El tipo de recurso networkWatchers/packetCaptures se puede implementar con operaciones destinadas a:
- Grupos de recursos
Para obtener una lista de las propiedades modificadas en cada versión de API, consulte registro de cambios.
Formato de los recursos
Para crear un recurso Microsoft.Network/networkWatchers/packetCaptures, agregue el siguiente terraform a la plantilla.
resource "azapi_resource" "symbolicname" {
type = "Microsoft.Network/networkWatchers/packetCaptures@2023-04-01"
name = "string"
parent_id = "string"
body = jsonencode({
properties = {
bytesToCapturePerPacket = int
filters = [
{
localIPAddress = "string"
localPort = "string"
protocol = "string"
remoteIPAddress = "string"
remotePort = "string"
}
]
scope = {
exclude = [
"string"
]
include = [
"string"
]
}
storageLocation = {
filePath = "string"
storageId = "string"
storagePath = "string"
}
target = "string"
targetType = "string"
timeLimitInSeconds = int
totalBytesPerSession = int
}
})
}
Valores de propiedad
networkWatchers/packetCaptures
Nombre | Descripción | Value |
---|---|---|
type | Tipo de recurso | "Microsoft.Network/networkWatchers/packetCaptures@2023-04-01" |
name | 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 |
properties | Propiedades de la captura de paquetes. | PacketCaptureParametersOrPacketCaptureResultProperti... (obligatorio) |
PacketCaptureParametersOrPacketCaptureResultProperti...
Nombre | Descripción | Valor |
---|---|---|
bytesToCapturePerPacket | Número de bytes capturados por paquete, los bytes restantes se truncan. | int Restricciones: Valor mínimo = 0 Valor máximo = 4294967295 |
filters | Una lista de filtros de captura de paquetes. | PacketCaptureFilter[] |
scope | 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) |
Destino | 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 |
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 rangos con varias entradas. Default = null. | string |
localPort | Puerto local en el que se va a filtrar. Notación: "80" para una 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 rangos con varias entradas. Default = null. | string |
protocol | Protocolo en el que se va a filtrar. | "Cualquiera" "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 rangos con varias entradas. Default = null. | string |
remotePort | Puerto remoto en el que se va a filtrar. Notación: "80" para una 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 rangos con varias entradas. Default = null. | string |
PacketCaptureMachineScope
Nombre | Descripción | Valor |
---|---|---|
exclude | Lista de instancias de AzureVMSS que se deben excluir de AzureVMSS de la captura de paquetes en ejecución. | string[] |
include | Lista de instancias de AzureVMSS en las que ejecutar la captura de paquetes. | string[] |
PacketCaptureStorageLocation
Nombre | Descripción | Valor |
---|---|---|
filePath | 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 empezar con /var/captures. Obligatorio si no se proporciona ningún identificador de almacenamiento; de lo contrario, es opcional. | string |
storageId | Identificador de la cuenta de almacenamiento para guardar la sesión de captura de paquetes. Obligatorio si no se proporciona ninguna ruta de acceso de archivo local. | string |
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. | string |
Comentarios
https://aka.ms/ContentUserFeedback.
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea:Enviar y ver comentarios de