Compartir a través de

Flow Logs - Get

  • Referencia
Servicio:
Network Watcher
Versión de la API:
2024-05-01

Obtiene un recurso de registro de flujo por nombre.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/networkWatchers/{networkWatcherName}/flowLogs/{flowLogName}?api-version=2024-05-01

Parámetros de identificador URI

Nombre En Requerido Tipo Description
flowLogName
 path True

string

Nombre del recurso de registro de flujo.
networkWatcherName
 path True

string

Nombre del monitor de red.
resourceGroupName
 path True

string

Nombre del grupo de recursos.
subscriptionId
 path True

string

Credenciales de suscripción que identifican de forma única la suscripción de Microsoft Azure. El identificador de suscripción forma parte del URI de cada llamada de servicio.
api-version
 query True

string

Versión de la API de cliente.

Respuestas

Nombre Tipo Description
200 OK

FlowLog

Solicitud correcta. La operación devuelve un recurso de registro de flujo.
Other Status Codes

ErrorResponse

Respuesta de error que describe por qué se produjo un error en la operación.

Seguridad

azure_auth

Flujo de OAuth2 de Azure Active Directory.

Tipo: oauth2
Flujo: implicit
Dirección URL de autorización: https://login.microsoftonline.com/common/oauth2/authorize

Ámbitos

Nombre Description
user_impersonation suplantar la cuenta de usuario

Ejemplos

Get flow log

Solicitud de ejemplo

GET https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/networkWatchers/nw1/flowLogs/flowLog1?api-version=2024-05-01

Respuesta de muestra

status code:
200 
{
  "name": "flowLog1",
  "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/networkWatchers/тц1/FlowLogs/flowLog1",
  "etag": "W/\"00000000-0000-0000-0000-000000000000\"",
  "properties": {
    "provisioningState": "Succeeded",
    "targetResourceId": "/subscriptions/subid/resourceGroups/rg/providers/Microsoft.Network/networkSecurityGroups/vm5-nsg",
    "targetResourceGuid": "00000000-0000-0000-0000-000000000000",
    "storageId": "/subscriptions/subid/resourceGroups/rg/providers/Microsoft.Storage/storageAccounts/wzstorage002",
    "enabledFilteringCriteria": "srcIP=158.255.7.8 || dstPort=56891",
    "enabled": true,
    "flowAnalyticsConfiguration": {
      "networkWatcherFlowAnalyticsConfiguration": {
        "enabled": false,
        "workspaceId": "-",
        "workspaceRegion": "-",
        "trafficAnalyticsInterval": 60
      }
    },
    "retentionPolicy": {
      "days": 0,
      "enabled": false
    },
    "format": {
      "type": "JSON",
      "version": 2
    }
  },
  "location": "centraluseuap",
  "type": "Microsoft.Network/networkWatchers/FlowLogs",
  "identity": {
    "type": "UserAssigned",
    "userAssignedIdentities": {
      "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ManagedIdentity/userAssignedIdentities/id1": {
        "clientId": "c16d15e1-f60a-40e4-8a05-df3d3f655c14",
        "principalId": "e3858881-e40c-43bd-9cde-88da39c05023"
      }
    }
  }
}

Definiciones

Nombre Description
ErrorDetails

Representación de detalles de error comunes.
ErrorResponse

Objeto de error.
FlowLog

Un recurso de registro de flujo.
FlowLogFormatParameters

Parámetros que definen el formato del registro de flujo.
FlowLogFormatType

Tipo de archivo del registro de flujo.
ManagedServiceIdentity

Identidad del recurso.
ProvisioningState

Estado de aprovisionamiento actual.
ResourceIdentityType

Tipo de identidad que se usa para el recurso. El tipo "SystemAssigned, UserAssigned" incluye una identidad creada implícitamente y un conjunto de identidades asignadas por el usuario. El tipo "None" quitará las identidades de la máquina virtual.
RetentionPolicyParameters

Parámetros que definen la directiva de retención para el registro de flujo.
TrafficAnalyticsConfigurationProperties

Parámetros que definen la configuración del análisis de tráfico.
TrafficAnalyticsProperties

Parámetros que definen la configuración del análisis de tráfico.
UserAssignedIdentities

Lista de identidades de usuario asociadas al recurso. Las referencias de clave de diccionario de identidad de usuario serán identificadores de recursos de ARM con el formato: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'.

ErrorDetails

Representación de detalles de error comunes.

Nombre Tipo Description
code

string

Código de error.
message

string

Mensaje de error.
target

string

Destino de error.

ErrorResponse

Objeto de error.

Nombre Tipo Description
error

ErrorDetails

Error
Objeto de detalles del error.

FlowLog

