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

`tigris objects set` is deprecated. Use [`set-access`](/docs/cli/objects/set-access/.md) to change ACLs and [`tigris mv`](/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](/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
```