Every command here also takes the global flags, returns the exit codes, and prints the JSON envelope with --json.
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>
| Flag | What it does |
|---|
--name <name> | Required3-63 lowercase letters, digits and hyphens |
--site <slug> | Requiredsite whose store holds the objects |
Show one bucket, by name or id.
Usage
ghaym cloud buckets get <bucket>
| Argument | Required |
|---|
<bucket> | Yes |
ghaym cloud buckets update
Change public read or the allowed browser origins.
Usage
ghaym cloud buckets update <bucket> [flags]
| Argument | Required |
|---|
<bucket> | Yes |
| Flag | What it does |
|---|
--public-read | anyone with an object's address may read it |
--no-public-read | only signed requests may read objects |
--origin <origin> | allowed browser origin, repeatable; replaces the list |
--clear-origins | allow 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]
| Argument | Required |
|---|
<bucket> | Yes |
| Flag | What 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>
| Argument | Required |
|---|
<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]
| Argument | Required |
|---|
<bucket> | Yes |
| Flag | What it does |
|---|
--show | print 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]
| Argument | Required |
|---|
<bucket> | Yes |
| Flag | What it does |
|---|
--show | print the new secret |
--yes | rotate 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]
| Argument | Required |
|---|
<bucket> | Yes |
| Flag | What 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]
| Argument | Required |
|---|
<bucket> | Yes |
| Flag | What 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>
| Argument | Required |
|---|
<bucket> | Yes |
<key> | Yes |
ghaym cloud buckets objects link
Print a short-lived signed URL to share the object.
Usage
ghaym cloud buckets objects link <bucket> <key>
| Argument | Required |
|---|
<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]
| Argument | Required |
|---|
<bucket> | Yes |
<key> | Yes |
| Flag | What it does |
|---|
--yes | delete 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]
| Argument | Required |
|---|
<bucket> | Yes |
<prefix> | Yes |
| Flag | What it does |
|---|
--yes | delete without asking |
ghaym cloud buckets folder-deletes list
List the bucket's folder deletes.
Usage
ghaym cloud buckets folder-deletes list <bucket> [flags]
| Argument | Required |
|---|
<bucket> | Yes |
| Flag | What 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]
| Argument | Required |
|---|
<bucket> | Yes |
<file> | Yes |
| Flag | What it does |
|---|
--key <key> | object key; the file's name when omitted |
--replace | overwrite 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]
| Argument | Required |
|---|
<bucket> | Yes |
<service> | Yes |
| Flag | What it does |
|---|
--prefix <prefix> | prefix in front of the variable names, as UPLOADS |
--env <env> | environment name or id; production when omitted |
--apply | publish 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]
| Argument | Required |
|---|
<bucket> | Yes |
<service> | Yes |
| Flag | What it does |
|---|
--env <env> | environment name or id; production when omitted |
--apply | publish 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]
| Argument | Required |
|---|
<service> | Yes |
| Flag | What it does |
|---|
--env <env> | environment name or id; production when omitted |