Object Storage Service:cp (ファイルのアップロード)

パラメーター

タイプ

説明

source

string

ローカルファイルパス。相対パス、絶対パス、および - をサポートします。- に設定すると、標準入力からデータを読み取ります。

dest

string

送信先バケット内のファイルパス。例：oss://bucket[/prefix]。

--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 ブラウザーによるオブジェクトのダウンロード時のキャッシュ動作を指定します。

--content-disposition

string

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

--content-encoding

string

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

--content-type

string

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

--copy-props

string

ソースオブジェクトからコピーするプロパティを決定します。有効値：

• none

• metadata

• default

--checkpoint-dir

string

• チェックポイントディレクトリパスを指定しない場合、再開可能なアップロードは無効になります。

• ディレクトリを指定した場合、再開可能なアップロードが有効になり、チェックポイントファイルは指定されたパス下の .ossutil_checkpoint サブディレクトリに保存されます。

-d, --dirs

string

サブディレクトリ内のすべてのファイルを再帰的にリストすることなく、現在のディレクトリ内のファイルおよびサブディレクトリをリストします。

--encoding-type

string

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

--end-with

string

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

--exclude

stringArray

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

--exclude-from

stringArray

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

--expires

stringArray

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

--files-from

stringArray

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

--files-from-raw

stringArray

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

--filter

stringArray

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

--filter-from

stringArray

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

-f, --force

/

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

--include

stringArray

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

--include-from

stringArray

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

-j, --job

int

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

--listObjects

/

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

/

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

--storage-class

string

オブジェクトのストレージクラス。有効値：

• Standard：標準ストレージ。

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

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

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

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

--tagging

strings

key=value 形式のオブジェクトのタグ。

--tagging-directive

string

送信先オブジェクトのタグの設定方法を指定します。有効値：

• COPY

• REPLACE

-u, --update

/

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

--ignore-existing

/

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