On this page

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

**Alias:** `o`

## Usage

```bash
tigris objects <operation> [flags]
t3 o <operation> [flags]
```

## Commands

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

`tigris objects set` is deprecated. Use [`set-access`](/content/docs/cli/objects/set-access/index.html) to change
ACLs and [`tigris mv`](/content/docs/cli/mv/index.html) to rename objects.

## Examples

```bash
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
```