InvokeHTTP 2025.5.31.15¶

Pacote¶

org.apache.nifi | nifi-standard-nar

Descrição¶

Um processador cliente HTTP que pode interagir com um ponto de extremidade HTTP configurável. O URL de destino e o método HTTP são configuráveis. Quando o método HTTP é PUT, POST ou PATCH, o conteúdo do FlowFile é incluído como o corpo da solicitação e os atributos do FlowFile são convertidos em cabeçalhos HTTP, opcionalmente, com base nas propriedades de configuração.

Tags¶

client, http, https, rest

Requisito de entrada¶

ALLOWED

Oferece suporte a propriedades dinâmicas confidenciais¶

true

Propriedades¶

Propriedade	Descrição
Tempo limite de conexão	Tempo máximo de espera para a conexão inicial do soquete com o URL HTTP.
Método HTTP	Método de solicitação HTTP (GET, POST, PUT, PATCH, DELETE, HEAD, OPTIONS). Também há suporte para métodos arbitrários. Os métodos diferentes de POST, PUT e PATCH serão enviados sem um corpo de mensagem.
HTTP URL	URL remoto HTTP incluindo um esquema de HTTP ou HTTPS, bem como um nome de host ou endereço IP com elementos opcionais de porta e caminho. Qualquer codificação do URL deve ser feita pelo usuário.
HTTP/2 desativado	Desativa a negociação do protocolo HTTP/2. HTTP/2 requer TLS. O protocolo HTTP/1.1 compatível é necessário quando HTTP/2 está desativado.
Estratégia de atualização do token de acesso OAuth2	Especifica qual estratégia deve ser usada para atualizar o token de acesso OAuth2.
Corpo de solicitação ativado	Habilite o envio do corpo da solicitação HTTP para os métodos PATCH, POST ou PUT.
Solicitação de codificação de transferência em partes ativada	Habilite o envio de solicitações HTTP com o cabeçalho Transfer-Encoding definido como chunked (fragmentado) e desabilite o envio do cabeçalho Content-Length. O Transfer-Encoding se aplica ao corpo em solicitações HTTP/1.1, conforme descrito na RFC 7230, seção 3.3.1
Solicitação Content-Encoding	Content-Encoding HTTP aplicado ao corpo da solicitação durante a transmissão. O servidor receptor deve oferecer suporte à codificação selecionada para evitar falhas na solicitação.
Solicitação Content-Type	Cabeçalho HTTP Content-Type aplicado ao envio de um corpo de solicitação HTTP para os métodos PATCH, POST ou PUT. O padrão do Content-Type é application/octet-stream quando não configurado.
Cabeçalho de data de solicitação ativado	Habilite o envio de solicitações HTTP Date Header, conforme descrito na RFC 7231, seção 7.1.1.2.
Solicitação de autenticação Digest ativada	Ative a autenticação Digest em solicitações HTTP com credenciais de nome de usuário e senha, conforme descrito na RFC 7616.
Penalização por falha de solicitação ativada	Habilite a penalização de FlowFiles de solicitação ao receber a resposta HTTP com um código de status entre 400 e 499.
Padrão de atributos do cabeçalho da solicitação	Expressão regular que define quais atributos do FlowFile devem ser enviados como cabeçalhos HTTP na solicitação. Se não for definido, nenhum atributo será enviado como cabeçalho. As propriedades dinâmicas serão sempre enviadas como cabeçalhos. O nome da propriedade dinâmica será a chave do cabeçalho e o valor da propriedade dinâmica, interpretado como linguagem de expressão, será o valor do cabeçalho. Os atributos e seus valores são limitados a caracteres ASCII devido ao requisito do protocolo HTTP.
Solicitação de nome de arquivo de dados de formulário com várias partes ativada	Habilite o envio do atributo de nome de arquivo do FlowFile como o parâmetro filename no cabeçalho Content-Disposition para solicitações multipart/form-data HTTP.
Nome do formulário de dados multipartes de solicitação	Permitir o envio do corpo da solicitação HTTP formatado com multipart/form-data e usando o nome do formulário configurado.
Solicitação do provedor de token de acesso OAuth2	Permite a recuperação gerenciada do token de portador OAuth2 aplicado às solicitações HTTP usando o cabeçalho de autorização.
Solicitar senha	A senha fornecida para autenticação de solicitações HTTP. Codificado usando Base64 para autenticação básica HTTP, conforme descrito na RFC 7617.
Solicitação User-Agent	Cabeçalho HTTP User-Agent aplicado às solicitações. A RFC 7231, seção 5.5.3, descreve a formatação recomendada.
Solicitar nome de usuário	O nome de usuário fornecido para autenticação de solicitações HTTP. Codificado usando Base64 para autenticação básica HTTP, conforme descrito na RFC 7617.
Nome do atributo de corpo da resposta	Nome de atributo FlowFile usado para gravar um corpo de resposta HTTP para FlowFiles transferidos para a relação original.
Tamanho do atributo do corpo da resposta	Tamanho máximo em bytes aplicado ao gravar um corpo de resposta HTTP em um atributo FlowFile. Os atributos que excederem o máximo serão truncados.
Corpo da resposta ignorado	Desative a gravação dos FlowFiles de resposta HTTP na relação de respostas
Cache de resposta ativado	Habilite o cache de resposta HTTP descrito na RFC 7234. O armazenamento em cache das respostas considera ETag e outros cabeçalhos.
Tamanho do cache de resposta	Tamanho máximo do cache de resposta HTTP em bytes. O armazenamento em cache das respostas considera ETag e outros cabeçalhos.
Estratégia de cookies de resposta	Estratégia para aceitar e persistir cookies HTTP. A aceitação de cookies permite a persistência em várias solicitações.
Estratégia de nomeação do FlowFile de resposta	Determina a estratégia usada para definir o atributo de nome de arquivo dos FlowFiles transferidos para a relação de resposta.
Geração de resposta necessária	Permita a geração e a transferência de um FlowFile para a relação de resposta, independentemente da resposta HTTP recebida.
Atributos de solicitação de cabeçalho de resposta ativados	Permita a adição de cabeçalhos de resposta HTTP como atributos para FlowFiles transferidos para as relações Original, Nova tentativa ou Sem nova tentativa.
Prefixo dos atributos da solicitação do cabeçalho de resposta	Prefixo para os cabeçalhos de resposta HTTP quando incluídos como atributos para FlowFiles transferidos para as relações Original, Nova tentativa ou Sem nova tentativa. Recomenda-se terminar com um caractere separador como “.” ou “-”.
Redirecionamentos de resposta ativados	Habilite os seguintes redirecionamentos HTTP enviados com as respostas da série HTTP 300, conforme descrito na seção 6.4 da RFC 7231.
Serviço de contexto SSL	O serviço de contexto SSL Context Service fornece certificados confiáveis e certificados de cliente para a comunicação TLS.
Conexões ociosas de soquete	Número máximo de conexões ociosas com o HTTP URL.
Tempo limite de inatividade do soquete	Tempo máximo de espera antes de fechar conexões ociosas com o HTTP URL.
Tempo limite de leitura do soquete	Tempo máximo de espera para receber respostas de uma conexão de soquete com o HTTP URL.
Tempo limite de gravação do soquete	Tempo máximo de espera para operações de gravação durante o envio de solicitações de uma conexão de soquete para o HTTP URL.
proxy-configuration-service	Especifica o serviço de Controller Service de configuração de proxy para a realização de proxy de solicitações de rede. No caso de SOCKS, não é garantido que a versão de SOCKS selecionada será usada pelo processador.

