presign

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

Ncloud Storage에 업로드한 객체에 대해 사전 서명(Pre-signed) URL을 생성합니다. 사전 서명 URL을 사용하면 유효 기간 내에 별도의 인증 없이 객체를 다운로드할 수 있습니다.

구문

presign 구문은 다음과 같습니다.

aws s3 presign \
    <s3-uri> \
    [--expires-in <expires-in>] \
    --endpoint-url <endpoint-url>

옵션

presign 실행 시 지정할 수 있는 옵션을 설명합니다.

필수 옵션

presign의 필수 옵션입니다.

옵션	타입	필수 여부	설명
`<s3-uri>`	String	Required	객체의 S3 URI `s3://{bucket_name}/{object_name}` 형식

선택 옵션

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

옵션	타입	필수 여부	설명
`--expires-in`	Integer	Optional	사전 서명 URL이 만료될 때까지의 시간 (초) `1`~`604800` (기본값: `3600`)

공통 옵션

aws 명령에서 공통으로 사용하는 옵션에 대한 정보는 Ncloud Storage 옵션을 참조해 주십시오.

예시

사전 서명 URL을 생성하면 서명과 만료 정보가 포함된 URL이 출력됩니다.

명령

기본 유효 기간으로 사전 서명 URL을 생성하는 명령 예시는 다음과 같습니다.

aws s3 presign s3://my-test-bucket/img/image.png \
    --expires-in 3600 \
    --endpoint-url=https://kr.ncloudstorage.com

유효 기간을 1주일로 지정하여 사전 서명 URL을 생성하는 명령 예시는 다음과 같습니다.

aws s3 presign s3://my-test-bucket/img/image.png \
    --expires-in 604800 \
    --endpoint-url=https://kr.ncloudstorage.com

출력

기본 유효 기간으로 사전 서명 URL을 생성하는 출력 예시는 다음과 같습니다.

https://kr.ncloudstorage.com/my-test-bucket/img/image.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=<access-key-redacted>%2F20260821%2Fkr%2Fs3%2Faws4_request&X-Amz-Date=20260821T051207Z&X-Amz-Expires=3600&X-Amz-SignedHeaders=host&X-Amz-Signature=<signature-redacted>

유효 기간을 1주일로 지정하여 사전 서명 URL을 생성하는 출력 예시는 다음과 같습니다.

https://kr.ncloudstorage.com/my-test-bucket/img/image.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=<access-key-redacted>%2F20260821%2Fkr%2Fs3%2Faws4_request&X-Amz-Date=20260821T051153Z&X-Amz-Expires=604800&X-Amz-SignedHeaders=host&X-Amz-Signature=<signature-redacted>