---
title: "tempurl"
slug: "cli-archivestorage-tempurl"
updated: 2026-10-08T04:56:29Z
published: 2026-10-08T04:56:29Z
canonical: "cli.ncloud-docs.com/cli-archivestorage-tempurl"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://cli.ncloud-docs.com/llms.txt
> Use this file to discover all available pages before exploring further.

# tempurl

Available in Classic and VPC

Create a temporary URL that provides access to the object.

## Syntax

The `tempurl` syntax is as follows:

```
swift tempurl \
    <method> \
    <time> \
    <path> \
    <key> \
    [--absolute] \
    [--prefix-based] \
    [--iso8601] \
    [--ip-range <ip-range>] \
    [--digest <sha1|sha256|sha512>]
```

## Options

This section describes the options available when running `tempurl`.

### Required options

The following options are required for `tempurl`.

| Options | Type | Required | Description |
| --- | --- | --- | --- |
| `&lt;method&gt;` | String | Required | HTTP method allowed for temporary URLs - `GET` \| `HEAD` \| `PUT` \| `POST` \| `DELETE` |
| `&lt;time&gt;` | String | Required | Expiration time of the temporary URL - Integer in seconds (e.g., `3600`). - `s` `m` `h` `d` suffixes appended to a number (e.g., `24h`). - ISO 8601-formatted timestamp (e.g., `2026-08-19T19:20:30Z`). - When entering `--absolute`, the integer is interpreted as the Unix timestamp at the expiration time. |
| `&lt;path&gt;` | String | Required | Full path to the object or storage URL - Example: `/v1/AUTH_{project_id}/{container}/{object}` |
| `&lt;key&gt;` | String | Required | Temporary URL secret key configured in the cluster - Configure it via the `post` command (e.g., `swift post -m &quot;Temp-URL-Key:{key}&quot;`). - See [post](/docs/en/cli-archivestorage-post). |

### Optional options

These are the optional options for `tempurl`. Options that are not specified will use their default values.

| Options | Type | Required | Description |
| --- | --- | --- | --- |
| `--absolute` | Boolean | Optional | Interprets `&lt;time&gt;` as a Unix timestamp. - `&lt;time&gt;` is ignored if it is in ISO 8601 format. |
| `--prefix-based` | Boolean | Optional | Creates a prefix-based temporary URL. |
| `--iso8601` | Boolean | Optional | Includes an ISO 8601 UTC timestamp in the temporary URL instead of a Unix timestamp. |
| `--ip-range` | String | Optional | IP addresses or IP ranges allowed to use the temporary URL |
| `--digest` | String | Optional | Digest algorithm to use - `sha1` \| `sha256` \| `sha512` |

### Common options

For information about the options common to all `swift` subcommands, see [Archive Storage options](/docs/en/guide-archivestorage#%EC%98%B5%EC%85%98).

## Examples

When you create a temporary URL, a path containing the signature and expiration date/time is output. Prepend the storage URL verified using the [auth](/docs/en/cli-archivestorage-auth) command to the output path.

### Command

The command example is as follows:

```
swift tempurl GET 3600 \
    /v1/AUTH_a1b2c3d4e5f64a7b8c9d0e1f2a3b4c5d/test-container-01/sample.txt \
    {key}
```

### Output

The output example is as follows:

```
/v1/AUTH_a1b2c3d4e5f64a7b8c9d0e1f2a3b4c5d/test-container-01/sample.txt?temp_url_sig=<signature-redacted>&temp_url_expires=1787108031
```