InvokeHTTP 2025.5.31.15

Bundle

org.apache.nifi | nifi-standard-nar

Description

Un processeur client HTTP qui peut interagir avec un point de terminaison HTTP configurable. Les méthodes URL et HTTP de destination sont configurables. Lorsque la méthode HTTP est PUT, POST ou PATCH, le contenu FlowFile est inclus dans le corps de la requête et les attributs FlowFile sont convertis en en-têtes HTTP, éventuellement sur la base des propriétés de configuration.

Balises

client, http, https, rest

Exigences en matière d’entrées

ALLOWED

Prend en charge les propriétés dynamiques sensibles

true

Propriétés

Propriété

Description

Connection Timeout

Temps d’attente maximum pour la connexion initiale de la socket à l’adresse HTTP URL.

Méthode HTTP

méthode de requête HTTP (GET, POST, PUT, PATCH, DELETE, HEAD, OPTIONS). Les méthodes arbitraires sont également prises en charge. Les méthodes autres que POST, PUT et PATCH seront envoyées sans corps de message.

HTTP URL

URL HTTP distante comprenant un schéma http ou https, ainsi qu’un nom d’hôte ou une adresse IP avec des éléments facultatifs de port et de chemin. Tout encodage de l’URL doit être effectué par l’utilisateur.

HTTP/2 Désactivé

Désactive la négociation du protocole HTTP/2. HTTP/2 exige TLS. Le protocole HTTP/1.1 pris en charge est exigé lorsque HTTP/2 est désactivé.

Stratégie de rafraîchissement des jetons d’accès OAuth2

Spécifie la stratégie à utiliser pour actualiser le jeton d’accès OAuth2.

Corps de la requête activé

Permet d’envoyer le corps de la requête HTTP pour les méthodes PATCH, POST ou PUT.

Requête de Transfer-Encoding en morceaux

Activer l’envoi de requêtes HTTP avec l’en-tête Transfer-Encoding réglé sur chunked, et désactiver l’envoi de l’en-tête Content-Length. Transfer-Encoding s’applique au corps des requêtes HTTP/1.1 comme décrit dans RFC 7230 Section 3.3.1

Requête Content-Encoding

HTTP Content-Encoding appliqué au corps de la requête lors de la transmission. Le serveur de réception doit prendre en charge le codage sélectionné pour éviter que les requêtes n’échouent.

Requête Content-Type

En-tête HTTP Content-Type appliqué lors de l’envoi d’un corps de requête HTTP pour les méthodes PATCH, POST ou PUT. Par défaut, Content-Type est application/octet-stream s’il n’est pas configuré.

En-tête de la date de la requête activé

Activer l’envoi d’en-tête HTTP Date sur les requêtes HTTP comme décrit dans RFC 7231 Section 7.1.1.2.

Activer l’authentification Digest

Activez l’authentification Digest sur les requêtes HTTP avec les identifiants de connexion, nom d’utilisateur et mot de passe, comme décrit dans RFC 7616.

Pénalisation de l’échec de la requête activée

Activer la pénalisation de la requête FlowFiles lors de la réception de la réponse HTTP avec un code de statut compris entre 400 et 499.

Modèle d’attributs de l’en-tête de la requête

Expression régulière qui définit les attributs FlowFile à envoyer en tant qu’en-têtes HTTP dans la requête. S’il n’est pas défini, aucun attribut n’est envoyé comme en-tête. Les propriétés dynamiques sont toujours envoyées sous forme d’en-têtes. Le nom de la propriété dynamique sera la clé d’en-tête et la valeur de la propriété dynamique, interprétée en langue d’expression, sera la valeur de l’en-tête. Les attributs et leurs valeurs sont limités aux caractères ASCII en raison de l’exigence du protocole HTTP.

Activer le nom de fichier des données Form-Data multipart

Permet d’envoyer l’attribut de nom de fichier FlowFile comme paramètre de nom de fichier dans l’en-tête Content-Disposition pour les requêtes multipart/form-data HTTP.

Requête de nom Multipart Form-Data

Permet d’envoyer le corps de la requête HTTP formaté à l’aide de multipart/form-data et utilisant le nom de la forme configurée.

Requête de fournisseur de jeton d’accès OAuth2

Permet de récupérer de manière gérée le jeton de support OAuth2 appliqué aux requêtes HTTP à l’aide de l’en-tête d’autorisation.

Requête du mot de passe

Le mot de passe fourni pour l’authentification des requêtes HTTP. Encodé à l’aide de Base64 pour l’authentification de base HTTP comme décrit dans RFC 7617.

Requête User-Agent

En-tête User-Agent HTTP appliqué aux requêtes. RFC 7231 La section 5.5.3 décrit le formatage recommandé.

Requête de nom d’utilisateur

