S3 Delete Object
Removes an object from a bucket.
In-ports
s3-uri String
— a S3 object location.
trigger <any>
— triggers the S3 request.
abort <any>
— aborts all pending requests.
config JSON
(dynamic) — accepts a JSON object with configuration properties.
Out-ports
response Object
— emits a response wrapped into JSON object.
errors JSON
— emits any errors that occur during action execution.
Overview
The S3 Delete Object component removes an object from an Amazon S3 bucket. This component is part of the group of components that are designed to perform operations with Amazon S3.
To use this component, send an S3 URI of the object you want to delete 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.
The behavior depends on the bucket's versioning state:
- If bucket versioning is not enabled, the operation permanently deletes the object.
- If bucket versioning is enabled, the operation inserts a delete marker, which becomes the current version of the object.
- If bucket versioning is suspended, the operation removes the object that has a null
versionId
, if there is one, and inserts a delete marker that becomes the current version of the object. If there isn't an object with a nullversionId
, and all versions of the object have aversionId
, Amazon S3 does not remove the object and only inserts a delete marker.
To permanently delete an object in a versioned bucket, you must include the object’s versionId
in the request. For more information about versioning-enabled buckets, see Deleting object versions from a versioning-enabled bucket.
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 204 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
)
Specifies the region in which the S3 client operates.
- Required: Yes
- Default: None
Version ID (versionId
)
Version ID used to reference a specific version of the object.
- Required: No
- Default: None
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: