--- title: "presign" slug: "presign" updated: 2026-09-17T09:16:08Z published: 2026-09-17T09:16:08Z canonical: "cli.ncloud-docs.com/presign" --- > ## 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. # presign Classic/VPC 환경에서 이용 가능합니다. Ncloud Storage에 업로드한 객체에 대해 사전 서명(Pre-signed) URL을 생성합니다. 사전 서명 URL을 사용하면 유효 기간 내에 별도의 인증 없이 객체를 다운로드할 수 있습니다. ## 구문 `presign` 구문은 다음과 같습니다. ``` aws s3 presign \ \ [--expires-in ] \ --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 옵션](/docs/storage-ncloudstorage#%EC%98%B5%EC%85%98)을 참조해 주십시오. ## 예시 사전 서명 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=%2F20260821%2Fkr%2Fs3%2Faws4_request&X-Amz-Date=20260821T051207Z&X-Amz-Expires=3600&X-Amz-SignedHeaders=host&X-Amz-Signature= ``` 유효 기간을 1주일로 지정하여 사전 서명 URL을 생성하는 출력 예시는 다음과 같습니다. ``` https://kr.ncloudstorage.com/my-test-bucket/img/image.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=%2F20260821%2Fkr%2Fs3%2Faws4_request&X-Amz-Date=20260821T051153Z&X-Amz-Expires=604800&X-Amz-SignedHeaders=host&X-Amz-Signature= ```