Flow Logs - Create Or Update
Créez ou mettez à jour un journal de flux pour le groupe de sécurité réseau spécifié.
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/networkWatchers/{networkWatcherName}/flowLogs/{flowLogName}?api-version=2023-09-01
Paramètres URI
Nom | Dans | Obligatoire | Type | Description |
---|---|---|---|---|
flow
|
path | True |
string |
Nom du journal de flux. |
network
|
path | True |
string |
Nom de l’observateur de réseau. |
resource
|
path | True |
string |
Nom du groupe de ressources. |
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.storageId | True |
string |
ID du compte de stockage utilisé pour stocker le journal de flux. |
properties.targetResourceId | True |
string |
ID du groupe de sécurité réseau auquel le journal de flux sera appliqué. |
id |
string |
ID de la ressource |
|
location |
string |
Emplacement de la ressource. |
|
properties.enabled |
boolean |
Indicateur pour activer/désactiver la journalisation des flux. |
|
properties.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. |
||
tags |
object |
Balises de ressource. |
Réponses
Nom | Type | Description |
---|---|---|
200 OK |
Mise à jour réussie. L’opération retourne la ressource de journal de flux résultante. |
|
201 Created |
La demande a réussi. L’opération retourne la ressource de journal de flux résultante. |
|
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
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"
}
Définitions
Nom | Description |
---|---|
Error |
Représentation des détails d’erreur courante. |
Error |
Objet d’erreur. |
Flow |
Ressource de journal de flux. |
Flow |
Paramètres qui définissent le format du journal de flux. |
Flow |
Type de fichier du journal de flux. |
Provisioning |
État d’approvisionnement actuel. |
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 d’erreur.
Nom | Type | Description |
---|---|---|
error |
Erreur |
FlowLog
Ressource de journal de flux.
Nom | Type | Description |
---|---|---|
etag |
string |
Chaîne unique en lecture seule qui change chaque fois que la ressource est mise à jour. |
id |
string |
ID de la ressource |
location |
string |
Emplacement de la ressource. |
name |
string |
Nom de la ressource. |
properties.enabled |
boolean |
Indicateur pour activer/désactiver la journalisation des flux. |
properties.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.provisioningState |
État d’approvisionnement 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. |
properties.targetResourceGuid |
string |
Guid du groupe de sécurité réseau auquel le journal de flux sera appliqué. |
properties.targetResourceId |
string |
ID du groupe de sécurité réseau auquel le journal de flux sera appliqué. |
tags |
object |
Balises de ressource. |
type |
string |
Type de ressource. |
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 |
ProvisioningState
État d’approvisionnement actuel.
Nom | Type | Description |
---|---|---|
Deleting |
string |
|
Failed |
string |
|
Succeeded |
string |
|
Updating |
string |
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’analyse 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. |