vetta storage

Buckets and objects on a fullstack app’s object store, from the terminal.

Object storage on the organization’s fullstack app. Every command takes --app <id>; without it the organization’s single fullstack app is used — two candidates is 409 ambiguous_app naming both, none is 404 not_found.

Reads require the agents:read scope; mb, rb, put, rm and url --upload require agents:write.

​

Commands

Command	Description
vetta storage buckets	The app’s buckets.
vetta storage mb <bucket>	Make a bucket. --public serves its objects without a signature.
vetta storage rb <bucket>	Remove a bucket. A non-empty bucket needs --force, which empties it first.
vetta storage ls <bucket>[/<prefix>]	The objects, or only those under the prefix.
vetta storage put <bucket>/<key> <file>	Upload a file as the object.
vetta storage get <bucket>/<key> [file]	Download the object to the file, or to stdout.
vetta storage rm <bucket>/<key>	Delete the object. Idempotent.
vetta storage url <bucket>/<key>	A one-hour download URL, or with --upload a PUT URL.

​

buckets, mb, rb

vetta storage buckets
vetta storage mb avatars --public
vetta storage rb avatars --force

Flag	Description
--app	The app, when the organization has more than one fullstack app.
--public	mb: a public bucket.
--force	rb: empty the bucket before removing it.

​

ls

vetta storage ls avatars
vetta storage ls avatars/users/ --limit 50

Flag	Description
--limit	Page size.
--after	Cursor from a previous page’s next_cursor.

​

put, get, rm

vetta storage put avatars/users/alice.json ./alice.json
vetta storage get avatars/users/alice.json            # bytes on stdout
vetta storage get avatars/users/alice.json ./out.json # bytes into the file
vetta storage rm avatars/users/alice.json

put sends the file’s bytes inline (up to 50 MiB) with a Content-Type taken from --content-type, else from the file’s suffix (.json, .png, .pdf, …), else application/octet-stream. For a larger upload take a URL with url --upload and PUT the bytes to it directly.

Flag	Description
--content-type	put: the type to store, overriding the suffix.

​

url

vetta storage url avatars/users/alice.json
vetta storage url avatars/video.mp4 --upload --content-type video/mp4 --expires 3600

Flag	Description
--upload	A PUT URL for the bytes instead of a GET URL for them.
--content-type	--upload: the type the upload will carry; defaults from the key’s suffix.
--expires	--upload: seconds the URL is good for, 60–3600, default 900.