ListenHTTP 2025.5.31.15

Pacote

org.apache.nifi | nifi-standard-nar

Descrição

Inicia um servidor HTTP e escuta em um determinado caminho base para transformar as solicitações recebidas em FlowFiles. O URI padrão do serviço será http://{hostname}:{port}/contentListener. Somente as solicitações HEAD e POST são compatíveis. GET, PUT, DELETE, OPTIONS e TRACE resultarão em um erro e no código de status de resposta HTTP 405; CONNECT também resultará em um erro e no código de status de resposta HTTP 400. GET é compatível com <service_URI>/healthcheck. Se o serviço estiver disponível, ele retornará “200 OK” com o conteúdo “OK”. A funcionalidade de verificação de integridade pode ser configurada para ser acessada por meio de uma porta diferente. Para obter detalhes, consulte a documentação da propriedade “Porta de escuta para solicitações de verificação de integridade”. Uma propriedade de Record Reader e Record Writer pode ser ativada no processador para processar as solicitações recebidas como registros. O processamento de registros não é permitido para solicitações multipart e solicitações no formato FlowFileV3 (minifi).

Tags

http, https, ingest, listen, rest

Requisito de entrada

FORBIDDEN

Oferece suporte a propriedades dinâmicas confidenciais

falso

Propriedades

Propriedade

Descrição

Padrão de DN autorizado

Uma expressão regular a ser aplicada ao nome distinto do assunto das conexões de entrada. Se o padrão não corresponder ao DN do assunto, o processador responderá com um status HTTP 403 Forbidden.

Caminho base

Caminho base para conexões de entrada

Cabeçalhos HTTP a serem recebidos como atributos (regex)

Especifica a expressão regular que determina os nomes dos cabeçalhos HTTP que devem ser transmitidos como atributos FlowFile

Protocolos HTTP

Protocolos HTTP compatíveis para negociação de protocolo de camada de aplicativo com TLS

Porta de escuta

A porta para escutar as conexões de entrada

Tempo máximo do FlowFile não confirmado

O tempo máximo de espera para que um FlowFile seja confirmado antes de ser removido do cache

Tamanho máximo do cabeçalho da solicitação

O tamanho máximo compatível dos cabeçalhos HTTP nas solicitações enviadas a esse processador

Código de retorno

O código de retorno HTTP retornado após cada chamada HTTP

Serviço de contexto SSL

O serviço de contexto SSL permite o suporte para HTTPS

authorized-issuer-dn-pattern

Uma expressão regular a ser aplicada ao nome distinto do emissor das conexões de entrada. Se o padrão não corresponder ao DN do emissor, o processador responderá com um status HTTP 403 Forbidden.

client-authentication

Política de autenticação de cliente para conexões TLS. Necessário quando o serviço de contexto SSL estiver configurado.

health-check-port

A porta para escutar as solicitações de verificação de integridade recebidas. Se definido, deve ser diferente da porta de escuta. Configure essa porta se o processador estiver configurado para usar SSL bidirecional e se for usado um balanceador de carga que não ofereça suporte à autenticação de cliente para solicitações de verificação de integridade. Somente o serviço /<base_path>/healthcheck está disponível por meio dessa porta e somente as solicitações GET e HEAD são compatíveis. Se o processador estiver configurado para não usar SSL, SSL também não será usado nessa porta. Se o processador estiver configurado para usar SSL unidirecional, o SSL unidirecional será usado nessa porta. Se o processador estiver configurado para usar SSL bidirecional, o SSL unidirecional será usado nessa porta (a autenticação do cliente não é necessária).

max-thread-pool-size

O número máximo de threads a ser usado pelo servidor Jetty incorporado. O valor pode ser definido entre 8 e 1000. O valor dessa propriedade afeta o desempenho dos fluxos e do sistema operacional, portanto, o valor padrão só deve ser alterado em casos justificados. Um valor menor que o valor padrão pode ser adequado se apenas um pequeno número de clientes HTTP se conectar ao servidor. Um valor maior pode ser adequado se for esperado que um grande número de clientes HTTP faça solicitações ao servidor simultaneamente.

multipart-read-buffer-size

O tamanho limite, no qual o conteúdo de um arquivo de entrada seria gravado no disco. Aplica-se somente a solicitações com Content-Type: multipart/form-data. Ele é usado para evitar ataques do tipo negação de serviço, para evitar o preenchimento do heap ou do espaço em disco.

multipart-request-max-size

O tamanho máximo da solicitação. Aplica-se somente a solicitações com Content-Type: multipart/form-data e é usado para evitar ataques do tipo negação de serviço, para evitar o preenchimento da pilha ou do espaço em disco

record-reader

O Record Reader a ser usado para analisar o FlowFile de entrada em registros

record-writer

O Record Writer a ser usado para serializar registros depois de terem sido transformados

Relações

Nome

Descrição

success

Relação para FlowFiles recebidos com sucesso

Casos de uso

Descompacte o conteúdo do FlowFileV3 recebido em um POST

Casos de uso que envolvem outros componentes

Limite a taxa de fluxo de dados que é aceita