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의 필수 옵션입니다.

옵션	타입	필수 여부	설명
`<method>`	String	Required	임시 URL로 허용할 HTTP 메서드 `GET` \| `HEAD` \| `PUT` \| `POST` \| `DELETE`
`<time>`	String	Required	임시 URL의 유효 기간 초 단위 정수 (예시: `3600`) `s` `m` `h` `d` 접미사를 붙인 숫자 (예시: `24h`) ISO 8601 형식 타임스탬프 (예시: `2026-08-19T19:20:30Z`) `--absolute` 입력 시 정수는 만료 시점의 Unix 타임스탬프로 해석
`<path>`	String	Required	오브젝트의 전체 경로 또는 스토리지 URL 예시: `/v1/AUTH_{project_id}/{container}/{object}`
`<key>`	String	Required	클러스터에 설정된 임시 URL 비밀 키 `post` 명령으로 설정 (예시: `swift post -m "Temp-URL-Key:{key}"`) post 참조

선택 옵션

tempurl의 선택 옵션입니다. 지정하지 않은 옵션에는 기본값이 적용됩니다.

옵션	타입	필수 여부	설명
`--absolute`	Boolean	Optional	`<time>`을 Unix 타임스탬프로 해석 `<time>`이 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 옵션을 참조해 주십시오.

예시

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