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

パラメーター

タイプ

説明

local-path

string

ローカルパス。 相対パス、絶対パス、および - がサポートされています。 - を指定すると、出力は標準出力に送信されます。

prefix

string

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

--acl

string

オブジェクトのアクセス権限。 有効な値:

• private: オブジェクトは非公開です。

• public-read: オブジェクトは公開読み取りです。

• public-read-write: オブジェクトは公開読み書きです。

• default: オブジェクトはバケットの ACL を継承します。

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

--max-size

SizeSuffix

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

--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 などの単位サフィックスも使用できます。1 K (KiB) = 1024 B。

--no-progress

/

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

--page-size

int

バッチダウンロードでページごとにリストするオブジェクトの最大数。 デフォルト値は 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

/

既存の宛先ファイルをスキップします。