PutS3Object 2025.5.31.15¶
Bundle¶
org.apache.nifi | nifi-aws-nar
Description¶
Écrit le contenu d’un FlowFile en tant qu’objet S3 dans un compartiment Amazon S3 Bucket.
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 |
Cache Control |
Définit l’en-tête Cache-Control HTTP indiquant les directives de mise en cache de l’objet associé. Les directives multiples sont séparées par des virgules. |
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. |
Content Disposition |
Définit l’en-tête Content-Disposition HTTP indiquant si le contenu est destiné à être affiché en ligne ou s’il doit être téléchargé. Les valeurs possibles sont “inline” ou “attachment”. Si cette propriété n’est pas spécifiée, le content-disposition de l’objet sera défini sur le nom du fichier. Lorsque l’option “attachment” est sélectionnée, la valeur “; filename=” et la clé de l’objet sont automatiquement ajoutées pour former la valeur finale “attachment; filename= »filename.jpg »”. |
Content Type |
Définit l’en-tête Content-Type HTTP indiquant le type de contenu stocké dans l’objet associé. La valeur de cet en-tête est un type MIME standard. Le client Java AWS S3 tentera de déterminer le type de contenu correct s’il n’a pas encore été défini. Il incombe aux utilisateurs de s’assurer qu’un type de contenu approprié est défini lors du chargement des flux. Si aucun type de contenu n’est fourni et ne peut être déterminé par le nom du fichier, le type de contenu par défaut “application/octet-stream” sera utilisé. |
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. |
Expiration Time Rule |
|
File Resource Service |
Service de ressources de fichiers fournissant l’accès à la ressource locale à transférer |
FullControl User List |
La liste séparée par des virgules des ID ou des adresses e-mail des utilisateurs Amazon qui doivent avoir un contrôle total sur un objet |
Multipart Part Size |
Spécifie la taille de la pièce à utiliser lors de l’utilisation le PutS3Multipart Upload API. Les FlowFiles seront divisés en morceaux de cette taille pour le processus de chargement, mais la dernière partie envoyée peut être plus petite puisqu’elle n’est pas complétée. La plage de validité est comprise entre 50MB et 5GB. |
Multipart Threshold |
Spécifie le seuil de taille du fichier pour le passage de la PutS3Object API à la PutS3MultipartUpload API. Les FlowFiles supérieurs à cette limite seront envoyés à l’aide du processus multipartite avec état. La plage de validité est comprise entre 50MB et 5GB. |
Multipart Upload AgeOff Interval |
Spécifie l’intervalle auquel les chargements multipartites existants dans AWS S3 seront évalués pour la suppression automatique. Lorsque le processeur est déclenché, il lance l’évaluation de suppression automatique si cet intervalle a été dépassé. |
Multipart Upload Max Age Threshold |
Spécifie l’âge maximum des chargements multipartites existants dans AWS S3. Lorsque le processus de la suppression automatique se produit, tout chargement plus ancien que ce seuil est annulé. |
Clé d’objet |
La clé d’objet S3 à utiliser. Ce nom est analogue à un nom de fichier pour les systèmes de fichiers traditionnels. |
Propriétaire |
L’ID Amazon à utiliser pour le propriétaire de l’objet |
Read ACL User List |
La liste séparée par des virgules des ID ou des adresses e-mail des utilisateurs Amazon qui doivent avoir l’autorisation de lire la liste de contrôle d’accès d’un objet |
Read Permission User List |
La liste séparée par des virgules des ID ou des adresses e-mail des utilisateurs Amazon qui doivent avoir l’accès en lecture à un objet |
Region |
La région AWS à laquelle se connecter. |
Resource Transfer Source |
La source du contenu à transférer |
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. |
Storage Class |
|
Write ACL User List |
La liste séparée par des virgules des ID ou des adresses e-mail des utilisateurs Amazon qui doivent avoir l’autorisation de modifier la liste de contrôle d’accès d’un objet |
Write Permission User List |
La liste séparée par des virgules des ID ou des adresses e-mail des utilisateurs Amazon qui doivent avoir l’accès en écriture à un objet |
conserves-acl |
Liste de contrôle d’accès (ACL) Amazon prédéfinie pour un objet. Les valeurs possibles sont les suivantes : BucketOwnerFullControl, BucketOwnerRead, LogDeliveryWrite, AuthenticatedRead, PublicReadWrite, PublicRead et Private. Cette propriété sera ignorée si une autre propriété ACL/permission/owner est spécifiée |
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. |
s3-object-remove-tags-prefix |
Si cette option est réglée sur “True”, la valeur fournie pour “Object Tags Prefixe” sera supprimée du ou des attributs et considérée comme le nom de la balise. Par exemple : si le message entrant FlowFile porte les attributs tagS3country, tagS3PII et que le préfixe est défini sur “tagS3”, les valeurs de balise correspondantes seront “country” et “PII” |
s3-object-tags-prefix |
Spécifie le préfixe qui sera balayé par rapport aux attributs du FlowFile entrant et le nom et la valeur de l’attribut correspondant seront considérés comme le nom et la valeur de la balise de l’objet S3 sortant. Par exemple : si le FlowFile entrant porte les attributs tagS3country, tagS3PII, le préfixe à spécifier est “tagS3” |
s3-temporary-directory-multipart |
Répertoire dans lequel, pour les chargements en plusieurs parties, le fournisseur enregistre localement l’état de suivi du chargement ID et des parties chargées qui doivent toutes deux être fournies pour achever le chargement. |
server-side-encryption |
Spécifie l’algorithme utilisé pour le chiffrement côté serveur. |
use-chunked-encoding |
Active/désactive l’encodage en morceaux pour les requêtes de chargement. Ne définissez cette option sur faux que si votre point de terminaison ne prend pas en charge le chargement par morceaux. |
use-path-style-access |
L’accès par chemin peut être imposé en définissant cette propriété à vrai. Définissez-la sur faux si votre point de terminaison ne prend pas en charge les requêtes de type hébergement virtuel, mais uniquement les requêtes de type chemin. |
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 compartiment S3 où l’objet a été placé dans S3 |
s3.key |
La clé S3 à l’intérieur de laquelle l’objet a été placé dans S3 |
s3.contenttype |
Le type de contenu S3 de l’objet S3 mis dans S3 |
s3.version |
La version de l’objet S3 qui a été placée dans S3 |
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.etag |
L’ETag de l’objet S3 |
s3.contentdisposition |
Le contenu de l’objet S3 qui a été placé dans S3 |
s3.cachecontrol |
L’en-tête de contrôle de cache de l’objet S3 |
s3.uploadId |
L’identifiant de chargement (uploadId) utilisé pour charger l’objet sur S3 |
s3.expiration |
Une forme lisible par l’utilisateur de la date d’expiration de l’objet S3, si elle est définie. |
s3.sseAlgorithm |
Algorithme de chiffrement de l’objet côté serveur |
s3.usermetadata |
Une forme lisible par l’utilisateur des métadonnées utilisateur de l’objet S3, si elles ont été définies. |
s3.encryptionStrategy |
Le nom de la stratégie de chiffrement, s’il y en a une qui a été ensemble |