TagS3Object 2025.10.9.21

Bundle

org.apache.nifi | nifi-aws-nar

Description

Adds or updates a tag on an Amazon S3 Object.

Tags

AWS, Amazon, Archive, S3, Tag

Input Requirement

REQUIRED

Supports Sensitive Dynamic Properties

false

Properties

PropertyDescription
AWS Credentials Provider serviceThe Controller Service that is used to obtain AWS credentials provider
Append TagIf set to true, the tag will be appended to the existing set of tags on the S3 object. Any existing tags with the same key as the new tag will be updated with the specified value. If set to false, the existing tags will be removed and the new tag will be set on the S3 object.
BucketThe S3 Bucket to interact with
Communications TimeoutThe amount of time to wait in order to establish a connection to AWS or receive data from AWS before timing out.
Custom Signer Class NameFully qualified class name of the custom signer class. The signer must implement com.amazonaws.auth. Signer interface.
Custom Signer Module LocationComma-separated list of paths to files and/or directories which contain the custom signer’s JAR file and its dependencies (if any).
Endpoint Override URLEndpoint URL to use instead of the AWS default including scheme, host, port, and path. The AWS libraries select an endpoint URL based on the AWS region, but this property overrides the selected endpoint URL, allowing use with other S3-compatible endpoints.
Object KeyThe S3 Object Key to use. This is analogous to a filename for traditional file systems.
RegionThe AWS Region to connect to.
SSL Context ServiceSpecifies an optional SSL Context Service that, if provided, will be used to create connections
Signer OverrideThe AWS S3 library uses Signature Version 4 by default but this property allows you to specify the Version 2 signer to support older S3-compatible services or even to plug in your own custom signer implementation.
Tag KeyThe key of the tag that will be set on the S3 Object
Tag ValueThe value of the tag that will be set on the S3 Object
VersionThe Version of the Object to tag
proxy-configuration-serviceSpecifies the Proxy Configuration Controller Service to proxy network requests.

Relationships

NameDescription
failureIf the Processor is unable to process a given FlowFile, it will be routed to this Relationship.
successFlowFiles are routed to this Relationship after they have been successfully processed.

Writes attributes

NameDescription
s3.tag.___The tags associated with the S3 object will be written as part of the FlowFile attributes
s3.exceptionThe class name of the exception thrown during processor execution
s3.additionalDetailsThe S3 supplied detail from the failed operation
s3.statusCodeThe HTTP error code (if available) from the failed operation
s3.errorCodeThe S3 moniker of the failed operation
s3.errorMessageThe S3 exception message from the failed operation

See also