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 などのサフィックスも使用できます。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

/

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

--storage-class

string

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

• Standard: 標準

• IA: 低頻度アクセス

• Archive: アーカイブストレージ

• ColdArchive: コールドアーカイブ

• DeepColdArchive: ディープコールドアーカイブ

--tagging

strings

オブジェクトのタグを指定します。key=value フォーマットを使用します。

--tagging-directive

string

宛先オブジェクトのタグの設定方法を指定します。有効な値:

• COPY

• REPLACE

-u, --update

/

宛先ファイルよりも新しいソースファイルのみをアップロードします。

--ignore-existing

/

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