Le nom d’utilisateur fourni pour l’authentification des requêtes HTTP. Encodé à l’aide de Base64 pour l’authentification de base HTTP comme décrit dans RFC 7617.

Nom de l’attribut du corps de la réponse

Nom de l’attribut FlowFile utilisé pour écrire un corps de réponse HTTP pour FlowFiles transférés à la relation d’origine.

Taille de l’attribut de corps de la réponse

Taille maximale en octets appliquée lors de l’écriture d’un corps de réponse HTTP à un attribut FlowFile. Les attributs dépassant le maximum seront tronqués.

Corps de la réponse ignoré

Désactiver l’écriture de FlowFiles de réponse HTTP dans la relation « response »

Cache de réponse activé

Activer la mise en cache des réponses HTTP décrite dans RFC 7234. La mise en cache des réponses tient compte de ETag et d’autres en-têtes.

Taille du cache de réponse

Taille maximale du cache de réponse HTTP en octets. La mise en cache des réponses tient compte de ETag et d’autres en-têtes.

Stratégie de cookies de réponse

Stratégie d’acceptation et de persistance des cookies HTTP. L’acceptation des cookies permet la persistance des données à travers plusieurs requêtes.

Stratégie de dénomination de réponse FlowFile

Détermine la stratégie utilisée pour définir l’attribut de nom de fichier FlowFiles transféré à la relation « Response ».

Génération de réponses exigée

Permet de générer et de transférer un FlowFile à la relation « response » indépendamment de la réponse HTTP reçue.

En-tête de réponse Attributs de requête activés

Permet d’ajouter des en-têtes de réponse HTTP en tant qu’attributs aux FlowFiles transférés dans les relations Original, Retry ou No Retry.

Préfixe d’en-tête de réponse Attributs de la requête

Préfixe des en-têtes de réponse HTTP lorsqu’ils sont inclus en tant qu’attributs de FlowFiles transférés dans les relations Original, Retry ou No Retry. Il est recommandé de terminer par un caractère de séparation tel que « . » ou « - ».

Redirections de réponse activées

Activer les redirections HTTP suivantes envoyées avec HTTP les réponses de la série 300 comme décrit dans RFC 7231 Section 6.4.

Service contextuel SSL

Le service contextuel SSL fournit des certificats de confiance et des certificats clients pour la communication TLS.

Connexions de socket inactives

Nombre maximal de connexions inactives à l’adresse HTTP URL.

Délai d’expiration de la socket inactive

Délai maximal d’attente avant la fermeture des connexions inactives à l’adresse HTTP URL.

Délai d’expiration de lecture de socket

Temps d’attente maximal pour la réception des réponses d’une connexion de socket à l’adresse HTTP URL.

Délai d’expiration de l’écriture de socket

Temps d’attente maximum pour les opérations d’écriture lors de l’envoi de requêtes à partir d’une connexion de socket à l’adresse HTTP URL.

service proxy-configuration

Spécifie le Controller Service de configuration proxy pour les requêtes réseau proxy. Dans le cas de SOCKS, il n’est pas garanti que la version SOCKS sélectionnée sera utilisée par le processeur.

Relations

Nom

Description

Échec

Requête de FlowFiles transférée lors de la réception d’erreurs de communication de socket.

Pas de nouvelle tentative

Requête de FlowFiles transférée lors de la réception de réponses HTTP avec un code de statut compris entre 400 et 499.

Originaux

Requête de FlowFiles transférée lors de la réception de réponses HTTP avec un code de statut compris entre 200 et 299.

Réponse

Réponse de FlowFiles transférée lors de la réception de réponses HTTP avec un code de statut compris entre 200 et 299.

Réessayer

Requête de FlowFiles transférée lors de la réception de réponses HTTP avec un code de statut compris entre 500 et 599.

Écrit les attributs

Nom

Description

invokehttp.status.code

Le code de statut renvoyé

invokehttp.statut.message

Le message de statut renvoyé

invokehttp.response.body

Dans l’instance où le code de statut reçu n’est pas un succès (2xx), le corps de la réponse sera placé dans l’attribut “invokehttp.response.body” de la requête FlowFile.

invokehttp.request.url

La requête initiale URL

invokehttp.request.duration

Durée (en millisecondes) de l’appel HTTP vers le point de terminaison externe

invokehttp.response.url

L’URL qui a fait l’objet de la requête finale après avoir suivi les éventuelles redirections

invokehttp.tx.id

L’ID de transaction renvoyé après lecture de la réponse

invokehttp.distant.dn

Le DN du serveur distant

invokehttp.java.exception.class

La classe d’exception Java levée en cas d’échec du processeur

invokehttp.java.exception.message

Le message d’exception Java levé en cas d’échec du processeur

user-defined

Si la propriété « Put Response Body In Attribute » est définie, la valeur de cette propriété deviendra la clé d’attribut et la valeur sera le corps de la réponse HTTP.