dodil k3 bucket
Manage K3 buckets — create, get, list, update, delete. Mirrors Buckets — API Reference.
Bucket-scoped sub-groups: dodil k3 bucket policy (S3-style ACL) and dodil k3 bucket cors (CORS configuration).
dodil k3 bucket create
dodil k3 bucket create [name] [flags]Creates a new bucket scoped to the caller’s org. Defaults from the API apply (access_mode = PRIVATE, storage_quota_bytes = 0 = unlimited) — the CLI does not currently expose flags for them.
| Flag | Short | Type | Description |
|---|---|---|---|
--description | -d | string | Human-readable bucket description |
Examples:
dodil k3 bucket create kb-prod
dodil k3 bucket create kb-prod -d "Production knowledge base"dodil k3 bucket get
dodil k3 bucket get [name]Fetches a bucket by name. Output format follows the global --output flag (default table; use --output json for machine-readable).
Example:
dodil k3 bucket get kb-prod --output jsondodil k3 bucket list
dodil k3 bucket listLists all buckets in the caller’s org. Pagination and search filtering exist on the underlying ListBuckets API but are not surfaced as CLI flags today.
dodil k3 bucket update
dodil k3 bucket update [name] [flags]Patches mutable fields on a bucket — only the flags you pass are sent. Anything you don’t pass stays unchanged. Mirrors UpdateBucket.
| Flag | Short | Type | Description |
|---|---|---|---|
--description | -d | string | Human-readable description |
--storage-quota-bytes | — | int64 | Storage quota in bytes (0 = unlimited) |
--access-mode | — | string | private | public | custom — the CLI uses these friendly values and maps to BUCKET_ACCESS_MODE_* for the API |
Examples:
# Change just the description
dodil k3 bucket update kb-prod -d "Renamed bucket"
# Make it public
dodil k3 bucket update kb-prod --access-mode public
# Set a 10 GiB quota
dodil k3 bucket update kb-prod --storage-quota-bytes 10737418240
# Multiple fields at once
dodil k3 bucket update kb-prod -d "Tighter quota" --storage-quota-bytes 5368709120dodil k3 bucket delete
dodil k3 bucket delete [name]Deletes a bucket. Be sure it’s empty (the API will refuse to delete a non-empty bucket).
Example:
dodil k3 bucket delete kb-prodSee also
- Buckets — API Reference — the full Bucket lifecycle contract
- Core Concepts → Bucket — type signature + enums
dodil k3 bucket policy·dodil k3 bucket cors·dodil k3 object·dodil k3 mount