Delen via


Flow Logs - Create Or Update

Een stroomlogboek voor de opgegeven netwerkbeveiligingsgroep maken of bijwerken.

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

URI-parameters

Name In Vereist Type Description
flowLogName
path True

string

De naam van het stroomlogboek.

networkWatcherName
path True

string

De naam van de network watcher.

resourceGroupName
path True

string

De naam van de resourcegroep.

subscriptionId
path True

string

De abonnementsreferenties waarmee het Microsoft Azure-abonnement uniek wordt geïdentificeerd. De abonnements-id maakt deel uit van de URI voor elke serviceoproep.

api-version
query True

string

Client-API-versie.

Aanvraagbody

Name Vereist Type Description
properties.storageId True

string

Id van het opslagaccount dat wordt gebruikt voor het opslaan van het stroomlogboek.

properties.targetResourceId True

string

Id van netwerkbeveiligingsgroep waarop stroomlogboek wordt toegepast.

id

string

Resource-id.

identity

ManagedServiceIdentity

Beheerde identiteit van FlowLog-resource

location

string

Resourcelocatie.

properties.enabled

boolean

Vlag om stroomlogboekregistratie in of uit te schakelen.

properties.enabledFilteringCriteria

string

Optioneel veld voor het filteren van netwerkverkeerslogboeken op basis van SrcIP, SrcPort, DstIP, DstPort, Protocol, Versleuteling, Richting en Actie. Als dit niet is opgegeven, wordt al het netwerkverkeer geregistreerd.

properties.flowAnalyticsConfiguration

TrafficAnalyticsProperties

Parameters die de configuratie van verkeersanalyse definiëren.

properties.format

FlowLogFormatParameters

Parameters waarmee de indeling van het stroomlogboek wordt gedefinieerd.

properties.retentionPolicy

RetentionPolicyParameters

Parameters waarmee het bewaarbeleid voor het stroomlogboek wordt gedefinieerd.

tags

object

Resourcetags.

Antwoorden

Name Type Description
200 OK

FlowLog

Update is voltooid. De bewerking retourneert de resulterende stroomlogboekresource.

201 Created

FlowLog

Aanvraag is voltooid. De bewerking retourneert de resulterende stroomlogboekresource.

Other Status Codes

ErrorResponse

Foutreactie waarin wordt beschreven waarom de bewerking is mislukt.

Beveiliging

azure_auth

Azure Active Directory OAuth2 Flow.

Type: oauth2
Stroom: implicit
Autorisatie-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiken

Name Description
user_impersonation Uw gebruikersaccount imiteren

Voorbeelden

Create or update flow log

Voorbeeldaanvraag

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": {}
    }
  }
}

Voorbeeldrespons

{
  "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"
}

Definities

Name Description
ErrorDetails

Algemene weergave van foutdetails.

ErrorResponse

Het foutobject.

FlowLog

Een stroomlogboekresource.

FlowLogFormatParameters

Parameters waarmee de indeling van het stroomlogboek wordt gedefinieerd.

FlowLogFormatType

Het bestandstype van het stroomlogboek.

ManagedServiceIdentity

Identiteit voor de resource.

ProvisioningState

De huidige inrichtingsstatus.

ResourceIdentityType

Het type identiteit dat wordt gebruikt voor de resource. Het type SystemAssigned, UserAssigned bevat zowel een impliciet gemaakte identiteit als een set door de gebruiker toegewezen identiteiten. Met het type None worden alle identiteiten van de virtuele machine verwijderd.

RetentionPolicyParameters

Parameters waarmee het bewaarbeleid voor het stroomlogboek wordt gedefinieerd.

TrafficAnalyticsConfigurationProperties

Parameters die de configuratie van verkeersanalyse definiëren.

TrafficAnalyticsProperties

Parameters die de configuratie van verkeersanalyse definiëren.

UserAssignedIdentities

De lijst met gebruikersidentiteiten die zijn gekoppeld aan de resource. De sleutelverwijzingen voor de gebruikersidentiteitswoordenlijst zijn ARM-resource-id's in de vorm: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}.

ErrorDetails

Algemene weergave van foutdetails.

Name Type Description
code

string

Foutcode.

message

string

Foutmelding.

target

string

Foutdoel.

ErrorResponse

Het foutobject.

Name Type Description
error

ErrorDetails

Fout
Het object met foutdetails.

FlowLog

Een stroomlogboekresource.

Name Type Description
etag

string

Een unieke alleen-lezen tekenreeks die wordt gewijzigd wanneer de resource wordt bijgewerkt.

id

string

Resource-id.

identity

ManagedServiceIdentity

Beheerde identiteit van FlowLog-resource

location

string

Resourcelocatie.

name

string

Resourcenaam.

