すべてのプロダクト
Search
ドキュメントセンター

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

最終更新日:Nov 15, 2025

ossutil cp コマンドを使用して、ファイル、イメージ、ビデオなどのローカルリソースを OSS にアップロードします。 このコマンドを使用して、大きなファイルをアップロードすることもできます。

注意事項

  • ファイルをアップロードするには、oss:PutObjectoss:ListParts、および oss:AbortMultipartUpload 権限が必要です。 詳細については、「RAM ユーザーへのカスタムアクセスポリシーの付与」をご参照ください。

  • バッチアップロードは、ソースがディレクトリの場合にのみサポートされます。

コマンド構文

ossutil cp source dest [flags]

パラメーター

タイプ

説明

source

string

ローカルファイルのパス。 相対パス、絶対パス、および - がサポートされています。 - を指定すると、データは標準入力から読み取られます。

dest

string

宛先バケット内のオブジェクトファイルのパス。 例: oss://bucket[/prefix]

--acl

string

オブジェクトのアクセス制御リスト (ACL)。 有効値:

  • private: 非公開。

  • public-read: 公開読み取り。

  • public-read-write: 公開読み書き。

  • default: バケットの ACL を継承します。

--bigfile-threshold

int

大きなファイルのマルチパートアップロード、ダウンロード、またはコピーを有効にするためのサイズしきい値。 デフォルト値は 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 です。

説明

このパラメーターは、-f--update--size-only、または --ignore-existing パラメーターを指定した場合にのみ有効になります。

--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 時間を表します。

説明

--min-age 1h は、1 時間以上経過したファイルのみをアップロードします。

--max-age

Duration

指定された期間内に変更されたファイルのみをアップロードします。 デフォルトの単位は秒です。 サフィックスを使用して単位を指定できます。 たとえば、1h は 1 時間を表します。

説明

--max-age 1h は、過去 1 時間以内に変更されたファイルのみをアップロードします。

--min-mtime

Time

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

説明

--min-mtime "2006-01-02T15:04:05" は、2006 年 1 月 2 日 15: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

各パートのサイズ。 デフォルトでは、ファイルサイズに基づいて適切なパートサイズが自動的に計算されます。 値は 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

/

既存のオブジェクトファイルをスキップします。

説明

詳細については、「コマンドラインオプション」をご参照ください。

宛先オブジェクトの命名規則は次のとおりです。

  • 単一ファイルのアップロードの場合、プレフィックスが空の場合、オブジェクト名はファイル名になります。

  • 単一ファイルのアップロードの場合、プレフィックスが「/」で終わる場合、オブジェクト名はプレフィックス + ファイル名になります。

  • バッチアップロードの場合、プレフィックスが空の場合、オブジェクト名はソースファイルの相対パスになります。

  • バッチアップロードの場合、プレフィックスが「/」で終わる場合、オブジェクト名はプレフィックス + ソースファイルの相対パスになります。

  • バッチアップロードの場合、プレフィックスが「/」で終わらない場合、オブジェクト名はプレフィックス + 「/」 + ソースファイルの相対パスになります。

説明

ソースファイルの相対パスは、ルートディレクトリの後に始まります。 たとえば、コマンド `cp /root/dir/ ...` の場合、ファイル `/root/dir/subdir/test.txt` の相対パスは `subdir/test.txt` です。

  • 単一ファイルのアップロード

    ローカルファイル examplefile.txt を examplebucket の desfolder フォルダにアップロードします。

    ossutil cp D:/localpath/examplefile.txt oss://examplebucket/desfolder/
  • フォルダ内のファイルのみをアップロードする

    ローカルの localfolder ディレクトリから examplebucket の desfolder フォルダにファイルをアップロードします。

    ossutil cp -r D:/localpath/localfolder/ oss://examplebucket/desfolder/
  • 条件を満たすファイルのバッチアップロード

    TXT 形式のすべてのファイルをアップロードします。

    ossutil cp -r D:/localpath/localfolder/ oss://examplebucket/desfolder/ --include "*.txt"
  • 10 個の同時タスクを使用してファイルをバッチアップロードする

    ossutil cp -r D:/localpath/localfolder/ oss://examplebucket/desfolder/ -f -j 10