S3 Get Object
Retrieves an object from Amazon S3.
In-ports
s3-uri String
— the location of a S3 object.
trigger <any>
— triggers the S3 request.
abort <any>
— aborts all pending requests.
config JSON
(dynamic) — accepts a JSON object with configuration properties that can be set at runtime.
Out-ports
response JSON
— response wrapped into JSON object.
errors JSON
— emits any errors that occur during action execution.
Overview
The S3 Get Object component allows you to retrieve an object from Amazon S3. This component is part of the group of components designed to perform operations with Amazon S3.
To retrieve an object, send an S3 URI of the object to the s3-uri port. S3 URI indicates an S3 location in the format s3://amzn-s3-demo-bucket/mykey
, where amzn-s3-demo-bucket
is the bucket name and mykey
is the key. You must have the READ
access to the object (or version).
If the trigger input port is used, the component waits until an event is received before executing the action. The action is performed with each event. Errors encountered will be emitted on the errors output port. Use the abort port to cancel the execution.
If the action is successful, the service sends back an HTTP 200 response.
Settings
Enable realtime config port
When enabled, this setting allows the component to be configured via the config port. The port accepts a configuration object as input, enabling dynamic property updates during runtime. While using this port won't trigger component reinitialization, it may result in the loss of some previous component state.
Region (region
)
The region in which S3 client needs to work.
- Required: Yes
Response data type (responseType
)
Determines the format of the response data. The component will automatically set the corresponding header parameters to the service request.
- Required: No
- Values:
[arraybuffer, blob, json, text]
- Default:
blob
Range (range
)
Downloads the specified byte range of an object. For more information about the HTTP Range header, see RFC 9110.
- Type:
String
- Required: No
Version ID (versionId
)
Version ID used to reference a specific version of the object. By default, the component returns the current version of an object.
- Required: No
Keep always active
Determines whether the component will remain active even if it is not connected to a visible widget or another active component.
Related
See also
For more information about Amazon S3, see the following: