Flow Logs - Create Or Update
Creare o aggiornare un log di flusso per il gruppo di sicurezza di rete specificato.
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/networkWatchers/{networkWatcherName}/flowLogs/{flowLogName}?api-version=2023-09-01
Parametri dell'URI
Nome | In | Necessario | Tipo | Descrizione |
---|---|---|---|---|
flow
|
path | True |
string |
Nome del log del flusso. |
network
|
path | True |
string |
Nome del network watcher. |
resource
|
path | True |
string |
Nome del gruppo di risorse. |
subscription
|
path | True |
string |
Credenziali della sottoscrizione che identificano in modo univoco la sottoscrizione di Microsoft Azure. L'ID sottoscrizione fa parte dell'URI per ogni chiamata di servizio. |
api-version
|
query | True |
string |
Versione API client. |
Corpo della richiesta
Nome | Necessario | Tipo | Descrizione |
---|---|---|---|
properties.storageId | True |
string |
ID dell'account di archiviazione usato per archiviare il log del flusso. |
properties.targetResourceId | True |
string |
ID del gruppo di sicurezza di rete a cui verrà applicato il log dei flussi. |
id |
string |
ID risorsa. |
|
location |
string |
Percorso della risorsa. |
|
properties.enabled |
boolean |
Contrassegno per abilitare/disabilitare la registrazione dei flussi. |
|
properties.flowAnalyticsConfiguration |
Parametri che definiscono la configurazione dell'analisi del traffico. |
||
properties.format |
Parametri che definiscono il formato del log del flusso. |
||
properties.retentionPolicy |
Parametri che definiscono i criteri di conservazione per il log dei flussi. |
||
tags |
object |
Tag delle risorse. |
Risposte
Nome | Tipo | Descrizione |
---|---|---|
200 OK |
Aggiornamento riuscito. L'operazione restituisce la risorsa del log del flusso risultante. |
|
201 Created |
Richiesta completata. L'operazione restituisce la risorsa del log del flusso risultante. |
|
Other Status Codes |
Risposta di errore che descrive il motivo per cui l'operazione non è riuscita. |
Sicurezza
azure_auth
Flusso OAuth2 di Azure Active Directory.
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
Nome | Descrizione |
---|---|
user_impersonation | rappresentare l'account utente |
Esempio
Create or update flow log
Sample Request
PUT https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/networkWatchers/nw1/flowLogs/fl?api-version=2023-09-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",
"enabled": true,
"format": {
"type": "JSON",
"version": 1
}
}
}
Sample Response
{
"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",
"enabled": true,
"flowAnalyticsConfiguration": {},
"retentionPolicy": {
"days": 0,
"enabled": false
},
"format": {
"type": "JSON",
"version": 1
}
},
"type": "Microsoft.Network/networkWatchers/FlowLogs",
"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",
"enabled": true,
"flowAnalyticsConfiguration": {},
"retentionPolicy": {
"days": 0,
"enabled": false
},
"format": {
"type": "JSON",
"version": 1
}
},
"type": "Microsoft.Network/networkWatchers/FlowLogs",
"location": "centraluseuap"
}
Definizioni
Nome | Descrizione |
---|---|
Error |
Rappresentazione comune dei dettagli degli errori. |
Error |
Oggetto error. |
Flow |
Risorsa del log del flusso. |
Flow |
Parametri che definiscono il formato del log del flusso. |
Flow |
Tipo di file del log del flusso. |
Provisioning |
Stato di provisioning corrente. |
Retention |
Parametri che definiscono i criteri di conservazione per il log dei flussi. |
Traffic |
Parametri che definiscono la configurazione dell'analisi del traffico. |
Traffic |
Parametri che definiscono la configurazione dell'analisi del traffico. |
ErrorDetails
Rappresentazione comune dei dettagli degli errori.
Nome | Tipo | Descrizione |
---|---|---|
code |
string |
Codice di errore. |
message |
string |
Messaggio di errore. |
target |
string |
Destinazione degli errori. |
ErrorResponse
Oggetto error.
Nome | Tipo | Descrizione |
---|---|---|
error |
Errore |
FlowLog
Risorsa del log del flusso.
Nome | Tipo | Descrizione |
---|---|---|
etag |
string |
Stringa di sola lettura univoca che cambia ogni volta che la risorsa viene aggiornata. |
id |
string |
ID risorsa. |
location |
string |
Percorso della risorsa. |
name |
string |
Nome risorsa. |
properties.enabled |
boolean |
Contrassegno per abilitare/disabilitare la registrazione dei flussi. |
properties.flowAnalyticsConfiguration |
Parametri che definiscono la configurazione dell'analisi del traffico. |
|
properties.format |
Parametri che definiscono il formato del log del flusso. |
|
properties.provisioningState |
Stato di provisioning del log del flusso. |
|
properties.retentionPolicy |
Parametri che definiscono i criteri di conservazione per il log dei flussi. |
|
properties.storageId |
string |
ID dell'account di archiviazione usato per archiviare il log del flusso. |
properties.targetResourceGuid |
string |
GUID del gruppo di sicurezza di rete a cui verrà applicato il log dei flussi. |
properties.targetResourceId |
string |
ID del gruppo di sicurezza di rete a cui verrà applicato il log dei flussi. |
tags |
object |
Tag delle risorse. |
type |
string |
Tipo di risorsa. |
FlowLogFormatParameters
Parametri che definiscono il formato del log del flusso.
Nome | Tipo | Valore predefinito | Descrizione |
---|---|---|---|
type |
Tipo di file del log del flusso. |
||
version |
integer |
0 |
Versione (revisione) del log del flusso. |
FlowLogFormatType
Tipo di file del log del flusso.
Nome | Tipo | Descrizione |
---|---|---|
JSON |
string |
ProvisioningState
Stato di provisioning corrente.
Nome | Tipo | Descrizione |
---|---|---|
Deleting |
string |
|
Failed |
string |
|
Succeeded |
string |
|
Updating |
string |
RetentionPolicyParameters
Parametri che definiscono i criteri di conservazione per il log dei flussi.
Nome | Tipo | Valore predefinito | Descrizione |
---|---|---|---|
days |
integer |
0 |
Numero di giorni per conservare i record del log del flusso. |
enabled |
boolean |
False |
Contrassegno per abilitare/disabilitare la conservazione. |
TrafficAnalyticsConfigurationProperties
Parametri che definiscono la configurazione dell'analisi del traffico.
Nome | Tipo | Descrizione |
---|---|---|
enabled |
boolean |
Contrassegnare per abilitare/disabilitare l'analisi del traffico. |
trafficAnalyticsInterval |
integer |
Intervallo in minuti che determina la frequenza con cui il servizio TA deve eseguire l'analisi dei flussi. |
workspaceId |
string |
GUID della risorsa dell'area di lavoro associata. |
workspaceRegion |
string |
Posizione dell'area di lavoro associata. |
workspaceResourceId |
string |
ID risorsa dell'area di lavoro associata. |
TrafficAnalyticsProperties
Parametri che definiscono la configurazione dell'analisi del traffico.
Nome | Tipo | Descrizione |
---|---|---|
networkWatcherFlowAnalyticsConfiguration |
Parametri che definiscono la configurazione dell'analisi del traffico. |