# tigris objects

Low-level object operations for listing, downloading, uploading, and deleting individual objects in a bucket.

**Alias:** `o`

## Usage[​](#usage "Direct link to Usage")

```
tigris objects <operation> [flags]

t3 o <operation> [flags]
```

## Commands[​](#commands "Direct link to Commands")

| Command                                                                             | Description                                                          |
| ----------------------------------------------------------------------------------- | -------------------------------------------------------------------- |
| [`list`](https://www.tigrisdata.com/docs/cli/objects/list.md)                       | List objects in a bucket, optionally filtered by a key prefix        |
| [`list-versions`](https://www.tigrisdata.com/docs/cli/objects/list-versions.md)     | List object versions and delete markers (requires bucket versioning) |
| [`get`](https://www.tigrisdata.com/docs/cli/objects/get.md)                         | Download an object by key                                            |
| [`put`](https://www.tigrisdata.com/docs/cli/objects/put.md)                         | Upload a local file as an object                                     |
| [`delete`](https://www.tigrisdata.com/docs/cli/objects/delete.md)                   | Delete one or more objects by key                                    |
| [`set-access`](https://www.tigrisdata.com/docs/cli/objects/set-access.md)           | Set the access level (public or private) on an existing object       |
| [`info`](https://www.tigrisdata.com/docs/cli/objects/info.md)                       | Show metadata for an object (content type, size, modified date)      |
| [`restore`](https://www.tigrisdata.com/docs/cli/objects/restore.md)                 | Restore an archived object (e.g. GLACIER tier) for a number of days  |
| [`restore-info`](https://www.tigrisdata.com/docs/cli/objects/restore-info.md)       | Show the restore state of an archived object                         |
| [`restore-deleted`](https://www.tigrisdata.com/docs/cli/objects/restore-deleted.md) | Restore a soft-deleted object within its retention window            |
| [`purge`](https://www.tigrisdata.com/docs/cli/objects/purge.md)                     | Permanently destroy a soft-deleted object version                    |

`tigris objects set` is deprecated. Use [`set-access`](https://www.tigrisdata.com/docs/cli/objects/set-access.md) to change ACLs and [`tigris mv`](https://www.tigrisdata.com/docs/cli/mv.md) to rename objects.

## Examples[​](#examples "Direct link to Examples")

```
tigris objects list my-bucket

tigris objects list-versions my-bucket

tigris objects get my-bucket report.pdf --output ./report.pdf

tigris objects put my-bucket report.pdf ./report.pdf

tigris objects delete my-bucket report.pdf

tigris objects set-access my-bucket report.pdf public

tigris objects info my-bucket report.pdf

tigris objects restore my-bucket archived.bin --days 3

tigris objects restore-info my-bucket archived.bin
```

## Recovering deleted objects[​](#recovering-deleted-objects "Direct link to Recovering deleted objects")

On a bucket with [soft delete](https://www.tigrisdata.com/docs/buckets/soft-delete.md) enabled, deleted objects stay recoverable for the bucket's retention window. Recovery is a three-step flow — find the deleted keys, pick a version, then restore or purge it:

```
# 1. Which keys are deleted?

tigris objects list my-bucket --deleted



# 2. Which versions of this key can be recovered?

tigris objects list-versions my-bucket --prefix report.pdf --deleted



# 3a. Bring one back...

tigris objects restore-deleted my-bucket report.pdf --version-id 1787441627070249004



# 3b. ...or destroy it for good, ahead of the retention window.

tigris objects purge my-bucket report.pdf --version-id 1787441627070249004 --yes
```
