tebib bucket

Generated from the CLI's own command tree. Run tebib bucket --help for the same text in your terminal.

Buckets: S3 object storage in the project's region.

Commands

tebib bucket create

Create a bucket (private unless --public).

tebib bucket create [OPTIONS] NAME

Argument	Description
NAME required	S3 bucket name: 3-63 lowercase letters, digits and '-', unique.

Option	Value	Description
--public	flag	Anyone may download objects (no listing).
--max-size-gib	int range	Cap the bucket's size.
--description	str	Description.
--tag	KEY=VALUE (repeatable)	Tag as KEY=VALUE; repeat for more tags.
--project, -p	str	Project ID (default: from the profile).
--wait	flag	Wait until the resource is ready (or gone, for deletes).
--timeout	float range	Seconds to wait with --wait. Default: 300.
--output, -o	table | json | yaml	Output format.

Examples

tebib bucket create acme-photos --public --wait     # private unless --public

tebib bucket delete

Delete a bucket. It must be empty unless --force.

tebib bucket delete [OPTIONS] BUCKET_ID

Argument	Description
BUCKET_ID required	Bucket ID (bkt-...).

Option	Value	Description
--force	flag	Delete its objects too. There is no undo.
--yes, -y	flag	Don't ask for confirmation.
--wait	flag	Wait until the resource is ready (or gone, for deletes).
--timeout	float range	Seconds to wait with --wait. Default: 600.
--project, -p	str	Project ID (default: from the profile).

Examples

tebib bucket delete bkt-... --force --yes           # with its objects; no undo

tebib bucket list

List the project's buckets.

tebib bucket list [OPTIONS]

Option	Value	Description
--project, -p	str	Project ID (default: from the profile).
--limit	int range	Show at most this many items.
--output, -o	table | json | yaml	Output format.

tebib bucket set-size-cap

Cap a bucket's size (uploads over it are refused), or remove the cap.

tebib bucket set-size-cap [OPTIONS] BUCKET_ID GIB

Argument	Description
BUCKET_ID required	Bucket ID (bkt-...).
GIB required	GiB; 0 removes the cap.

Option	Value	Description
--project, -p	str	Project ID (default: from the profile).
--output, -o	table | json | yaml	Output format.

tebib bucket set-visibility

Make a bucket private, or let anyone download its objects (public-read).

tebib bucket set-visibility [OPTIONS] BUCKET_ID VISIBILITY

Argument	Description
BUCKET_ID required	Bucket ID (bkt-...).
VISIBILITY required	private or public-read.

Option	Value	Description
--project, -p	str	Project ID (default: from the profile).
--output, -o	table | json | yaml	Output format.

tebib bucket show

Show one bucket.

tebib bucket show [OPTIONS] ID

Argument	Description
ID required	Bucket ID (bkt-...).

Option	Value	Description
--project, -p	str	Project ID (default: from the profile).
--output, -o	table | json | yaml	Output format.

tebib bucket update

Change a bucket's description or tags.

tebib bucket update [OPTIONS] ID

Argument	Description
ID required	Bucket ID (bkt-...).

Option	Value	Description
--description	str	New description.
--tag	KEY=VALUE (repeatable)	Replace ALL tags (KEY=VALUE, repeatable).
--clear-tags	flag	Remove all tags.
--project, -p	str	Project ID (default: from the profile).
--output, -o	table | json | yaml	Output format.