---
title: "tempurl"
slug: "cli-archivestorage-tempurl"
updated: 2026-10-08T09:45:29Z
published: 2026-10-08T09:45: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

Classic/VPC環境で利用できます。

オブジェクトにアクセスできる一時的な URLを作成します。

## 構文

`tempurl`構文は次の通りです。

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

## オプション

`tempurl`の実行時に指定できるオプションについて説明します。

### 必須オプション

`tempurl`の必須オプションです。

| オプション | タイプ | 必須の有無 | 説明 |
| --- | --- | --- | --- |
| `&lt;method&gt;` | String | Required | 一時 URLで許可する HTTPメソッド - `GET` \| `HEAD` \| `PUT` \| `POST` \| `DELETE` |
| `&lt;time&gt;` | String | Required | 一時 URLの有効期間 - 秒単位の整数 (例: `3600`) - `s`、`m`、`h`、`d`の接尾辞を付けた数字 (例: `24h`) - ISO 8601形式のタイムスタンプ (例: `2026-08-19T19:20:30Z`) - `--absolute`入力時、整数は有効期限の Unixタイムスタンプとして解釈 |
| `&lt;path&gt;` | String | Required | オブジェクトのフルパスまたはストレージ URL - 例: `/v1/AUTH_{project_id}/{container}/{object}` |
| `&lt;key&gt;` | String | Required | クラスタに設定された一時 URLのシークレットキー - `post`コマンドで設定 (例: `swift post -m &quot;Temp-URL-Key:{key}&quot;`) - [post](/docs/ja/cli-archivestorage-post)を参照 |

### 任意オプション

`tempurl`の任意オプションです。指定しない場合、オプションにはデフォルト値が適用されます。

| オプション | タイプ | 必須の有無 | 説明 |
| --- | --- | --- | --- |
| `--absolute` | Boolean | Optional | `&lt;time&gt;`を Unixタイムスタンプとして解釈 - `&lt;time&gt;`が ISO 8601形式の場合は無視 |
| `--prefix-based` | Boolean | Optional | 接頭辞ベースの一時 URLを作成 |
| `--iso8601` | Boolean | Optional | 一時 URLに Unixタイムスタンプではなく、ISO 8601形式の UTCタイムスタンプを含める |
| `--ip-range` | String | Optional | 一時 URLの使用を許可する IPアドレスまたは IPアドレス範囲 |
| `--digest` | String | Optional | 使用するダイジェストアルゴリズム - `sha1` \| `sha256` \| `sha512` |

### 共通オプション

`swift`コマンドで共通して使用するオプションについては、[Archive Storageのオプション](/docs/ja/guide-archivestorage#%EC%98%B5%EC%85%98)をご参照ください。

## 例

一時 URLを作成すると、署名と有効期限が含まれたパスが出力されます。出力されたパスの先頭に、[auth](/docs/ja/cli-archivestorage-auth)コマンドで確認したストレージ URLを追加して使用します。

### コマンド

コマンドの例は次の通りです。

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

### 出力

出力の例は次の通りです。

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