delete object

This block is part of the object storage group and was last modified in core v15.0.1.

delete object v15.0.1

Removes an object. Deleting a key that is not there is not an error.

In pins 3 + flow
  • flow
    flow
  • connection required
    s3connection

    The object storage connection to use, from an open connection block.

  • bucket
    value

    Bucket name. Leave empty to use the bucket set on the connection.

  • key required
    value

    The object key to delete.

Out pins 4 + flow
  • flow
    flow
  • connection
    s3connection

    The same connection, so it can be passed to the next block.

  • success
    condition

    True when the delete was accepted, including when the object was already gone.

  • error
    value
  • key
    value

    The key that was deleted.

Deletes `bucket`/`key`. IDEMPOTENT: S3 answers 204 for a key that does not exist, so this reports success=true whether or not anything was removed : a cleanup flow should not fail because it ran twice. It therefore cannot tell you whether the object existed; run s3connection_head_object first when that matters. success=false with NO_CONNECTION, MISSING_BUCKET, MISSING_KEY, or an S3 code such as AccessDenied.

s3 delete
remove object
delete

Version history

Introduced in v15.0.1.


Back to object storage Return to the main group to view all sub-groups Back to object storage Return to the group to view all blocks within this group