Flow Logs - Create Or Update
Skapa eller uppdatera en flödeslogg för den angivna nätverkssäkerhetsgruppen.
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/networkWatchers/{networkWatcherName}/flowLogs/{flowLogName}?api-version=2024-05-01
URI-parametrar
Name | I | Obligatorisk | Typ | Description |
---|---|---|---|---|
flow
|
path | True |
string |
Namnet på flödesloggen. |
network
|
path | True |
string |
Namnet på nätverksbevakaren. |
resource
|
path | True |
string |
Namnet på resursgruppen. |
subscription
|
path | True |
string |
Autentiseringsuppgifterna för prenumerationen som unikt identifierar Microsoft Azure-prenumerationen. Prenumerations-ID:t utgör en del av URI:n för varje tjänstanrop. |
api-version
|
query | True |
string |
Klient-API-version. |
Begärandetext
Name | Obligatorisk | Typ | Description |
---|---|---|---|
properties.storageId | True |
string |
ID för lagringskontot som används för att lagra flödesloggen. |
properties.targetResourceId | True |
string |
ID för den nätverkssäkerhetsgrupp som flödesloggen ska tillämpas på. |
id |
string |
Resurs-ID. |
|
identity |
Hanterad identitet för FlowLog-resurs |
||
location |
string |
Resursplats. |
|
properties.enabled |
boolean |
Flagga för att aktivera/inaktivera flödesloggning. |
|
properties.enabledFilteringCriteria |
string |
Valfritt fält för att filtrera nätverkstrafikloggar baserat på SrcIP, SrcPort, DstIP, DstPort, Protocol, Encryption, Direction and Action. Om den inte anges loggas all nätverkstrafik. |
|
properties.flowAnalyticsConfiguration |
Parametrar som definierar konfigurationen av trafikanalys. |
||
properties.format |
Parametrar som definierar flödesloggformatet. |
||
properties.retentionPolicy |
Parametrar som definierar kvarhållningsprincipen för flödesloggen. |
||
tags |
object |
Resurstaggar. |
Svar
Name | Typ | Description |
---|---|---|
200 OK |
Uppdateringen lyckades. Åtgärden returnerar den resulterande flödesloggresursen. |
|
201 Created |
Begäran lyckades. Åtgärden returnerar den resulterande flödesloggresursen. |
|
Other Status Codes |
Felsvar som beskriver varför åtgärden misslyckades. |
Säkerhet
azure_auth
Azure Active Directory OAuth2 Flow.
Typ:
oauth2
Flow:
implicit
Auktoriseringswebbadress:
https://login.microsoftonline.com/common/oauth2/authorize
Omfattningar
Name | Description |
---|---|
user_impersonation | personifiera ditt användarkonto |
Exempel
Create or update flow log
Exempelbegäran
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": {}
}
}
}
Exempelsvar
{
"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"
}
Definitioner
Name | Description |
---|---|
Error |
Vanliga felinformationsrepresentationer. |
Error |
Felobjektet. |
Flow |
En flödesloggresurs. |
Flow |
Parametrar som definierar flödesloggformatet. |
Flow |
Filtypen för flödesloggen. |
Managed |
Identitet för resursen. |
Provisioning |
Det aktuella etableringstillståndet. |
Resource |
Den typ av identitet som används för resursen. Typen "SystemAssigned, UserAssigned" innehåller både en implicit skapad identitet och en uppsättning användartilldelade identiteter. Typen "Ingen" tar bort alla identiteter från den virtuella datorn. |
Retention |
Parametrar som definierar kvarhållningsprincipen för flödesloggen. |
Traffic |
Parametrar som definierar konfigurationen av trafikanalys. |
Traffic |
Parametrar som definierar konfigurationen av trafikanalys. |
User |
Listan över användaridentiteter som är associerade med resursen. Nyckelreferenserna för användaridentitetsordlistan är ARM-resurs-ID:er i formuläret: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'. |
ErrorDetails
Vanliga felinformationsrepresentationer.
Name | Typ | Description |
---|---|---|
code |
string |
Felkod. |
message |
string |
Felmeddelande. |
target |
string |
Felmål. |
ErrorResponse
Felobjektet.
Name | Typ | Description |
---|---|---|
error |
Fel |
FlowLog
En flödesloggresurs.
Name | Typ | Description |
---|---|---|
etag |
string |
En unik skrivskyddad sträng som ändras när resursen uppdateras. |
id |
string |
Resurs-ID. |
identity |
Hanterad identitet för FlowLog-resurs |
|
location |
string |
Resursplats. |
name |
string |
Resursnamn. |
properties.enabled |
boolean |
Flagga för att aktivera/inaktivera flödesloggning. |
properties.enabledFilteringCriteria |
string |
Valfritt fält för att filtrera nätverkstrafikloggar baserat på SrcIP, SrcPort, DstIP, DstPort, Protocol, Encryption, Direction and Action. Om den inte anges loggas all nätverkstrafik. |
properties.flowAnalyticsConfiguration |
Parametrar som definierar konfigurationen av trafikanalys. |
|
properties.format |
Parametrar som definierar flödesloggformatet. |
|
properties.provisioningState |
Etableringstillståndet för flödesloggen. |
|
properties.retentionPolicy |
Parametrar som definierar kvarhållningsprincipen för flödesloggen. |
|
properties.storageId |
string |
ID för lagringskontot som används för att lagra flödesloggen. |
properties.targetResourceGuid |
string |
Guid för nätverkssäkerhetsgrupp som flödesloggen ska tillämpas på. |
properties.targetResourceId |
string |
ID för den nätverkssäkerhetsgrupp som flödesloggen ska tillämpas på. |
tags |
object |
Resurstaggar. |
type |
string |
Resurstyp. |
FlowLogFormatParameters
Parametrar som definierar flödesloggformatet.
Name | Typ | Standardvärde | Description |
---|---|---|---|
type |
Filtypen för flödesloggen. |
||
version |
integer |
0 |
Version (revision) av flödesloggen. |
FlowLogFormatType
Filtypen för flödesloggen.
Name | Typ | Description |
---|---|---|
JSON |
string |
ManagedServiceIdentity
Identitet för resursen.
Name | Typ | Description |
---|---|---|
principalId |
string |
Huvud-ID:t för den systemtilldelade identiteten. Den här egenskapen tillhandahålls endast för en systemtilldelad identitet. |
tenantId |
string |
Klient-ID:t för den systemtilldelade identiteten. Den här egenskapen tillhandahålls endast för en systemtilldelad identitet. |
type |
Den typ av identitet som används för resursen. Typen "SystemAssigned, UserAssigned" innehåller både en implicit skapad identitet och en uppsättning användartilldelade identiteter. Typen "Ingen" tar bort alla identiteter från den virtuella datorn. |
|
userAssignedIdentities |
Listan över användaridentiteter som är associerade med resursen. Nyckelreferenserna för användaridentitetsordlistan är ARM-resurs-ID:er i formuläret: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'. |
ProvisioningState
Det aktuella etableringstillståndet.
Name | Typ | Description |
---|---|---|
Deleting |
string |
|
Failed |
string |
|
Succeeded |
string |
|
Updating |
string |
ResourceIdentityType
Den typ av identitet som används för resursen. Typen "SystemAssigned, UserAssigned" innehåller både en implicit skapad identitet och en uppsättning användartilldelade identiteter. Typen "Ingen" tar bort alla identiteter från den virtuella datorn.
Name | Typ | Description |
---|---|---|
None |
string |
|
SystemAssigned |
string |
|
SystemAssigned, UserAssigned |
string |
|
UserAssigned |
string |
RetentionPolicyParameters
Parametrar som definierar kvarhållningsprincipen för flödesloggen.
Name | Typ | Standardvärde | Description |
---|---|---|---|
days |
integer |
0 |
Antal dagar för att behålla flödesloggposter. |
enabled |
boolean |
False |
Flagga för att aktivera/inaktivera kvarhållning. |
TrafficAnalyticsConfigurationProperties
Parametrar som definierar konfigurationen av trafikanalys.
Name | Typ | Description |
---|---|---|
enabled |
boolean |
Flagga för att aktivera/inaktivera trafikanalys. |
trafficAnalyticsInterval |
integer |
Intervallet i minuter som avgör hur ofta TA-tjänsten ska utföra flödesanalyser. |
workspaceId |
string |
Resurs-GUID för den anslutna arbetsytan. |
workspaceRegion |
string |
Platsen för den anslutna arbetsytan. |
workspaceResourceId |
string |
Resurs-ID för den anslutna arbetsytan. |
TrafficAnalyticsProperties
Parametrar som definierar konfigurationen av trafikanalys.
Name | Typ | Description |
---|---|---|
networkWatcherFlowAnalyticsConfiguration |
Parametrar som definierar konfigurationen av trafikanalys. |
UserAssignedIdentities
Listan över användaridentiteter som är associerade med resursen. Nyckelreferenserna för användaridentitetsordlistan är ARM-resurs-ID:er i formuläret: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'.
Name | Typ | Description |
---|---|---|
|