CopyS3Object
Description
Copies a file from one bucket and key to another in AWS S3
Tags
AWS, Amazon, Archive, Copy, S3
Properties
In the list below required Properties are shown with an asterisk (*). Other properties are considered optional. The table also indicates any default values, and whether a property supports the NiFi Expression Language.
| Display Name | API Name | Default Value | Allowable Values | Description |
|---|---|---|---|---|
| Source Bucket * | Source Bucket | ${s3.bucket} | The bucket that contains the file to be copied. Supports Expression Language, using FlowFile attributes and Environment variables. | |
| Source Key * | Source Key | ${filename} | The source key in the source bucket Supports Expression Language, using FlowFile attributes and Environment variables. | |
| Destination Bucket * | Destination Bucket | The bucket that will receive the copy. Supports Expression Language, using FlowFile attributes and Environment variables. | ||
| Destination Key * | Destination Key | ${filename}-1 | The target key in the target bucket Supports Expression Language, using FlowFile attributes and Environment variables. | |
| AWS Credentials Provider Service * | AWS Credentials Provider service | Controller Service: AWSCredentialsProviderService Implementations: AWSCredentialsProviderControllerService | The Controller Service that is used to obtain AWS credentials provider | |
| Region * | Region | US West (Oregon) |
| The AWS Region to connect to. |
| Communications Timeout * | Communications Timeout | 30 secs | The amount of time to wait in order to establish a connection to AWS or receive data from AWS before timing out. | |
| FullControl User List | FullControl User List | ${s3.permissions.full.users} | A comma-separated list of Amazon User ID's or E-mail addresses that specifies who should have Full Control for an object Supports Expression Language, using FlowFile attributes and Environment variables. | |
| Read Permission User List | Read Permission User List | ${s3.permissions.read.users} | A comma-separated list of Amazon User ID's or E-mail addresses that specifies who should have Read Access for an object Supports Expression Language, using FlowFile attributes and Environment variables. | |
| Write Permission User List | Write Permission User List | ${s3.permissions.write.users} | A comma-separated list of Amazon User ID's or E-mail addresses that specifies who should have Write Access for an object Supports Expression Language, using FlowFile attributes and Environment variables. | |
| Read ACL User List | Read ACL User List | ${s3.permissions.readacl.users} | A comma-separated list of Amazon User ID's or E-mail addresses that specifies who should have permissions to read the Access Control List for an object Supports Expression Language, using FlowFile attributes and Environment variables. | |
| Write ACL User List | Write ACL User List | ${s3.permissions.writeacl.users} | A comma-separated list of Amazon User ID's or E-mail addresses that specifies who should have permissions to change the Access Control List for an object Supports Expression Language, using FlowFile attributes and Environment variables. | |
| Canned ACL | canned-acl | ${s3.permissions.cannedacl} | Amazon Canned ACL for an object, one of: BucketOwnerFullControl, BucketOwnerRead, LogDeliveryWrite, AuthenticatedRead, PublicReadWrite, PublicRead, Private; will be ignored if any other ACL/permission/owner property is specified Supports Expression Language, using FlowFile attributes and Environment variables. | |
| Owner | Owner | ${s3.owner} | The Amazon ID to use for the object's owner Supports Expression Language, using FlowFile attributes and Environment variables. | |
| SSL Context Service | SSL Context Service | Controller Service: SSLContextService Implementations: StandardRestrictedSSLContextService StandardSSLContextService | Specifies an optional SSL Context Service that, if provided, will be used to create connections | |
| Endpoint Override URL | Endpoint Override URL | Endpoint 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. Supports Expression Language, using Environment variables. | ||
| Signer Override | Signer Override | Default Signature |
| The 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. |
| Custom Signer Class Name * | custom-signer-class-name | Fully qualified class name of the custom signer class. The signer must implement com.amazonaws.auth.Signer interface. Supports Expression Language, using Environment variables. This property is only considered if:
| ||
| Custom Signer Module Location | custom-signer-module-location | Comma-separated list of paths to files and/or directories which contain the custom signer's JAR file and its dependencies (if any). Supports Expression Language, using Environment variables. This property is only considered if:
| ||
| Proxy Configuration Service | proxy-configuration-service | Controller Service: ProxyConfigurationService Implementations: StandardProxyConfigurationService | Specifies the Proxy Configuration Controller Service to proxy network requests. Supported proxies: HTTP + AuthN |
Dynamic Properties
This component does not support dynamic properties.
Relationships
| Name | Description |
|---|---|
| failure | If the Processor is unable to process a given FlowFile, it will be routed to this Relationship. |
| success | FlowFiles are routed to this Relationship after they have been successfully processed. |
Reads Attributes
This processor does not read attributes.
Writes Attributes
This processor does not write attributes.
State Management
This component does not store state.
Restricted
This component is not restricted.
Input Requirement
This component requires an incoming relationship.
System Resource Considerations
This component does not specify system resource considerations.
See Also
DeleteS3Object, FetchS3Object, ListS3, PutS3Object, TagS3Object