Un recurso de registro de flujo.

Nombre Tipo Description
etag

string

Cadena de solo lectura única que cambia cada vez que se actualiza el recurso.
id

string

Identificador de recurso.
identity

ManagedServiceIdentity

Identidad administrada del recurso FlowLog
location

string

Ubicación del recurso.
name

string

Nombre del recurso.
properties.enabled

boolean

Marca para habilitar o deshabilitar el registro de flujo.
properties.enabledFilteringCriteria

string

Campo opcional para filtrar los registros de tráfico de red en función de SrcIP, SrcPort, DstIP, DstPort, Protocolo, Cifrado, Dirección y Acción. Si no se especifica, se registrará todo el tráfico de red.
properties.flowAnalyticsConfiguration

TrafficAnalyticsProperties

Parámetros que definen la configuración del análisis de tráfico.
properties.format

FlowLogFormatParameters

Parámetros que definen el formato del registro de flujo.
properties.provisioningState

ProvisioningState

Estado de aprovisionamiento del registro de flujo.
properties.retentionPolicy

RetentionPolicyParameters

Parámetros que definen la directiva de retención para el registro de flujo.
properties.storageId

string

Identificador de la cuenta de almacenamiento que se usa para almacenar el registro de flujo.
properties.targetResourceGuid

string

Guid del grupo de seguridad de red al que se aplicará el registro de flujo.
properties.targetResourceId

string

Identificador del grupo de seguridad de red al que se aplicará el registro de flujo.
tags

object

Etiquetas de recursos.
type

string

Tipo de recurso.

FlowLogFormatParameters

Parámetros que definen el formato del registro de flujo.

Nombre Tipo Valor predeterminado Description
type

FlowLogFormatType

Tipo de archivo del registro de flujo.
version

integer

0

Versión (revisión) del registro de flujo.

FlowLogFormatType

Tipo de archivo del registro de flujo.

Nombre Tipo Description
JSON

string

ManagedServiceIdentity

Identidad del recurso.

Nombre Tipo Description
principalId

string

Identificador de entidad de seguridad de la identidad asignada por el sistema. Esta propiedad solo se proporcionará para una identidad asignada por el sistema.
tenantId

string

Identificador de inquilino de la identidad asignada por el sistema. Esta propiedad solo se proporcionará para una identidad asignada por el sistema.
type

ResourceIdentityType

Tipo de identidad que se usa para el recurso. El tipo "SystemAssigned, UserAssigned" incluye una identidad creada implícitamente y un conjunto de identidades asignadas por el usuario. El tipo "None" quitará las identidades de la máquina virtual.
userAssignedIdentities

UserAssignedIdentities

Lista de identidades de usuario asociadas al recurso. Las referencias de clave de diccionario de identidad de usuario serán identificadores de recursos de ARM con el formato: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'.

ProvisioningState

Estado de aprovisionamiento actual.

Nombre Tipo Description
Deleting

string

Failed

string

Succeeded

string

Updating

string

ResourceIdentityType

Tipo de identidad que se usa para el recurso. El tipo "SystemAssigned, UserAssigned" incluye una identidad creada implícitamente y un conjunto de identidades asignadas por el usuario. El tipo "None" quitará las identidades de la máquina virtual.

Nombre Tipo Description
None

string

SystemAssigned

string

SystemAssigned, UserAssigned

string

UserAssigned

string

RetentionPolicyParameters

Parámetros que definen la directiva de retención para el registro de flujo.

Nombre Tipo Valor predeterminado Description
days

integer

0

Número de días para conservar los registros de flujo.
enabled

boolean

False

Marca para habilitar o deshabilitar la retención.

TrafficAnalyticsConfigurationProperties

Parámetros que definen la configuración del análisis de tráfico.

Nombre Tipo Description
enabled

boolean

Marca para habilitar o deshabilitar el análisis de tráfico.
trafficAnalyticsInterval

integer

Intervalo en minutos que decidiría la frecuencia con la que el servicio TA debería realizar análisis de flujo.
workspaceId

string

Guid de recurso del área de trabajo adjunta.
workspaceRegion

string

Ubicación del área de trabajo adjunta.
workspaceResourceId

string

Identificador de recurso del área de trabajo adjunta.

TrafficAnalyticsProperties

Parámetros que definen la configuración del análisis de tráfico.

Nombre Tipo Description
networkWatcherFlowAnalyticsConfiguration

TrafficAnalyticsConfigurationProperties

Parámetros que definen la configuración del análisis de tráfico.

UserAssignedIdentities

Lista de identidades de usuario asociadas al recurso. Las referencias de clave de diccionario de identidad de usuario serán identificadores de recursos de ARM con el formato: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'.

Nombre Tipo Description