S3Uploader
Using the Amazon Simple Storage Service (S3), uploads data to an Amazon S3 bucket.
输入端口
This transformer accepts any feature.
输出端口
Features which have successfully uploaded their contents to S3 are output through this port.
Features which have not successfully uploaded their contents to S3 are output through this port.Additionally, a message stored in an attribute specified inError Attribute, will contain details about the failure.
票面价值ameters
S3 Bucket
The name of the Amazon S3 bucket.
The AWS Region in which the specifiedBucketresides.If the default value,US East, N.Virginia (us-east-1), is specified, and the specifiedBucketdoes not reside there, the operation will still succeed.However, to optimize latency, it is best practice to specify the correct region.
Specify a web connection to Amazon S3.Web connections can be reused in multiple workspaces, and connection parameters are hidden in the workspace.For more information, seeUsing Web Connections.Alternatively, checkEmbed Access Key(below) and specify the connection parameters manually.
When checked, you must specify the connection parameters to Amazon S3 manually.The connection parameters are visible in the workspace.To connect, specify:
An access key associated with a user with permission to upload data to the specified bucket.If a pairing of an access key and a secret access key is not given, credentials will be searched in various locations listed here.
- 在题为文件AwsCredentials.properties位于Java类路径
- 有关属性aws.accessKeyId和aws.secretKey在Java系统属性
- 在环境变量AWS_ACCESS_KEY_ID和AWS_SECRET_KEY
If credentials are still not found, the client will act as if it is in anonymous mode, where requests aren’t signed.This is useful if accessing a publicly accessible object or bucket.
A secret key paired with the access key provided.See the访问密钥IDparameter for credential searching.
S3 Upload Options
The name that the uploaded data will be stored under.Bucket Name和Object Keytogether uniquely identify an object, and should vary for each feature processed.
IfYes, allows Amazon S3 Transfer Acceleration on the bucket, if enabled.To enable acceleration, seehttp://docs.aws.amazon.com/AmazonS3/latest/UG/enable-bucket-transfer-acceleration.html.
When allowing S3 Acceleration, keep in mind the following:
- The specifiedBucketname must be DNS-compliant.
- Your Amazon account is charged for performing accelerated requests.
- Server-Side Encryption (AES-256): Instructs the Amazon S3 to encrypt the data after it is uploaded using the 256-bit Advanced Encryption Standard (AES).For more information, seethis AWS Blog post.
- None: Data is not encrypted after upload.
Data Source
The source of the data to be uploaded.
- File: The specified file will be uploaded.TheUpload Content Typewill be automatically determined based on the file extension.SeeSource Filename.
- Attribute or Expression: The contents of the specified attribute or expression will be uploaded.See数据上传.
- 夹: The specified folder will be uploaded.Because permissions are either bucket- or object-specific, the default permissions cannot be altered for a folder.See源文件夹.
When working with large objects,Fileis the better choice as the data will be streamed directly from disk and not require that the object be stored entirely in memory on a feature.
File/Attribute or Expression Options
The file to be uploaded, whenData SourceisFile.
The data to be uploaded, whenData SourceisAttribute or Expression.An attribute or expression can be used to supply the data.
The predefined set of grantees and permissions to store with each uploaded object.For more information, seehttp://docs.aws.amazon.com/AmazonS3/latest/dev/ACLOverview.html#CannedACL.
You can specify header fields in the HTTP upload request.UnderName, specify a header field.You can select from a drop-down list of predefined fields that include metadata and ACL permissions parameters.Alternatively, enter fields manually.UnderValue, specify a field value.
注意:IfCannedACLorContent-Typeheaders are specified here, they overridePermissions和Upload Content Typesettings, respectively.
夹 Options
The folder to be uploaded, whenData Sourceis夹.
Option to include or exclude subfolders of the given folder from the upload.
Output Options
Specify the output attribute that will store the uploaded object’s URI.
Specify a list name for thelist attributethat will contain all headers entered inHeaders.
Editing Transformer Parameters
Using a set of menu options, transformer parameters can be assigned by referencing other elements in the workspace.More advanced functions, such as an advanced editor and an arithmetic editor, are also available in some transformers.To access a menu of these options, clickbeside the applicable parameter.For more information, seeTransformer Parameter Menu Options.
Transformer Categories
FME Licensing Level
FME Professional edition and above
Search FME Knowledge Center
Search for samples and information about this transformer on theFME Knowledge Center.