---
title: "tempurl"
slug: "cli-archivestorage-tempurl"
updated: 2026-09-17T09:16:11Z
published: 2026-09-17T09:16:11Z
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 "Temp-URL-Key:{key}"`) - [post](/docs/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/guide-archivestorage#%EC%98%B5%EC%85%98)을 참조해 주십시오.

## 예시

임시 URL을 생성하면 서명과 만료 일시가 포함된 경로가 출력됩니다. 출력된 경로 앞에 [auth](/docs/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
```