storage::deleteObject
Delete an object. No-op when the object does not exist.
- bucketstringrequired
- keystringrequired
- version_idstring
- deletedbooleanrequired
storage
v0.1.23Object storage across AWS S3, GCS, Cloudflare R2, and a native local filesystem backend. Streamed uploads, signed URLs, and object change triggers.
Install
bash
iii trigger compose::add worker=storage@0.1.23Run in your project with the iii engine running. Exact versions are immutable and digest-pinned.
Functions10
Function
storage::getObject
Download a small object inline as base64 (10 MiB hard limit). This buffers and inflates the payload; use a presignUrl GET for files and large objects.
- bucketstringrequired
- keystringrequired
- version_idstring
- body_base64stringrequired
- content_typestringrequired
- etagstringrequired
- last_modifiedstring· date-timerequired
- sizeinteger· uint64requiredmin 0
storage::headObject
Fetch object metadata (size, ETag, content-type, last-modified) without downloading the body.
- bucketstringrequired
- keystringrequired
- version_idstring
- content_typestringrequired
- etagstringrequired
- last_modifiedstring· date-timerequired
- sizeinteger· uint64requiredmin 0
storage::listBuckets
List configured worker-facing storage buckets and their providers.
Empty object
- bucketsobject[]required
- namestringrequired
- providerstringrequired
storage::listObjects
List objects and common prefixes in a bucket with provider-native pagination.
- bucketstringrequired
- cursorstring
- delimiterstring
Directory separator. Use `/` for the bucket/folder explorer; omit it for a flat recursive listing.
- limitinteger· uint32min 0
- prefixstring
- common_prefixesstring[]required
- next_cursorstring
- objectsobject[]required
- content_typestring
- etagstringrequired
- keystringrequired
- last_modifiedstring· date-timerequired
- sizeinteger· uint64requiredmin 0
storage::on-config-change
Internal: transactionally apply the authoritative storage configuration without restarting the worker.
- idstring
- okbooleanrequired
storage::presignPost
Issue a short-lived multipart/form-data POST for direct browser upload. The file never buffers in the engine or worker RPC path.
- bucketstringrequired
- content_typestringrequired
- expires_in_secondsinteger· uint64min 0
- keystringrequired
- max_size_bytesinteger· uint64min 0
Optional upload cap enforced while the HTTP body is streamed.
- expires_atstring· date-timerequired
- fieldsobjectrequired
- urlstringrequired
storage::presignUrl
Issue a short-lived URL the browser can hit directly to PUT or GET an object.
- bucketstringrequired
- content_typestring
- expires_in_secondsinteger· uint64min 0
- keystringrequired
- methodstringrequiredenum GET, PUT
- response_content_dispositionstring
GET-only: override `Content-Disposition` header on the served response. Rejected with `INVALID_PRESIGN_PARAMS` if set on a PUT presign.
- response_content_typestring
GET-only: override `Content-Type` header on the served response. Rejected with `INVALID_PRESIGN_PARAMS` if set on a PUT presign.
- expires_atstring· date-timerequired
- urlstringrequired
storage::putObject
Upload a small object inline as base64 (10 MiB hard limit). This buffers and inflates the payload; use presignPost or a presignUrl PUT for files and large objects.
- body_base64stringrequired
Base64-encoded small body (10 MiB decoded hard limit). The legacy field name `body` is accepted as an alias for backward compatibility.
- bucketstringrequired
- cache_controlstring
- content_typestring
- keystringrequired
- metadataobject
- etagstringrequired
- sizeinteger· uint64requiredmin 0
- version_idstring
storage::ui-content
Serve the storage worker's injected console UI assets (content function for its console:script / console:style triggers).
- pathstringrequired
The asset path from the trigger config (e.g. `state/page.js`).
- contentstringrequired
The asset source, verbatim.
- content_typestringrequired
MIME type the console should serve the asset with.
Triggers2
storage::object-created
Fires when an object is written to a configured bucket whose notifications source is wired up.
valueunknown
valueunknown
storage::object-deleted
Fires when an object is removed from a configured bucket whose notifications source is wired up.
valueunknown
valueunknown