Flow Logs - Create Or Update
Vytvořte nebo aktualizujte protokol toku pro zadanou skupinu zabezpečení sítě.
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/networkWatchers/{networkWatcherName}/flowLogs/{flowLogName}?api-version=2023-09-01
Parametry identifikátoru URI
Name | V | Vyžadováno | Typ | Description |
---|---|---|---|---|
flow
|
path | True |
string |
Název protokolu toku. |
network
|
path | True |
string |
Název sledovacího procesu sítě. |
resource
|
path | True |
string |
Název skupiny prostředků. |
subscription
|
path | True |
string |
Přihlašovací údaje předplatného, které jednoznačně identifikují předplatné Microsoft Azure. ID předplatného je součástí identifikátoru URI pro každé volání služby. |
api-version
|
query | True |
string |
Verze rozhraní API klienta. |
Text požadavku
Name | Vyžadováno | Typ | Description |
---|---|---|---|
properties.storageId | True |
string |
ID účtu úložiště, který se používá k uložení protokolu toku. |
properties.targetResourceId | True |
string |
ID skupiny zabezpečení sítě, na kterou se použije protokol toku. |
id |
string |
ID prostředku. |
|
location |
string |
Umístění prostředku. |
|
properties.enabled |
boolean |
Příznak pro povolení nebo zakázání protokolování toku |
|
properties.flowAnalyticsConfiguration |
Parametry, které definují konfiguraci analýzy provozu. |
||
properties.format |
Parametry, které definují formát protokolu toku. |
||
properties.retentionPolicy |
Parametry, které definují zásady uchovávání informací pro protokol toků. |
||
tags |
object |
Značky prostředků. |
Odpovědi
Name | Typ | Description |
---|---|---|
200 OK |
Aktualizace proběhla úspěšně. Operace vrátí výsledný prostředek protokolu toků. |
|
201 Created |
Žádost byla úspěšná. Operace vrátí výsledný prostředek protokolu toků. |
|
Other Status Codes |
Chybová odpověď popisující, proč operace selhala. |
Zabezpečení
azure_auth
Tok Azure Active Directory OAuth2.
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
Name | Description |
---|---|
user_impersonation | zosobnění uživatelského účtu |
Příklady
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"
}
Definice
Name | Description |
---|---|
Error |
Znázornění běžných podrobností o chybách |
Error |
Objekt chyby. |
Flow |
Prostředek protokolu toku. |
Flow |
Parametry, které definují formát protokolu toku. |
Flow |
Typ souboru protokolu toku. |
Provisioning |
Aktuální stav zřizování. |
Retention |
Parametry, které definují zásady uchovávání informací pro protokol toků. |
Traffic |
Parametry, které definují konfiguraci analýzy provozu. |
Traffic |
Parametry, které definují konfiguraci analýzy provozu. |
ErrorDetails
Znázornění běžných podrobností o chybách
Name | Typ | Description |
---|---|---|
code |
string |
Kód chyby |
message |
string |
Chybová zpráva. |
target |
string |
Cíl chyby. |
ErrorResponse
Objekt chyby.
Name | Typ | Description |
---|---|---|
error |
Chyba |
FlowLog
Prostředek protokolu toku.
Name | Typ | Description |
---|---|---|
etag |
string |
Jedinečný řetězec jen pro čtení, který se změní při každé aktualizaci prostředku. |
id |
string |
ID prostředku. |
location |
string |
Umístění prostředku. |
name |
string |
Název prostředku. |
properties.enabled |
boolean |
Příznak pro povolení nebo zakázání protokolování toku |
properties.flowAnalyticsConfiguration |
Parametry, které definují konfiguraci analýzy provozu. |
|
properties.format |
Parametry, které definují formát protokolu toku. |
|
properties.provisioningState |
Stav zřizování protokolu toku. |
|
properties.retentionPolicy |
Parametry, které definují zásady uchovávání informací pro protokol toků. |
|
properties.storageId |
string |
ID účtu úložiště, který se používá k uložení protokolu toku. |
properties.targetResourceGuid |
string |
Guid skupiny zabezpečení sítě, na kterou se použije protokol toku. |
properties.targetResourceId |
string |
ID skupiny zabezpečení sítě, na kterou se použije protokol toku. |
tags |
object |
Značky prostředků. |
type |
string |
Typ prostředku. |
FlowLogFormatParameters
Parametry, které definují formát protokolu toku.
Name | Typ | Výchozí hodnota | Description |
---|---|---|---|
type |
Typ souboru protokolu toku. |
||
version |
integer |
0 |
Verze (revize) protokolu toku. |
FlowLogFormatType
Typ souboru protokolu toku.
Name | Typ | Description |
---|---|---|
JSON |
string |
ProvisioningState
Aktuální stav zřizování.
Name | Typ | Description |
---|---|---|
Deleting |
string |
|
Failed |
string |
|
Succeeded |
string |
|
Updating |
string |
RetentionPolicyParameters
Parametry, které definují zásady uchovávání informací pro protokol toků.
Name | Typ | Výchozí hodnota | Description |
---|---|---|---|
days |
integer |
0 |
Počet dnů pro uchování záznamů protokolu toků |
enabled |
boolean |
False |
Příznak pro povolení nebo zakázání uchovávání informací |
TrafficAnalyticsConfigurationProperties
Parametry, které definují konfiguraci analýzy provozu.
Name | Typ | Description |
---|---|---|
enabled |
boolean |
Příznak pro povolení nebo zakázání analýzy provozu |
trafficAnalyticsInterval |
integer |
Interval v minutách, který by rozhodoval, jak často má služba technického poradce provádět analýzu toků. |
workspaceId |
string |
Identifikátor GUID prostředku připojeného pracovního prostoru. |
workspaceRegion |
string |
Umístění připojeného pracovního prostoru. |
workspaceResourceId |
string |
ID prostředku připojeného pracovního prostoru. |
TrafficAnalyticsProperties
Parametry, které definují konfiguraci analýzy provozu.
Name | Typ | Description |
---|---|---|
networkWatcherFlowAnalyticsConfiguration |
Parametry, které definují konfiguraci analýzy provozu. |