ListenHTTP 2025.10.2.19¶
번들¶
org.apache.nifi | nifi-standard-nar
설명¶
HTTP 서버를 시작하고 지정된 기본 경로에서 수신 요청을 FlowFiles로 변환하기 위해 수신 대기합니다. 서비스의 기본 URI는 http://{hostname}:{port}/contentListener입니다. HEAD 및 POST 요청만 지원됩니다. GET, PUT, DELETE, OPTIONS 및 TRACE는 오류 및 HTTP 응답 상태 코드 405를 발생시킵니다. 또한 CONNECT도 오류 및 HTTP 응답 상태 코드 400을 발생시킵니다. GET은 <service_URI>/healthcheck에서 지원됩니다. 서비스를 사용할 수 있는 경우 “OK” 내용이 포함된 “200 OK”를 반환합니다. 상태 확인 기능은 다른 포트를 통해 액세스할 수 있도록 구성할 수 있습니다. 자세한 내용은 “상태 확인 요청을 위한 수신 포트” 속성의 설명서를 참조하세요. Record Reader 및 Record Writer 속성은 수신 요청을 레코드로 처리하기 위해 프로세서에서 활성화할 수 있습니다. 멀티파트 요청 및 FlowFileV3 형식(minifi)의 요청에는 레코드 처리가 허용되지 않습니다. 수신 요청에 FlowFileV3 패키지 형식이 포함된 경우 데이터는 자동으로 패키지 내에 포함된 개별 FlowFile로 압축이 풀립니다. 원본 FlowFile 이름이 복원됩니다.
입력 요구 사항¶
FORBIDDEN
민감한 동적 속성 지원¶
false
속성¶
속성 |
설명 |
|---|---|
승인된 DN 패턴 |
수신 연결의 주체의 고유 이름에 적용할 정규식입니다. 패턴이 제목 DN 과 일치하지 않으면 프로세서는 HTTP 403 Forbidden 상태로 응답합니다. |
기본 경로 |
수신 연결의 기본 경로 |
HTTP 특성으로 받을 헤더(정규식) |
FlowFile 특성으로 전달할 HTTP 헤더의 이름을 결정하는 정규식을 지정합니다 |
HTTP 프로토콜 |
TLS 와의 애플리케이션 계층 프로토콜 협상을 위해 지원되는 HTTP 프로토콜 |
수신 대기 포트 |
수신 연결을 수신 대기할 포트입니다 |
최대 미확인 flowfile 시간 |
캐시에서 제거되기 전에 FlowFile 확인을 기다리는 최대 시간입니다 |
요청 헤더 최대 크기 |
이 프로세서로 전송되는 요청에서 지원되는 HTTP 헤더의 최대 크기입니다 |
반환 코드 |
HTTP 호출 후 반환되는 HTTP 반환 코드 |
SSL 컨텍스트 서비스 |
SSL 컨텍스트 서비스는 HTTPS 를 지원합니다. |
authorized-issuer-dn-pattern |
수신 연결의 발급자 고유 이름에 적용할 정규식입니다. 패턴이 발급자 DN 과 일치하지 않는 경우 프로세서는 HTTP 403 Forbidden 상태로 응답합니다. |
클라이언트 인증 |
TLS 연결에 대한 클라이언트 인증 정책입니다. SSL 컨텍스트 서비스 구성 시 필수입니다. |
health-check-port |
수신되는 상태 확인 요청을 수신 대기할 포트입니다. 설정된 경우 수신 포트와 다른 포트여야 합니다. 프로세서가 양방향 SSL 을 사용하도록 설정되어 있고 상태 확인 요청에 대한 클라이언트 인증을 지원하지 않는 로드밸런서를 사용하는 경우 이 포트를 구성합니다. 이 포트를 통해 /<base_path>/healthcheck 서비스만 사용할 수 있으며 GET 및 HEAD 요청만 지원됩니다. 프로세서가 SSL 을 사용하지 않도록 설정된 경우 SSL 도 이 포트에서 사용되지 않습니다. 프로세서가 단방향 SSL 을 사용하도록 설정된 경우 이 포트에서는 단방향 SSL 이 사용됩니다. 프로세서가 양방향 SSL 을 사용하도록 설정된 경우 이 포트에서는 단방향 SSL 이 사용됩니다(클라이언트 인증이 필요하지 않음). |
최대 스레드 풀 크기 |
임베디드 Jetty 서버에서 사용할 최대 스레드 수입니다. 값은 8~1000 사이로 설정할 수 있습니다. 이 속성의 값은 플로우과 운영 체제의 성능에 영향을 미치므로 정당한 경우에만 기본값을 변경해야 합니다. 적은 수의 HTTP 클라이언트만 서버에 연결하는 경우 기본값보다 작은 값이 적합할 수 있습니다. 많은 수의 HTTP 클라이언트가 동시에 서버에 요청을 할 것으로 예상되는 경우 더 큰 값이 적합할 수 있습니다. |
multipart-read-buffer-size |
수신 파일의 내용이 디스크에 기록되는 임계값 크기입니다. Content-Type: multipart/form-data인 요청에만 적용됩니다. 서비스 거부 유형의 공격을 방지하고 힙 또는 디스크 공간을 채우는 것을 방지하는 데 사용됩니다. |
multipart-request-max-size |
요청의 최대 크기입니다. 내용 타입이 multipart/form-data인 요청에만 적용되며, 서비스 거부 유형의 공격을 방지하고 힙 또는 디스크 공간을 채우는 것을 방지하기 위해 사용됩니다 |
record-reader |
수신 FlowFile 을 레코드로 구문 분석하는 데 사용할 Record Reader입니다 |
record-writer |
레코드를 변환한 후 직렬화하는 데 사용할 Record Writer입니다 |
관계¶
이름 |
설명 |
|---|---|
성공 |
성공적으로 수신된 FlowFiles 의 관계 |
사용 사례¶
POST 로 수신된 FlowFileV3 내용 압축 풀기 |
다른 구성 요소가 포함된 사용 사례¶
허용되는 날짜 플로우 속도 제한 |