다음을 통해 공유


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
flowLogName
path True

string

흐름 로그의 이름입니다.

networkWatcherName
path True

string

네트워크 감시자의 이름입니다.

resourceGroupName
path True

string

리소스 그룹의 이름입니다.

subscriptionId
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

ManagedServiceIdentity

FlowLog 리소스 관리 ID

location

string

리소스 위치입니다.

properties.enabled

boolean

흐름 로깅을 사용하거나 사용하지 않도록 설정하는 플래그입니다.

properties.enabledFilteringCriteria

string

SrcIP, SrcPort, DstIP, DstPort, 프로토콜, 암호화, 방향 및 작업을 기반으로 네트워크 트래픽 로그를 필터링하는 선택적 필드입니다. 지정하지 않으면 모든 네트워크 트래픽이 기록됩니다.

properties.flowAnalyticsConfiguration

TrafficAnalyticsProperties

트래픽 분석의 구성을 정의하는 매개 변수입니다.

properties.format

FlowLogFormatParameters

흐름 로그 형식을 정의하는 매개 변수입니다.

properties.retentionPolicy

RetentionPolicyParameters

흐름 로그에 대한 보존 정책을 정의하는 매개 변수입니다.

tags

object

리소스 태그.

응답

Name 형식 Description
200 OK

FlowLog

업데이트에 성공했습니다. 이 작업은 결과 흐름 로그 리소스를 반환합니다.

201 Created

FlowLog

요청이 성공했습니다. 이 작업은 결과 흐름 로그 리소스를 반환합니다.

Other Status Codes

ErrorResponse

작업이 실패한 이유를 설명하는 오류 응답입니다.

보안

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
ErrorDetails

일반적인 오류 세부 정보 표현입니다.

ErrorResponse

오류 개체입니다.

FlowLog

흐름 로그 리소스입니다.

FlowLogFormatParameters

흐름 로그 형식을 정의하는 매개 변수입니다.

FlowLogFormatType

흐름 로그의 파일 형식입니다.

ManagedServiceIdentity

리소스의 ID입니다.

ProvisioningState

현재 프로비저닝 상태입니다.

ResourceIdentityType

리소스에 사용되는 ID의 형식입니다. 'SystemAssigned, UserAssigned' 형식에는 암시적으로 생성된 ID와 사용자 할당 ID 집합이 모두 포함됩니다. 'None' 형식은 가상 머신에서 모든 ID를 제거합니다.

RetentionPolicyParameters

흐름 로그에 대한 보존 정책을 정의하는 매개 변수입니다.

TrafficAnalyticsConfigurationProperties

트래픽 분석의 구성을 정의하는 매개 변수입니다.

TrafficAnalyticsProperties

트래픽 분석의 구성을 정의하는 매개 변수입니다.

UserAssignedIdentities

리소스와 연결된 사용자 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

ErrorDetails

오류
오류 세부 정보 개체입니다.

FlowLog

흐름 로그 리소스입니다.

Name 형식 Description
etag

string

리소스를 업데이트할 때마다 변경되는 고유한 읽기 전용 문자열입니다.

id

string

리소스 ID입니다.

identity

ManagedServiceIdentity

FlowLog 리소스 관리 ID

location

string

리소스 위치입니다.

name

string

리소스 이름입니다.

properties.enabled

boolean

흐름 로깅을 사용하거나 사용하지 않도록 설정하는 플래그입니다.

properties.enabledFilteringCriteria

string

SrcIP, SrcPort, DstIP, DstPort, 프로토콜, 암호화, 방향 및 작업을 기반으로 네트워크 트래픽 로그를 필터링하는 선택적 필드입니다. 지정하지 않으면 모든 네트워크 트래픽이 기록됩니다.

properties.flowAnalyticsConfiguration

TrafficAnalyticsProperties

트래픽 분석의 구성을 정의하는 매개 변수입니다.

properties.format

FlowLogFormatParameters

흐름 로그 형식을 정의하는 매개 변수입니다.

properties.provisioningState

ProvisioningState

흐름 로그의 프로비전 상태입니다.

properties.retentionPolicy

RetentionPolicyParameters

흐름 로그에 대한 보존 정책을 정의하는 매개 변수입니다.

properties.storageId

string

흐름 로그를 저장하는 데 사용되는 스토리지 계정의 ID입니다.

properties.targetResourceGuid

string

흐름 로그를 적용할 네트워크 보안 그룹의 Guid입니다.

properties.targetResourceId

string

흐름 로그를 적용할 네트워크 보안 그룹의 ID입니다.

tags

object

리소스 태그.

type

string

리소스 종류입니다.

FlowLogFormatParameters

흐름 로그 형식을 정의하는 매개 변수입니다.

Name 형식 Default value Description
type

FlowLogFormatType

흐름 로그의 파일 형식입니다.

version

integer

0

흐름 로그의 버전(수정 버전)입니다.

FlowLogFormatType

흐름 로그의 파일 형식입니다.

Name 형식 Description
JSON

string

ManagedServiceIdentity

리소스의 ID입니다.

Name 형식 Description
principalId

string

시스템 할당 ID의 보안 주체 ID입니다. 이 속성은 시스템 할당 ID에 대해서만 제공됩니다.

tenantId

string

시스템 할당 ID의 테넌트 ID입니다. 이 속성은 시스템 할당 ID에 대해서만 제공됩니다.

type

ResourceIdentityType

리소스에 사용되는 ID의 형식입니다. 'SystemAssigned, UserAssigned' 형식에는 암시적으로 생성된 ID와 사용자 할당 ID 집합이 모두 포함됩니다. 'None' 형식은 가상 머신에서 모든 ID를 제거합니다.

userAssignedIdentities

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

TrafficAnalyticsConfigurationProperties

트래픽 분석의 구성을 정의하는 매개 변수입니다.

UserAssignedIdentities

리소스와 연결된 사용자 ID 목록입니다. 사용자 ID 사전 키 참조는 '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}' 형식의 ARM 리소스 ID입니다.

Name 형식 Description