Network Watchers - Set Flow Log Configuration
Configure le journal de flux et l’analytique du trafic (facultatif) sur une ressource spécifiée.
POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/networkWatchers/{networkWatcherName}/configureFlowLog?api-version=2023-09-01
Paramètres URI
Nom | Dans | Obligatoire | Type | Description |
---|---|---|---|---|
network
|
path | True |
string |
Nom de la ressource network watcher. |
resource
|
path | True |
string |
Nom du groupe de ressources network watcher. |
subscription
|
path | True |
string |
Informations d’identification d’abonnement qui identifient de façon unique l’abonnement Microsoft Azure. L’ID d’abonnement fait partie de l’URI pour chaque appel de service. |
api-version
|
query | True |
string |
Version d’API client. |
Corps de la demande
Nom | Obligatoire | Type | Description |
---|---|---|---|
properties.enabled | True |
boolean |
Indicateur permettant d’activer/désactiver la journalisation de flux. |
properties.storageId | True |
string |
ID du compte de stockage utilisé pour stocker le journal de flux. |
targetResourceId | True |
string |
ID de la ressource à configurer pour le journal de flux et l’analytique du trafic (facultatif). |
flowAnalyticsConfiguration |
Paramètres qui définissent la configuration de l’analytique du trafic. |
||
properties.format |
Paramètres qui définissent le format du journal de flux. |
||
properties.retentionPolicy |
Paramètres qui définissent la stratégie de rétention pour le journal de flux. |
Réponses
Nom | Type | Description |
---|---|---|
200 OK |
Demande réussie pour la configuration du journal de flux et de la configuration de l’analytique du trafic (facultatif). |
|
202 Accepted |
Accepté et l’opération se termine de manière asynchrone. |
|
Other Status Codes |
Réponse d’erreur décrivant la raison de l’échec de l’opération. |
Sécurité
azure_auth
Flux OAuth2 Azure Active Directory.
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
Nom | Description |
---|---|
user_impersonation | Emprunter l’identité de votre compte d’utilisateur |
Exemples
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
}
}
Définitions
Nom | Description |
---|---|
Error |
Représentation des détails d’erreur courante. |
Error |
Objet error. |
Flow |
Paramètres qui définissent le format du journal de flux. |
Flow |
Type de fichier du journal de flux. |
Flow |
Informations sur la configuration du journal de flux et de l’analytique du trafic (facultatif) . |
Retention |
Paramètres qui définissent la stratégie de rétention pour le journal de flux. |
Traffic |
Paramètres qui définissent la configuration de l’analytique du trafic. |
Traffic |
Paramètres qui définissent la configuration de l’analytique du trafic. |
ErrorDetails
Représentation des détails d’erreur courante.
Nom | Type | Description |
---|---|---|
code |
string |
Code d’erreur. |
message |
string |
Message d’erreur. |
target |
string |
Cible d’erreur. |
ErrorResponse
Objet error.
Nom | Type | Description |
---|---|---|
error |
Erreur |
FlowLogFormatParameters
Paramètres qui définissent le format du journal de flux.
Nom | Type | Valeur par défaut | Description |
---|---|---|---|
type |
Type de fichier du journal de flux. |
||
version |
integer |
0 |
Version (révision) du journal de flux. |
FlowLogFormatType
Type de fichier du journal de flux.
Nom | Type | Description |
---|---|---|
JSON |
string |
FlowLogInformation
Informations sur la configuration du journal de flux et de l’analytique du trafic (facultatif) .
Nom | Type | Description |
---|---|---|
flowAnalyticsConfiguration |
Paramètres qui définissent la configuration de l’analytique du trafic. |
|
properties.enabled |
boolean |
Indicateur permettant d’activer/désactiver la journalisation de flux. |
properties.format |
Paramètres qui définissent le format du journal de flux. |
|
properties.retentionPolicy |
Paramètres qui définissent la stratégie de rétention pour le journal de flux. |
|
properties.storageId |
string |
ID du compte de stockage utilisé pour stocker le journal de flux. |
targetResourceId |
string |
ID de la ressource à configurer pour le journal de flux et l’analytique du trafic (facultatif). |
RetentionPolicyParameters
Paramètres qui définissent la stratégie de rétention pour le journal de flux.
Nom | Type | Valeur par défaut | Description |
---|---|---|---|
days |
integer |
0 |
Nombre de jours pour conserver les enregistrements du journal de flux. |
enabled |
boolean |
False |
Indicateur pour activer/désactiver la rétention. |
TrafficAnalyticsConfigurationProperties
Paramètres qui définissent la configuration de l’analytique du trafic.
Nom | Type | Description |
---|---|---|
enabled |
boolean |
Indicateur pour activer/désactiver l’analytique du trafic. |
trafficAnalyticsInterval |
integer |
Intervalle en minutes qui détermine la fréquence à laquelle le service TA doit effectuer l’analyse de flux. |
workspaceId |
string |
Guid de ressource de l’espace de travail attaché. |
workspaceRegion |
string |
Emplacement de l’espace de travail attaché. |
workspaceResourceId |
string |
ID de ressource de l’espace de travail attaché. |
TrafficAnalyticsProperties
Paramètres qui définissent la configuration de l’analytique du trafic.
Nom | Type | Description |
---|---|---|
networkWatcherFlowAnalyticsConfiguration |
Paramètres qui définissent la configuration de l’analytique du trafic. |