PutS3Object 2025.10.2.19¶
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. |
ACL enregistré |
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 |
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 la disposition du contenu de l’en-tête HTTP indiquant si le contenu est destiné à être affiché en ligne ou doit être téléchargé. Les valeurs possibles sont « inline » ou « attachment ». Si cette propriété n’est pas spécifiée, la disposition du contenu de l’objet sera définie sur le nom de fichier. Lorsque la pièce jointe est sélectionnée, la clé d’objet “; filename=”plus est automatiquement ajoutée pour former la valeur finale “ attachment; filename= »filename.jpg »”. |
Content Type |
Définit le type de contenu de l’en tête HTTP indiquant le type de contenu stocké dans l’objet associé. La valeur de cet en-tête est de type MIME standard. Le client AWS S3 Java tentera de déterminer le type de contenu correct si celui-ci n’a pas encore été défini. Les utilisateurs sont responsables 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 de fichier, le type de contenu par défaut « application/octet-stream » sera utilisé. |
Nom de classe du signataire personnalisé |
Nom complet de la classe du signataire personnalisé. Le signataire doit implémenter l’interface de signataire ccom.amazonaws.auth. |
Emplacement du module de signataire personnalisé |
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). |
Service de chiffrement |
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. |
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 passer de l’API PutS3Object vers l’API PutS3MultipartUpload. Les fichiers de flux plus volumineux que cette limite seront envoyés en utilisant le processus multipart avec état. La plage valide se situe entre 50MB et 5GB. |
Multipart Upload AgeOff Interval |
Spécifie l’intervalle auquel les chargements multipart existants dans AWS S3 seront évalués pour l’expiration. Lorsque le processeur est déclenché, il lance l’évaluation d’expiration si cet intervalle a été dépassé. |
Multipart Upload Max Age Threshold |
Spécifie l’âge maximal des chargements multipart existants dans AWS S3. Lorsque le processus d’expiration se produit, tout chargement plus ancien que ce seuil sera 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. |
Préfixe des balises d’objet |
Spécifie le préfixe qui sera analysé par rapport aux attributs FlowFile entrants et le nom et la valeur de l’attribut correspondant seront considérés respectivement comme le nom de la balise de l’objet S3 sortant et la valeur de la balise. Par exemple : si le FlowFile entrant porte les attributs tagS3country, tagS3PII, le préfixe de balise à spécifier serait tagS3” |
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. |
Supprimer le préfixe de balise |
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” |
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 |
Chiffrement côté serveur |
Spécifie l’algorithme utilisé pour le chiffrement côté serveur. |
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 |
|
État de répertoire temporaire 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. |
Utiliser l’encodage en morceaux |
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. |
Utiliser l’accès par chemin |
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. |
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 |
service proxy-configuration |
Spécifie le Controller Service de configuration proxy pour les requêtes réseau proxy. |
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 |