# 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)      |

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