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 |
---|---|---|---|---|
flow
|
path | True |
string |
Der Name des Flussprotokolls. |
network
|
path | True |
string |
Der Name der Netzwerküberwachung. |
resource
|
path | True |
string |
Der Name der Ressourcengruppe. |
subscription
|
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 |
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 |
Parameter, die die Konfiguration der Datenverkehrsanalyse definieren. |
||
properties.format |
Parameter, die das Flussprotokollformat definieren. |
||
properties.retentionPolicy |
Parameter, die die Aufbewahrungsrichtlinie für das Ablaufprotokoll definieren. |
||
tags |
object |
Ressourcentags. |
Antworten
Name | Typ | Beschreibung |
---|---|---|
200 OK |
Aktualisierung erfolgreich. Der Vorgang gibt die resultierende Ablaufprotokollressource zurück. |
|
201 Created |
Anforderung erfolgreich. Der Vorgang gibt die resultierende Ablaufprotokollressource zurück. |
|
Other Status Codes |
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 |
---|---|
Error |
Allgemeine Fehlerdetails darstellung. |
Error |
Das Fehlerobjekt. |
Flow |
Eine Flussprotokollressource. |
Flow |
Parameter, die das Flussprotokollformat definieren. |
Flow |
Der Dateityp des Flussprotokolls. |
Managed |
Identität für die Ressource. |
Provisioning |
Der aktuelle Bereitstellungsstatus. |
Resource |
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. |
Retention |
Parameter, die die Aufbewahrungsrichtlinie für das Ablaufprotokoll definieren. |
Traffic |
Parameter, die die Konfiguration der Datenverkehrsanalyse definieren. |
Traffic |
Parameter, die die Konfiguration der Datenverkehrsanalyse definieren. |
User |
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 |
Fehler |
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 |
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 |
Parameter, die die Konfiguration der Datenverkehrsanalyse definieren. |
|
properties.format |
Parameter, die das Flussprotokollformat definieren. |
|
properties.provisioningState |
Der Bereitstellungsstatus des Ablaufprotokolls. |
|
properties.retentionPolicy |
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 |
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 |
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 |
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 |
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 |
---|---|---|
|