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