tencent cloud

フィードバック

ファイルのアップロード・ダウンロードまたはコピー - cp

最終更新日:2024-06-26 10:27:35
    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
    
    お問い合わせ

    カスタマーサービスをご提供できるため、ぜひお気軽にお問い合わせくださいませ。

    テクニカルサポート

    さらにサポートが必要な場合は、サポートチケットを送信して弊社サポートチームにお問い合わせください。24時間365日のサポートをご提供します。

    電話サポート(24 時間365日対応)