InvokeHTTP 2025.5.31.15¶
번들¶
org.apache.nifi | nifi-standard-nar
설명¶
구성 가능한 HTTP 엔드포인트와 상호 작용할 수 있는 HTTP 클라이언트 프로세서입니다. 대상 URL 및 HTTP 메서드를 구성할 수 있습니다. HTTP 메서드가 PUT, POST 또는 PATCH 인 경우 FlowFile 내용이 요청 본문으로 포함되고 FlowFile 특성은 구성 속성에 따라 선택적으로 HTTP 헤더로 변환됩니다.
입력 요구 사항¶
ALLOWED
민감한 동적 속성 지원¶
true
속성¶
속성 |
설명 |
|---|---|
Connection Timeout |
HTTP URL 에 대한 초기 소켓 연결을 기다리는 최대 시간입니다. |
HTTP 메서드 |
HTTP 요청 방법(GET, POST, PUT, PATCH, DELETE, HEAD, OPTIONS). 임의의 방법도 지원됩니다. POST, PUT 및 PATCH 이외의 방법은 메시지 본문 없이 전송됩니다. |
HTTP URL |
HTTP 원격 URL 포트 및 경로 요소(선택 사항)가 포함된 호스트 이름 또는 IP 주소와 http 또는 https 체계를 포함합니다. URL 인코딩은 사용자가 직접 수행해야 합니다. |
HTTP/2 비활성화됨 |
HTTP/2 프로토콜의 협상을 비활성화합니다. HTTP/2에는TLS 가 필요합니다. HTTP/2를 비활성화하면 HTTP/1.1 프로토콜 지원이 필수입니다. |
OAuth2 Access Token Refresh Strategy |
OAuth2 액세스 토큰을 새로 고치는 데 사용할 전략을 지정합니다. |
요청 본문 활성화됨 |
PATCH, POST 또는 PUT 메소드에 대해 HTTP 요청 본문 전송을 활성화합니다. |
요청 청크 전송-인코딩 활성화됨 |
전송 인코딩 헤더를 청크로 설정한 HTTP 요청 전송을 활성화하고 내용 길이 헤더 전송을 비활성화합니다. 전송 인코딩은 RFC 7230 섹션 3.3.1에 설명된 대로 HTTP/1.1 요청의 본문에 적용됩니다 |
내용 인코딩 요청하기 |
HTTP 내용 인코딩 - 전송 중 요청 본문에 인코딩이 적용됩니다. 요청 실패를 방지하려면 수신 서버가 선택한 인코딩을 지원해야 합니다. |
요청 내용 유형 |
PATCH, POST, PUT 메소드에 대한 HTTP 요청 본문을 보낼 때 적용되는 HTTP 내용 유형 헤더입니다. 내용 유형은 구성되지 않은 경우 기본적으로 application/octet-stream으로 설정됩니다. |
요청 날짜 헤더 활성화됨 |
RFC 7231 섹션 7.1.1.2에 설명된 대로 HTTP 요청에 HTTP 날짜 헤더를 보내도록 설정합니다. |
다이제스트 인증 요청 활성화됨 |
RFC 7616에 설명된 대로 사용자 이름 및 비밀번호 자격 증명을 사용하여 HTTP 요청에 다이제스트 인증을 사용하도록 설정합니다. |
요청 실패 페널티 활성화됨 |
상태 코드가 400~499 사이인 HTTP 응답을 수신하면 FlowFiles 요청에 대한 페널티를 활성화합니다. |
요청 헤더 특성 패턴 |
요청에서 HTTP 헤더로 보낼 FlowFile 특성을 정의하는 정규식입니다. 정의되지 않은 경우 특성이 헤더로 전송되지 않습니다. 동적 속성은 항상 헤더로 전송됩니다. 동적 속성 이름은 헤더 키가 되고, 식 언어로 해석되는 동적 속성 값은 헤더 값이 됩니다. 특성과 그 값은 HTTP 프로토콜의 요구 사항으로 인해 ASCII 문자로 제한됩니다. |
다중 부분 양식 요청 - 데이터 파일 이름 사용 가능 |
멀티파트/폼 데이터 HTTP 요청에 대해 내용-배치 헤더의 파일 이름 매개 변수로 FlowFile 파일 이름 특성을 전송하도록 설정합니다. |
다중 부분 양식 요청 - 데이터 이름 |
멀티파트/양식 데이터를 사용하고 구성된 양식 이름을 사용하여 HTTP 요청 본문 형식의 전송을 사용하도록 설정합니다. |
요청 OAuth2 액세스 토큰 공급자 |
승인 헤더를 사용하여 HTTP 요청에 적용된 OAuth2 무기명 토큰을 관리 검색할 수 있습니다. |
비밀번호 요청하기 |
HTTP 요청의 인증을 위해 제공되는 비밀번호입니다. RFC 7617에 설명된 대로 HTTP 기본 인증에 대해 Base64를 사용하여 인코딩됩니다. |
사용자 Agent 요청하기 |
HTTP 사용자-Agent 헤더가 요청에 적용됩니다. RFC 7231 섹션 5.5.3에서는 권장 형식에 대해 설명합니다. |
사용자 이름 요청 |
HTTP 요청의 인증을 위해 제공되는 사용자 이름입니다. RFC 7617에 설명된 대로 HTTP 기본 인증에 대해 Base64를 사용하여 인코딩됩니다. |
응답 본문 특성 이름 |
원본 관계로 전송된 FlowFiles 에 대한 HTTP 응답 본문을 작성하는 데 사용되는 FlowFile 특성 이름입니다. |
응답 본문 특성 크기 |
FlowFile 특성에 HTTP 응답 본문을 작성할 때 적용되는 최대 크기(바이트)입니다. 최대치를 초과하는 특성은 잘립니다. |
응답 본문 무시됨 |
HTTP 응답 FlowFiles 에 응답 관계 쓰기를 비활성화합니다. |
응답 캐시 활성화됨 |
RFC 7234에 설명된 HTTP 응답 캐싱을 활성화합니다. 캐시 응답은 ETag 및 기타 헤더를 고려합니다. |
응답 캐시 크기 |
HTTP 응답 캐시의 최대 크기(바이트)입니다. 캐시 응답은 ETag 및 기타 헤더를 고려합니다. |
Response Cookie Strategy |
HTTP 쿠키를 수락하고 유지하는 전략. 쿠키를 수락하면 여러 요청에 걸쳐 지속성을 유지할 수 있습니다. |
Response FlowFile Naming Strategy |
응답 관계로 전송된 FlowFiles 의 파일 이름 특성을 설정하는 데 사용되는 전략을 결정합니다. |
응답 생성 필수 |
HTTP 응답 수신 여부에 관계없이 FlowFile 을 생성하고 응답 관계로 전송할 수 있도록 설정합니다. |
응답 헤더 요청 특성 활성화됨 |
원본, 재시도 또는 재시도 없음 관계로 전송된 FlowFiles 에 HTTP 응답 헤더를 특성으로 추가하도록 설정합니다. |
응답 헤더 요청 특성 접두사 |
원본, 재시도 또는 재시도 없음 관계로 전송된 FlowFiles 에 대한 특성으로 포함된 경우 HTTP 응답 헤더에 접두사를 추가합니다. ‘.’ 또는 ‘-’ 같은 구분 문자로 끝나는 것이 좋습니다. |
응답 리디렉션 활성화됨 |
RFC 7231 섹션 6.4에 설명된 대로 HTTP 300 시리즈 응답과 함께 전송된 다음 HTTP 리디렉션을 사용하도록 설정합니다. |
SSL 컨텍스트 서비스 |
SSL 컨텍스트 서비스는 TLS 통신을 위한 신뢰할 수 있는 인증서 및 클라이언트 인증서를 제공합니다. |
소켓 유휴 연결 |
HTTP URL 에 대한 최대 유휴 연결 수입니다. |
소켓 유휴 시간 제한 |
HTTP URL 에 대한 유휴 연결을 닫기 전에 대기할 수 있는 최대 시간입니다. |
소켓 읽기 시간 제한 |
HTTP URL 에 대한 소켓 연결에서 응답을 받기 위해 대기하는 최대 시간입니다. |
소켓 쓰기 시간 제한 |
소켓 연결에서 HTTP URL 로 요청을 보내는 동안 쓰기 작업을 기다리는 최대 시간입니다. |
프록시 구성 서비스 |
네트워크 요청을 프록시할 프록시 구성 컨트롤러 서비스를 지정합니다. SOCKS 의 경우 선택한 SOCKS 버전이 프로세서에서 사용된다는 보장은 없습니다. |
관계¶
이름 |
설명 |
|---|---|
실패 |
소켓 통신 오류 수신 시 FlowFiles 전송을 요청합니다. |
재시도 안 함 |
상태 코드가 400~499 사이인 HTTP 응답을 받으면 FlowFiles 전송을 요청합니다. |
원본 |
상태 코드가 200에서 299 사이인 HTTP 응답을 수신하면 FlowFiles 전송을 요청합니다. |
응답 |
상태 코드가 200에서 299 사이인 HTTP 응답을 수신하면 FlowFiles 응답이 전송됩니다. |
다시 시도 |
상태 코드가 500~599 사이인 HTTP 응답을 받으면 FlowFiles 전송을 요청합니다. |
Writes 특성¶
이름 |
설명 |
|---|---|
invokehttp.status.code |
반환되는 상태 코드 |
invokehttp.status.message |
반환되는 상태 메시지 |
invokehttp.response.본문 |
수신된 상태 코드가 성공(2xx)이 아닌 인스턴스에서는 응답 본문이 요청의 ‘invokehttp.response.body’ 특성 FlowFile 에 저장됩니다. |
invokehttp.request.url |
원본 요청 URL |
invokehttp.request.duration |
외부 엔드포인트에 대한 HTTP 호출의 지속 시간(밀리초) |
invokehttp.response.url |
리디렉션 후 최종적으로 요청된 URL 은 다음과 같습니다 |
invokehttp.tx.id |
응답을 읽은 후 반환되는 트랜잭션 ID |
invokehttp.remote.dn |
원격 서버의 DN |
invokehttp.java.exception.class |
프로세서 실패 시 발생하는 Java 예외 클래스 |
invokehttp.java.exception.message |
프로세서 실패 시 발생하는 Java 예외 메시지 |
user-defined |
‘Put Response Body In Attribute’ 속성이 설정되어 있으면 설정된 값이 특성 키가 되고 HTTP 응답의 본문이 됩니다. |