In this article
...
The S3 Browser Snap is a Read-type Snap that reads the objects from S3.
Prerequisites
...
Type | Format | Number of Views | Examples of Upstream and Downstream Snaps | Description |
|---|
Input | Document | | | Key/value pairs used to evaluate expression properties in this Snap. |
Output | Document | | | The output displays the following attributes: bucket: The S3 bucket name.
objectKey: The S3 object with the prefix.
path: The path to the S3 bucket.
size: The size of the S3 object.
lastModified: The date when the S3 object was last modified.
storage-class: The Storage Class field, which indicates the archived status of the S3 object.
ownerDisplayName: The display name of the S3 owner.
ownerID: The ID of the S3 owner.
The attributes for each S3 object matching the specific Snap field values. For example, if you have the following S3 objects with the prefix "foo/" in the bucket "mrtest": | Info |
|---|
foo/bar/ban
foo/bar/bash
foo/bar/baz
foo/batbat/baz
foo/boo
If the S3 Browser Snap has the following properties, then the Snap produces output documents for all the five S3 objects. Bucket: mrtest
Prefix: foo/
Filter: **
Delimiter:
If the S3 Browser Snap has the following properties, then the Snap produces only one output document for foo/boo. Bucket: mrtest
Prefix: foo/
Filter: **
Delimiter: /
|
| Note |
|---|
When you use the Cross Account IAM Role in the S3 account, the ownerDisplayName and ownerID fields may be empty in the output document. |
|
Error | Error handling is a generic way to handle errors without losing data or failing the Snap execution. You can handle the errors that the Snap might encounter while running the Pipeline by choosing one of the following options from the When errors occur list under the Views tab: Stop Pipeline Execution: Stops the current pipeline execution when the Snap encounters an error. Discard Error Data and Continue: Ignores the error, discards that record, and continues with the remaining records. Route Error Data to Error View: Routes the error data to an error view without stopping the Snap execution.
Learn more about Error handling in Pipelines. |
...
