ghaym cloud buckets

Manage object storage buckets.

Every command here also takes the global flags, returns the exit codes, and prints the JSON envelope with --json.

ghaym cloud buckets list

List the workspace's buckets.

Usage
ghaym cloud buckets list

ghaym cloud buckets sites

List the sites a bucket can be created in, with the storage price.

Usage
ghaym cloud buckets sites

ghaym cloud buckets create

Create a bucket; it provisions in the background.

Usage
ghaym cloud buckets create --name <name> --site <slug>
FlagWhat it does
--name <name>Required3-63 lowercase letters, digits and hyphens
--site <slug>Requiredsite whose store holds the objects

ghaym cloud buckets get

Show one bucket, by name or id.

Usage
ghaym cloud buckets get <bucket>
ArgumentRequired
<bucket>Yes

ghaym cloud buckets update

Change public read or the allowed browser origins.

Usage
ghaym cloud buckets update <bucket> [flags]
ArgumentRequired
<bucket>Yes
FlagWhat it does
--public-readanyone with an object's address may read it
--no-public-readonly signed requests may read objects
--origin <origin>allowed browser origin, repeatable; replaces the list
--clear-originsallow no browser origin

ghaym cloud buckets delete

Delete a bucket and everything in it; this cannot be undone.

Usage
ghaym cloud buckets delete <bucket> [flags]
ArgumentRequired
<bucket>Yes
FlagWhat it does
--confirm <name>the bucket's name, to delete without asking

ghaym cloud buckets stats

Show what the bucket stores against its quota.

Usage
ghaym cloud buckets stats <bucket>
ArgumentRequired
<bucket>Yes

ghaym cloud buckets credentials get

Show the key pair; the secret stays masked without --show.

Usage
ghaym cloud buckets credentials get <bucket> [flags]
ArgumentRequired
<bucket>Yes
FlagWhat it does
--showprint the secret

ghaym cloud buckets credentials rotate

Issue a new key pair; the old one stops at once, or after connected services redeploy.

Usage
ghaym cloud buckets credentials rotate <bucket> [flags]
ArgumentRequired
<bucket>Yes
FlagWhat it does
--showprint the new secret
--yesrotate without asking

ghaym cloud buckets objects list

List one folder's objects, a page at a time.

Usage
ghaym cloud buckets objects list <bucket> [flags]
ArgumentRequired
<bucket>Yes
FlagWhat it does
--prefix <prefix>folder to list, ending in /
--cursor <cursor>next page, from the last answer

ghaym cloud buckets objects summary

Count the objects and bytes under a prefix, a page at a time.

Usage
ghaym cloud buckets objects summary <bucket> [flags]
ArgumentRequired
<bucket>Yes
FlagWhat it does
--prefix <prefix>folder to count, ending in /
--cursor <cursor>next page, from the last answer

ghaym cloud buckets objects download-url

Print a short-lived signed URL that downloads the object.

Usage
ghaym cloud buckets objects download-url <bucket> <key>
ArgumentRequired
<bucket>Yes
<key>Yes

Print a short-lived signed URL to share the object.

Usage
ghaym cloud buckets objects link <bucket> <key>
ArgumentRequired
<bucket>Yes
<key>Yes

ghaym cloud buckets objects delete

Delete one object; this cannot be undone.

Usage
ghaym cloud buckets objects delete <bucket> <key> [flags]
ArgumentRequired
<bucket>Yes
<key>Yes
FlagWhat it does
--yesdelete without asking

ghaym cloud buckets folder-deletes start

Count what the folder holds, then start deleting it; this cannot be undone.

Usage
ghaym cloud buckets folder-deletes start <bucket> <prefix> [flags]
ArgumentRequired
<bucket>Yes
<prefix>Yes
FlagWhat it does
--yesdelete without asking

ghaym cloud buckets folder-deletes list

List the bucket's folder deletes.

Usage
ghaym cloud buckets folder-deletes list <bucket> [flags]
ArgumentRequired
<bucket>Yes
FlagWhat it does
--status <statuses>comma-separated statuses, as running,stopped

ghaym cloud buckets upload

Upload one file, up to 5 GiB.

Usage
ghaym cloud buckets upload <bucket> <file> [flags]
ArgumentRequired
<bucket>Yes
<file>Yes
FlagWhat it does
--key <key>object key; the file's name when omitted
--replaceoverwrite an object already at the key

ghaym cloud buckets connect

Stage giving a web service the bucket's six S3_* variables.

Usage
ghaym cloud buckets connect <bucket> <service> [flags]
ArgumentRequired
<bucket>Yes
<service>Yes
FlagWhat it does
--prefix <prefix>prefix in front of the variable names, as UPLOADS
--env <env>environment name or id; production when omitted
--applypublish now instead of leaving the change staged

ghaym cloud buckets disconnect

Stage taking the bucket's variables away from a web service.

Usage
ghaym cloud buckets disconnect <bucket> <service> [flags]
ArgumentRequired
<bucket>Yes
<service>Yes
FlagWhat it does
--env <env>environment name or id; production when omitted
--applypublish now instead of leaving the change staged

ghaym cloud buckets connections

List the buckets connected to a service in one environment.

Usage
ghaym cloud buckets connections <service> [flags]
ArgumentRequired
<service>Yes
FlagWhat it does
--env <env>environment name or id; production when omitted