Relações¶

Nome	Descrição
Falha	FlowFiles de solicitação transferidos ao receber erros de comunicação de soquete.
Sem nova tentativa	Solicite a transferência de FlowFiles ao receber respostas HTTP com um código de status entre 400 e 499.
Original	Solicite a transferência de FlowFiles ao receber respostas HTTP com um código de status entre 200 e 299.
Resposta	FlowFiles de resposta transferidos ao receber respostas HTTP com um código de status entre 200 e 299.
Repetir	Solicite a transferência de FlowFiles ao receber respostas HTTP com um código de status entre 500 e 599.

Grava atributos¶

Nome	Descrição
invokehttp.status.code	O código de status que é retornado
invokehttp.status.message	A mensagem de status que é retornada
invokehttp.response.body	Se o código de status recebido não for um sucesso (2xx), o corpo da resposta será colocado no atributo “invokehttp.response.body” do FlowFile de solicitação.
invokehttp.request.url	O URL de solicitação original
invokehttp.request.duration	Duração (em milissegundos) da chamada HTTP para o ponto de extremidade externo
invokehttp.response.url	O URL que foi finalmente solicitado depois que todos os redirecionamentos foram seguidos
invokehttp.tx.id	O ID de transação que é retornado após a leitura da resposta
invokehttp.remote.dn	O DN do servidor remoto
invokehttp.java.exception.class	A classe de exceção Java criada quando o processador falha
invokehttp.java.exception.message	A mensagem de exceção Java exibida quando o processador falha
user-defined	Se a propriedade “Colocar corpo da resposta no atributo” for definida, o que quer que seja definido se tornará a chave do atributo e o valor será o corpo da resposta HTTP.