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

Object Storage Service:presign (署名付き URL の生成)

最終更新日:Nov 09, 2025

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

Time

署名付き URL が有効期限切れになる日時。

--expires-duration

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 操作を呼び出してオブジェクトをリストします。

--min-age

Duration

指定された時間間隔より前に変更されたファイルのみを処理します。デフォルトの単位は秒です。単位のサフィックスを使用できます。たとえば、1h は 1 時間を示します。

説明

--min-age 1h は、少なくとも 1 時間前に変更されたファイルのみが処理されることを示します。

--max-age

Duration

指定された時間間隔内に変更されたファイルのみを処理します。デフォルトの単位は秒です。単位のサフィックスを使用できます。たとえば、1h は 1 時間を示します。

説明

--max-age 1h は、過去 1 時間以内に変更されたファイルのみが処理されることを示します。

--min-mtime

Time

指定された時刻以降に変更されたファイルのみを処理します。時間フォーマット: UTC。例: 2006-01-02T15:04:05。

説明

--min-mtime "2006-01-02T15:04:05" は、2006 年 1 月 2 日 15:04:05 以降に変更されたファイルのみが処理されることを示します。

--max-mtime

Time

指定された時刻より前に変更されたファイルのみを処理します。時間フォーマット: UTC。例: 2006-01-02T15:04:05。

--max-size

SizeSuffix

転送できるファイルの最大サイズ。デフォルトでは、サイズはバイト (B) 単位です。数値に 1024 ベースの単位をサフィックスとして付けることができます: B (バイト)、K (キビバイト)、M (メビバイト)、G (ギビバイト)、T (テビバイト)、または P (ペビバイト)。

--metadata-exclude

stringArray

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

--metadata-filter

stringArray

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

--metadata-filter-from

stringArray

ファイルからメタデータ フィルター ルールを読み取ります。

--metadata-include

stringArray

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

--min-size

SizeSuffix

転送できるファイルの最小サイズ。デフォルトでは、サイズはバイト (B) 単位です。数値に 1024 ベースの単位をサフィックスとして付けることができます: B (バイト)、K (キビバイト)、M (メビバイト)、G (ギビバイト)、T (テビバイト)、または P (ペビバイト)。

--page-size

int

バッチ処理中にページごとにリストするオブジェクトの最大数。デフォルト値: 1000。有効な値: 1~1000。

--query-param

stringArray

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

-r, --recursive

/

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

--request-payer

string

リクエストの支払者。バケットでリクエスト元支払いモードが有効になっている場合は、このパラメーターを 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"