ListenHTTP 2025.5.31.15¶
번들¶
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”를 반환합니다. 상태 확인 기능은 다른 포트를 통해 액세스할 수 있도록 구성할 수 있습니다. 자세한 내용은 “Listening Port for health check requests” 속성에 대한 설명서를 참조하십시오. 프로세서에서 Record Reader 및 Record Writer 속성을 활성화하여 수신 요청을 레코드로 처리할 수 있습니다. 여러 부분으로 구성된 요청 및 FlowFileV3 형식(minifi)의 요청에 대해서는 레코드 처리가 허용되지 않습니다.
입력 요구 사항¶
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 내용 압축 풀기 |
다른 구성 요소가 포함된 사용 사례¶
허용되는 날짜 플로우 속도 제한 |