storage::deleteObject
Delete an object. No-op when the object does not exist.
- bucketstringrequired
- keystringrequired
- version_idstring
- deletedbooleanrequired
storage
v0.1.9Object 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.9Run in your project with the iii engine running. Exact versions are immutable and digest-pinned.
Functions6
Function
storage::getObject
Read an object. Body is base64; for large objects use presignUrl.
- 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::on-config-change
Internal: rebuild storage backends from the authoritative configuration when it changes.
- idstring
Configuration id that changed (advisory; the handler re-fetches the value).
- okbooleanrequired
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
Write an object to a configured bucket. Body is base64; max 10MB inline.
- body_base64stringrequired
Base64-encoded body. The legacy field name `body` is accepted as an alias for backward compatibility with clients that pre-date the rename.
- bucketstringrequired
- cache_controlstring
- content_typestring
- keystringrequired
- metadataobject
- etagstringrequired
- sizeinteger· uint64requiredmin 0
- version_idstring
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