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>