Skip to main content

ListenHTTP

Описание

Запускает HTTP-сервер и прослушивает указанный путь для преобразования входящих запросов в FlowFiles. URI службы по умолчанию — http://{hostname}:{port}/contentListener. Поддерживаются только запросы HEAD и POST. Запросы GET, PUT, DELETE, OPTIONS и TRACE вызовут ошибку и вернут код ответа HTTP 405; CONNECT также вызовет ошибку с кодом ответа HTTP 400. Запросы GET поддерживаются на <service_URI>/healthcheck. Если служба доступна, она возвращает "200 OK" с содержимым "OK". Функция проверки работоспособности может быть настроена для доступа через другой порт. Для подробностей см. документацию свойства "Порт для проверки работоспособности".

Теги

ingest, http, https, rest, listen

Свойства

НазваниеОписание
Base PathБазовый путь для входящих подключений Поддерживает язык выражений: true (будет оцениваться только с использованием переменных среды)
Listening PortПорт для прослушивания входящих подключений Поддерживает язык выражений: true (будет оцениваться только с использованием переменных среды)
Listening Port for Health Check RequestsПорт для прослушивания входящих запросов проверки работоспособности. Если он указан, то должен отличаться от порта прослушивания. Настройте этот порт, если процессор настроен на использование двустороннего SSL и используется балансировщик нагрузки, который не поддерживает аутентификацию клиента для запросов проверки работоспособности. Через этот порт доступна только служба /<base_path>/healthcheck, и поддерживаются только запросы GET и HEAD. Если процессор настроен на использование SSL, SSL не будет использоваться и на этом порту. Если процессор настроен на использование одностороннего SSL, на этом порту будет использоваться односторонний SSL. Если процессор настроен на использование двустороннего протокола SSL, на этом порту будет использоваться односторонний протокол SSL (аутентификация клиента не требуется). Поддерживает язык выражений: true (будет оцениваться только с использованием переменных среды)
Max Data to Receive per SecondМаксимальный объем данных для получения в секунду; позволяет ограничить пропускную способность до указанной скорости передачи данных; если не указано, скорость передачи данных не ограничивается
SSL Context ServiceСлужба SSL-контекста обеспечивает поддержку HTTPS
HTTP ProtocolsПротоколы HTTP, поддерживаемые для согласования протокола прикладного уровня с TLSThis Property is only considered if the [SSL Context Service] Property has a value specified.
Client AuthenticationПолитика аутентификации клиента для TLS-соединений. Требуется при настройке службы SSL-контекста.This Property is only considered if the [SSL Context Service] Property has a value specified.
Authorized Subject DN PatternРегулярное выражение, применяемое к отличительному имени субъекта входящих подключений. Если шаблон не соответствует DN субъекта, процессор выдаст ответ со статусом HTTP 403 Forbidden.
Authorized Issuer DN PatternРегулярное выражение, применяемое к отличительному имени эмитента во входящих соединениях. Если шаблон не соответствует отличительному имени эмитента, процессор ответит кодом состояния HTTP 403 «Запрещено».
Max Unconfirmed Flowfile TimeМаксимальное время ожидания подтверждения FlowFile перед его удалением из кэша
HTTP Headers to receive as Attributes (Regex)Указывает регулярное выражение, определяющее имена заголовков HTTP, которые должны передаваться в качестве атрибутов FlowFile
Return CodeКод возврата HTTP, возвращаемый после каждого HTTP-вызова
Multipart Request Max SizeМаксимальный размер запроса. Применяется только к запросам с Content-Type: multipart/form-data и используется для предотвращения атак типа «отказ в обслуживании», а также для предотвращения заполнения кучи или дискового пространства.
Multipart Read Buffer SizeПороговый размер, при котором содержимое входящего файла будет записано на диск. Применяется только к запросам с Content-Type: multipart/form-data. Используется для предотвращения атак типа «отказ в обслуживании», а также для предотвращения заполнения кучи или дискового пространства.
Maximum Thread Pool SizeМаксимальное количество потоков, используемых встроенным сервером Jetty. Значение может быть установлено в диапазоне от 8 до 1000. Значение этого свойства влияет на производительность потоков и операционной системы, поэтому значение по умолчанию следует изменять только в обоснованных случаях. Значение, меньшее значения по умолчанию, может подойти, если к серверу подключается лишь небольшое количество HTTP-клиентов. Большее значение может подойти, если ожидается, что большое количество HTTP-клиентов будет одновременно отправлять запросы на сервер.
Record ReaderСредство чтения записей для разбора входящего FlowFile на записи
Record WriterСредство записи записей для сериализации преобразованных записейThis Property is only considered if the [Record Reader] Property has a value specified.

Взаимосвязи

  • success: Отношение для успешно полученных файлов Flow