Generated from the CLI's own command tree. Run tebib storage --help for the same text in your terminal.
Object storage: the S3 endpoint and S3 access keys.
Commands
tebib storage info
The project's S3 endpoint and region, and what it stores.
tebib storage info [OPTIONS]
| Option | Value | Description |
|---|
--project, -p | str | Project ID (default: from the profile). |
--output, -o | table | json | yaml | Output format. |
Examples
tebib storage info # endpoint, region, what the project stores
tebib storage key
S3 access keys for aws-cli, rclone and SDKs. A key reaches every bucket in its project.
tebib storage key create
Create an S3 key for you (or a service account) and print its secret once.
tebib storage key create [OPTIONS] NAME
| Argument | Description |
|---|
NAME required | A name for the key, unique in the project. |
| Option | Value | Description |
|---|
--service-account | SA_ID | Give it to a service account (sa-...). |
--description | str | Description. |
--tag | KEY=VALUE (repeatable) | Tag as KEY=VALUE; repeat for more tags. |
--project, -p | str | Project ID (default: from the profile). |
--output, -o | table | json | yaml | Output format. |
Examples
tebib storage key create laptop # S3 key; the secret is printed once
tebib storage key delete
Delete a storage key.
tebib storage key delete [OPTIONS] ID
| Argument | Description |
|---|
ID required | S3 key ID (s3key-...). |
| Option | Value | Description |
|---|
--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). |
tebib storage key disable
Turn a key off (S3 refuses it) without deleting it.
tebib storage key disable [OPTIONS] KEY_ID
| Argument | Description |
|---|
KEY_ID required | S3 key ID (s3key-...). |
| Option | Value | Description |
|---|
--project, -p | str | Project ID (default: from the profile). |
--output, -o | table | json | yaml | Output format. |
tebib storage key enable
Turn a key back on, with the same secret.
tebib storage key enable [OPTIONS] KEY_ID
| Argument | Description |
|---|
KEY_ID required | S3 key ID (s3key-...). |
| Option | Value | Description |
|---|
--project, -p | str | Project ID (default: from the profile). |
--output, -o | table | json | yaml | Output format. |
tebib storage key list
List the project's storage keys.
tebib storage key 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 storage key rotate
New key ID and secret; the old pair keeps working for --overlap-hours.
tebib storage key rotate [OPTIONS] KEY_ID
| Argument | Description |
|---|
KEY_ID required | S3 key ID (s3key-...). |
| Option | Value | Description |
|---|
--overlap-hours | int range | How long the old key keeps working (0-168). Default: 24. |
--yes, -y | flag | Don't ask for confirmation. |
--project, -p | str | Project ID (default: from the profile). |
--output, -o | table | json | yaml | Output format. |
Examples
tebib storage key rotate s3key-... --overlap-hours 24
tebib storage key show
Show one storage key.
tebib storage key show [OPTIONS] ID
| Argument | Description |
|---|
ID required | S3 key ID (s3key-...). |
| Option | Value | Description |
|---|
--project, -p | str | Project ID (default: from the profile). |
--output, -o | table | json | yaml | Output format. |
tebib storage key update
Change a storage key's description or tags.
tebib storage key update [OPTIONS] ID
| Argument | Description |
|---|
ID required | S3 key ID (s3key-...). |
| 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. |
