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

指定された時間間隔より前に変更されたファイルのみをダウンロードします。デフォルト単位は秒です。単位サフィックスを使用できます。たとえば、`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`。

--min-size

SizeSuffix

転送する最小ファイルサイズを制限します。デフォルト単位はバイトです。B|K|M|G|T|P などの単位サフィックスも使用できます。1K (KiB) = 1024B。

--no-progress

/

プログレスバーを表示しません。

--page-size

int

バッチダウンロード中にオブジェクトをページ分割する最大値 (デフォルト: 1000)。有効値: 1 ～ 1000。

--parallel

int

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

--part-size

SizeSuffix

シャードサイズ。デフォルトでは、システムはファイルサイズに基づいて適切なシャードサイズを計算します。有効値: 100 KiB ～ 5 GiB。

-r, --recursive

/

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

--request-payer

string

リクエストの支払い方法。リクエスト元支払いモードを使用する場合は、この値を設定します。有効値: `requester`。

--size-only

/

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

--start-after

string

指定された値より後のオブジェクトをアルファベット順に返します (指定された値を含まない)。

--storage-class

string

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

• Standard: 標準ストレージ。

• IA (Infrequent Access) storage class: 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。