Object Storage Service:cp (ファイルのダウンロード)

パラメーター

タイプ

説明

local-path

string

相対パス、絶対パス、および - をサポートします。- を指定すると、出力は標準出力に出力されます。

prefix

string

オブジェクトのプレフィックス。プレフィックスが「/」で終わる場合は、バッチ操作のみがサポートされます。「/」で終わらない場合は、コマンドラインオプションに基づいて、単一オブジェクトまたはバッチダウンロードのいずれかが実行されます。

--acl

string

オブジェクトのアクセス権限。有効な値は以下のとおりです。

• private：非公開。

• public-read：公開読み取り。

• public-read-write：公開読み書き。

• default：バケットから継承。

--bandwidth-limit

SizeSuffix

ネットワーク帯域幅を制限してデータ転送レートをコントロールします。最小値は 1024 B/s です。デフォルトの単位は B/s です。

帯域幅の値に単位を指定できます。サポートされる単位は、B（バイト）、K（キロバイト）、M（メガバイト）、G（ギガバイト）です。たとえば、50 M と指定すると、制限値は 50 MB/s になります。

--bigfile-threshold

SizeSuffix

大規模ファイルに対してマルチパートアップロード、ダウンロード、またはコピーを有効にするしきい値（デフォルト：104857600）。

--cache-control

string

Web ブラウザーによってオブジェクトがダウンロードされた際のキャッシュ動作を指定します。

--checkers

int

同時チェック数（デフォルト：16）。

--checkpoint-dir

string

再開可能なダウンロードのチェックポイント情報を保存するディレクトリ（デフォルト：.ossutil_checkpoint/）。

--content-disposition

string

オブジェクトの表示方法を指定します。

--content-encoding

string

オブジェクトのエンコーディング方式を宣言します。

--content-type

string

オブジェクトのコンテンツタイプ。

--copy-props

string

メタデータおよびタグのコピー方法を制御します。有効な値は以下のとおりです。

• none：コピーしない。

• metadata：メタデータをコピーする。

• default：メタデータとタグの両方をコピーする。

-d, --dirs

string

現在のディレクトリ内のファイルおよびサブディレクトリをダウンロードしますが、ネストされたサブディレクトリ内のすべてのファイルを再帰的にダウンロードすることはありません。

--encoding-type

string

入力オブジェクト名またはファイル名のエンコーディング方式。有効な値：url。

--end-with

string

アルファベット順で指定された値以前または一致するオブジェクトを返します。

--exclude

stringArray

パスまたはファイル名に対する除外ルール。

--exclude-from

stringArray

ファイルから除外ルールを読み取ります。

--expires

string

キャッシュされたコンテンツの絶対的な有効期限を指定します。

--files-from

stringArray

ファイルからソースファイル名のリストを読み取ります。空行またはコメント行は無視されます。フィルタリングシナリオでのみ適用されます。

--files-from-raw

stringArray

ファイルからソースファイル名のリストを読み取ります。フィルタリングシナリオでのみ適用されます。

--filter

stringArray

パスまたはファイル名に対するフィルタリングルール。

--filter-from

stringArray

ファイルからフィルタリングルールを読み取ります。

-f, --force

/

確認プロンプトを表示せずに強制的に操作を実行します。

--include

stringArray

パスまたはファイル名に対する包含ルール。

--include-from

stringArray

ファイルから包含ルールを読み取ります。

-j, --job

int

同時タスク数（デフォルト：3）。

--list-objects

/

ListObjects API を使用してオブジェクトを一覧表示します。

--max-size

SizeSuffix

転送するファイルの最大サイズ。デフォルトの単位はバイトです。接尾辞 B|K|M|G|T|P を追加できます。注：1K (KiB) = 1024B。

--metadata

strings

key=value 形式のオブジェクトに対するユーザー定義メタデータ。

--metadata-directive

string

送信先オブジェクトのメタデータ設定方法を指定します。有効な値は以下のとおりです。

• COPY

• REPLACE

--metadata-exclude

stringArray

オブジェクトのメタデータに対する除外ルール。

--metadata-filter

stringArray

オブジェクトのメタデータに対するフィルタリングルール。

--metadata-filter-from

stringArray

ファイルからオブジェクトのメタデータフィルタリングルールを読み取ります。

--metadata-include

stringArray

オブジェクトのメタデータに対する包含ルール。

--min-age

Duration

指定された時間間隔より前に変更されたファイルのみをダウンロードします。デフォルトの単位は秒です。h（時間）などの接尾辞を使用できます。たとえば、1h は 1 時間を意味します。

--max-age

Duration

指定された時間間隔以内に変更されたファイルのみをダウンロードします。デフォルトの単位は秒です。h（時間）などの接尾辞を使用できます。たとえば、1h は 1 時間を意味します。

--min-mtime

Time

指定された時刻以降に変更されたファイルのみをダウンロードします。時刻形式：UTC（例：2006-01-02T15:04:05）。

--max-mtime

Time

指定された時刻以前に変更されたファイルのみをダウンロードします。時刻形式：UTC（例：2006-01-02T15:04:05）。

--min-size

SizeSuffix

転送するファイルの最小サイズ。デフォルトの単位はバイトです。接尾辞 B|K|M|G|T|P を追加できます。注：1K (KiB) = 1024B。

--no-progress

/

進行状況バーを表示しません。

--page-size

int

バッチダウンロード中に 1 ページあたりに一覧表示されるオブジェクトの最大数（デフォルト：1000）。有効範囲：1～1000。

--parallel

int

単一ファイルに対する内部操作の同時タスク数。

--part-size

SizeSuffix

マルチパート操作時のパーツサイズ。デフォルトでは、ossutil がファイルサイズに基づいて適切なパーツサイズを自動計算します。有効範囲：100 KiB～5 GiB。

-r, --recursive

/

再帰的に操作を実行します。このオプションを指定すると、コマンドはバケット内のすべての一致するオブジェクトに対して操作を行います。指定しない場合は、パスで指定されたオブジェクトに対してのみ操作を行います。

--request-payer

string

リクエストの支払い方法。バケットがリクエスト元支払いモードを使用している場合は、これを requester に設定します。

--size-only

/

送信先ファイルとサイズが異なるソースファイルのみをダウンロードします。

--start-after

string

アルファベット順で指定された値より後のオブジェクトを返します（指定された値自体は含みません）。

--storage-class

string

オブジェクトのストレージクラス。有効な値は以下のとおりです。

• Standard：標準ストレージ。

• IA：低頻度アクセスストレージ。

• Archive：アーカイブストレージ。

• ColdArchive：コールドアーカイブストレージ。

• DeepColdArchive：ディープコールドアーカイブストレージ。

--tagging

strings

key=value 形式のオブジェクトに対するタグ。

--tagging-directive

string

送信先オブジェクトのタグ設定方法を指定します。有効な値は以下のとおりです。

• COPY

• REPLACE

-u, --update

/

送信先にすでに存在し、かつソースファイルよりも新しい更新時刻を持つファイルをスキップします。

--ignore-existing

/

送信先にすでに存在するファイルをスキップします。

--version-id

string

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

--write-buffer-size

SizeSuffix

書き込みに使用するメモリバッファーのサイズ。4 KB 境界に自動的にアラインされます。接尾辞 B / K / M をサポート（デフォルト：128 KiB）。有効範囲：0～32 MiB。