Freigeben über


Flow Logs - Create Or Update

Erstellen oder Aktualisieren eines Flussprotokolls für die angegebene Netzwerksicherheitsgruppe.

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

URI-Parameter

Name In Erforderlich Typ Beschreibung
flowLogName
path True

string

Der Name des Flussprotokolls.

networkWatcherName
path True

string

Der Name der Netzwerküberwachung.

resourceGroupName
path True

string

Der Name der Ressourcengruppe.

subscriptionId
path True

string

Die Abonnementanmeldeinformationen, die das Microsoft Azure-Abonnement eindeutig identifizieren. Die Abonnement-ID ist Teil des URI für jeden Dienstaufruf.

api-version
query True

string

Client-API-Version.

Anforderungstext

Name Erforderlich Typ Beschreibung
properties.storageId True

string

ID des Speicherkontos, das zum Speichern des Ablaufprotokolls verwendet wird.

properties.targetResourceId True

string

ID der Netzwerksicherheitsgruppe, auf die das Ablaufprotokoll angewendet wird.

id

string

Ressourcen-ID.

identity

ManagedServiceIdentity

Verwaltete FlowLog-Ressource

location

string

Ressourcenspeicherort.

properties.enabled

boolean

Kennzeichnen, um die Ablaufprotokollierung zu aktivieren/deaktivieren.

properties.enabledFilteringCriteria

string

Optionales Feld zum Filtern von Netzwerkdatenverkehrsprotokollen basierend auf SrcIP, SrcPort, DstIP, DstPort, Protokoll, Verschlüsselung, Richtung und Aktion. Wenn nicht angegeben, wird der gesamte Netzwerkdatenverkehr protokolliert.

properties.flowAnalyticsConfiguration

TrafficAnalyticsProperties

Parameter, die die Konfiguration der Datenverkehrsanalyse definieren.

properties.format

FlowLogFormatParameters

Parameter, die das Flussprotokollformat definieren.

properties.retentionPolicy

RetentionPolicyParameters

Parameter, die die Aufbewahrungsrichtlinie für das Ablaufprotokoll definieren.

tags

object

Ressourcentags.

Antworten

Name Typ Beschreibung
200 OK

FlowLog

Aktualisierung erfolgreich. Der Vorgang gibt die resultierende Ablaufprotokollressource zurück.

201 Created

FlowLog

Anforderung erfolgreich. Der Vorgang gibt die resultierende Ablaufprotokollressource zurück.

Other Status Codes

ErrorResponse

Fehlerantwort, die beschreibt, warum der Vorgang fehlgeschlagen ist.

Sicherheit

azure_auth

Azure Active Directory OAuth2-Fluss.

Typ: oauth2
Ablauf: implicit
Autorisierungs-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiche

Name Beschreibung
user_impersonation Identitätswechsel ihres Benutzerkontos

Beispiele

Create or update flow log

Beispielanforderung

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

{
  "location": "centraluseuap",
  "properties": {
    "targetResourceId": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/networkSecurityGroups/desmondcentral-nsg",
    "storageId": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Storage/storageAccounts/nwtest1mgvbfmqsigdxe",
    "enabledFilteringCriteria": "srcIP=158.255.7.8 || dstPort=56891",
    "enabled": true,
    "format": {
      "type": "JSON",
      "version": 1
    }
  },
  "identity": {
    "type": "UserAssigned",
    "userAssignedIdentities": {
      "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ManagedIdentity/userAssignedIdentities/id1": {}
    }
  }
}

Beispiel für eine Antwort

