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

パラメーター

型

説明

source

string

ローカルファイルのパスです。相対パス、絶対パス、または - を指定できます。- を指定した場合、ossutil は標準入力からデータを読み込みます。

dest

string

送信先オブジェクトのパスで、oss://bucket[/prefix] の形式で指定します。

--acl

string

オブジェクトのアクセス制御リスト (ACL) です。有効な値は以下のとおりです。

• private

• public-read

• public-read-write

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

--bandwidth-limit

SizeSuffix

データ転送レートの制限値です。最小値は 1024 B/s です。デフォルト単位は B/s です。

帯域幅値に単位を明示的に指定できます（例：B（バイト）、K（キロバイト）、M（メガバイト）、G（ギガバイト））。たとえば、50M は 50 MB/s の帯域幅制限を意味します。

--bigfile-threshold

SizeSuffix

マルチパートアップロード、ダウンロード、またはコピーを開始するファイルサイズのしきい値です。デフォルト値は 104857600 バイト（100 MiB）です。

--cache-control

string

ブラウザなどのクライアントがオブジェクトをどのようにキャッシュするかを指定します。

--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 などの接尾辞を指定できます。1 K（KiB）＝ 1024 B です。

--metadata

strings

キー＝値の形式でオブジェクトのユーザーメタデータを指定します。

--metadata-directive

string

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

• COPY

• REPLACE

--metadata-exclude

stringArray

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

--metadata-filter

stringArray

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

--metadata-filter-from

stringArray

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

--metadata-include

stringArray

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

--min-age

Duration

指定された時間間隔以上前に変更されたファイルのみをアップロードします。デフォルトの単位は秒です。1 時間を意味する「1h」などの単位接尾辞を使用できます。

--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

バッチアップロード時のページ分割リクエストで、1 回のリクエストで一覧表示するオブジェクトの最大数です。値の範囲は 1～1,000 です。デフォルト値は 1000 です。

--parallel

int

単一の大きなファイルの場合、同時にアップロードするパート数を設定します。

--part-size

SizeSuffix

マルチパートアップロードにおける各パートのサイズです。デフォルトでは、ossutil がファイルサイズに基づいて最適なパートサイズを自動計算します。値の範囲は 100 KiB～5 GiB です。

-r, --recursive

/

ディレクトリをアップロードする場合、すべてのファイルおよびサブディレクトリを再帰的にアップロードするには、このオプションを指定する必要があります。

--request-payer

string

リクエストの支払者を指定します。送信先バケットで「Requester Pays」モードが有効になっている場合は、requester を指定します。

--size-only

/

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

--storage-class

string

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

• Standard

• IA

• Archive

• Cold Archive

• Deep Cold Archive

--tagging

strings

キー＝値の形式でオブジェクトのタグを指定します。複数のタグを追加するには、このオプションを複数回指定できます。

--tagging-directive

string

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

• COPY

• REPLACE

-u, --update

/

ソースファイルが送信先ファイルより新しい場合、または送信先ファイルが存在しない場合にのみ、ファイルをアップロードします。

--ignore-existing

/

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