@tigrisdata/cli 2.18.0-beta.2 → 2.18.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +296 -342
- package/SKILL.md +0 -3
- package/dist/{chunk-ZUJOS5T2.js → chunk-3L2I7HZB.js} +1 -1
- package/dist/chunk-DQMSOC2W.js +8 -0
- package/dist/cli.js +1 -1
- package/dist/index.js +1 -1
- package/dist/lib/buckets/migrate.js +3 -3
- package/dist/lib/update.js +1 -1
- package/dist/utils/update-check.js +1 -1
- package/package.json +10 -10
- package/dist/chunk-BBX3M4S2.js +0 -8
package/README.md
CHANGED
|
@@ -68,15 +68,15 @@ List all buckets (no arguments) or objects under a bucket/prefix path. Accepts b
|
|
|
68
68
|
tigris ls [path] [flags]
|
|
69
69
|
```
|
|
70
70
|
|
|
71
|
-
| Flag
|
|
72
|
-
|
|
71
|
+
| Flag | Description |
|
|
72
|
+
|------|-------------|
|
|
73
73
|
| `-snapshot, --snapshot-version` | Read from a specific bucket snapshot. Accepts a snapshot version string or any UNIX nanosecond-precision timestamp (e.g. 1765889000501544464) |
|
|
74
|
-
| `--format`
|
|
75
|
-
| `--limit`
|
|
76
|
-
| `-pt, --page-token`
|
|
74
|
+
| `--format` | Output format |
|
|
75
|
+
| `--limit` | Maximum number of items to return per page |
|
|
76
|
+
| `-pt, --page-token` | Pagination token from a previous request to fetch the next page |
|
|
77
|
+
| `--source` | List objects from a specific storage source on buckets with shadow migration enabled |
|
|
77
78
|
|
|
78
79
|
**Examples:**
|
|
79
|
-
|
|
80
80
|
```bash
|
|
81
81
|
tigris ls
|
|
82
82
|
tigris ls my-bucket
|
|
@@ -92,20 +92,19 @@ Create a bucket (bare name) or a folder inside a bucket (bucket/folder/ with tra
|
|
|
92
92
|
tigris mk <path> [flags]
|
|
93
93
|
```
|
|
94
94
|
|
|
95
|
-
| Flag
|
|
96
|
-
|
|
97
|
-
| `-a, --access`
|
|
98
|
-
| `--public`
|
|
99
|
-
| `-s, --enable-snapshots`
|
|
100
|
-
| `-t, --default-tier`
|
|
101
|
-
| `-c, --consistency`
|
|
102
|
-
| `-r, --region`
|
|
103
|
-
| `-l, --locations`
|
|
104
|
-
| `-fork, --fork-of`
|
|
95
|
+
| Flag | Description |
|
|
96
|
+
|------|-------------|
|
|
97
|
+
| `-a, --access` | Access level (only applies when creating a bucket) |
|
|
98
|
+
| `--public` | Shorthand for --access public (only applies when creating a bucket) |
|
|
99
|
+
| `-s, --enable-snapshots` | Enable snapshots for the bucket (only applies when creating a bucket) |
|
|
100
|
+
| `-t, --default-tier` | Default storage tier (only applies when creating a bucket) |
|
|
101
|
+
| `-c, --consistency` | (Deprecated, use --locations) Consistency level (only applies when creating a bucket) |
|
|
102
|
+
| `-r, --region` | (Deprecated, use --locations) Region (only applies when creating a bucket) |
|
|
103
|
+
| `-l, --locations` | Location for the bucket (only applies when creating a bucket) |
|
|
104
|
+
| `-fork, --fork-of` | Create this bucket as a fork (copy-on-write clone) of the named source bucket |
|
|
105
105
|
| `-source-snap, --source-snapshot` | Fork from a specific snapshot of the source bucket. Accepts a snapshot version string or any UNIX nanosecond-precision timestamp (e.g. 1765889000501544464). Requires --fork-of |
|
|
106
106
|
|
|
107
107
|
**Examples:**
|
|
108
|
-
|
|
109
108
|
```bash
|
|
110
109
|
tigris mk my-bucket
|
|
111
110
|
tigris mk my-bucket --access public --region iad
|
|
@@ -124,7 +123,6 @@ tigris touch <path>
|
|
|
124
123
|
```
|
|
125
124
|
|
|
126
125
|
**Examples:**
|
|
127
|
-
|
|
128
126
|
```bash
|
|
129
127
|
tigris touch my-bucket/placeholder.txt
|
|
130
128
|
tigris touch t3://my-bucket/logs/
|
|
@@ -138,12 +136,11 @@ Copy files between local filesystem and Tigris, or between paths within Tigris.
|
|
|
138
136
|
tigris cp <src> <dest> [flags]
|
|
139
137
|
```
|
|
140
138
|
|
|
141
|
-
| Flag
|
|
142
|
-
|
|
139
|
+
| Flag | Description |
|
|
140
|
+
|------|-------------|
|
|
143
141
|
| `-r, --recursive` | Copy directories recursively |
|
|
144
142
|
|
|
145
143
|
**Examples:**
|
|
146
|
-
|
|
147
144
|
```bash
|
|
148
145
|
tigris cp ./file.txt t3://my-bucket/file.txt
|
|
149
146
|
tigris cp t3://my-bucket/file.txt ./local-copy.txt
|
|
@@ -159,13 +156,12 @@ Move (rename) objects within Tigris. Both source and destination must be remote
|
|
|
159
156
|
tigris mv <src> <dest> [flags]
|
|
160
157
|
```
|
|
161
158
|
|
|
162
|
-
| Flag
|
|
163
|
-
|
|
164
|
-
| `-r, --recursive` | Move directories recursively
|
|
165
|
-
| `-f, --force`
|
|
159
|
+
| Flag | Description |
|
|
160
|
+
|------|-------------|
|
|
161
|
+
| `-r, --recursive` | Move directories recursively |
|
|
162
|
+
| `-f, --force` | Skip confirmation prompts (alias for --yes) |
|
|
166
163
|
|
|
167
164
|
**Examples:**
|
|
168
|
-
|
|
169
165
|
```bash
|
|
170
166
|
tigris mv t3://my-bucket/old.txt t3://my-bucket/new.txt -f
|
|
171
167
|
tigris mv t3://my-bucket/old-dir/ t3://my-bucket/new-dir/ -rf
|
|
@@ -180,13 +176,12 @@ Remove a bucket, folder, or object from Tigris. A bare bucket name deletes the b
|
|
|
180
176
|
tigris rm <path> [flags]
|
|
181
177
|
```
|
|
182
178
|
|
|
183
|
-
| Flag
|
|
184
|
-
|
|
185
|
-
| `-r, --recursive` | Remove directories recursively
|
|
186
|
-
| `-f, --force`
|
|
179
|
+
| Flag | Description |
|
|
180
|
+
|------|-------------|
|
|
181
|
+
| `-r, --recursive` | Remove directories recursively |
|
|
182
|
+
| `-f, --force` | Skip confirmation prompts (alias for --yes) |
|
|
187
183
|
|
|
188
184
|
**Examples:**
|
|
189
|
-
|
|
190
185
|
```bash
|
|
191
186
|
tigris rm t3://my-bucket/file.txt -f
|
|
192
187
|
tigris rm t3://my-bucket/folder/ -rf
|
|
@@ -202,13 +197,12 @@ Show storage stats (no args), bucket info, or object metadata
|
|
|
202
197
|
tigris stat [path] [flags]
|
|
203
198
|
```
|
|
204
199
|
|
|
205
|
-
| Flag
|
|
206
|
-
|
|
207
|
-
| `--format`
|
|
200
|
+
| Flag | Description |
|
|
201
|
+
|------|-------------|
|
|
202
|
+
| `--format` | Output format |
|
|
208
203
|
| `-snapshot, --snapshot-version` | Read from a specific bucket snapshot. Accepts a snapshot version string or any UNIX nanosecond-precision timestamp (e.g. 1765889000501544464) |
|
|
209
204
|
|
|
210
205
|
**Examples:**
|
|
211
|
-
|
|
212
206
|
```bash
|
|
213
207
|
tigris stat
|
|
214
208
|
tigris stat t3://my-bucket
|
|
@@ -223,16 +217,15 @@ Generate a presigned URL for temporary access to an object without credentials
|
|
|
223
217
|
tigris presign <path> [flags]
|
|
224
218
|
```
|
|
225
219
|
|
|
226
|
-
| Flag
|
|
227
|
-
|
|
228
|
-
| `-m, --method`
|
|
229
|
-
| `-e, --expires-in` | URL expiry time in seconds
|
|
230
|
-
| `--access-key`
|
|
231
|
-
| `--select`
|
|
232
|
-
| `--format`
|
|
220
|
+
| Flag | Description |
|
|
221
|
+
|------|-------------|
|
|
222
|
+
| `-m, --method` | HTTP method for the presigned URL |
|
|
223
|
+
| `-e, --expires-in` | URL expiry time in seconds |
|
|
224
|
+
| `--access-key` | Access key ID to use for signing. If not provided, resolved from credentials or auto-selected |
|
|
225
|
+
| `--select` | Interactively select an access key (OAuth only) |
|
|
226
|
+
| `--format` | Output format |
|
|
233
227
|
|
|
234
228
|
**Examples:**
|
|
235
|
-
|
|
236
229
|
```bash
|
|
237
230
|
tigris presign my-bucket/file.txt
|
|
238
231
|
tigris presign t3://my-bucket/report.pdf --method put --expires-in 7200
|
|
@@ -248,15 +241,14 @@ Download multiple objects as a streaming tar archive in a single request. Design
|
|
|
248
241
|
tigris bundle <bucket> [flags]
|
|
249
242
|
```
|
|
250
243
|
|
|
251
|
-
| Flag
|
|
252
|
-
|
|
253
|
-
| `-k, --keys`
|
|
254
|
-
| `-o, --output`
|
|
255
|
-
| `--compression` | Compression algorithm for the archive. Auto-detected from output file extension when not specified
|
|
256
|
-
| `--on-error`
|
|
244
|
+
| Flag | Description |
|
|
245
|
+
|------|-------------|
|
|
246
|
+
| `-k, --keys` | Comma-separated object keys, or path to a file with one key per line. If a local file matching the value exists, it is read as a keys file. If omitted, reads keys from stdin |
|
|
247
|
+
| `-o, --output` | Output file path. Defaults to stdout (for piping) |
|
|
248
|
+
| `--compression` | Compression algorithm for the archive. Auto-detected from output file extension when not specified |
|
|
249
|
+
| `--on-error` | How to handle missing objects. 'skip' omits them, 'fail' aborts the request |
|
|
257
250
|
|
|
258
251
|
**Examples:**
|
|
259
|
-
|
|
260
252
|
```bash
|
|
261
253
|
tigris bundle my-bucket --keys key1.jpg,key2.jpg --output archive.tar
|
|
262
254
|
tigris bundle my-bucket --keys keys.txt --output archive.tar
|
|
@@ -270,10 +262,10 @@ cat keys.txt | tigris bundle my-bucket > archive.tar
|
|
|
270
262
|
|
|
271
263
|
Start a session via OAuth (default) or temporary credentials. Session state is cleared on logout
|
|
272
264
|
|
|
273
|
-
| Command
|
|
274
|
-
|
|
275
|
-
| `login select`
|
|
276
|
-
| `login oauth` (o)
|
|
265
|
+
| Command | Description |
|
|
266
|
+
|---------|-------------|
|
|
267
|
+
| `login select` | Choose how to login - OAuth (browser) or credentials (access key) |
|
|
268
|
+
| `login oauth` (o) | Login via browser using OAuth2 device flow. Best for interactive use |
|
|
277
269
|
| `login credentials` (c) | Login with an access key and secret. Creates a temporary session that is cleared on logout |
|
|
278
270
|
|
|
279
271
|
#### `login select`
|
|
@@ -289,7 +281,6 @@ tigris login oauth
|
|
|
289
281
|
```
|
|
290
282
|
|
|
291
283
|
**Examples:**
|
|
292
|
-
|
|
293
284
|
```bash
|
|
294
285
|
tigris login oauth
|
|
295
286
|
```
|
|
@@ -300,13 +291,12 @@ tigris login oauth
|
|
|
300
291
|
tigris login credentials [flags]
|
|
301
292
|
```
|
|
302
293
|
|
|
303
|
-
| Flag
|
|
304
|
-
|
|
305
|
-
| `-key, --access-key`
|
|
294
|
+
| Flag | Description |
|
|
295
|
+
|------|-------------|
|
|
296
|
+
| `-key, --access-key` | Your access key ID (will prompt if not provided) |
|
|
306
297
|
| `-secret, --access-secret` | Your secret access key (will prompt if not provided) |
|
|
307
298
|
|
|
308
299
|
**Examples:**
|
|
309
|
-
|
|
310
300
|
```bash
|
|
311
301
|
tigris login credentials --access-key tid_AaBb --access-secret tsec_XxYy
|
|
312
302
|
tigris login credentials
|
|
@@ -321,7 +311,6 @@ tigris logout
|
|
|
321
311
|
```
|
|
322
312
|
|
|
323
313
|
**Examples:**
|
|
324
|
-
|
|
325
314
|
```bash
|
|
326
315
|
tigris logout
|
|
327
316
|
```
|
|
@@ -335,7 +324,6 @@ tigris whoami
|
|
|
335
324
|
```
|
|
336
325
|
|
|
337
326
|
**Examples:**
|
|
338
|
-
|
|
339
327
|
```bash
|
|
340
328
|
tigris whoami
|
|
341
329
|
```
|
|
@@ -348,14 +336,13 @@ Save access-key credentials to ~/.tigris/config.json for persistent use across a
|
|
|
348
336
|
tigris configure [flags]
|
|
349
337
|
```
|
|
350
338
|
|
|
351
|
-
| Flag
|
|
352
|
-
|
|
353
|
-
| `-key, --access-key`
|
|
354
|
-
| `-secret, --access-secret` | Your Tigris secret access key
|
|
355
|
-
| `-e, --endpoint`
|
|
339
|
+
| Flag | Description |
|
|
340
|
+
|------|-------------|
|
|
341
|
+
| `-key, --access-key` | Your Tigris access key ID |
|
|
342
|
+
| `-secret, --access-secret` | Your Tigris secret access key |
|
|
343
|
+
| `-e, --endpoint` | Tigris API endpoint (default: https://t3.storage.dev) |
|
|
356
344
|
|
|
357
345
|
**Examples:**
|
|
358
|
-
|
|
359
346
|
```bash
|
|
360
347
|
tigris configure --access-key tid_AaBb --access-secret tsec_XxYy
|
|
361
348
|
tigris configure --endpoint https://custom.endpoint.dev
|
|
@@ -367,11 +354,11 @@ tigris configure --endpoint https://custom.endpoint.dev
|
|
|
367
354
|
|
|
368
355
|
List, create, and switch between organizations. An organization is a workspace that contains your resources like buckets and access keys
|
|
369
356
|
|
|
370
|
-
| Command
|
|
371
|
-
|
|
372
|
-
| `organizations list` (l)
|
|
373
|
-
| `organizations create` (c) | Create a new organization with the given name
|
|
374
|
-
| `organizations select` (s) | Set the named organization as your active org for all subsequent commands
|
|
357
|
+
| Command | Description |
|
|
358
|
+
|---------|-------------|
|
|
359
|
+
| `organizations list` (l) | List all organizations you belong to and interactively select one as active |
|
|
360
|
+
| `organizations create` (c) | Create a new organization with the given name |
|
|
361
|
+
| `organizations select` (s) | Set the named organization as your active org for all subsequent commands |
|
|
375
362
|
|
|
376
363
|
#### `organizations list`
|
|
377
364
|
|
|
@@ -379,13 +366,12 @@ List, create, and switch between organizations. An organization is a workspace t
|
|
|
379
366
|
tigris organizations list [flags]
|
|
380
367
|
```
|
|
381
368
|
|
|
382
|
-
| Flag
|
|
383
|
-
|
|
384
|
-
| `--format`
|
|
385
|
-
| `-i, --select` | Interactive selection mode
|
|
369
|
+
| Flag | Description |
|
|
370
|
+
|------|-------------|
|
|
371
|
+
| `--format` | Output format (default: select) |
|
|
372
|
+
| `-i, --select` | Interactive selection mode |
|
|
386
373
|
|
|
387
374
|
**Examples:**
|
|
388
|
-
|
|
389
375
|
```bash
|
|
390
376
|
tigris orgs list
|
|
391
377
|
tigris orgs list --format json
|
|
@@ -398,7 +384,6 @@ tigris organizations create <name>
|
|
|
398
384
|
```
|
|
399
385
|
|
|
400
386
|
**Examples:**
|
|
401
|
-
|
|
402
387
|
```bash
|
|
403
388
|
tigris orgs create my-org
|
|
404
389
|
```
|
|
@@ -410,7 +395,6 @@ tigris organizations select <name>
|
|
|
410
395
|
```
|
|
411
396
|
|
|
412
397
|
**Examples:**
|
|
413
|
-
|
|
414
398
|
```bash
|
|
415
399
|
tigris orgs select my-org
|
|
416
400
|
```
|
|
@@ -419,17 +403,17 @@ tigris orgs select my-org
|
|
|
419
403
|
|
|
420
404
|
Create, list, inspect, delete, and assign roles to access keys. Access keys are credentials used for programmatic API access
|
|
421
405
|
|
|
422
|
-
| Command
|
|
423
|
-
|
|
424
|
-
| `access-keys list` (l)
|
|
425
|
-
| `access-keys create` (c)
|
|
426
|
-
| `access-keys delete` (d)
|
|
427
|
-
| `access-keys get` (g)
|
|
428
|
-
| `access-keys assign` (a)
|
|
429
|
-
| `access-keys rotate` (r)
|
|
430
|
-
| `access-keys attach-policy` (ap) | Attach an IAM policy to an access key. If no policy ARN is provided, shows interactive selection of available policies
|
|
431
|
-
| `access-keys detach-policy` (dp) | Detach an IAM policy from an access key. If no policy ARN is provided, shows interactive selection of attached policies
|
|
432
|
-
| `access-keys list-policies` (lp) | List all IAM policies attached to an access key
|
|
406
|
+
| Command | Description |
|
|
407
|
+
|---------|-------------|
|
|
408
|
+
| `access-keys list` (l) | List all access keys in the current organization |
|
|
409
|
+
| `access-keys create` (c) | Create a new access key with the given name. Returns the key ID and secret (shown only once) |
|
|
410
|
+
| `access-keys delete` (d) | Permanently delete an access key by its ID. This revokes all access immediately |
|
|
411
|
+
| `access-keys get` (g) | Show details for an access key including its name, creation date, and assigned bucket roles |
|
|
412
|
+
| `access-keys assign` (a) | Assign per-bucket roles to an access key. Pair each --bucket with a --role (Editor or ReadOnly), or use --admin for org-wide access |
|
|
413
|
+
| `access-keys rotate` (r) | Rotate an access key's secret. The current secret is immediately invalidated and a new one is returned (shown only once) |
|
|
414
|
+
| `access-keys attach-policy` (ap) | Attach an IAM policy to an access key. If no policy ARN is provided, shows interactive selection of available policies |
|
|
415
|
+
| `access-keys detach-policy` (dp) | Detach an IAM policy from an access key. If no policy ARN is provided, shows interactive selection of attached policies |
|
|
416
|
+
| `access-keys list-policies` (lp) | List all IAM policies attached to an access key |
|
|
433
417
|
|
|
434
418
|
#### `access-keys list`
|
|
435
419
|
|
|
@@ -437,14 +421,13 @@ Create, list, inspect, delete, and assign roles to access keys. Access keys are
|
|
|
437
421
|
tigris access-keys list [flags]
|
|
438
422
|
```
|
|
439
423
|
|
|
440
|
-
| Flag
|
|
441
|
-
|
|
442
|
-
| `--format`
|
|
443
|
-
| `--limit`
|
|
424
|
+
| Flag | Description |
|
|
425
|
+
|------|-------------|
|
|
426
|
+
| `--format` | Output format (default: table) |
|
|
427
|
+
| `--limit` | Maximum number of items to return per page |
|
|
444
428
|
| `-pt, --page-token` | Pagination token from a previous request to fetch the next page |
|
|
445
429
|
|
|
446
430
|
**Examples:**
|
|
447
|
-
|
|
448
431
|
```bash
|
|
449
432
|
tigris access-keys list
|
|
450
433
|
```
|
|
@@ -456,7 +439,6 @@ tigris access-keys create <name>
|
|
|
456
439
|
```
|
|
457
440
|
|
|
458
441
|
**Examples:**
|
|
459
|
-
|
|
460
442
|
```bash
|
|
461
443
|
tigris access-keys create my-ci-key
|
|
462
444
|
```
|
|
@@ -467,12 +449,11 @@ tigris access-keys create my-ci-key
|
|
|
467
449
|
tigris access-keys delete <id> [flags]
|
|
468
450
|
```
|
|
469
451
|
|
|
470
|
-
| Flag
|
|
471
|
-
|
|
452
|
+
| Flag | Description |
|
|
453
|
+
|------|-------------|
|
|
472
454
|
| `--force` | Skip confirmation prompts (alias for --yes) |
|
|
473
455
|
|
|
474
456
|
**Examples:**
|
|
475
|
-
|
|
476
457
|
```bash
|
|
477
458
|
tigris access-keys delete tid_AaBbCcDdEeFf --yes
|
|
478
459
|
```
|
|
@@ -484,7 +465,6 @@ tigris access-keys get <id>
|
|
|
484
465
|
```
|
|
485
466
|
|
|
486
467
|
**Examples:**
|
|
487
|
-
|
|
488
468
|
```bash
|
|
489
469
|
tigris access-keys get tid_AaBbCcDdEeFf
|
|
490
470
|
```
|
|
@@ -495,15 +475,14 @@ tigris access-keys get tid_AaBbCcDdEeFf
|
|
|
495
475
|
tigris access-keys assign <id> [flags]
|
|
496
476
|
```
|
|
497
477
|
|
|
498
|
-
| Flag
|
|
499
|
-
|
|
500
|
-
| `-b, --bucket`
|
|
501
|
-
| `-r, --role`
|
|
502
|
-
| `--admin`
|
|
503
|
-
| `--revoke-roles` | Revoke all bucket roles from the access key
|
|
478
|
+
| Flag | Description |
|
|
479
|
+
|------|-------------|
|
|
480
|
+
| `-b, --bucket` | Bucket name (can specify multiple, comma-separated). Each bucket is paired positionally with a --role value |
|
|
481
|
+
| `-r, --role` | Role to assign (can specify multiple, comma-separated). Each role pairs with the corresponding --bucket value |
|
|
482
|
+
| `--admin` | Grant admin access to all buckets in the organization |
|
|
483
|
+
| `--revoke-roles` | Revoke all bucket roles from the access key |
|
|
504
484
|
|
|
505
485
|
**Examples:**
|
|
506
|
-
|
|
507
486
|
```bash
|
|
508
487
|
tigris access-keys assign tid_AaBb --bucket my-bucket --role Editor
|
|
509
488
|
tigris access-keys assign tid_AaBb --bucket a,b --role Editor,ReadOnly
|
|
@@ -517,12 +496,11 @@ tigris access-keys assign tid_AaBb --revoke-roles
|
|
|
517
496
|
tigris access-keys rotate <id> [flags]
|
|
518
497
|
```
|
|
519
498
|
|
|
520
|
-
| Flag
|
|
521
|
-
|
|
499
|
+
| Flag | Description |
|
|
500
|
+
|------|-------------|
|
|
522
501
|
| `--force` | Skip confirmation prompts (alias for --yes) |
|
|
523
502
|
|
|
524
503
|
**Examples:**
|
|
525
|
-
|
|
526
504
|
```bash
|
|
527
505
|
tigris access-keys rotate tid_AaBbCcDdEeFf --yes
|
|
528
506
|
```
|
|
@@ -533,12 +511,11 @@ tigris access-keys rotate tid_AaBbCcDdEeFf --yes
|
|
|
533
511
|
tigris access-keys attach-policy <id> [flags]
|
|
534
512
|
```
|
|
535
513
|
|
|
536
|
-
| Flag
|
|
537
|
-
|
|
514
|
+
| Flag | Description |
|
|
515
|
+
|------|-------------|
|
|
538
516
|
| `--policy-arn` | ARN of the policy to attach |
|
|
539
517
|
|
|
540
518
|
**Examples:**
|
|
541
|
-
|
|
542
519
|
```bash
|
|
543
520
|
tigris access-keys attach-policy tid_AaBb --policy-arn arn:aws:iam::org_id:policy/my-policy
|
|
544
521
|
tigris access-keys attach-policy tid_AaBb
|
|
@@ -550,13 +527,12 @@ tigris access-keys attach-policy tid_AaBb
|
|
|
550
527
|
tigris access-keys detach-policy <id> [flags]
|
|
551
528
|
```
|
|
552
529
|
|
|
553
|
-
| Flag
|
|
554
|
-
|
|
555
|
-
| `--policy-arn` | ARN of the policy to detach
|
|
556
|
-
| `--force`
|
|
530
|
+
| Flag | Description |
|
|
531
|
+
|------|-------------|
|
|
532
|
+
| `--policy-arn` | ARN of the policy to detach |
|
|
533
|
+
| `--force` | Skip confirmation prompts (alias for --yes) |
|
|
557
534
|
|
|
558
535
|
**Examples:**
|
|
559
|
-
|
|
560
536
|
```bash
|
|
561
537
|
tigris access-keys detach-policy tid_AaBb --policy-arn arn:aws:iam::org_id:policy/my-policy --yes
|
|
562
538
|
tigris access-keys detach-policy tid_AaBb
|
|
@@ -568,14 +544,13 @@ tigris access-keys detach-policy tid_AaBb
|
|
|
568
544
|
tigris access-keys list-policies <id> [flags]
|
|
569
545
|
```
|
|
570
546
|
|
|
571
|
-
| Flag
|
|
572
|
-
|
|
573
|
-
| `--format`
|
|
574
|
-
| `--limit`
|
|
547
|
+
| Flag | Description |
|
|
548
|
+
|------|-------------|
|
|
549
|
+
| `--format` | Output format (default: table) |
|
|
550
|
+
| `--limit` | Maximum number of items to return per page |
|
|
575
551
|
| `-pt, --page-token` | Pagination token from a previous request to fetch the next page |
|
|
576
552
|
|
|
577
553
|
**Examples:**
|
|
578
|
-
|
|
579
554
|
```bash
|
|
580
555
|
tigris access-keys list-policies tid_AaBbCcDdEeFf
|
|
581
556
|
```
|
|
@@ -584,8 +559,8 @@ tigris access-keys list-policies tid_AaBbCcDdEeFf
|
|
|
584
559
|
|
|
585
560
|
Test whether your current credentials can reach Tigris and optionally verify access to a specific bucket
|
|
586
561
|
|
|
587
|
-
| Command
|
|
588
|
-
|
|
562
|
+
| Command | Description |
|
|
563
|
+
|---------|-------------|
|
|
589
564
|
| `credentials test` (t) | Verify that current credentials are valid. Optionally checks access to a specific bucket |
|
|
590
565
|
|
|
591
566
|
#### `credentials test`
|
|
@@ -594,12 +569,11 @@ Test whether your current credentials can reach Tigris and optionally verify acc
|
|
|
594
569
|
tigris credentials test [flags]
|
|
595
570
|
```
|
|
596
571
|
|
|
597
|
-
| Flag
|
|
598
|
-
|
|
572
|
+
| Flag | Description |
|
|
573
|
+
|------|-------------|
|
|
599
574
|
| `-b, --bucket` | Bucket name to test access against (optional) |
|
|
600
575
|
|
|
601
576
|
**Examples:**
|
|
602
|
-
|
|
603
577
|
```bash
|
|
604
578
|
tigris credentials test
|
|
605
579
|
tigris credentials test --bucket my-bucket
|
|
@@ -613,19 +587,20 @@ Buckets are containers for objects. You can also create forks and snapshots of b
|
|
|
613
587
|
|
|
614
588
|
Create, inspect, update, and delete buckets. Buckets are top-level containers that hold objects
|
|
615
589
|
|
|
616
|
-
| Command
|
|
617
|
-
|
|
618
|
-
| `buckets list` (l)
|
|
619
|
-
| `buckets create` (c)
|
|
620
|
-
| `buckets get` (g)
|
|
621
|
-
| `buckets delete` (d)
|
|
622
|
-
| `buckets set` (s)
|
|
623
|
-
| `buckets set-ttl`
|
|
624
|
-
| `buckets set-locations`
|
|
625
|
-
| `buckets set-migration`
|
|
626
|
-
| `buckets
|
|
627
|
-
| `buckets set-
|
|
628
|
-
| `buckets set-
|
|
590
|
+
| Command | Description |
|
|
591
|
+
|---------|-------------|
|
|
592
|
+
| `buckets list` (l) | List all buckets in the current organization |
|
|
593
|
+
| `buckets create` (c) | Create a new bucket with optional access, tier, and location settings |
|
|
594
|
+
| `buckets get` (g) | Show details for a bucket including access level, region, tier, and custom domain |
|
|
595
|
+
| `buckets delete` (d) | Delete one or more buckets by name. The bucket must be empty or delete-protection must be off |
|
|
596
|
+
| `buckets set` (s) | Update settings on an existing bucket such as access level, location, caching, or custom domain |
|
|
597
|
+
| `buckets set-ttl` | Configure object expiration (TTL) on a bucket. Objects expire after a number of days or on a specific date |
|
|
598
|
+
| `buckets set-locations` | Set the data locations for a bucket |
|
|
599
|
+
| `buckets set-migration` | Configure data migration from an external S3-compatible source bucket. Tigris will pull objects on demand from the source |
|
|
600
|
+
| `buckets migrate` | Actively migrate all objects from a shadow bucket to Tigris by scheduling server-side migration for unmigrated objects |
|
|
601
|
+
| `buckets set-transition` | Configure a lifecycle transition rule on a bucket. Automatically move objects to a different storage class after a number of days or on a specific date |
|
|
602
|
+
| `buckets set-notifications` | Configure object event notifications on a bucket. Sends webhook requests to a URL when objects are created, updated, or deleted |
|
|
603
|
+
| `buckets set-cors` | Configure CORS rules on a bucket. Each invocation adds a rule unless --override or --reset is used |
|
|
629
604
|
|
|
630
605
|
##### `buckets list`
|
|
631
606
|
|
|
@@ -633,15 +608,14 @@ Create, inspect, update, and delete buckets. Buckets are top-level containers th
|
|
|
633
608
|
tigris buckets list [flags]
|
|
634
609
|
```
|
|
635
610
|
|
|
636
|
-
| Flag
|
|
637
|
-
|
|
638
|
-
| `--format`
|
|
639
|
-
| `--forks-of`
|
|
640
|
-
| `--limit`
|
|
611
|
+
| Flag | Description |
|
|
612
|
+
|------|-------------|
|
|
613
|
+
| `--format` | Output format (default: table) |
|
|
614
|
+
| `--forks-of` | Only list buckets that are forks of the named source bucket |
|
|
615
|
+
| `--limit` | Maximum number of items to return per page |
|
|
641
616
|
| `-pt, --page-token` | Pagination token from a previous request to fetch the next page |
|
|
642
617
|
|
|
643
618
|
**Examples:**
|
|
644
|
-
|
|
645
619
|
```bash
|
|
646
620
|
tigris buckets list
|
|
647
621
|
tigris buckets list --format json
|
|
@@ -654,20 +628,19 @@ tigris buckets list --forks-of my-bucket
|
|
|
654
628
|
tigris buckets create [name] [flags]
|
|
655
629
|
```
|
|
656
630
|
|
|
657
|
-
| Flag
|
|
658
|
-
|
|
659
|
-
| `-a, --access`
|
|
660
|
-
| `--public`
|
|
661
|
-
| `-s, --enable-snapshots`
|
|
662
|
-
| `-t, --default-tier`
|
|
663
|
-
| `-c, --consistency`
|
|
664
|
-
| `-r, --region`
|
|
665
|
-
| `-l, --locations`
|
|
666
|
-
| `-fork, --fork-of`
|
|
631
|
+
| Flag | Description |
|
|
632
|
+
|------|-------------|
|
|
633
|
+
| `-a, --access` | Access level (default: private) |
|
|
634
|
+
| `--public` | Shorthand for --access public |
|
|
635
|
+
| `-s, --enable-snapshots` | Enable snapshots for the bucket (default: false) |
|
|
636
|
+
| `-t, --default-tier` | Choose the default tier for the bucket (default: STANDARD) |
|
|
637
|
+
| `-c, --consistency` | (Deprecated, use --locations) Choose the consistency level for the bucket |
|
|
638
|
+
| `-r, --region` | (Deprecated, use --locations) Region |
|
|
639
|
+
| `-l, --locations` | Location for the bucket (default: global) |
|
|
640
|
+
| `-fork, --fork-of` | Create this bucket as a fork (copy-on-write clone) of the named source bucket |
|
|
667
641
|
| `-source-snap, --source-snapshot` | Fork from a specific snapshot of the source bucket. Accepts a snapshot version string or any UNIX nanosecond-precision timestamp (e.g. 1765889000501544464). Requires --fork-of |
|
|
668
642
|
|
|
669
643
|
**Examples:**
|
|
670
|
-
|
|
671
644
|
```bash
|
|
672
645
|
tigris buckets create my-bucket
|
|
673
646
|
tigris buckets create my-bucket --access public --locations iad
|
|
@@ -682,12 +655,11 @@ tigris buckets create my-fork --fork-of my-bucket --source-snapshot 176588900050
|
|
|
682
655
|
tigris buckets get <name> [flags]
|
|
683
656
|
```
|
|
684
657
|
|
|
685
|
-
| Flag
|
|
686
|
-
|
|
658
|
+
| Flag | Description |
|
|
659
|
+
|------|-------------|
|
|
687
660
|
| `--format` | Output format (default: table) |
|
|
688
661
|
|
|
689
662
|
**Examples:**
|
|
690
|
-
|
|
691
663
|
```bash
|
|
692
664
|
tigris buckets get my-bucket
|
|
693
665
|
```
|
|
@@ -698,12 +670,11 @@ tigris buckets get my-bucket
|
|
|
698
670
|
tigris buckets delete <name> [flags]
|
|
699
671
|
```
|
|
700
672
|
|
|
701
|
-
| Flag
|
|
702
|
-
|
|
673
|
+
| Flag | Description |
|
|
674
|
+
|------|-------------|
|
|
703
675
|
| `--force` | Skip confirmation prompts (alias for --yes) |
|
|
704
676
|
|
|
705
677
|
**Examples:**
|
|
706
|
-
|
|
707
678
|
```bash
|
|
708
679
|
tigris buckets delete my-bucket --yes
|
|
709
680
|
tigris buckets delete bucket-a,bucket-b --yes
|
|
@@ -715,20 +686,19 @@ tigris buckets delete bucket-a,bucket-b --yes
|
|
|
715
686
|
tigris buckets set <name> [flags]
|
|
716
687
|
```
|
|
717
688
|
|
|
718
|
-
| Flag
|
|
719
|
-
|
|
720
|
-
| `--access`
|
|
721
|
-
| `--region`
|
|
722
|
-
| `--locations`
|
|
723
|
-
| `--allow-object-acl`
|
|
724
|
-
| `--disable-directory-listing` | Disable directory listing
|
|
725
|
-
| `--cache-control`
|
|
726
|
-
| `--custom-domain`
|
|
727
|
-
| `--enable-delete-protection`
|
|
728
|
-
| `--enable-additional-headers` | Enable additional HTTP headers (X-Content-Type-Options nosniff)
|
|
689
|
+
| Flag | Description |
|
|
690
|
+
|------|-------------|
|
|
691
|
+
| `--access` | Bucket access level |
|
|
692
|
+
| `--region` | (Deprecated, use --locations) Allowed regions (can specify multiple) |
|
|
693
|
+
| `--locations` | Bucket location (see https://www.tigrisdata.com/docs/buckets/locations/ for more details) |
|
|
694
|
+
| `--allow-object-acl` | Enable object-level ACL |
|
|
695
|
+
| `--disable-directory-listing` | Disable directory listing |
|
|
696
|
+
| `--cache-control` | Default cache-control header value |
|
|
697
|
+
| `--custom-domain` | Custom domain for the bucket |
|
|
698
|
+
| `--enable-delete-protection` | Enable delete protection |
|
|
699
|
+
| `--enable-additional-headers` | Enable additional HTTP headers (X-Content-Type-Options nosniff) |
|
|
729
700
|
|
|
730
701
|
**Examples:**
|
|
731
|
-
|
|
732
702
|
```bash
|
|
733
703
|
tigris buckets set my-bucket --access public
|
|
734
704
|
tigris buckets set my-bucket --locations iad,fra --cache-control 'max-age=3600'
|
|
@@ -741,15 +711,14 @@ tigris buckets set my-bucket --custom-domain assets.example.com
|
|
|
741
711
|
tigris buckets set-ttl <name> [flags]
|
|
742
712
|
```
|
|
743
713
|
|
|
744
|
-
| Flag
|
|
745
|
-
|
|
746
|
-
| `-d, --days` | Expire objects after this many days
|
|
747
|
-
| `--date`
|
|
748
|
-
| `--enable`
|
|
749
|
-
| `--disable`
|
|
714
|
+
| Flag | Description |
|
|
715
|
+
|------|-------------|
|
|
716
|
+
| `-d, --days` | Expire objects after this many days |
|
|
717
|
+
| `--date` | Expire objects on this date (ISO-8601, e.g. 2026-06-01) |
|
|
718
|
+
| `--enable` | Enable TTL on the bucket (uses existing lifecycle rules) |
|
|
719
|
+
| `--disable` | Disable TTL on the bucket |
|
|
750
720
|
|
|
751
721
|
**Examples:**
|
|
752
|
-
|
|
753
722
|
```bash
|
|
754
723
|
tigris buckets set-ttl my-bucket --days 30
|
|
755
724
|
tigris buckets set-ttl my-bucket --date 2026-06-01
|
|
@@ -762,12 +731,11 @@ tigris buckets set-ttl my-bucket --disable
|
|
|
762
731
|
tigris buckets set-locations <name> [flags]
|
|
763
732
|
```
|
|
764
733
|
|
|
765
|
-
| Flag
|
|
766
|
-
|
|
734
|
+
| Flag | Description |
|
|
735
|
+
|------|-------------|
|
|
767
736
|
| `-l, --locations` | Bucket location |
|
|
768
737
|
|
|
769
738
|
**Examples:**
|
|
770
|
-
|
|
771
739
|
```bash
|
|
772
740
|
tigris buckets set-locations my-bucket --locations iad
|
|
773
741
|
tigris buckets set-locations my-bucket --locations iad,fra
|
|
@@ -780,40 +748,51 @@ tigris buckets set-locations my-bucket --locations global
|
|
|
780
748
|
tigris buckets set-migration <name> [flags]
|
|
781
749
|
```
|
|
782
750
|
|
|
783
|
-
| Flag
|
|
784
|
-
|
|
785
|
-
| `-b, --bucket`
|
|
786
|
-
| `-e, --endpoint`
|
|
787
|
-
| `-r, --region`
|
|
788
|
-
| `-key, --access-key`
|
|
789
|
-
| `-secret, --secret-key` | Secret key for the source bucket
|
|
790
|
-
| `--write-through`
|
|
791
|
-
| `--disable`
|
|
751
|
+
| Flag | Description |
|
|
752
|
+
|------|-------------|
|
|
753
|
+
| `-b, --bucket` | Name of the source bucket to migrate from |
|
|
754
|
+
| `-e, --endpoint` | Endpoint URL of the source S3-compatible service |
|
|
755
|
+
| `-r, --region` | Region of the source bucket |
|
|
756
|
+
| `-key, --access-key` | Access key for the source bucket |
|
|
757
|
+
| `-secret, --secret-key` | Secret key for the source bucket |
|
|
758
|
+
| `--write-through` | Enable write-through mode (writes go to both source and Tigris) |
|
|
759
|
+
| `--disable` | Disable migration and clear all migration settings |
|
|
792
760
|
|
|
793
761
|
**Examples:**
|
|
794
|
-
|
|
795
762
|
```bash
|
|
796
763
|
tigris buckets set-migration my-bucket --bucket source-bucket --endpoint https://s3.amazonaws.com --region us-east-1 --access-key AKIA... --secret-key wJal...
|
|
797
764
|
tigris buckets set-migration my-bucket --bucket source-bucket --endpoint https://s3.amazonaws.com --region us-east-1 --access-key AKIA... --secret-key wJal... --write-through
|
|
798
765
|
tigris buckets set-migration my-bucket --disable
|
|
799
766
|
```
|
|
800
767
|
|
|
768
|
+
##### `buckets migrate`
|
|
769
|
+
|
|
770
|
+
```
|
|
771
|
+
tigris buckets migrate <path>
|
|
772
|
+
```
|
|
773
|
+
|
|
774
|
+
**Examples:**
|
|
775
|
+
```bash
|
|
776
|
+
tigris buckets migrate my-bucket
|
|
777
|
+
tigris buckets migrate my-bucket/images/
|
|
778
|
+
tigris buckets migrate t3://my-bucket/prefix/
|
|
779
|
+
```
|
|
780
|
+
|
|
801
781
|
##### `buckets set-transition`
|
|
802
782
|
|
|
803
783
|
```
|
|
804
784
|
tigris buckets set-transition <name> [flags]
|
|
805
785
|
```
|
|
806
786
|
|
|
807
|
-
| Flag
|
|
808
|
-
|
|
809
|
-
| `-s, --storage-class` | Target storage class to transition objects to
|
|
810
|
-
| `-d, --days`
|
|
811
|
-
| `--date`
|
|
812
|
-
| `--enable`
|
|
813
|
-
| `--disable`
|
|
787
|
+
| Flag | Description |
|
|
788
|
+
|------|-------------|
|
|
789
|
+
| `-s, --storage-class` | Target storage class to transition objects to |
|
|
790
|
+
| `-d, --days` | Transition objects after this many days |
|
|
791
|
+
| `--date` | Transition objects on this date (ISO-8601, e.g. 2026-06-01) |
|
|
792
|
+
| `--enable` | Enable lifecycle transition rules on the bucket |
|
|
793
|
+
| `--disable` | Disable lifecycle transition rules on the bucket |
|
|
814
794
|
|
|
815
795
|
**Examples:**
|
|
816
|
-
|
|
817
796
|
```bash
|
|
818
797
|
tigris buckets set-transition my-bucket --storage-class STANDARD_IA --days 30
|
|
819
798
|
tigris buckets set-transition my-bucket --storage-class GLACIER --date 2026-06-01
|
|
@@ -827,19 +806,18 @@ tigris buckets set-transition my-bucket --disable
|
|
|
827
806
|
tigris buckets set-notifications <name> [flags]
|
|
828
807
|
```
|
|
829
808
|
|
|
830
|
-
| Flag
|
|
831
|
-
|
|
832
|
-
| `-u, --url`
|
|
809
|
+
| Flag | Description |
|
|
810
|
+
|------|-------------|
|
|
811
|
+
| `-u, --url` | Webhook URL to send notifications to (must be http or https) |
|
|
833
812
|
| `-f, --filter` | SQL WHERE clause to filter events by key (e.g. WHERE `key` REGEXP "^images") |
|
|
834
|
-
| `-t, --token`
|
|
835
|
-
| `--username`
|
|
836
|
-
| `--password`
|
|
837
|
-
| `--enable`
|
|
838
|
-
| `--disable`
|
|
839
|
-
| `--reset`
|
|
813
|
+
| `-t, --token` | Token for webhook authentication |
|
|
814
|
+
| `--username` | Username for basic webhook authentication |
|
|
815
|
+
| `--password` | Password for basic webhook authentication |
|
|
816
|
+
| `--enable` | Enable notifications on the bucket (uses existing config) |
|
|
817
|
+
| `--disable` | Disable notifications on the bucket (preserves existing config) |
|
|
818
|
+
| `--reset` | Clear all notification settings on the bucket |
|
|
840
819
|
|
|
841
820
|
**Examples:**
|
|
842
|
-
|
|
843
821
|
```bash
|
|
844
822
|
tigris buckets set-notifications my-bucket --url https://example.com/webhook
|
|
845
823
|
tigris buckets set-notifications my-bucket --url https://example.com/webhook --token secret123
|
|
@@ -856,18 +834,17 @@ tigris buckets set-notifications my-bucket --reset
|
|
|
856
834
|
tigris buckets set-cors <name> [flags]
|
|
857
835
|
```
|
|
858
836
|
|
|
859
|
-
| Flag
|
|
860
|
-
|
|
861
|
-
| `-o, --origins`
|
|
862
|
-
| `-m, --methods`
|
|
863
|
-
| `--headers`
|
|
864
|
-
| `--expose-headers` | Response headers to expose (comma-separated)
|
|
865
|
-
| `--max-age`
|
|
866
|
-
| `--override`
|
|
867
|
-
| `--reset`
|
|
837
|
+
| Flag | Description |
|
|
838
|
+
|------|-------------|
|
|
839
|
+
| `-o, --origins` | Allowed origins (comma-separated, or '*' for all) |
|
|
840
|
+
| `-m, --methods` | Allowed HTTP methods (comma-separated, e.g. GET,POST,PUT) |
|
|
841
|
+
| `--headers` | Allowed request headers (comma-separated, or '*' for all) |
|
|
842
|
+
| `--expose-headers` | Response headers to expose (comma-separated) |
|
|
843
|
+
| `--max-age` | Preflight cache duration in seconds (default: 3600) |
|
|
844
|
+
| `--override` | Replace all existing CORS rules instead of appending |
|
|
845
|
+
| `--reset` | Clear all CORS rules on the bucket |
|
|
868
846
|
|
|
869
847
|
**Examples:**
|
|
870
|
-
|
|
871
848
|
```bash
|
|
872
849
|
tigris buckets set-cors my-bucket --origins '*' --methods GET,HEAD
|
|
873
850
|
tigris buckets set-cors my-bucket --origins https://example.com --methods GET,POST --headers Content-Type,Authorization --max-age 3600
|
|
@@ -879,9 +856,9 @@ tigris buckets set-cors my-bucket --reset
|
|
|
879
856
|
|
|
880
857
|
(Deprecated, use "buckets create --fork-of" and "buckets list --forks-of") List and create forks
|
|
881
858
|
|
|
882
|
-
| Command
|
|
883
|
-
|
|
884
|
-
| `forks list` (l)
|
|
859
|
+
| Command | Description |
|
|
860
|
+
|---------|-------------|
|
|
861
|
+
| `forks list` (l) | (Deprecated, use "buckets list --forks-of") List all forks created from the given source bucket |
|
|
885
862
|
| `forks create` (c) | (Deprecated, use "buckets create --fork-of") Create a new fork (copy-on-write clone) of the source bucket |
|
|
886
863
|
|
|
887
864
|
##### `forks list`
|
|
@@ -890,12 +867,11 @@ tigris buckets set-cors my-bucket --reset
|
|
|
890
867
|
tigris forks list <name> [flags]
|
|
891
868
|
```
|
|
892
869
|
|
|
893
|
-
| Flag
|
|
894
|
-
|
|
870
|
+
| Flag | Description |
|
|
871
|
+
|------|-------------|
|
|
895
872
|
| `--format` | Output format (default: table) |
|
|
896
873
|
|
|
897
874
|
**Examples:**
|
|
898
|
-
|
|
899
875
|
```bash
|
|
900
876
|
tigris forks list my-bucket
|
|
901
877
|
tigris forks list my-bucket --format json
|
|
@@ -907,12 +883,11 @@ tigris forks list my-bucket --format json
|
|
|
907
883
|
tigris forks create <name> <fork-name> [flags]
|
|
908
884
|
```
|
|
909
885
|
|
|
910
|
-
| Flag
|
|
911
|
-
|
|
886
|
+
| Flag | Description |
|
|
887
|
+
|------|-------------|
|
|
912
888
|
| `-s, --snapshot` | Create fork from a specific snapshot. Accepts a snapshot version string or any UNIX nanosecond-precision timestamp (e.g. 1765889000501544464) |
|
|
913
889
|
|
|
914
890
|
**Examples:**
|
|
915
|
-
|
|
916
891
|
```bash
|
|
917
892
|
tigris forks create my-bucket my-fork
|
|
918
893
|
tigris forks create my-bucket my-fork --snapshot 1765889000501544464
|
|
@@ -922,9 +897,9 @@ tigris forks create my-bucket my-fork --snapshot 1765889000501544464
|
|
|
922
897
|
|
|
923
898
|
List and take snapshots. A snapshot is a point-in-time, read-only copy of a bucket's state
|
|
924
899
|
|
|
925
|
-
| Command
|
|
926
|
-
|
|
927
|
-
| `snapshots list` (l) | List all snapshots for the given bucket, ordered by creation time
|
|
900
|
+
| Command | Description |
|
|
901
|
+
|---------|-------------|
|
|
902
|
+
| `snapshots list` (l) | List all snapshots for the given bucket, ordered by creation time |
|
|
928
903
|
| `snapshots take` (t) | Take a new snapshot of the bucket's current state. Optionally provide a name for the snapshot |
|
|
929
904
|
|
|
930
905
|
##### `snapshots list`
|
|
@@ -933,14 +908,13 @@ List and take snapshots. A snapshot is a point-in-time, read-only copy of a buck
|
|
|
933
908
|
tigris snapshots list <name> [flags]
|
|
934
909
|
```
|
|
935
910
|
|
|
936
|
-
| Flag
|
|
937
|
-
|
|
938
|
-
| `--format`
|
|
939
|
-
| `--limit`
|
|
911
|
+
| Flag | Description |
|
|
912
|
+
|------|-------------|
|
|
913
|
+
| `--format` | Output format (default: table) |
|
|
914
|
+
| `--limit` | Maximum number of items to return per page |
|
|
940
915
|
| `-pt, --page-token` | Pagination token from a previous request to fetch the next page |
|
|
941
916
|
|
|
942
917
|
**Examples:**
|
|
943
|
-
|
|
944
918
|
```bash
|
|
945
919
|
tigris snapshots list my-bucket
|
|
946
920
|
tigris snapshots list my-bucket --format json
|
|
@@ -953,7 +927,6 @@ tigris snapshots take <name> [snapshot-name]
|
|
|
953
927
|
```
|
|
954
928
|
|
|
955
929
|
**Examples:**
|
|
956
|
-
|
|
957
930
|
```bash
|
|
958
931
|
tigris snapshots take my-bucket
|
|
959
932
|
tigris snapshots take my-bucket my-snapshot
|
|
@@ -963,14 +936,14 @@ tigris snapshots take my-bucket my-snapshot
|
|
|
963
936
|
|
|
964
937
|
Low-level object operations for listing, downloading, uploading, and deleting individual objects in a bucket
|
|
965
938
|
|
|
966
|
-
| Command
|
|
967
|
-
|
|
968
|
-
| `objects list` (l)
|
|
969
|
-
| `objects get` (g)
|
|
970
|
-
| `objects put` (p)
|
|
971
|
-
| `objects delete` (d) | Delete one or more objects by key from the given bucket
|
|
972
|
-
| `objects set` (s)
|
|
973
|
-
| `objects info` (i)
|
|
939
|
+
| Command | Description |
|
|
940
|
+
|---------|-------------|
|
|
941
|
+
| `objects list` (l) | List objects in a bucket, optionally filtered by a key prefix |
|
|
942
|
+
| `objects get` (g) | Download an object by key. Prints to stdout by default, or saves to a file with --output |
|
|
943
|
+
| `objects put` (p) | Upload a local file as an object. Content-type is auto-detected from extension unless overridden |
|
|
944
|
+
| `objects delete` (d) | Delete one or more objects by key from the given bucket |
|
|
945
|
+
| `objects set` (s) | Update settings on an existing object such as access level |
|
|
946
|
+
| `objects info` (i) | Show metadata for an object (content type, size, modified date) |
|
|
974
947
|
|
|
975
948
|
#### `objects list`
|
|
976
949
|
|
|
@@ -978,16 +951,16 @@ Low-level object operations for listing, downloading, uploading, and deleting in
|
|
|
978
951
|
tigris objects list <bucket> [flags]
|
|
979
952
|
```
|
|
980
953
|
|
|
981
|
-
| Flag
|
|
982
|
-
|
|
983
|
-
| `-p, --prefix`
|
|
984
|
-
| `--format`
|
|
954
|
+
| Flag | Description |
|
|
955
|
+
|------|-------------|
|
|
956
|
+
| `-p, --prefix` | Filter objects by key prefix (e.g. "images/" to list only images) |
|
|
957
|
+
| `--format` | Output format (default: table) |
|
|
985
958
|
| `-snapshot, --snapshot-version` | Read from a specific bucket snapshot. Accepts a snapshot version string or any UNIX nanosecond-precision timestamp (e.g. 1765889000501544464) |
|
|
986
|
-
| `--limit`
|
|
987
|
-
| `-pt, --page-token`
|
|
959
|
+
| `--limit` | Maximum number of items to return per page |
|
|
960
|
+
| `-pt, --page-token` | Pagination token from a previous request to fetch the next page |
|
|
961
|
+
| `--source` | List objects from a specific storage source on buckets with shadow migration enabled |
|
|
988
962
|
|
|
989
963
|
**Examples:**
|
|
990
|
-
|
|
991
964
|
```bash
|
|
992
965
|
tigris objects list my-bucket
|
|
993
966
|
tigris objects list t3://my-bucket
|
|
@@ -1002,14 +975,13 @@ tigris objects list my-bucket --format json
|
|
|
1002
975
|
tigris objects get <bucket> [key] [flags]
|
|
1003
976
|
```
|
|
1004
977
|
|
|
1005
|
-
| Flag
|
|
1006
|
-
|
|
1007
|
-
| `-o, --output`
|
|
1008
|
-
| `-m, --mode`
|
|
978
|
+
| Flag | Description |
|
|
979
|
+
|------|-------------|
|
|
980
|
+
| `-o, --output` | Output file path (if not specified, prints to stdout) |
|
|
981
|
+
| `-m, --mode` | Response mode: "string" loads into memory, "stream" writes in chunks (auto-detected from extension if not specified) |
|
|
1009
982
|
| `-snapshot, --snapshot-version` | Read from a specific bucket snapshot. Accepts a snapshot version string or any UNIX nanosecond-precision timestamp (e.g. 1765889000501544464) |
|
|
1010
983
|
|
|
1011
984
|
**Examples:**
|
|
1012
|
-
|
|
1013
985
|
```bash
|
|
1014
986
|
tigris objects get my-bucket config.json
|
|
1015
987
|
tigris objects get t3://my-bucket/config.json
|
|
@@ -1022,14 +994,13 @@ tigris objects get my-bucket archive.zip --output ./archive.zip --mode stream
|
|
|
1022
994
|
tigris objects put <bucket> [key] [file] [flags]
|
|
1023
995
|
```
|
|
1024
996
|
|
|
1025
|
-
| Flag
|
|
1026
|
-
|
|
1027
|
-
| `-a, --access`
|
|
997
|
+
| Flag | Description |
|
|
998
|
+
|------|-------------|
|
|
999
|
+
| `-a, --access` | Access level (default: private) |
|
|
1028
1000
|
| `-t, --content-type` | Content type (auto-detected from extension if omitted) |
|
|
1029
|
-
| `--format`
|
|
1001
|
+
| `--format` | Output format (default: table) |
|
|
1030
1002
|
|
|
1031
1003
|
**Examples:**
|
|
1032
|
-
|
|
1033
1004
|
```bash
|
|
1034
1005
|
tigris objects put my-bucket report.pdf ./report.pdf
|
|
1035
1006
|
tigris objects put t3://my-bucket/report.pdf ./report.pdf
|
|
@@ -1042,12 +1013,11 @@ tigris objects put my-bucket logo.png ./logo.png --access public --content-type
|
|
|
1042
1013
|
tigris objects delete <bucket> [key] [flags]
|
|
1043
1014
|
```
|
|
1044
1015
|
|
|
1045
|
-
| Flag
|
|
1046
|
-
|
|
1016
|
+
| Flag | Description |
|
|
1017
|
+
|------|-------------|
|
|
1047
1018
|
| `--force` | Skip confirmation prompts (alias for --yes) |
|
|
1048
1019
|
|
|
1049
1020
|
**Examples:**
|
|
1050
|
-
|
|
1051
1021
|
```bash
|
|
1052
1022
|
tigris objects delete my-bucket old-file.txt --yes
|
|
1053
1023
|
tigris objects delete t3://my-bucket/old-file.txt --yes
|
|
@@ -1060,13 +1030,12 @@ tigris objects delete my-bucket file-a.txt,file-b.txt --yes
|
|
|
1060
1030
|
tigris objects set <bucket> [key] [flags]
|
|
1061
1031
|
```
|
|
1062
1032
|
|
|
1063
|
-
| Flag
|
|
1064
|
-
|
|
1065
|
-
| `-a, --access`
|
|
1033
|
+
| Flag | Description |
|
|
1034
|
+
|------|-------------|
|
|
1035
|
+
| `-a, --access` | Access level |
|
|
1066
1036
|
| `-n, --new-key` | Rename the object to a new key |
|
|
1067
1037
|
|
|
1068
1038
|
**Examples:**
|
|
1069
|
-
|
|
1070
1039
|
```bash
|
|
1071
1040
|
tigris objects set my-bucket my-file.txt --access public
|
|
1072
1041
|
tigris objects set t3://my-bucket/my-file.txt --access public
|
|
@@ -1079,13 +1048,12 @@ tigris objects set my-bucket my-file.txt --access private
|
|
|
1079
1048
|
tigris objects info <bucket> [key] [flags]
|
|
1080
1049
|
```
|
|
1081
1050
|
|
|
1082
|
-
| Flag
|
|
1083
|
-
|
|
1084
|
-
| `--format`
|
|
1051
|
+
| Flag | Description |
|
|
1052
|
+
|------|-------------|
|
|
1053
|
+
| `--format` | Output format (default: table) |
|
|
1085
1054
|
| `-snapshot, --snapshot-version` | Read from a specific bucket snapshot |
|
|
1086
1055
|
|
|
1087
1056
|
**Examples:**
|
|
1088
|
-
|
|
1089
1057
|
```bash
|
|
1090
1058
|
tigris objects info my-bucket report.pdf
|
|
1091
1059
|
tigris objects info t3://my-bucket/report.pdf
|
|
@@ -1096,25 +1064,25 @@ tigris objects info my-bucket report.pdf --format json
|
|
|
1096
1064
|
|
|
1097
1065
|
Identity and Access Management - manage policies, users, and permissions
|
|
1098
1066
|
|
|
1099
|
-
| Command
|
|
1100
|
-
|
|
1067
|
+
| Command | Description |
|
|
1068
|
+
|---------|-------------|
|
|
1101
1069
|
| `iam policies` (p) | Manage IAM policies. Policies define permissions for access keys |
|
|
1102
|
-
| `iam users` (u)
|
|
1070
|
+
| `iam users` (u) | Manage organization users and invitations |
|
|
1103
1071
|
|
|
1104
1072
|
#### `iam policies` | `p`
|
|
1105
1073
|
|
|
1106
1074
|
Manage IAM policies. Policies define permissions for access keys
|
|
1107
1075
|
|
|
1108
|
-
| Command
|
|
1109
|
-
|
|
1110
|
-
| `iam policies list` (l)
|
|
1111
|
-
| `iam policies get` (g)
|
|
1112
|
-
| `iam policies create` (c)
|
|
1113
|
-
| `iam policies edit` (e)
|
|
1114
|
-
| `iam policies delete` (d)
|
|
1115
|
-
| `iam policies link-key` (lnk)
|
|
1076
|
+
| Command | Description |
|
|
1077
|
+
|---------|-------------|
|
|
1078
|
+
| `iam policies list` (l) | List all policies in the current organization |
|
|
1079
|
+
| `iam policies get` (g) | Show details for a policy including its document and attached users. If no ARN provided, shows interactive selection |
|
|
1080
|
+
| `iam policies create` (c) | Create a new policy with the given name and policy document. Document can be provided via file, inline JSON, or stdin |
|
|
1081
|
+
| `iam policies edit` (e) | Update an existing policy's document. Document can be provided via file, inline JSON, or stdin. If no ARN provided, shows interactive selection |
|
|
1082
|
+
| `iam policies delete` (d) | Delete a policy. If no ARN provided, shows interactive selection |
|
|
1083
|
+
| `iam policies link-key` (lnk) | Link an access key to a policy. If no policy ARN is provided, shows interactive selection. If no access key ID is provided, shows interactive selection of unlinked keys |
|
|
1116
1084
|
| `iam policies unlink-key` (ulnk) | Unlink an access key from a policy. If no policy ARN is provided, shows interactive selection. If no access key ID is provided, shows interactive selection of linked keys |
|
|
1117
|
-
| `iam policies list-keys` (lk)
|
|
1085
|
+
| `iam policies list-keys` (lk) | List all access keys attached to a policy. If no policy ARN is provided, shows interactive selection |
|
|
1118
1086
|
|
|
1119
1087
|
##### `iam policies list`
|
|
1120
1088
|
|
|
@@ -1122,14 +1090,13 @@ Manage IAM policies. Policies define permissions for access keys
|
|
|
1122
1090
|
tigris iam policies list [flags]
|
|
1123
1091
|
```
|
|
1124
1092
|
|
|
1125
|
-
| Flag
|
|
1126
|
-
|
|
1127
|
-
| `--format`
|
|
1128
|
-
| `--limit`
|
|
1093
|
+
| Flag | Description |
|
|
1094
|
+
|------|-------------|
|
|
1095
|
+
| `--format` | Output format (default: table) |
|
|
1096
|
+
| `--limit` | Maximum number of items to return per page |
|
|
1129
1097
|
| `-pt, --page-token` | Pagination token from a previous request to fetch the next page |
|
|
1130
1098
|
|
|
1131
1099
|
**Examples:**
|
|
1132
|
-
|
|
1133
1100
|
```bash
|
|
1134
1101
|
tigris iam policies list
|
|
1135
1102
|
```
|
|
@@ -1140,12 +1107,11 @@ tigris iam policies list
|
|
|
1140
1107
|
tigris iam policies get [resource] [flags]
|
|
1141
1108
|
```
|
|
1142
1109
|
|
|
1143
|
-
| Flag
|
|
1144
|
-
|
|
1110
|
+
| Flag | Description |
|
|
1111
|
+
|------|-------------|
|
|
1145
1112
|
| `--format` | Output format (default: table) |
|
|
1146
1113
|
|
|
1147
1114
|
**Examples:**
|
|
1148
|
-
|
|
1149
1115
|
```bash
|
|
1150
1116
|
tigris iam policies get
|
|
1151
1117
|
tigris iam policies get arn:aws:iam::org_id:policy/my-policy
|
|
@@ -1157,13 +1123,12 @@ tigris iam policies get arn:aws:iam::org_id:policy/my-policy
|
|
|
1157
1123
|
tigris iam policies create <name> [flags]
|
|
1158
1124
|
```
|
|
1159
1125
|
|
|
1160
|
-
| Flag
|
|
1161
|
-
|
|
1126
|
+
| Flag | Description |
|
|
1127
|
+
|------|-------------|
|
|
1162
1128
|
| `-d, --document` | Policy document (JSON file path or inline JSON). If omitted, reads from stdin |
|
|
1163
|
-
| `--description`
|
|
1129
|
+
| `--description` | Policy description |
|
|
1164
1130
|
|
|
1165
1131
|
**Examples:**
|
|
1166
|
-
|
|
1167
1132
|
```bash
|
|
1168
1133
|
tigris iam policies create my-policy --document policy.json
|
|
1169
1134
|
tigris iam policies create my-policy --document '{"Version":"2012-10-17","Statement":[...]}'
|
|
@@ -1176,13 +1141,12 @@ cat policy.json | tigris iam policies create my-policy
|
|
|
1176
1141
|
tigris iam policies edit [resource] [flags]
|
|
1177
1142
|
```
|
|
1178
1143
|
|
|
1179
|
-
| Flag
|
|
1180
|
-
|
|
1144
|
+
| Flag | Description |
|
|
1145
|
+
|------|-------------|
|
|
1181
1146
|
| `-d, --document` | New policy document (JSON file path or inline JSON). If omitted, reads from stdin |
|
|
1182
|
-
| `--description`
|
|
1147
|
+
| `--description` | Update policy description |
|
|
1183
1148
|
|
|
1184
1149
|
**Examples:**
|
|
1185
|
-
|
|
1186
1150
|
```bash
|
|
1187
1151
|
tigris iam policies edit --document policy.json
|
|
1188
1152
|
tigris iam policies edit arn:aws:iam::org_id:policy/my-policy --document policy.json
|
|
@@ -1195,12 +1159,11 @@ cat policy.json | tigris iam policies edit arn:aws:iam::org_id:policy/my-policy
|
|
|
1195
1159
|
tigris iam policies delete [resource] [flags]
|
|
1196
1160
|
```
|
|
1197
1161
|
|
|
1198
|
-
| Flag
|
|
1199
|
-
|
|
1162
|
+
| Flag | Description |
|
|
1163
|
+
|------|-------------|
|
|
1200
1164
|
| `--force` | Skip confirmation prompts (alias for --yes) |
|
|
1201
1165
|
|
|
1202
1166
|
**Examples:**
|
|
1203
|
-
|
|
1204
1167
|
```bash
|
|
1205
1168
|
tigris iam policies delete
|
|
1206
1169
|
tigris iam policies delete arn:aws:iam::org_id:policy/my-policy --yes
|
|
@@ -1212,12 +1175,11 @@ tigris iam policies delete arn:aws:iam::org_id:policy/my-policy --yes
|
|
|
1212
1175
|
tigris iam policies link-key [resource] [flags]
|
|
1213
1176
|
```
|
|
1214
1177
|
|
|
1215
|
-
| Flag
|
|
1216
|
-
|
|
1178
|
+
| Flag | Description |
|
|
1179
|
+
|------|-------------|
|
|
1217
1180
|
| `--id` | Access key ID to attach |
|
|
1218
1181
|
|
|
1219
1182
|
**Examples:**
|
|
1220
|
-
|
|
1221
1183
|
```bash
|
|
1222
1184
|
tigris iam policies link-key arn:aws:iam::org_id:policy/my-policy --id tid_AaBb
|
|
1223
1185
|
tigris iam policies link-key
|
|
@@ -1229,13 +1191,12 @@ tigris iam policies link-key
|
|
|
1229
1191
|
tigris iam policies unlink-key [resource] [flags]
|
|
1230
1192
|
```
|
|
1231
1193
|
|
|
1232
|
-
| Flag
|
|
1233
|
-
|
|
1234
|
-
| `--id`
|
|
1194
|
+
| Flag | Description |
|
|
1195
|
+
|------|-------------|
|
|
1196
|
+
| `--id` | Access key ID to detach |
|
|
1235
1197
|
| `--force` | Skip confirmation prompts (alias for --yes) |
|
|
1236
1198
|
|
|
1237
1199
|
**Examples:**
|
|
1238
|
-
|
|
1239
1200
|
```bash
|
|
1240
1201
|
tigris iam policies unlink-key arn:aws:iam::org_id:policy/my-policy --id tid_AaBb --yes
|
|
1241
1202
|
tigris iam policies unlink-key
|
|
@@ -1247,12 +1208,11 @@ tigris iam policies unlink-key
|
|
|
1247
1208
|
tigris iam policies list-keys [resource] [flags]
|
|
1248
1209
|
```
|
|
1249
1210
|
|
|
1250
|
-
| Flag
|
|
1251
|
-
|
|
1211
|
+
| Flag | Description |
|
|
1212
|
+
|------|-------------|
|
|
1252
1213
|
| `--format` | Output format (default: table) |
|
|
1253
1214
|
|
|
1254
1215
|
**Examples:**
|
|
1255
|
-
|
|
1256
1216
|
```bash
|
|
1257
1217
|
tigris iam policies list-keys arn:aws:iam::org_id:policy/my-policy
|
|
1258
1218
|
tigris iam policies list-keys
|
|
@@ -1262,13 +1222,13 @@ tigris iam policies list-keys
|
|
|
1262
1222
|
|
|
1263
1223
|
Manage organization users and invitations
|
|
1264
1224
|
|
|
1265
|
-
| Command
|
|
1266
|
-
|
|
1267
|
-
| `iam users list` (l)
|
|
1268
|
-
| `iam users invite` (i)
|
|
1269
|
-
| `iam users revoke-invitation` (ri) | Revoke pending invitations. If no invitation ID provided, shows interactive selection
|
|
1270
|
-
| `iam users update-role` (ur)
|
|
1271
|
-
| `iam users remove` (rm)
|
|
1225
|
+
| Command | Description |
|
|
1226
|
+
|---------|-------------|
|
|
1227
|
+
| `iam users list` (l) | List all users and pending invitations in the organization |
|
|
1228
|
+
| `iam users invite` (i) | Invite users to the organization by email |
|
|
1229
|
+
| `iam users revoke-invitation` (ri) | Revoke pending invitations. If no invitation ID provided, shows interactive selection |
|
|
1230
|
+
| `iam users update-role` (ur) | Update user roles in the organization. If no user ID provided, shows interactive selection |
|
|
1231
|
+
| `iam users remove` (rm) | Remove users from the organization. If no user ID provided, shows interactive selection |
|
|
1272
1232
|
|
|
1273
1233
|
##### `iam users list`
|
|
1274
1234
|
|
|
@@ -1276,12 +1236,11 @@ Manage organization users and invitations
|
|
|
1276
1236
|
tigris iam users list [flags]
|
|
1277
1237
|
```
|
|
1278
1238
|
|
|
1279
|
-
| Flag
|
|
1280
|
-
|
|
1239
|
+
| Flag | Description |
|
|
1240
|
+
|------|-------------|
|
|
1281
1241
|
| `--format` | Output format (default: table) |
|
|
1282
1242
|
|
|
1283
1243
|
**Examples:**
|
|
1284
|
-
|
|
1285
1244
|
```bash
|
|
1286
1245
|
tigris iam users list
|
|
1287
1246
|
tigris iam users list --format json
|
|
@@ -1293,12 +1252,11 @@ tigris iam users list --format json
|
|
|
1293
1252
|
tigris iam users invite <email> [flags]
|
|
1294
1253
|
```
|
|
1295
1254
|
|
|
1296
|
-
| Flag
|
|
1297
|
-
|
|
1255
|
+
| Flag | Description |
|
|
1256
|
+
|------|-------------|
|
|
1298
1257
|
| `-r, --role` | Role to assign to the invited user(s) (default: member) |
|
|
1299
1258
|
|
|
1300
1259
|
**Examples:**
|
|
1301
|
-
|
|
1302
1260
|
```bash
|
|
1303
1261
|
tigris iam users invite user@example.com
|
|
1304
1262
|
tigris iam users invite user@example.com --role admin
|
|
@@ -1311,12 +1269,11 @@ tigris iam users invite user1@example.com,user2@example.com
|
|
|
1311
1269
|
tigris iam users revoke-invitation [resource] [flags]
|
|
1312
1270
|
```
|
|
1313
1271
|
|
|
1314
|
-
| Flag
|
|
1315
|
-
|
|
1272
|
+
| Flag | Description |
|
|
1273
|
+
|------|-------------|
|
|
1316
1274
|
| `--force` | Skip confirmation prompts (alias for --yes) |
|
|
1317
1275
|
|
|
1318
1276
|
**Examples:**
|
|
1319
|
-
|
|
1320
1277
|
```bash
|
|
1321
1278
|
tigris iam users revoke-invitation
|
|
1322
1279
|
tigris iam users revoke-invitation invitation_id --yes
|
|
@@ -1329,12 +1286,11 @@ tigris iam users revoke-invitation id1,id2,id3 --yes
|
|
|
1329
1286
|
tigris iam users update-role [resource] [flags]
|
|
1330
1287
|
```
|
|
1331
1288
|
|
|
1332
|
-
| Flag
|
|
1333
|
-
|
|
1289
|
+
| Flag | Description |
|
|
1290
|
+
|------|-------------|
|
|
1334
1291
|
| `-r, --role` | Role(s) to assign (comma-separated). Each role pairs with the corresponding user ID. If one role is given, it applies to all users |
|
|
1335
1292
|
|
|
1336
1293
|
**Examples:**
|
|
1337
|
-
|
|
1338
1294
|
```bash
|
|
1339
1295
|
tigris iam users update-role --role admin
|
|
1340
1296
|
tigris iam users update-role user_id --role member
|
|
@@ -1348,12 +1304,11 @@ tigris iam users update-role id1,id2 --role admin,member
|
|
|
1348
1304
|
tigris iam users remove [resource] [flags]
|
|
1349
1305
|
```
|
|
1350
1306
|
|
|
1351
|
-
| Flag
|
|
1352
|
-
|
|
1307
|
+
| Flag | Description |
|
|
1308
|
+
|------|-------------|
|
|
1353
1309
|
| `--force` | Skip confirmation prompts (alias for --yes) |
|
|
1354
1310
|
|
|
1355
1311
|
**Examples:**
|
|
1356
|
-
|
|
1357
1312
|
```bash
|
|
1358
1313
|
tigris iam users remove
|
|
1359
1314
|
tigris iam users remove user@example.com --yes
|
|
@@ -1371,7 +1326,6 @@ tigris update
|
|
|
1371
1326
|
```
|
|
1372
1327
|
|
|
1373
1328
|
**Examples:**
|
|
1374
|
-
|
|
1375
1329
|
```bash
|
|
1376
1330
|
tigris update
|
|
1377
1331
|
```
|