blocks.store.s3 — mvxcvi/blocks-s3 2.0.0

S3 stores provide block storage backed by a bucket in Amazon S3.

Each block is stored in a separate object in the bucket. Stores may be constructed using an s3://<bucket-name>/<prefix> URI.

s3-block-store clj

(s3-block-store bucket & {:as opts})

Creates a new S3 block store. If credentials are not provided, the AWS SDK will use a number of mechanisms to infer them from the environment.

Supported options:

• :credentials Authentication credentials to use for the store. There are several possibilities:
  • An AWSCredentialsProvider to draw credentials from dynamically.
  • A static AWSCredentials object to use directly.
  • A map with :access-key, :secret-key, and optionally :session-token entries.
• :region A keyword or string designating the region the bucket is in. (like :us-west-2)
• :prefix A string prefix to store the blocks under. A trailing slash is always added if not present.
• :sse A keyword algorithm selection to use Server Side Encryption when storing blocks. Currently only :aes-256 is supported.
• :alter-put-metadata A 2-arg function that will be called with the block store and a block's ObjectMetadata before it is written. This function may make any desired modifications on the metadata, such as custom encryption schemes, attaching extra headers, and so on.