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