{
  "name": "Microsoft.Networkdesmond-rgdesmondcentral-nsg",
  "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/networkWatchers/nw/FlowLogs/fl",
  "etag": "W/\"00000000-0000-0000-0000-000000000000\"",
  "properties": {
    "provisioningState": "Updating",
    "targetResourceId": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/networkSecurityGroups/desmondcentral-nsg",
    "targetResourceGuid": "00000000-0000-0000-0000-000000000000",
    "storageId": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Storage/storageAccounts/nwtest1mgvbfmqsigdxe",
    "enabledFilteringCriteria": "srcIP=158.255.7.8 || dstPort=56891",
    "enabled": true,
    "flowAnalyticsConfiguration": {},
    "retentionPolicy": {
      "days": 0,
      "enabled": false
    },
    "format": {
      "type": "JSON",
      "version": 1
    }
  },
  "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"
      }
    }
  },
  "location": "centraluseuap"
}
{
  "name": "Microsoft.Networkdesmond-rgdesmondcentral-nsg",
  "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/networkWatchers/nw/FlowLogs/fl",
  "etag": "W/\"00000000-0000-0000-0000-000000000000\"",
  "properties": {
    "provisioningState": "Succeeded",
    "targetResourceId": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/networkSecurityGroups/desmondcentral-nsg",
    "targetResourceGuid": "00000000-0000-0000-0000-000000000000",
    "storageId": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Storage/storageAccounts/nwtest1mgvbfmqsigdxe",
    "enabledFilteringCriteria": "srcIP=158.255.7.8 || dstPort=56891",
    "enabled": true,
    "flowAnalyticsConfiguration": {},
    "retentionPolicy": {
      "days": 0,
      "enabled": false
    },
    "format": {
      "type": "JSON",
      "version": 1
    }
  },
  "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"
      }
    }
  },
  "location": "centraluseuap"
}

Definitionen

Name Beschreibung
ErrorDetails

Allgemeine Fehlerdetails darstellung.

ErrorResponse

Das Fehlerobjekt.

FlowLog

Eine Flussprotokollressource.

FlowLogFormatParameters

Parameter, die das Flussprotokollformat definieren.

FlowLogFormatType

Der Dateityp des Flussprotokolls.

ManagedServiceIdentity

Identität für die Ressource.

ProvisioningState

Der aktuelle Bereitstellungsstatus.

ResourceIdentityType

Der Identitätstyp, der für die Ressource verwendet wird. Der Typ "SystemAssigned, UserAssigned" enthält sowohl eine implizit erstellte Identität als auch eine Gruppe von vom Benutzer zugewiesenen Identitäten. Der Typ "None" entfernt alle Identitäten vom virtuellen Computer.

RetentionPolicyParameters

Parameter, die die Aufbewahrungsrichtlinie für das Ablaufprotokoll definieren.

TrafficAnalyticsConfigurationProperties

Parameter, die die Konfiguration der Datenverkehrsanalyse definieren.

TrafficAnalyticsProperties

Parameter, die die Konfiguration der Datenverkehrsanalyse definieren.

UserAssignedIdentities

Die Liste der Benutzeridentitäten, die der Ressource zugeordnet sind. Die Benutzeridentitätswörterbuchschlüsselverweise sind ARM-Ressourcen-IDs im Formular: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}".

ErrorDetails

Allgemeine Fehlerdetails darstellung.

Name Typ Beschreibung
code

string

Fehlercode.

message

string

Fehlermeldung.

target

string

Fehlerziel.

ErrorResponse

Das Fehlerobjekt.

Name Typ Beschreibung
error

ErrorDetails

Fehler
Das Fehlerdetails-Objekt.

FlowLog

Eine Flussprotokollressource.

Name Typ Beschreibung
etag

string

Eine eindeutige schreibgeschützte Zeichenfolge, die sich ändert, wenn die Ressource aktualisiert wird.

id

string

Ressourcen-ID.

identity

ManagedServiceIdentity

Verwaltete FlowLog-Ressource

location

string

Ressourcenspeicherort.

name

string

Ressourcenname.

properties.enabled

boolean

Kennzeichnen, um die Ablaufprotokollierung zu aktivieren/deaktivieren.

properties.enabledFilteringCriteria

string

Optionales Feld zum Filtern von Netzwerkdatenverkehrsprotokollen basierend auf SrcIP, SrcPort, DstIP, DstPort, Protokoll, Verschlüsselung, Richtung und Aktion. Wenn nicht angegeben, wird der gesamte Netzwerkdatenverkehr protokolliert.

properties.flowAnalyticsConfiguration

TrafficAnalyticsProperties

Parameter, die die Konfiguration der Datenverkehrsanalyse definieren.

properties.format

FlowLogFormatParameters

Parameter, die das Flussprotokollformat definieren.

properties.provisioningState

ProvisioningState

Der Bereitstellungsstatus des Ablaufprotokolls.

properties.retentionPolicy

RetentionPolicyParameters

Parameter, die die Aufbewahrungsrichtlinie für das Ablaufprotokoll definieren.

