FetchS3Object 2025.5.31.15

Bundle

org.apache.nifi | nifi-aws-nar

Description

Récupère le contenu d’un objet S3 et l’écrit dans le contenu d’un FlowFile

Balises

AWS, Amazon, récupérer, obtenir, S3

Exigences en matière d’entrées

REQUIRED

Prend en charge les propriétés dynamiques sensibles

false

Propriétés

Propriété

Description

Service des fournisseurs d’identifiants de connexion AWS

Le Controller Service qui est utilisé pour obtenir le fournisseur d’identifiants de connexion AWS

Compartiment

Le compartiment S3 avec lequel interagir

Délai d’expiration de la communication

Le temps d’attente pour établir une connexion avec AWS ou recevoir des données de AWS avant qu’un délai d’expiration ne se produise.

Endpoint Override URL

URL du point de terminaison à utiliser à la place du point de terminaison AWS par défaut, y compris le schéma, l’hôte, le port et le chemin. Les bibliothèques AWS sélectionnent une URL de point de terminaison en fonction de la région AWS, mais cette propriété remplace l’URL de point de terminaison sélectionnée, ce qui permet une utilisation avec d’autres points de terminaison compatibles S3.

Clé d’objet

La clé d’objet S3 à utiliser. Ce nom est analogue à un nom de fichier pour les systèmes de fichiers traditionnels.

Region

La région AWS à laquelle se connecter.

Service contextuel SSL

Spécifie un service contextuel SSL facultatif qui, s’il est fourni, sera utilisé pour créer des connexions

Signer Override

La bibliothèque d’AWS S3 utilise par défaut le protocole Signature Version 4, mais cette propriété vous permet de spécifier le signataire version 2 pour prendre en charge des services compatibles S3 plus anciens ou même pour ajouter votre propre implémentation de signataire personnalisée.

Version

La version de l’objet à télécharger

custom-signer-class-name

Nom de classe entièrement qualifié de la classe de signataire personnalisée. Le signataire doit mettre en œuvre l’interface com.amazonaws.auth.Signer.

custom-signer-module-location

Liste séparée par des virgules des chemins d’accès aux fichiers et/ou aux répertoires contenant le fichier JAR du signataire personnalisé et ses dépendances (le cas échéant).

encryption-service

Spécifie le contrôleur de service de chiffrement utilisé pour configurer les requêtes. PutS3Object : Pour des raisons de compatibilité ascendante, cette valeur est ignorée lorsque l’option Chiffrement côté serveur est définie. FetchS3Object : Ne doit être configuré qu’en cas de chiffrement par la clé du client côté serveur, par KMS côté client et par la clé du client côté client.

service proxy-configuration

Spécifie le Controller Service de configuration proxy pour les requêtes réseau proxy.

range-length

Nombre d’octets à télécharger à partir de l’objet, en commençant par le début de la plage. Une valeur vide ou une valeur qui dépasse la fin de l’objet sera lue jusqu’à la fin de l’objet.

range-start

La position de l’octet à laquelle commencer la lecture de l’objet. Une valeur vide ou une valeur de zéro commencera la lecture au début de l’objet.

requester-pays

Si true, indique que la requête consent à payer tous les frais associés à la récupération d’objets dans le compartiment S3. Cela définit l’en-tête « x-amz-request-payer » à « requester ».

Relations

Nom

Description

failure

Si le processeur n’est pas en mesure de traiter un FlowFile donné, celui-ci sera routé vers cette relation.

success

Les FlowFiles sont routés vers cette relation après avoir été traités correctement.

Écrit les attributs

Nom

Description

s3.url

L’URL qui peut être utilisée pour accéder à l’objet S3

s3.bucket

Le nom du compartiment S3

path

Le chemin du fichier

absolute.path

Le chemin du fichier

filename

Le nom du fichier

hash.value

La somme MD5 du fichier

hash.algorithm

MD5

mime.type

Si S3 fournit le type de contenu/typeMIME, cet attribut contiendra ce fichier

s3.etag

Le ETag qui peut être utilisé pour voir si le fichier a été modifié

s3.exception

Nom de la classe de l’exception levée pendant l’exécution du processeur

s3.additionalDetails

Le détail S3 fourni à partir de l’opération échouée

s3.statusCode

Le code d’erreur HTTP (s’il est disponible) de l’opération qui a échoué

s3.errorCode

Le nom S3 de l’opération échouée

s3.errorMessage

Le message d’exception S3 de l’opération échouée

s3.expirationTime

Si le fichier a une date d’expiration, cet attribut sera ensemble, contenant les millisecondes depuis l’époque dans le fuseau horaire UTC

s3.expirationTimeRuleId

L’ID de la règle qui dicte le délai d’expiration de cet objet

s3.sseAlgorithm

Algorithme de chiffrement de l’objet côté serveur

s3.version

La version de l’objet S3

s3.encryptionStrategy

Le nom de la stratégie de chiffrement qui a été utilisée pour stocker l’objet S3 (s’il est chiffré)

Cas d’utilisation

Récupérer un fichier spécifique sur S3

Cas d’utilisation impliquant d’autres composants

Récupérer tous les fichiers d’un compartiment S3

Récupérer uniquement les fichiers de S3 qui répondent à certains critères spécifiés

Récupérer les nouveaux fichiers au fur et à mesure de leur arrivée dans un compartiment S3

Voir aussi :