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 |
---|---|---|---|---|
flow
|
path | True |
string |
De naam van het stroomlogboek. |
network
|
path | True |
string |
De naam van de network watcher. |
resource
|
path | True |
string |
De naam van de resourcegroep. |
subscription
|
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 |
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 |
Parameters die de configuratie van verkeersanalyse definiëren. |
||
properties.format |
Parameters waarmee de indeling van het stroomlogboek wordt gedefinieerd. |
||
properties.retentionPolicy |
Parameters waarmee het bewaarbeleid voor het stroomlogboek wordt gedefinieerd. |
||
tags |
object |
Resourcetags. |
Antwoorden
Name | Type | Description |
---|---|---|
200 OK |
Update is voltooid. De bewerking retourneert de resulterende stroomlogboekresource. |
|
201 Created |
Aanvraag is voltooid. De bewerking retourneert de resulterende stroomlogboekresource. |
|
Other Status Codes |
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 |
---|---|
Error |
Algemene weergave van foutdetails. |
Error |
Het foutobject. |
Flow |
Een stroomlogboekresource. |
Flow |
Parameters waarmee de indeling van het stroomlogboek wordt gedefinieerd. |
Flow |
Het bestandstype van het stroomlogboek. |
Managed |
Identiteit voor de resource. |
Provisioning |
De huidige inrichtingsstatus. |
Resource |
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. |
Retention |
Parameters waarmee het bewaarbeleid voor het stroomlogboek wordt gedefinieerd. |
Traffic |
Parameters die de configuratie van verkeersanalyse definiëren. |
Traffic |
Parameters die de configuratie van verkeersanalyse definiëren. |
User |
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 |
Fout |
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 |
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 |
Parameters die de configuratie van verkeersanalyse definiëren. |
|
properties.format |
Parameters waarmee de indeling van het stroomlogboek wordt gedefinieerd. |
|
properties.provisioningState |
De inrichtingsstatus van het stroomlogboek. |
|
properties.retentionPolicy |
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 |
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 |
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 |
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 |
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 |
---|---|---|
|