Network Watchers - Set Flow Log Configuration
Configura il log del flusso e l'analisi del traffico (facoltativo) in una risorsa specificata.
POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/networkWatchers/{networkWatcherName}/configureFlowLog?api-version=2023-09-01
Parametri dell'URI
Nome | In | Necessario | Tipo | Descrizione |
---|---|---|---|---|
network
|
path | True |
string |
Nome della risorsa network watcher. |
resource
|
path | True |
string |
Nome del gruppo di risorse network watcher. |
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.enabled | True |
boolean |
Flag per abilitare/disabilitare la registrazione del flusso. |
properties.storageId | True |
string |
ID dell'account di archiviazione usato per archiviare il log del flusso. |
targetResourceId | True |
string |
ID della risorsa da configurare per il log del flusso e l'analisi del traffico (facoltativo). |
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 del flusso. |
Risposte
Nome | Tipo | Descrizione |
---|---|---|
200 OK |
Richiesta di esito positivo per l'impostazione del log del flusso e la configurazione facoltativa dell'analisi del traffico. |
|
202 Accepted |
Accettata e l'operazione verrà completata in modo asincrono. |
|
Other Status Codes |
Risposta di errore che descrive perché 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
Configure flow log
Sample Request
POST https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/networkWatchers/nw1/configureFlowLog?api-version=2023-09-01
{
"targetResourceId": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/networkSecurityGroups/nsg1",
"properties": {
"storageId": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Storage/storageAccounts/st1",
"enabled": true
}
}
Sample Response
{
"targetResourceId": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/networkSecurityGroups/nsg1",
"properties": {
"storageId": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Storage/storageAccounts/st1",
"enabled": true
}
}
Location: https:/management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/networkWatchers/nw1/configureFlowLog?api-version=2023-09-01
{
"targetResourceId": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/networkSecurityGroups/nsg1",
"properties": {
"storageId": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Storage/storageAccounts/st1",
"enabled": true
}
}
Definizioni
Nome | Descrizione |
---|---|
Error |
Rappresentazione dei dettagli degli errori comuni. |
Error |
Oggetto error. |
Flow |
Parametri che definiscono il formato del log del flusso. |
Flow |
Tipo di file del log del flusso. |
Flow |
Informazioni sulla configurazione del log del flusso e dell'analisi del traffico (facoltativo). |
Retention |
Parametri che definiscono i criteri di conservazione per il log del flusso. |
Traffic |
Parametri che definiscono la configurazione dell'analisi del traffico. |
Traffic |
Parametri che definiscono la configurazione dell'analisi del traffico. |
ErrorDetails
Rappresentazione dei dettagli degli errori comuni.
Nome | Tipo | Descrizione |
---|---|---|
code |
string |
Codice di errore. |
message |
string |
Messaggio di errore. |
target |
string |
Destinazione errore. |
ErrorResponse
Oggetto error.
Nome | Tipo | Descrizione |
---|---|---|
error |
Errore |
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 |
FlowLogInformation
Informazioni sulla configurazione del log del flusso e dell'analisi del traffico (facoltativo).
Nome | Tipo | Descrizione |
---|---|---|
flowAnalyticsConfiguration |
Parametri che definiscono la configurazione dell'analisi del traffico. |
|
properties.enabled |
boolean |
Flag per abilitare/disabilitare la registrazione del flusso. |
properties.format |
Parametri che definiscono il formato del log del flusso. |
|
properties.retentionPolicy |
Parametri che definiscono i criteri di conservazione per il log del flusso. |
|
properties.storageId |
string |
ID dell'account di archiviazione usato per archiviare il log del flusso. |
targetResourceId |
string |
ID della risorsa da configurare per il log del flusso e l'analisi del traffico (facoltativo). |
RetentionPolicyParameters
Parametri che definiscono i criteri di conservazione per il log del flusso.
Nome | Tipo | Valore predefinito | Descrizione |
---|---|---|---|
days |
integer |
0 |
Numero di giorni per conservare i record di 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 deciderà la frequenza con cui il servizio TA deve eseguire analisi del flusso. |
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. |