tencent cloud

cpコマンドは、ファイルをアップロード、ダウンロードまたはコピーするときに使います。

コマンド形式

./coscli cp <source_path> <destination_path> [flags]

説明：

? bucketAliasについては、ダウンロードとインストール設定をご参照ください。

• このコマンドのその他の共通オプション（例えばバケットの切り替え、ユーザーアカウントの切り替えなど）に関しては、共通オプションのドキュメントをご参照ください。

cpコマンドには、以下のオプションflagが含まれます。

flagの略称	flagの正式名称	flagの用途
なし	--include	特定のモードを含むファイル
なし	--exclude	特定のモードを除外したファイル
-r	--recursive	フォルダ内のすべてのファイルを再帰的にトラバーサル処理するかどうか
なし	--storage-class	アップロードするファイルのタイプを指定（デフォルトはSTANDARD）
なし	--part-size	ファイルチャンクサイズ（デフォルトは32MB）、単位：MB
なし	--thread-num	同時実行スレッド数（デフォルトの同時実行は5）
なし	--rate-limiting	シングルリンクレート制限(0.1～100MB/s)、単位：MB/s
なし	--meta	アップロードファイルのメタ情報。一部のHTTP標準属性（HTTP Header）およびx-cos-meta-で始まるユーザーカスタムメタデータ（User Meta）が含まれます。ファイルメタ情報の形式はheader:value#header:valueであり、例えばExpires:2022-10-12T00:00:00.000Z#Cache-Control:no-cache#Content-Encoding:gzip#x-cos-meta-x:xのようになります。

説明：

-cpコマンドは、大容量ファイルのアップロードやダウンロードを行う場合、アップロード/ダウンロードの同時実行を自動的に有効にします。

• ファイルが--part-sizeよりも大きい場合、COSCLIはまず--part-sizeに従ってファイルをチャンクにし、次に--thread-num個のスレッドを使用してアップロード/ダウンロードのタスクを同時に実行します。
• 各スレッドは1つのリンクを維持します。各リンクに対して--rate-limitingパラメータを使用すると、シングルリンクのレート制限ができます。同時アップロード/ダウンロードが有効な場合、合計レートは、--thread-num * --rate-limitingとなります。
• ファイルをチャンクでアップロード/ダウンロードする場合、デフォルトで中断からの再開が有効になります。
• --includeと--excludeは標準的な正規表現の構文をサポートしており、これを使えば特定の条件を満たすファイルをフィルタリングすることができます。
• zshを使用する場合、pattern文字列の両端に二重引用符を付ける必要がある場合があります。

./coscli cp ~/test/ cos://bucket1/example/ -r --include ".*.txt" --meta=x-cos-meta-a:a#ContentType:text#Expires:2022-10-12T00:00:00.000Z

操作事例

アップロード操作

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

./coscli cp ~/example.txt cos://bucket1/example.txt

ローカルのtestフォルダにあるすべてのファイルをbucket1内のexampleフォルダにアップロードします

./coscli cp ~/test/ cos://bucket1/example/ -r

ローカルのtestフォルダにあるすべての.mp4タイプのファイルをbucket1内のexampleフォルダにアップロードします

./coscli cp ~/test/ cos://bucket1/example/ -r --include .*.mp4

ローカルのtestフォルダにあるすべての.mdタイプではないファイルをbucket1内のexampleフォルダにアップロードします

./coscli cp ~/test/ cos://bucket1/example/ -r --exclude .*.md

ローカルのdirフォルダにはdirA、dirB、dirC、dirDという4つのフォルダがあり、dirフォルダにあるdirDフォルダを除くすべての内容をアップロードします

./coscli cp dir/ cos://bucket1/example/ -r --exclude dirD/.*

ローカルのtestフォルダにあるすべてのファイルをbucket1内のexampleフォルダにアップロードし、アーカイブタイプのファイルとして保存します

./coscli cp ~/test/ cos://bucket1/example/ -r --storage-class ARCHIVE

ローカルのfile.txtファイルをバケットbucket1にアップロードし、シングルリンクレート制限を1.3MB/sに設定します

./coscli cp ~/file.txt cos://bucket1/file.txt --rate-limiting 1.3

ダウンロード操作

単一ファイルのダウンロード

./coscli cp cos://bucket1/example.txt ~/example.txt

bucket1のexampleフォルダにあるすべてのファイルをローカルのtestフォルダにダウンロードします

./coscli cp cos://bucket1/example/ ~/test/ -r

bucket1のexampleフォルダにあるすべての.mp4タイプのファイルをローカルのtestフォルダにダウンロードします

./coscli cp cos://bucket1/example/ ~/test/ -r --include .*.mp4

bucket1のexampleフォルダにあるすべての.mdタイプではないファイルをローカルのtestフォルダにダウンロードします

./coscli cp cos://bucket1/example/ ~/test/ -r --exclude .*.md

コピー操作

バケット内の単一ファイルのコピー

./coscli cp cos://bucket1/example.txt cos://bucket1/example_copy.txt

バケット間の単一ファイルのコピー

./coscli cp cos://bucket1/example.txt cos://bucket2/example_copy.txt

bucket1のexample1フォルダにあるすべてのファイルをbucket2のexample2フォルダにコピーします

./coscli cp cos://bucket1/example1/ cos://bucket2/example2/ -r

bucket1のexample1フォルダにあるすべての.mp4タイプのファイルをbucket2のexample2フォルダにコピーします

./coscli cp cos://bucket1/example1/ cos://bucket2/example2/ -r --include .*.mp4

bucket1のexample1フォルダにあるすべての.mdタイプではないファイルをbucket2のexample2フォルダにコピーします

./coscli cp cos://bucket1/example1/ cos://bucket2/example2/ -r --exclude .*.md