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

指定された時刻 (例：2006-01-02T15:04:05) 以降に変更されたファイルのみをアップロードします。

--max-mtime

Time

指定された時刻 (例：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

マルチパートアップロードのパートサイズ。デフォルトでは、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

/

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

--enable-symlink-dir

/

アップロード中にシンボリックリンク (symlink) のサブディレクトリをたどってアップロードします。デフォルトでは、cp コマンドはディレクトリのアップロード時にシンボリックリンクされたサブディレクトリをスキップします。このオプションを指定すると、コマンドはシンボリックリンクされたサブディレクトリのコンテンツを再帰的にアップロードします。

-j, --job

10

複数のファイルをアップロードするための同時タスク数。デフォルト値：3。このオプションは、-f、--update、--size-only、または --ignore-existing も指定した場合にのみ有効になります。

--parallel

10

単一ファイルに対する内部操作 (マルチパートアップロードなど) の同時タスク数。この値を増やすと、単一の大容量ファイルのアップロードが高速化されます。

--checkpoint-dir

/path/to/checkpoint

再開可能なアップロードに使用されるディレクトリ。