# tigris objects restore

Restore an archived object (e.g. one in the `GLACIER` tier) into an actively readable copy for a number of days.

**Alias:** `rs`

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

```
tigris objects restore <bucket> [key] [flags]

t3 o rs <bucket> [key] [flags]
```

If the bucket argument contains the full path (e.g. `t3://my-bucket/archived.bin`), the `key` argument can be omitted.

## Arguments[​](#arguments "Direct link to Arguments")

| Name     | Required | Description                                          |
| -------- | -------- | ---------------------------------------------------- |
| `bucket` | Yes      | Bucket name, or a full path (`t3://bucket/key`)      |
| `key`    | No       | Object key. Omit if `bucket` contains the full path. |

## Flags[​](#flags "Direct link to Flags")

| Name                              | Required | Default | Description                                                                                                                                                    |
| --------------------------------- | -------- | ------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `--days`, `-d`                    | No       | `1`     | How many days the restored copy stays available before reverting to its archived tier                                                                          |
| `--version-id`                    | No       | —       | Restore a specific object version (requires bucket versioning). Omit to restore the current version                                                            |
| `--snapshot-version`, `-snapshot` | No       | —       | Restore the object as of a specific bucket snapshot. Accepts a snapshot version string or any UNIX nanosecond-precision timestamp (e.g. `1765889000501544464`) |
| `--format`                        | No       | `table` | Output format. Options: `json`, `table`, `xml`                                                                                                                 |

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

```
# Restore for the default 1 day

tigris objects restore my-bucket archived.bin



# Restore for 3 days

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



# Restore using a t3:// path

tigris objects restore t3://my-bucket/archived.bin --days 7
```

Use [`tigris objects restore-info`](/docs/cli/objects/restore-info/.md) to check the restore state of an object.