ossutil cp コマンドを使用して、ファイル、イメージ、ビデオなどのローカルリソースを OSS にアップロードします。 このコマンドを使用して、大きなファイルをアップロードすることもできます。
注意事項
ファイルをアップロードするには、
oss:PutObject、oss:ListParts、およびoss:AbortMultipartUpload権限が必要です。 詳細については、「RAM ユーザーへのカスタムアクセスポリシーの付与」をご参照ください。バッチアップロードは、ソースがディレクトリの場合にのみサポートされます。
コマンド構文
ossutil cp source dest [flags]パラメーター | タイプ | 説明 |
source | string | ローカルファイルのパス。 相対パス、絶対パス、および |
dest | string | 宛先バケット内のオブジェクトファイルのパス。 例: |
--acl | string | オブジェクトのアクセス制御リスト (ACL)。 有効値:
|
--bigfile-threshold | int | 大きなファイルのマルチパートアップロード、ダウンロード、またはコピーを有効にするためのサイズしきい値。 デフォルト値は 104857600 です。 |
--cache-control | string | オブジェクトがダウンロードされるときの Web ページのキャッシュ動作を指定します。 |
--content-disposition | string | オブジェクトの表示方法を指定します。 |
--content-encoding | string | オブジェクトのエンコーディングを指定します。 |
--content-type | string | オブジェクトのコンテンツタイプ。 |
--copy-props | string | ソースファイルからコピーするプロパティを決定します。 有効値:
|
--checkpoint-dir | string |
|
-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 | 宛先オブジェクトのメタデータの設定方法を指定します。 有効値:
|
--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 | 各パートのサイズ。 デフォルトでは、ファイルサイズに基づいて適切なパートサイズが自動的に計算されます。 値は 100 KiB から 5 GiB の範囲である必要があります。 |
-r, --recursive | / | 再帰的な操作を実行します。 指定すると、コマンドはバケット内の一致するすべてのオブジェクトに影響します。 それ以外の場合は、指定されたパスのオブジェクトにのみ影響します。 |
--request-payer | string | リクエストの支払方法。 リクエスト元支払いモードを使用する場合は、この値を requester に設定します。 |
--size-only | / | サイズが異なるソースファイルのみをアップロードします。 |
--storage-class | string | オブジェクトのストレージクラス。 有効値:
|
--tagging | strings | オブジェクトのタグを指定します。 key=value 形式を使用します。 |
--tagging-directive | string | 宛先オブジェクトにタグを付ける方法を指定します。 有効値:
|
-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