すべてのプロダクト
Search
ドキュメントセンター

Object Storage Service:事前署名

最終更新日:Aug 28, 2024

presignコマンドを実行して、署名付きURLを生成できます。

コマンド構文

ossutil presign oss:// bucket[/prefix] [flags]

パラメーター

データ型

説明

-d, -- dirs

/

現在のディレクトリのオブジェクトとサブディレクトリが返されることを指定します。

-- encoding-type

String

オブジェクト名のエンコードに使用されるエンコード方法。 有効値: url

-- end-with

String

-- end-withパラメーターの値の前または同じ名前のオブジェクトが返されるように指定します。

--exclude

stringArray

パスまたはオブジェクト名の除外ルール。

-- exclude-from

stringArray

除外ルールをルールファイルから読み取ることを指定します。

-- expires-date

時間

署名付きURLの有効期限が切れる時点。

-- expires-duration

有効期間

署名付きURLの有効期間。 有効期間は1秒から1週間の範囲です。 デフォルト値: 15m0s。

--files-from

stringArray

オブジェクト名をルールファイルから読み取り、空行またはコメント行を無視することを指定します。

-- files-from-raw

stringArray

オブジェクト名をルールファイルから読み取ることを指定します。

--filter

stringArray

パスまたはオブジェクト名のフィルタールール。

-- filter-from

stringArray

パスまたはオブジェクト名のフィルタールールをルールファイルから読み取ることを指定します。

-f, --force

/

確認のプロンプトなしでコマンドを強制的に実行することを指定します。

--include

stringArray

パスまたはオブジェクト名の包含ルール。

-- include-from

stringArray

包含ルールをルールファイルから読み取ることを指定します。

--limited-num

int

返される結果の最大数。

-- list-objects

/

オブジェクトを一覧表示するためにListObjects操作を呼び出すことを指定します。

--max-age

有効期間

最終変更時刻が -- max-ageパラメーターの値より前のオブジェクトを除外します。 デフォルトの単位は秒です。 単位は、ミリ秒、秒、分、時間、日、週、月、または年とすることができる。 デフォルトでは、このパラメータは空のままです。

-- max-mtime

時間

最終変更時刻が -- max-mtimeパラメーターの値より後のオブジェクトを除外します。 値はUTCです。 デフォルトでは、このパラメータは空のままです。

--max-size

SizeSuffix

転送できるオブジェクトの最大サイズ。 デフォルトの単位はバイトです。 オブジェクトサイズの単位は、バイト、KiB、MiB、GiB、TiB、またはPiBです。 注: 1 KiB = 1024バイト。

--metadata-exclude

stringArray

オブジェクトメタデータの除外ルール。

-- metadata-filter

stringArray

オブジェクトメタデータのフィルタールール。

-- metadata-filter-from

stringArray

オブジェクトメタデータのフィルタールールをルールファイルから読み取ることを指定します。

-- metadata-include

stringArray

オブジェクトメタデータの包含ルール。

--min-age

有効期間

最終変更時刻が -- min-ageパラメーターの値より後のオブジェクトを除外します。 デフォルトの単位は秒です。 単位は、ミリ秒、秒、分、時間、日、週、月、または年とすることができる。 デフォルトでは、このパラメータは空のままです。

-- min-mtime

時間

最終変更時刻が -- min-mtimeパラメーターの値より前のオブジェクトを除外します。 値はUTCです。 デフォルトでは、このパラメータは空のままです。

--min-size

SizeSuffix

転送可能なオブジェクトの最小サイズ。 デフォルトの単位はバイトです。 オブジェクトサイズの単位は、バイト、KiB、MiB、GiB、TiB、またはPiBです。 注: 1 KiB = 1024バイト。

--page-size

int

返されるオブジェクトの最大数。 デフォルト値は 1000 です。 有効な値: 1 ~ 1000

-- query-param

stringArray

リクエスト内のクエリパラメーター。

-r, -- recursive

/

コマンドがオブジェクトに対して再帰的に実行されることを指定します。 このパラメーターを指定すると、バケット内の条件を満たすすべてのオブジェクトに対してコマンドが有効になります。 それ以外の場合、コマンドは指定されたパス内のオブジェクトに対してのみ有効になります。

-- request-payer

String

リクエストの支払人。 pay-by-requesterがバケットに対して有効になっている場合、このパラメーターをrequesterに設定します。

-- start-after

String

-- end-withパラメーターの値の前または同じ名前のオブジェクトが返されるように指定します。

--traffic-limit

int

単一接続の帯域幅制限。 有効な値: 819200〜838860800。

-- version-id

String

オブジェクトのバージョンID。

説明

詳細については、「コマンドラインオプション」をご参照ください。

  • examplebucketバケット内のexample.txtオブジェクトの場合、デフォルトの有効期間が15分の署名付きURLを生成します。

    ossutil presign oss:// examplebucket/example.txt
  • examplebucketバケット内のexample.txtオブジェクトの場合、有効期間が1時間の署名付きURLを生成します。

    ossutil presign oss:// examplebucket/example.txt -- expires-duration 1h
  • examplebucketバケット内のexample.txtオブジェクトの場合、2024-06-01T12:00:00 (UTC) まで有効な署名付きURLを生成します。

    ossutil presign oss://examplebucket/example.txt --expires-date 2024-06-01T12:00:00
  • examplebucketバケット内のexample.txtオブジェクトの場合、画像処理パラメーターを含む署名付きURLを生成します。

    ossutil presign oss://examplebucket/example.txt --query-param x-oss-process=image/resize,m_fixed,w_100,h_100/rotate,90
  • examplebucketバケット内のexample.txtオブジェクトの「123」バージョンのシングルURLを生成します。

    ossutil presign oss:// examplebucket/example.txt -- version-id 123
  • examplebucketバケットの "folder" ディレクトリにあるオブジェクトの場合、有効期間が15分の署名付きURLを生成します。

    ossutil presign oss:// examplebucket/folder/ -r
  • examplebucketバケットの "folder" ディレクトリにあるTXTオブジェクトの場合、デフォルトの有効期間が15分のURLを生成します。

    ossutil presign oss:// examplebucket/folder/ -r -- include "*.txt"