Skip to main content

InvokeHTTP

Описание

Процессор HTTP-клиента, который может взаимодействовать с настраиваемой HTTP-целевой точкой. Настраиваются URL назначения и метод HTTP. При использовании методов PUT, POST или PATCH содержимое FlowFile включается в тело запроса, а атрибуты FlowFile преобразуются в HTTP-заголовки в зависимости от конфигурации.

Теги

http, https, rest, client

Свойства

НазваниеОписание
HTTP MethodМетод HTTP-запроса (GET, POST, PUT, PATCH, DELETE, HEAD, OPTIONS). Также поддерживаются произвольные методы. Методы, отличные от POST, PUT и PATCH, будут отправляться без тела сообщения. Поддерживает язык выражений: true (будет оцениваться с использованием атрибутов файла потока и переменных среды)
HTTP URLУдаленный URL-адрес HTTP, включающий схему http или https, а также имя хоста или IP-адрес с необязательными элементами порта и пути. Пользователь должен выполнить любую кодировку URL-адреса. Поддерживает язык выражений: true (будет оцениваться с использованием атрибутов файла потока и переменных среды)
HTTP/2 DisabledОтключить согласование протокола HTTP/2. Для HTTP/2 требуется TLS. Протокол HTTP/1.1 требуется при отключенном HTTP/2.
SSL Context ServiceСлужба контекста SSL предоставляет доверенные сертификаты и сертификаты клиента для связи TLS.
Connection TimeoutМаксимальное время ожидания первоначального подключения к URL-адресу HTTP.
Socket Read TimeoutМаксимальное время ожидания получения ответов от сокетного соединения с URL-адресом HTTP.
Socket Write TimeoutМаксимальное время ожидания операций записи при отправке запросов от сокетного соединения с URL-адресом HTTP.
Socket Idle TimeoutМаксимальное время ожидания перед закрытием неактивных соединений с URL-адресом HTTP.
Socket Idle ConnectionsМаксимальное количество простаивающих подключений к URL-адресу HTTP.
Proxy Configuration ServiceSpecifies the Proxy Configuration Controller Service to proxy network requests. If set, it supersedes proxy settings configured per component. Supported proxies: HTTP + AuthN, SOCKS In case of SOCKS, it is not guaranteed that the selected SOCKS Version will be used by the processor.
Request OAuth2 Access Token ProviderПозволяет управлять получением токена OAuth2 Bearer, применяемого к HTTP-запросам с использованием заголовка авторизации.
Request UsernameИмя пользователя, предоставляемое для аутентификации HTTP-запросов. Закодировано с использованием Base64 для базовой аутентификации HTTP, как описано в RFC 7617.
Request PasswordПароль, предоставляемый для аутентификации HTTP-запросов. Закодирован с использованием Base64 для базовой аутентификации HTTP, как описано в RFC 7617. Чувствительный параметр: true
Request Digest Authentication EnabledВключить дайджест-аутентификацию для HTTP-запросов с использованием имени пользователя и пароля, как описано в RFC 7616.This Property is only considered if the [Request Username] Property has a value specified.
Request Failure Penalization EnabledВключить штрафные санкции для запросов FlowFiles при получении HTTP-ответа с кодом состояния от 400 до 499.
Request Body EnabledВключить отправку тела HTTP-запроса для методов PATCH, POST или PUT.This Property is only considered if the [HTTP Method] Property is set to one of the following values: [POST], [PATCH], [PUT]
Request Multipart Form-Data NameВключение отправки тела HTTP-запроса, отформатированного с использованием multipart/form-data и настроенного имени формы. Поддерживает язык выражений: true (будет оцениваться с использованием атрибутов файла потока и переменных среды)This Property is only considered if the [Request Body Enabled] Property has a value of "true".
Request Multipart Form-Data Filename EnabledВключение отправки атрибута имени файла FlowFile в качестве параметра имени файла в заголовке Content-Disposition для HTTP-запросов multipart/form-data.This Property is only considered if the [Request Multipart Form-Data Name] Property has a value specified.
Request Chunked Transfer-Encoding EnabledВключите отправку HTTP-запросов с заголовком Transfer-Encoding, установленным в значение chunked, и отключите отправку заголовка Content-Length. Transfer-Encoding применяется к телу запроса в HTTP/1.1, как описано в разделе 3.3.1 RFC 7230.This Property is only considered if the [HTTP Method] Property is set to one of the following values: [POST], [PATCH], [PUT]
Request Content-EncodingКодирование содержимого HTTP, применяемое к телу запроса во время передачи. Получающий сервер должен поддерживать выбранное кодирование, чтобы избежать сбоев запроса.This Property is only considered if the [HTTP Method] Property is set to one of the following values: [POST], [PATCH], [PUT]
Request Content-TypeHTTP Content-Type Header applied to when sending an HTTP request body for PATCH, POST, or PUT methods. The Content-Type defaults to application/octet-stream when not configured. Поддерживает язык выражений: true (будет оцениваться с использованием атрибутов файла потока и переменных среды)This Property is only considered if the [HTTP Method] Property is set to one of the following values: [POST], [PATCH], [PUT]
Request Date Header EnabledВключить отправку HTTP-заголовка Date в HTTP-запросах, как описано в разделе 7.1.1.2 RFC 7231.
Request Header Attributes PatternРегулярное выражение, определяющее, какие атрибуты FlowFile отправлять в качестве HTTP-заголовков в запросе. Если не указано, никакие атрибуты не отправляются в качестве заголовков. Динамические свойства всегда будут отправляться в качестве заголовков. Имя динамического свойства будет ключом заголовка, а значение динамического свойства, интерпретируемое как язык выражений, будет значением заголовка. Атрибуты и их значения ограничены символами ASCII в соответствии с требованиями протокола HTTP.
Request User-AgentЗаголовок HTTP User-Agent, применяемый к запросам. Раздел 5.5.3 RFC 7231 описывает рекомендуемое форматирование. Поддерживает язык выражений: true (будет оцениваться с использованием атрибутов файла потока и переменных среды)
Response Body Attribute NameИмя атрибута FlowFile, используемого для записи тела HTTP-ответа для FlowFiles, передаваемых в исходную связь. Поддерживает язык выражений: true (будет оцениваться с использованием атрибутов файла потока и переменных среды)
Response Body Attribute SizeМаксимальный размер в байтах, применяемый при записи тела HTTP-ответа в атрибут FlowFile. Атрибуты, превышающие максимальный размер, будут усечены.This Property is only considered if the [Response Body Attribute Name] Property has a value specified.
Response Body IgnoredОтключить запись FlowFiles HTTP-ответа в связь Response
Response Cache EnabledВключить кэширование ответов HTTP, описанное в RFC 7234. При кэшировании ответов учитываются ETag и другие заголовки.
Response Cache SizeМаксимальный размер кэша ответов HTTP в байтах. При кэшировании ответов учитываются ETag и другие заголовки.This Property is only considered if the [Response Cache Enabled] Property has a value of "true".
Response Cookie StrategyСтратегия принятия и сохранения файлов cookie HTTP. Принятие файлов cookie обеспечивает сохранение данных при нескольких запросах.
Response Generation RequiredВключить генерацию и передачу FlowFile в отношение «Ответ» независимо от полученного HTTP-ответа.
Response FlowFile Naming StrategyОпределяет стратегию, используемую для установки атрибута имени файла FlowFiles, передаваемых в отношение «Ответ».
Response Header Request Attributes EnabledВключить добавление заголовков HTTP-ответа в качестве атрибутов к FlowFiles, передаваемым в отношение «Оригинал».
Response Redirects EnabledВключить следующие HTTP-перенаправления, отправляемые с ответами серии HTTP 300, как описано в разделе 6.4 RFC 7231.

Взаимосвязи

  • Original: Файлы запросов, передаваемые при получении HTTP-ответов с кодом состояния от 200 до 299.
  • Failure: Файлы запросов передаются при получении ошибок связи сокета.
  • Retry: Файлы запросов передаются при получении HTTP-ответов с кодом состояния от 500 до 599.
  • Response: Файлы ответов, передаваемые при получении HTTP-ответов с кодом состояния от 200 до 299.
  • No Retry: Файлы запросов передаются при получении HTTP-ответов с кодом состояния от 400 до 499.