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).
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 |