Flow Logs - Create Or Update
지정된 네트워크 보안 그룹에 대한 흐름 로그를 만들거나 업데이트합니다.
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/networkWatchers/{networkWatcherName}/flowLogs/{flowLogName}?api-version=2024-05-01
URI 매개 변수
Name | In(다음 안에) | 필수 | 형식 | Description |
---|---|---|---|---|
flow
|
path | True |
string |
흐름 로그의 이름입니다. |
network
|
path | True |
string |
네트워크 감시자의 이름입니다. |
resource
|
path | True |
string |
리소스 그룹의 이름입니다. |
subscription
|
path | True |
string |
Microsoft Azure 구독을 고유하게 식별하는 구독 자격 증명입니다. 구독 ID는 모든 서비스 호출에 대한 URI의 일부를 형성합니다. |
api-version
|
query | True |
string |
클라이언트 API 버전입니다. |
요청 본문
Name | 필수 | 형식 | Description |
---|---|---|---|
properties.storageId | True |
string |
흐름 로그를 저장하는 데 사용되는 스토리지 계정의 ID입니다. |
properties.targetResourceId | True |
string |
흐름 로그를 적용할 네트워크 보안 그룹의 ID입니다. |
id |
string |
리소스 ID입니다. |
|
identity |
FlowLog 리소스 관리 ID |
||
location |
string |
리소스 위치입니다. |
|
properties.enabled |
boolean |
흐름 로깅을 사용하거나 사용하지 않도록 설정하는 플래그입니다. |
|
properties.enabledFilteringCriteria |
string |
SrcIP, SrcPort, DstIP, DstPort, 프로토콜, 암호화, 방향 및 작업을 기반으로 네트워크 트래픽 로그를 필터링하는 선택적 필드입니다. 지정하지 않으면 모든 네트워크 트래픽이 기록됩니다. |
|
properties.flowAnalyticsConfiguration |
트래픽 분석의 구성을 정의하는 매개 변수입니다. |
||
properties.format |
흐름 로그 형식을 정의하는 매개 변수입니다. |
||
properties.retentionPolicy |
흐름 로그에 대한 보존 정책을 정의하는 매개 변수입니다. |
||
tags |
object |
리소스 태그. |
응답
Name | 형식 | Description |
---|---|---|
200 OK |
업데이트에 성공했습니다. 이 작업은 결과 흐름 로그 리소스를 반환합니다. |
|
201 Created |
요청이 성공했습니다. 이 작업은 결과 흐름 로그 리소스를 반환합니다. |
|
Other Status Codes |
작업이 실패한 이유를 설명하는 오류 응답입니다. |
보안
azure_auth
Azure Active Directory OAuth2 Flow.
형식:
oauth2
Flow:
implicit
권한 부여 URL:
https://login.microsoftonline.com/common/oauth2/authorize
범위
Name | Description |
---|---|
user_impersonation | 사용자 계정 가장 |
예제
Create or update flow log
샘플 요청
PUT https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/networkWatchers/nw1/flowLogs/fl?api-version=2024-05-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",
"enabledFilteringCriteria": "srcIP=158.255.7.8 || dstPort=56891",
"enabled": true,
"format": {
"type": "JSON",
"version": 1
}
},
"identity": {
"type": "UserAssigned",
"userAssignedIdentities": {
"/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ManagedIdentity/userAssignedIdentities/id1": {}
}
}
}
샘플 응답
{
"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",
"enabledFilteringCriteria": "srcIP=158.255.7.8 || dstPort=56891",
"enabled": true,
"flowAnalyticsConfiguration": {},
"retentionPolicy": {
"days": 0,
"enabled": false
},
"format": {
"type": "JSON",
"version": 1
}
},
"type": "Microsoft.Network/networkWatchers/FlowLogs",
"identity": {
"type": "UserAssigned",
"userAssignedIdentities": {
"/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ManagedIdentity/userAssignedIdentities/id1": {
"clientId": "c16d15e1-f60a-40e4-8a05-df3d3f655c14",
"principalId": "e3858881-e40c-43bd-9cde-88da39c05023"
}
}
},
"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",
"enabledFilteringCriteria": "srcIP=158.255.7.8 || dstPort=56891",
"enabled": true,
"flowAnalyticsConfiguration": {},
"retentionPolicy": {
"days": 0,
"enabled": false
},
"format": {
"type": "JSON",
"version": 1
}
},
"type": "Microsoft.Network/networkWatchers/FlowLogs",
"identity": {
"type": "UserAssigned",
"userAssignedIdentities": {
"/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ManagedIdentity/userAssignedIdentities/id1": {
"clientId": "c16d15e1-f60a-40e4-8a05-df3d3f655c14",
"principalId": "e3858881-e40c-43bd-9cde-88da39c05023"
}
}
},
"location": "centraluseuap"
}
정의
Name | Description |
---|---|
Error |
일반적인 오류 세부 정보 표현입니다. |
Error |
오류 개체입니다. |
Flow |
흐름 로그 리소스입니다. |
Flow |
흐름 로그 형식을 정의하는 매개 변수입니다. |
Flow |
흐름 로그의 파일 형식입니다. |
Managed |
리소스의 ID입니다. |
Provisioning |
현재 프로비저닝 상태입니다. |
Resource |
리소스에 사용되는 ID의 형식입니다. 'SystemAssigned, UserAssigned' 형식에는 암시적으로 생성된 ID와 사용자 할당 ID 집합이 모두 포함됩니다. 'None' 형식은 가상 머신에서 모든 ID를 제거합니다. |
Retention |
흐름 로그에 대한 보존 정책을 정의하는 매개 변수입니다. |
Traffic |
트래픽 분석의 구성을 정의하는 매개 변수입니다. |
Traffic |
트래픽 분석의 구성을 정의하는 매개 변수입니다. |
User |
리소스와 연결된 사용자 ID 목록입니다. 사용자 ID 사전 키 참조는 '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}' 형식의 ARM 리소스 ID입니다. |
ErrorDetails
일반적인 오류 세부 정보 표현입니다.
Name | 형식 | Description |
---|---|---|
code |
string |
오류 코드입니다. |
message |
string |
오류 메시지입니다. |
target |
string |
오류 대상입니다. |
ErrorResponse
오류 개체입니다.
Name | 형식 | Description |
---|---|---|
error |
오류 |
FlowLog
흐름 로그 리소스입니다.
Name | 형식 | Description |
---|---|---|
etag |
string |
리소스를 업데이트할 때마다 변경되는 고유한 읽기 전용 문자열입니다. |
id |
string |
리소스 ID입니다. |
identity |
FlowLog 리소스 관리 ID |
|
location |
string |
리소스 위치입니다. |
name |
string |
리소스 이름입니다. |
properties.enabled |
boolean |
흐름 로깅을 사용하거나 사용하지 않도록 설정하는 플래그입니다. |
properties.enabledFilteringCriteria |
string |
SrcIP, SrcPort, DstIP, DstPort, 프로토콜, 암호화, 방향 및 작업을 기반으로 네트워크 트래픽 로그를 필터링하는 선택적 필드입니다. 지정하지 않으면 모든 네트워크 트래픽이 기록됩니다. |
properties.flowAnalyticsConfiguration |
트래픽 분석의 구성을 정의하는 매개 변수입니다. |
|
properties.format |
흐름 로그 형식을 정의하는 매개 변수입니다. |
|
properties.provisioningState |
흐름 로그의 프로비전 상태입니다. |
|
properties.retentionPolicy |
흐름 로그에 대한 보존 정책을 정의하는 매개 변수입니다. |
|
properties.storageId |
string |
흐름 로그를 저장하는 데 사용되는 스토리지 계정의 ID입니다. |
properties.targetResourceGuid |
string |
흐름 로그를 적용할 네트워크 보안 그룹의 Guid입니다. |
properties.targetResourceId |
string |
흐름 로그를 적용할 네트워크 보안 그룹의 ID입니다. |
tags |
object |
리소스 태그. |
type |
string |
리소스 종류입니다. |
FlowLogFormatParameters
흐름 로그 형식을 정의하는 매개 변수입니다.
Name | 형식 | Default value | Description |
---|---|---|---|
type |
흐름 로그의 파일 형식입니다. |
||
version |
integer |
0 |
흐름 로그의 버전(수정 버전)입니다. |
FlowLogFormatType
흐름 로그의 파일 형식입니다.
Name | 형식 | Description |
---|---|---|
JSON |
string |
ManagedServiceIdentity
리소스의 ID입니다.
Name | 형식 | Description |
---|---|---|
principalId |
string |
시스템 할당 ID의 보안 주체 ID입니다. 이 속성은 시스템 할당 ID에 대해서만 제공됩니다. |
tenantId |
string |
시스템 할당 ID의 테넌트 ID입니다. 이 속성은 시스템 할당 ID에 대해서만 제공됩니다. |
type |
리소스에 사용되는 ID의 형식입니다. 'SystemAssigned, UserAssigned' 형식에는 암시적으로 생성된 ID와 사용자 할당 ID 집합이 모두 포함됩니다. 'None' 형식은 가상 머신에서 모든 ID를 제거합니다. |
|
userAssignedIdentities |
리소스와 연결된 사용자 ID 목록입니다. 사용자 ID 사전 키 참조는 '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}' 형식의 ARM 리소스 ID입니다. |
ProvisioningState
현재 프로비저닝 상태입니다.
Name | 형식 | Description |
---|---|---|
Deleting |
string |
|
Failed |
string |
|
Succeeded |
string |
|
Updating |
string |
ResourceIdentityType
리소스에 사용되는 ID의 형식입니다. 'SystemAssigned, UserAssigned' 형식에는 암시적으로 생성된 ID와 사용자 할당 ID 집합이 모두 포함됩니다. 'None' 형식은 가상 머신에서 모든 ID를 제거합니다.
Name | 형식 | Description |
---|---|---|
None |
string |
|
SystemAssigned |
string |
|
SystemAssigned, UserAssigned |
string |
|
UserAssigned |
string |
RetentionPolicyParameters
흐름 로그에 대한 보존 정책을 정의하는 매개 변수입니다.
Name | 형식 | Default value | Description |
---|---|---|---|
days |
integer |
0 |
흐름 로그 레코드를 보존할 일 수입니다. |
enabled |
boolean |
False |
보존을 사용/사용하지 않도록 설정하는 플래그입니다. |
TrafficAnalyticsConfigurationProperties
트래픽 분석의 구성을 정의하는 매개 변수입니다.
Name | 형식 | Description |
---|---|---|
enabled |
boolean |
트래픽 분석을 사용하거나 사용하지 않도록 설정하는 플래그입니다. |
trafficAnalyticsInterval |
integer |
TA 서비스가 흐름 분석을 수행하는 빈도를 결정하는 간격(분)입니다. |
workspaceId |
string |
연결된 작업 영역의 리소스 GUID입니다. |
workspaceRegion |
string |
연결된 작업 영역의 위치입니다. |
workspaceResourceId |
string |
연결된 작업 영역의 리소스 ID입니다. |
TrafficAnalyticsProperties
트래픽 분석의 구성을 정의하는 매개 변수입니다.
Name | 형식 | Description |
---|---|---|
networkWatcherFlowAnalyticsConfiguration |
트래픽 분석의 구성을 정의하는 매개 변수입니다. |
UserAssignedIdentities
리소스와 연결된 사용자 ID 목록입니다. 사용자 ID 사전 키 참조는 '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}' 형식의 ARM 리소스 ID입니다.
Name | 형식 | Description |
---|---|---|
|