properties.storageId

string

ID des Speicherkontos, das zum Speichern des Ablaufprotokolls verwendet wird.

properties.targetResourceGuid

string

Guid der Netzwerksicherheitsgruppe, auf die das Ablaufprotokoll angewendet wird.

properties.targetResourceId

string

ID der Netzwerksicherheitsgruppe, auf die das Ablaufprotokoll angewendet wird.

tags

object

Ressourcentags.

type

string

Ressourcentyp.

FlowLogFormatParameters

Parameter, die das Flussprotokollformat definieren.

Name Typ Standardwert Beschreibung
type

FlowLogFormatType

Der Dateityp des Flussprotokolls.

version

integer

0

Die Version (Revision) des Ablaufprotokolls.

FlowLogFormatType

Der Dateityp des Flussprotokolls.

Name Typ Beschreibung
JSON

string

ManagedServiceIdentity

Identität für die Ressource.

Name Typ Beschreibung
principalId

string

Die Prinzipal-ID der vom System zugewiesenen Identität. Diese Eigenschaft wird nur für eine vom System zugewiesene Identität bereitgestellt.

tenantId

string

Die Mandanten-ID der vom System zugewiesenen Identität. Diese Eigenschaft wird nur für eine vom System zugewiesene Identität bereitgestellt.

type

ResourceIdentityType

Der Identitätstyp, der für die Ressource verwendet wird. Der Typ "SystemAssigned, UserAssigned" enthält sowohl eine implizit erstellte Identität als auch eine Gruppe von vom Benutzer zugewiesenen Identitäten. Der Typ "None" entfernt alle Identitäten vom virtuellen Computer.

userAssignedIdentities

UserAssignedIdentities

Die Liste der Benutzeridentitäten, die der Ressource zugeordnet sind. Die Benutzeridentitätswörterbuchschlüsselverweise sind ARM-Ressourcen-IDs im Formular: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}".

ProvisioningState

Der aktuelle Bereitstellungsstatus.

Name Typ Beschreibung
Deleting

string

Failed

string

Succeeded

string

Updating

string

ResourceIdentityType

Der Identitätstyp, der für die Ressource verwendet wird. Der Typ "SystemAssigned, UserAssigned" enthält sowohl eine implizit erstellte Identität als auch eine Gruppe von vom Benutzer zugewiesenen Identitäten. Der Typ "None" entfernt alle Identitäten vom virtuellen Computer.

Name Typ Beschreibung
None

string

SystemAssigned

string

SystemAssigned, UserAssigned

string

UserAssigned

string

RetentionPolicyParameters

Parameter, die die Aufbewahrungsrichtlinie für das Ablaufprotokoll definieren.

Name Typ Standardwert Beschreibung
days

integer

0

Anzahl der Tage, die Ablaufprotokolldatensätze beibehalten werden sollen.

enabled

boolean

False

Kennzeichnen, um die Aufbewahrung zu aktivieren/zu deaktivieren.

TrafficAnalyticsConfigurationProperties

Parameter, die die Konfiguration der Datenverkehrsanalyse definieren.

Name Typ Beschreibung
enabled

boolean

Kennzeichnen, um Datenverkehrsanalysen zu aktivieren/zu deaktivieren.

trafficAnalyticsInterval

integer

Das Intervall in Minuten, das entscheiden würde, wie häufig der TA-Dienst Ablaufanalysen durchführen soll.

workspaceId

string

Die Ressourcen-GUID des angefügten Arbeitsbereichs.

workspaceRegion

string

Die Position des angefügten Arbeitsbereichs.

workspaceResourceId

string

Ressourcen-ID des angefügten Arbeitsbereichs.

TrafficAnalyticsProperties

Parameter, die die Konfiguration der Datenverkehrsanalyse definieren.

Name Typ Beschreibung
networkWatcherFlowAnalyticsConfiguration

TrafficAnalyticsConfigurationProperties

Parameter, die die Konfiguration der Datenverkehrsanalyse definieren.

UserAssignedIdentities

Die Liste der Benutzeridentitäten, die der Ressource zugeordnet sind. Die Benutzeridentitätswörterbuchschlüsselverweise sind ARM-Ressourcen-IDs im Formular: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}".

Name Typ Beschreibung