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 時間を示します。 説明
|
--max-age | Duration | 指定された時間間隔内に変更されたファイルのみを処理します。デフォルトの単位は秒です。単位のサフィックスを使用できます。たとえば、1h は 1 時間を示します。 説明
|
--min-mtime | Time | 指定された時刻以降に変更されたファイルのみを処理します。時間フォーマット: UTC。例: 2006-01-02T15: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.txtexamplebucket バケット内の example.txt オブジェクトに対して、有効期間が 1 時間の署名付き URL を生成します。
ossutil presign oss://examplebucket/example.txt --expires-duration 1hexamplebucket バケット内の example.txt オブジェクトに対して、2024-06-01T12:00:00 (UTC) まで有効な署名付き URL を生成します。
ossutil presign oss://examplebucket/example.txt --expires-date 2024-06-01T12:00:00examplebucket バケット内の example.txt オブジェクトに対して、イメージ処理パラメーターを含む署名付き URL を生成します。
ossutil presign oss://examplebucket/example.txt --query-param x-oss-process=image/resize,m_fixed,w_100,h_100/rotate,90examplebucket バケット内の example.txt オブジェクトの「123」バージョンの署名付き URL を生成します。
ossutil presign oss://examplebucket/example.txt --version-id 123examplebucket バケット内の「folder」ディレクトリ内のオブジェクトに対して、有効期間が 15 分の署名付き URL を生成します。
ossutil presign oss://examplebucket/folder/ -rexamplebucket バケットの「folder」ディレクトリ内の TXT オブジェクトに対して、デフォルトの有効期間が 15 分の署名付き URL を生成します。
ossutil presign oss://examplebucket/folder/ -r --include "*.txt"