properties.enabled

boolean

Vlag om stroomlogboekregistratie in of uit te schakelen.

properties.enabledFilteringCriteria

string

Optioneel veld voor het filteren van netwerkverkeerslogboeken op basis van SrcIP, SrcPort, DstIP, DstPort, Protocol, Versleuteling, Richting en Actie. Als dit niet is opgegeven, wordt al het netwerkverkeer geregistreerd.

properties.flowAnalyticsConfiguration

TrafficAnalyticsProperties

Parameters die de configuratie van verkeersanalyse definiëren.

properties.format

FlowLogFormatParameters

Parameters waarmee de indeling van het stroomlogboek wordt gedefinieerd.

properties.provisioningState

ProvisioningState

De inrichtingsstatus van het stroomlogboek.

properties.retentionPolicy

RetentionPolicyParameters

Parameters waarmee het bewaarbeleid voor het stroomlogboek wordt gedefinieerd.

properties.storageId

string

Id van het opslagaccount dat wordt gebruikt voor het opslaan van het stroomlogboek.

properties.targetResourceGuid

string

Guid van netwerkbeveiligingsgroep waarop stroomlogboek wordt toegepast.

properties.targetResourceId

string

Id van netwerkbeveiligingsgroep waarop stroomlogboek wordt toegepast.

tags

object

Resourcetags.

type

string

Resourcetype.

FlowLogFormatParameters

Parameters waarmee de indeling van het stroomlogboek wordt gedefinieerd.

Name Type Default value Description
type

FlowLogFormatType

Het bestandstype van het stroomlogboek.

version

integer

0

De versie (revisie) van het stroomlogboek.

FlowLogFormatType

Het bestandstype van het stroomlogboek.

Name Type Description
JSON

string

ManagedServiceIdentity

Identiteit voor de resource.

Name Type Description
principalId

string

De principal-id van de door het systeem toegewezen identiteit. Deze eigenschap wordt alleen verstrekt voor een door het systeem toegewezen identiteit.

tenantId

string

De tenant-id van de door het systeem toegewezen identiteit. Deze eigenschap wordt alleen verstrekt voor een door het systeem toegewezen identiteit.

type

ResourceIdentityType

Het type identiteit dat wordt gebruikt voor de resource. Het type SystemAssigned, UserAssigned bevat zowel een impliciet gemaakte identiteit als een set door de gebruiker toegewezen identiteiten. Met het type None worden alle identiteiten van de virtuele machine verwijderd.

userAssignedIdentities

UserAssignedIdentities

De lijst met gebruikersidentiteiten die zijn gekoppeld aan de resource. De sleutelverwijzingen voor de gebruikersidentiteitswoordenlijst zijn ARM-resource-id's in de vorm: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}.

ProvisioningState

De huidige inrichtingsstatus.

Name Type Description
Deleting

string

Failed

string

Succeeded

string

Updating

string

ResourceIdentityType

Het type identiteit dat wordt gebruikt voor de resource. Het type SystemAssigned, UserAssigned bevat zowel een impliciet gemaakte identiteit als een set door de gebruiker toegewezen identiteiten. Met het type None worden alle identiteiten van de virtuele machine verwijderd.

Name Type Description
None

string

SystemAssigned

string

SystemAssigned, UserAssigned

string

UserAssigned

string

RetentionPolicyParameters

Parameters waarmee het bewaarbeleid voor het stroomlogboek wordt gedefinieerd.

Name Type Default value Description
days

integer

0

Aantal dagen voor het bewaren van stroomlogboekrecords.

enabled

boolean

False

Vlag om retentie in of uit te schakelen.

TrafficAnalyticsConfigurationProperties

Parameters die de configuratie van verkeersanalyse definiëren.

Name Type Description
enabled

boolean

Vlag om verkeersanalyse in of uit te schakelen.

trafficAnalyticsInterval

integer

Het interval in minuten waarmee wordt bepaald hoe vaak de TA-service stroomanalyse moet uitvoeren.

workspaceId

string

De resource-GUID van de gekoppelde werkruimte.

workspaceRegion

string

De locatie van de gekoppelde werkruimte.

workspaceResourceId

string

Resource-id van de gekoppelde werkruimte.

TrafficAnalyticsProperties

Parameters die de configuratie van verkeersanalyse definiëren.

Name Type Description
networkWatcherFlowAnalyticsConfiguration

TrafficAnalyticsConfigurationProperties

Parameters die de configuratie van verkeersanalyse definiëren.

UserAssignedIdentities

De lijst met gebruikersidentiteiten die zijn gekoppeld aan de resource. De sleutelverwijzingen voor de gebruikersidentiteitswoordenlijst zijn ARM-resource-id's in de vorm: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}.

Name Type Description