---
title: "tempurl"
slug: "cli-archivestorage-tempurl"
updated: 2026-10-22T09:07:27Z
published: 2026-10-22T09:07:27Z
canonical: "cli-gov.ncloud-docs.com/cli-archivestorage-tempurl"
---

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

# tempurl

Classic/VPC 환경에서 이용 가능합니다.

오브젝트에 접근할 수 있는 임시 URL을 생성합니다.

## 구문

`tempurl` 구문은 다음과 같습니다. 구문의 `<method>`, `<time>`, `<path>`, `<key>`는 순서대로 입력해야 하는 필수 위치 인수(Positional Argument)입니다.

```
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 --meta "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` - 구형 클러스터의 경우 `sha1`만 지원할 수도 있음 |

### 공통 옵션

`swift` 명령에서 공통으로 사용하는 옵션에 대한 정보는 [Archive Storage 옵션](/docs/guide-archivestorage#%EC%98%B5%EC%85%98)을 참조해 주십시오.

## 예시

임시 URL을 생성하면 서명과 만료 일시가 포함된 경로가 출력됩니다.

### 명령

명령 예시는 다음과 같습니다.

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

### 출력

출력 예시는 다음과 같습니다.

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

출력된 경로 앞에 [auth](/docs/cli-archivestorage-auth) 명령으로 확인한 스토리지 URL 중 순수 도메인 부분인 최상위 진입점을 붙여 사용합니다. (예시: `https://kr.archive.gov-ncloudstorage.com`)

```
curl -O "https://kr.archive.gov-ncloudstorage.com/v1/AUTH_a1b2c3d4e5f64a7b8c9d0e1f2a3b4c5d/test-container-01/sample.txt?temp_url_sig=<signature-redacted>&temp_url_expires=1787108031"
```