tencent cloud

Cloud Object Storage

ドキュメントCloud Object StorageツールガイドCOSCMDツール

COSCMDツール

Download
フォーカスモード
フォントサイズ
最終更新日: 2026-07-15 10:50:14

機能説明

COSCMDツールを使用すると、ユーザーは簡単なコマンドラインコマンドでオブジェクト（Object）の一括アップロード、ダウンロード、削除などの操作を実現できます。

利用環境

システム環境

Windows、Linux、macOSシステムをサポートします。
説明：
ローカルの文字フォーマットがUTF-8であることを確認してください。そうしないと、中国語版のファイルを操作する際に問題が発生する可能性があります。
ローカルマシンの時刻が国際標準時（UTC）と調整されていることを確認してください。誤差が大きすぎる場合、正常に使用できなくなる可能性があります。

ソフトウェア依存

Python 2.7およびPython 3。
最新バージョンのpip。
説明：
ユーザーはpipが統合されたPythonバージョンを直接インストールすることをお勧めします。
Pythonバージョンが3.12の場合、pipで依存ライブラリをインストールする際に失敗しやすいため、ソースコードからのインストールをお勧めします。

インストールと設定

環境のインストールと設定の詳細な操作については、Python インストールと設定をご参照ください。
pip環境のインストールと設定の詳細な操作については、公式サイトのpipインストール説明をご参照ください。

ダウンロードとインストール

以下では、ユーザーにCOSCMDをインストールする3つの方法を提供します。

方式一： pipによるインストール（推奨）

以下のpipコマンドを実行してインストールしてください。
pip install coscmd
インストールが成功した後、ユーザーは-vまたは--versionコマンドで現在のバージョン情報を確認できます。
注意：
Windowsでインストールした後、C:\\python_install_dirとC:\\python_install_dir\\Scriptsの2つのパスを環境変数に追加する必要があります。
2. インストールが完了した後、以下のコマンドを実行して更新してください。
pip install coscmd -U

方法2：ソースコードからのインストール

注意：
Pythonバージョンが3.12の場合、pipで依存ライブラリをインストールする際に失敗しやすいため、このメソッドを使用してインストールすることをお勧めします。
ソースコードのダウンロードURL：ここをクリック。
git clone https://github.com/tencentyun/coscmd.git
cd coscmd
python setup.py install

方法3：オフラインインストール

注意：
ターゲットマシンがネットワーク接続できないためオンラインインストールができない場合は、まずネットワーク接続可能なマシンを見つけてオフラインインストールパッケージをダウンロードし、その後そのオフラインインストールパッケージをネットワーク接続不可のターゲットマシンにコピーしてインストールしてください。
2台のマシンのPythonバージョンが一致していることを確認してください。そうしないと、インストールが失敗する場合があります。
# インターネット接続可能なマシンで以下のコマンドを実行します
mkdir coscmd-packages
pip download coscmd -d coscmd-packages
tar -czvf coscmd-packages.tar.gz coscmd-packages

# インストールパッケージをインターネット接続不可のマシンにコピーした後、以下のコマンドを実行します
tar -xzvf coscmd-packages.tar.gz
pip install coscmd --no-index -f coscmd-packages

設定パラメータ

helpオプションを確認する

ユーザーは -h または --help コマンドでツールのヘルプ情報と使用方法を確認できます。
coscmd -h
help情報は以下の通りです。
usage: coscmd [-h] [-d] [-s] [-b BUCKET] [-r REGION] [-c CONFIG_PATH]
              [-l LOG_PATH] [--log_size LOG_SIZE]
              [--log_backup_count LOG_BACKUP_COUNT] [-v]
              {config,upload,download,delete,abort,copy,move,list,listparts,info,restore,signurl,createbucket,deletebucket,putobjectacl,getobjectacl,putbucketacl,getbucketacl,putbucketversioning,getbucketversioning,probe}
              ...

an easy-to-use but powerful command-line tool. try 'coscmd -h' to get more
informations. try 'coscmd sub-command -h' to learn all command usage, likes
'coscmd upload -h'

positional arguments:
  {config,upload,download,delete,abort,copy,move,list,listparts,info,restore,signurl,createbucket,deletebucket,putobjectacl,getobjectacl,putbucketacl,getbucketacl,putbucketversioning,getbucketversioning,probe}
    config              Config your information at first
    upload              Upload file or directory to COS
    download            Download file from COS to local
    delete              Delete file or files on COS
    abort               Aborts upload parts on COS
    copy                Copy file from COS to COS
    move                move file from COS to COS
    list                List files on COS
    listparts           List upload parts
    info                Get the information of file on COS
    restore             Restore
    signurl             Get download url
    createbucket        Create bucket
    deletebucket        Delete bucket
    putobjectacl        Set object acl
    getobjectacl        Get object acl
    putbucketacl        Set bucket acl
    getbucketacl        Get bucket acl
    putbucketversioning
                        Set the versioning state
    getbucketversioning
                        Get the versioning state
    probe               Connection test

optional arguments:
  -h, --help            show this help message and exit
  -d, --debug           Debug mode
  -s, --silence         Silence mode
  -b BUCKET, --bucket BUCKET
                        Specify bucket
  -r REGION, --region REGION
                        Specify region
  -c CONFIG_PATH, --config_path CONFIG_PATH
                        Specify config_path
  -l LOG_PATH, --log_path LOG_PATH
                        Specify log_path
  --log_size LOG_SIZE   specify max log size in MB (default 1MB)
  --log_backup_count LOG_BACKUP_COUNT
                        specify log backup num
  -v, --version         show program's version number and exit
それ以外にも、ユーザーは各コマンドの後（パラメータなし）に -h を入力して、そのコマンドの具体的な使用方法を確認できます。以下に示します。
# uploadコマンドの使用方法を確認します
coscmd upload -h

configコマンドを使用して設定ファイルを生成します

注意：
ユーザーには一時キーを使用してツールを操作することをお勧めします。一時的な権限付与によって、ツール使用時のセキュリティをさらに向上させることができます。一時キーを申請する際には、最小権限の原則に従い、対象のバケットまたはオブジェクト以外のリソースの漏洩を防止してください。
どうしても永続キーを使用する必要がある場合は、最小権限の原則に従って永続キーの権限範囲を制限することをお勧めします。
configコマンドは~/.cos.confに設定ファイルを自動生成します。コマンドの具体的な形式は以下の通りです。
coscmd config [OPTION]...<FILE>...
              [-h] --help
              [-a] <SECRET_ID>
              [-s] <SECRET_KEY>
              [-t] <TOKEN>
              [-b] <BucketName-APPID>
              [-r] <REGION> | [-e] <ENDPOINT>
              [-m] <MAX_THREAD>
              [-p] <PART_SIZE>
              [--do-not-use-ssl]
              [--anonymous]
説明：
ここで、"[]" 内のフィールドはオプションであり、"<>" 内のフィールドは入力が必要なパラメータです。
パラメータ設定の説明は以下の通りです。
オプション
パラメータ説明
有効値
必須
-a
APIキーIDは、APIキーコンソールに移動して取得してください。
文字列
はい
-s
APIキーKeyは、APIキーコンソールに移動して取得してください。
文字列
はい
-t
一時キーtokenは、一時キーを使用する場合に設定が必要で、x-cos-security-tokenヘッダーを設定します。
文字列
いいえ
-b
指定のバケット名です。バケットの命名形式は BucketName-APPID です。命名规范をご参照ください。初めて設定して使用する際は、COSコンソールでバケットを作成し、ツールの設定に使用します。
文字列
はい
-r
バケットの所在リージョンについては、リージョンとアクセスドメインをご参照ください。
文字列
はい
-e
リクエストのENDPOINTを設定します。ENDPOINTパラメータを設定すると、REGIONパラメータは無効になります。デフォルトドメインを使用している場合は、ここでの設定形式はcos.<region>.myqcloud.comです。グローバルアクセラレーションドメインを使用している場合は、cos.accelerate.myqcloud.comに設定します。
文字列
いいえ
-m
マルチスレッド操作の最大スレッド数を指定します（デフォルトは5）。ファイルのアップロードが遅い場合は、この値を適宜引き上げることができます。スレッド数はマシンの性能に依存します。マシンがサポートする最大スレッド数が30であると仮定した場合、同時実行スレッドを30に調整すると、マシンの性能を十分に活用できます。実行コマンドはcoscmd config -m 30です。
数字
いいえ
-p
チャンク操作の単一チャンクサイズ（単位MB、デフォルトは1MB、範囲は1 - 1000）。ファイルのアップロードが遅い場合は、この値を適宜引き上げることができます。
数字
いいえ
--do-not-use-ssl
HTTPプロトコルを使用し、HTTPSは使用しません。
文字列
いいえ
--anonymous
匿名操作（署名を付与しない）。
文字列
いいえ
configコマンドの使用例は以下の通りです：
coscmd config -a AChT4ThiXAbpBDEFGhT4ThiXAbp**** -s WE54wreefvds3462refgwewe**** -b configure-bucket-1250000000 -r ap-chengdu

設定ファイルを生成する

COSCMDツールは実行時に設定ファイルから必要な情報を読み取ります。COSCMDがデフォルトで読み取る設定ファイルのパスは~/.cos.confです。設定ファイルのパスを変更する場合は、設定ファイルとログファイルのパスを指定するコマンドを参照してください。
説明：
設定の前に、まずCOSコンソールで設定パラメータ用のバケット（例：configure-bucket-1250000000）を作成して、バケットの作成を参照してください。その後、キー情報を作成して、メインアカウントアクセスキー管理を参照してください。
設定ファイルの例は以下の通りです。
[common]
secret_id = ************************************
secret_key = ************************************
bucket = configure-bucket-1250000000
region = ap-chengdu
max_thread = 5
part_size = 1
retry = 5
timeout = 60
schema = https
verify = md5
anonymous = False
説明：
設定ファイルのtimeout項目、単位は秒、データの読み書きにおけるタイムアウト時間を指します。
設定ファイルのschema項目の選択可能な値はhttpおよびhttpsで、デフォルトはhttpsです。
設定ファイルのanonymous項目、オプション値はTrueまたはFalseで、匿名モードを使用するかどうか、つまり署名を空のまま保持するかどうかを示します。
その他の設定パラメータの説明については、coscmd config -hコマンドを使用してご確認ください。

汎用コマンド

BucketとRegionを指定するコマンド

ユーザーがバケット名と所属リージョンを指定せずにコマンドを実行する場合、デフォルトでは設定パラメータ時に記入したバケットに対して有効です。異なるバケットに対して操作を実行する必要がある場合は、バケット名とリージョンを指定する必要があります。
説明：
-b <BucketName-APPID>パラメータによってバケット名を指定します。バケットの命名形式はBucketName-APPIDであり、ここに入力するバケット名はこの形式でなければなりません。
-r <region>でリージョンを指定することで、バケットの所属リージョンを指定できます。
コマンド形式。
coscmd -b <BucketName-APPID> -r <region> <action> ...
操作例：examplebucket-1250000000という名前で、所属リージョンが北京のバケットを作成します。
coscmd -b examplebucket-1250000000 -r ap-beijing createbucket
操作例：Dドライブ下のファイルpicture.jpgを、examplebucket-1250000000という名前のバケットにアップロードします。
coscmd -b examplebucket-1250000000 -r ap-beijing upload D:/picture.jpg /

設定ファイルとログファイルのパスを指定するコマンド

ユーザーが設定ファイルのパスを指定しない場合、デフォルトの設定ファイルパス~/.cos.confが使用されます。ログファイルのパスを指定しない場合、デフォルトのログファイルパス~/.cos.logが使用されます。
説明：
-c <conf_path>パラメータで設定ファイルパスを指定します。COSCMDは実行時にこのパスから設定情報を読み取ります。
-l <log_conf>パラメータでログパスを指定します。COSCMDは実行中に生成されたログをこのパス下のログファイルに出力します。
コマンド形式。
coscmd -c <conf_path> -l <log_conf> <action> ...
操作例：設定ファイルパスを/data/home/cos_conf、ログ出力パスを/data/home/cos_logに指定し、examplebucket-1250000000という名前で、所属リージョンが北京のバケットを作成します。
coscmd -c /data/home/cos_conf -l /data/home/cos_log -b examplebucket-1250000000 -r ap-beijing createbucket

Debugモードでのコマンド実行

-d または --debugを各コマンドの前に追加すると、コマンド実行中に詳細な操作情報が表示されます。例は以下の通りです。
コマンド形式。
coscmd -d upload <localpath> <cospath>
操作例：アップロード時に詳細情報を出力します。
coscmd -d upload -rs D:/folder/ /

サイレンスモードでのコマンド実行

-s または --silenceを各コマンドの前に追加すると、コマンド実行中に一切の情報が出力されなくなります。
説明：
このコマンドは最低バージョン1.8.6.24を必要とします。
コマンド形式。
coscmd -s upload <localpath> <cospath>
操作例。
coscmd -s upload D:/picture.jpg /

よく使われるバケットコマンド

バケットを作成する

説明：
コマンドを実行してバケットを作成する際には、パラメータ-b <BucketName-APPID>でバケット名を指定し、-r <Region>で所属リージョンを指定してください。coscmd createbucketを直接実行するとエラーが発生します。これは、バケット名と所属リージョンを指定しない場合、設定パラメータ時に記入した既存のバケットに対して作成操作を実行することに相当するためです。
コマンド形式。
coscmd -b <BucketName-APPID> createbucket
操作例：examplebucket-1250000000という名前で、所属リージョンが北京のバケットを作成します。
coscmd -b examplebucket-1250000000 -r ap-beijing createbucket

バケットを削除する

説明：
coscmd deletebucketの使用方法は、設定パラメータ時に指定したバケットに対してのみ有効です。-b <BucketName-APPID>でバケットを指定し、-r <region>でリージョンを指定する使用方法が推奨されます。
コマンド形式。
coscmd -b <BucketName-APPID> deletebucket
操作例：空のバケットを削除します。
coscmd -b examplebucket-1250000000 -r ap-beijing deletebucket
操作例：空でないバケットを強制的に削除します。
coscmd -b examplebucket-1250000000 -r ap-beijing deletebucket -f
注意：
-fパラメータを指定した場合、強制的にこのバケットを削除します。すべてのファイル、バージョニング有効化後の履歴フォルダ、アップロードで生成された断片を含みます。操作は慎重に行ってください。

オブジェクトの常用コマンド

ファイルのアップロード

コマンド形式。
coscmd upload <localpath> <cospath>
注意：
"<>"内のパラメータを、アップロードするローカルファイルパス（localpath）およびCOS上に保存するパス（cospath）に置き換えてください。
COSCMDはソフトリンクのアップロードをサポートしていません。COSCLIツールを使用してください。詳細はアップロード、ダウンロードまたはファイルコピー - cpを参照してください。
操作例：Dドライブのpicture.jpgファイルをCOSのdocディレクトリ下にアップロードします。
coscmd upload D:/picture.jpg doc/
操作例：Dドライブのdocフォルダ下にあるpicture.jpgファイルをCOSのdocディレクトリ下にアップロードします。
coscmd upload D:/doc/picture.jpg doc/
操作例：オブジェクトタイプを指定し、アーカイブタイプのファイルをCOSのdocディレクトリ下にアップロードします。
coscmd upload D:/picture.jpg doc/ -H "{'x-cos-storage-class':'Archive'}"
注意：
-Hパラメータを使用してHTTPヘッダーを設定する際は、必ずJSON形式であることを確認してください。例：coscmd upload -H "{'x-cos-storage-class':'Archive','Content-Language':'zh-CN'}" <localpath> <cospath>。その他のヘッダーについては、PUT Objectドキュメントを参照してください。
操作例：metaメタプロパティを設定し、ファイルをCOSのdocディレクトリ下にアップロードします。
coscmd upload D:/picture.jpg doc/ -H "{'x-cos-meta-example':'example'}"
操作例：アップロードのレート制限を800Kbit/sに指定し、Dドライブのdocフォルダ下にあるfile.zipファイルをCOSのdocディレクトリ下にアップロードします。
coscmd upload D:/doc/file.zip doc/ -H "{'x-cos-traffic-limit':'819200'}"
説明：
-Hパラメータでリクエストヘッダーx-cos-traffic-limitを指定して制限を実施します。制限速度値の設定範囲は819200 - 838860800で、単位はデフォルトでbit/s（800Kbit/s - 800Mbit/s）です。この範囲を超えた場合、400エラーが返されます。

フォルダのアップロード

コマンド形式。
coscmd upload -r <localpath> <cospath>
注意：
Windowsユーザーは、システム標準のcmdツールまたはPowerShellでCOSCMDのuploadコマンドを使用することを推奨します。その他のツール（git bashなど）はコマンドパスの解析方法がPowerShellと異なるため、ファイルが誤ったパスにアップロードされる場合があります。
操作例：DドライブのdocフォルダとそのファイルをCOSのルートパスにアップロードします。
coscmd upload -r D:/doc /
操作例：Dドライブのdocフォルダ内のファイルとサブフォルダをCOSのtestパス下にアップロードします。docフォルダ自体は含まれません。
coscmd upload -r D:/doc test
操作例：同期アップロードを行い、md5とファイルサイズが同じ同名ファイルをスキップします。
coscmd upload -rs D:/doc doc
注意：
-sパラメータを使用すると、同期アップロードが可能になり、md5が一致するファイルのアップロードをスキップします（COS上の元ファイルは、バージョン1.8.3.2以降のCOSCMDでアップロードされたものであり、デフォルトでx-cos-meta-md5ヘッダーを保持している必要があります）。
操作例：同期アップロードを行い、ファイルサイズが同じ同名ファイルをスキップします。
coscmd upload -rs --skipmd5 D:/doc doc
注意：
-sパラメータを使用すると同期アップロードが可能になり、--skipmd5パラメータを追加すると、同名ファイルのサイズのみを比較し、サイズが同じ場合はアップロードをスキップします。
操作例：同期アップロードを行い、「Dドライブのdocフォルダ内で既に削除されたファイル」を削除します。
coscmd upload -rs --delete D:/doc /
説明：
例えば、当日のD:ドライブのdocフォルダ内のファイルとCOSのdocパス下のファイルは同期アップロードが完了しており、ソース側とターゲット側が一致しています。翌日、ユーザーがD:ドライブのdocフォルダ内のAファイルを削除した場合、上記コマンドを実行すると、COSのdocパス下のAファイルが削除され、これによりD:ドライブのdocフォルダ内のファイルとCOSのdocパス下のファイルが一致した状態を維持します。
操作例：Dドライブのdocフォルダ内の.txtおよび.doc拡張子のファイルをアップロードから除外します。
coscmd upload -rs D:/doc / --ignore *.txt,*.doc
操作例：Dドライブのdocフォルダ内の.txt拡張子のファイルをアップロードから除外します。
coscmd upload -rs D:/doc / --ignore "*.txt"
注意：
フォルダをアップロードする際、--ignoreパラメータを使用すると特定の種類のファイルを無視でき、--includeパラメータを使用すると特定の種類のファイルをフィルタリングできます。シェルのワイルドカードルールをサポートし、複数のルールをカンマ,で区切って指定できます。ある拡張子を無視する場合、""で囲む必要があります。
特定のフォルダ内のすべてのファイルを--ignoreでフィルタリングしたい場合、絶対パスを使用し、パスの前後に""を追加する必要があります。例：coscmd upload -rs D:/doc / --ignore "D:/doc/ignore_folder/*"。
操作例：Dドライブのdocフォルダ内の.txtおよび.doc拡張子のファイルをアップロードします。
coscmd upload -rs D:/doc / --include *.txt,*.doc
操作例：Dドライブのdocフォルダ内の.txt拡張子のファイルをアップロードします。
coscmd upload -rs D:/doc / --include "*.txt"
注意：
100MBを超えるファイルをアップロードする場合、COSCMDはマルチパートアップロード方式を採用します。コマンドの使用方法はシンプルアップロードと同様で、coscmd upload <localpath> <cospath>です。1.8.6.31より前のバージョン（1.8.6.31バージョンは含みません）を使用している場合、この閾値は10MBとなります。
COSCMDは大容量ファイルのレジュームアップロード機能をサポートします。マルチパートアップロードが失敗した場合、ファイルを再アップロードすると失敗したパートのみが転送され、最初からやり直す必要はありません（再アップロード時にファイルのディレクトリ構成と内容が元のアップロード環境と一致していることを保証してください）。
COSCMDはマルチパートアップロード時に各チャンクに対してMD5検証を行います。
COSCMDのアップロードはデフォルトでx-cos-meta-md5ヘッダーを付与し、その値はファイルのmd5値となります。--skipmd5パラメータを指定した場合、このヘッダーは付与されません。

ファイルリストを照会する

クエリコマンドは以下のとおりです：
コマンド形式。
coscmd list <cospath>
操作例：指定されたバケットのdoc/プレフィックス配下のすべてのファイルリストを再帰的に検索します。
coscmd list doc/
操作例：指定されたバケットのすべてのファイルリスト、ファイル数、およびファイルサイズを再帰的に検索します。
coscmd list -ar
操作例：examplefolderプレフィックスのすべてのファイルリストを再帰的に検索します。
coscmd list examplefolder/ -ar
操作例：指定されたバケットのすべてのファイルの過去のバージョンを検索します。
coscmd list -v
説明：
'<>'内のパラメータを、ファイルリストを検索したいCOS上のファイルのパス（cospath）に置き換えてください。<cospath>が空の場合、デフォルトでは現在のバケットのルートディレクトリを検索します。
-aを使用してすべてのファイルを検索します。
-rを使用して再帰検索を行い、末尾にリストアップされたファイルの数量とサイズの合計を返します。
-n numを使用してクエリ数の最大値を設定します。

ファイル情報を確認

コマンドは以下の通り：
コマンド形式。
coscmd info <cospath>
操作例：doc/picture.jpgのメタ情報を表示します。
coscmd info doc/picture.jpg
説明：
"<>"内のパラメータを、表示が必要なCOS上のファイルパス（cospath）に置き換えてください。

ファイルまたはフォルダをダウンロード

ファイルのダウンロード

コマンド形式。
coscmd download <cospath> <localpath>
注意：
"<>"内のパラメータを、ダウンロードするCOS上のファイルパス（cospath）およびローカルストレージパス（localpath）に置き換えてください。
操作例：COS上のdoc/picture.jpgをD:/picture.jpgにダウンロードします。
coscmd download doc/picture.jpg D:/picture.jpg
操作例：COS上のdoc/picture.jpgをDドライブにダウンロードします。
coscmd download doc/picture.jpg D:/
操作例：バージョンID付きのpicture.jpgファイルをDドライブにダウンロードします。
coscmd download picture.jpg --versionId MTg0NDUxMzc2OTM4NTExNTg7Tjg D:/
操作例：ダウンロードのシングルリンクのレート制限を800Kbit/sに指定し、COS上のdoc/picture.jpgをD:/picture.jpgにダウンロードします。
coscmd download doc/picture.jpg D:/picture.jpg -H "{'x-cos-traffic-limit':'819200'}"
説明：
-Hパラメータでリクエストヘッダーx-cos-traffic-limitを指定してレート制限を実施します。制限速度値の設定範囲は819200 - 838860800で、単位はデフォルトでbit/s（800Kbit/s - 800Mbit/s）です。この範囲を超えた場合、400エラーが返されます。

フォルダのダウンロード

コマンド形式。
coscmd download -r <cospath> <localpath>
操作例：docディレクトリをD:/folder/docにダウンロードします。
coscmd download -r doc D:/folder/
操作例：ルートディレクトリのファイルをダウンロードしますが、ルートディレクトリ下のdocディレクトリはスキップします。
coscmd download -r / D:/ --ignore "doc/*"
操作例：現在のバケットのルートディレクトリ下のすべてのファイルを上書きダウンロードします。
coscmd download -rf / D:/examplefolder/
注意：
ローカルに同名のファイルが存在する場合、ダウンロードが失敗します。-f パラメータを使用してローカルファイルを上書きする必要があります。
操作例：現在のバケットのルートディレクトリ下のすべてのファイルを同期ダウンロードし、md5検証値が同じ同名ファイルをスキップします。
coscmd download -rs / D:/examplefolder
注意：
-s または --sync パラメータを使用すると、フォルダのダウンロード時にローカルに既に存在する同一ファイルをスキップできます（ダウンロード対象のファイルがCOSCMDのuploadインターフェースでアップロードされ、x-cos-meta-md5ヘッダーを保持している場合に限ります）。
操作例：現在のバケットのルートディレクトリ下のすべてのファイルを同期ダウンロードし、ファイルサイズが同じ同名ファイルをスキップします。
coscmd download -rs --skipmd5 / D:/examplefolder
操作例：同期ダウンロードを行い、「COSバケット内のdocパス下で既に削除されたファイル」を削除します。
coscmd download -rs --delete / D:/doc
説明：
例えば、当日にD:ドライブのdocフォルダ内のファイルとCOSのdocパス下のファイルが同期ダウンロードされ、ソース側とターゲット側が一致しています。翌日、ユーザーがCOSのdocパス下のAファイルを削除した場合、上記コマンドを実行し、ウィンドウのプロンプトに従ってy（確定）を入力すると、D:ドライブのdocフォルダ下のAファイルが削除され、最終的にD:ドライブのdocフォルダ内のファイルとCOSのdocパス下のファイルが一致した状態を実現します。
操作例：.txtおよび.doc拡張子のファイルを無視します。
coscmd download -rs / D:/examplefolder --ignore *.txt,*.doc
操作例：.txt拡張子のファイルを無視します。
coscmd download -rs / D:/examplefolder --ignore "*.txt"
注意：
フォルダをアップロードする際、--ignoreパラメータを使用すると特定の種類のファイルを無視でき、--includeパラメータを使用すると特定の種類のファイルをフィルタリングできます。シェルのワイルドカードルールをサポートし、複数のルールをカンマ,で区切って指定できます。ある拡張子を無視する場合、""で囲む必要があります。
特定のディレクトリ内のすべてのファイルを--ignoreでフィルタリングしたい場合、絶対パスを使用し、パスの前後に""を追加する必要があります。例：coscmd upload -rs D:/doc / --ignore "D:/doc/ignore_folder/*"。
操作例：.txtおよび.doc拡張子のファイルをフィルタリングします。
coscmd download -rs / D:/examplefolder --include *.txt,*.doc
操作例：.txt拡張子のファイルをフィルタリングします。
coscmd download -rs / D:/examplefolder --include "*.txt"
注意：
古いバージョンのmgetインターフェースは廃止されました。downloadインターフェースは分割ダウンロードを使用しますので、downloadインターフェースをご利用ください。

署名付きダウンロードURLの取得

コマンド形式。
coscmd signurl <cospath>
操作例：doc/picture.jpgパスの署名付きURLを生成します。
coscmd signurl doc/picture.jpg
操作例：doc/picture.jpgパスの100秒署名付きURLを生成します。
coscmd signurl doc/picture.jpg -t 100
説明：
「<>」内のパラメータを、ダウンロードURLを取得したいCOS上のファイルパス（cospath）に置き換えてください。
-t timeを使用して、このURL内の署名の有効時間を設定します（単位は秒）。デフォルトは10000秒です。

ファイルまたはフォルダを削除する

ファイルの削除

コマンド形式。
coscmd delete <cospath>
注意：
<>内のパラメータを、削除が必要なCOS上のファイルパス（cospath）に置き換えてください。ツールはユーザーに削除操作を確認するかどうかをプロンプトします。
操作例：doc/exampleobject.txtを削除します。
coscmd delete doc/exampleobject.txt
操作例：バージョンID付きのファイルを削除します。
coscmd delete doc/exampleobject.txt --versionId MTg0NDUxMzc4ODA3NTgyMTErEWN

フォルダの削除

コマンド形式。
coscmd delete -r <cospath>
操作例：docディレクトリを削除します。
coscmd delete -r doc
操作例：folder/docディレクトリを削除します。
coscmd delete -r folder/doc
操作例：docフォルダ内のすべてのバージョニングファイルを削除します。
coscmd delete -r doc/ --versions
説明：
一括削除ではyの入力による確定が必要ですが、-fパラメータを使用すると確認をスキップして直接削除できます。
ご注意ください、フォルダ削除コマンドを実行すると、現在のフォルダおよびその中のファイルが削除されます。ただし、バージョニングが有効なファイルを削除する場合は、バージョンIDを指定して削除する必要があります。

マルチパートアップロードのファイルフラグメントを検索します。

コマンド形式。
coscmd listparts <cospath>
操作例：doc/プレフィックスのファイルフラグメントを表示します。
coscmd listparts doc/

チャンクアップロードファイルフラグメントをクリアします

コマンド形式。
coscmd abort
操作例：すべてのアップロードファイルフラグメントを削除します。
coscmd abort

ファイルまたはフォルダのコピー

ファイルのコピー

コマンド形式。
coscmd copy <sourcepath> <cospath>
操作例：同一バケット内でコピーを行い、examplebucket-1250000000バケット下のpicture.jpgファイルをdocフォルダ下にコピーします。
coscmd -b examplebucket-1250000000 -r ap-chengdu copy examplebucket-1250000000.cos.ap-chengdu.myqcloud.com/picture.jpg doc/
操作例：異なるバケット間でコピーを行い、examplebucket2-1250000000バケット下のdoc/picture.jpgオブジェクトをexamplebucket1-1250000000バケットのdoc/examplefolder/にコピーします。
coscmd -b examplebucket1-1250000000 -r ap-guangzhou copy examplebucket2-1250000000.cos.ap-beijing.myqcloud.com/doc/picture.jpg doc/examplefolder/
ストレージタイプを変更し、コピー後のオブジェクトに対応するストレージタイプを低頻度ストレージに変更します。
coscmd -b examplebucket1-1250000000 -r ap-guangzhou copy examplebucket2-1250000000.cos.ap-beijing.myqcloud.com/doc/picture.jpg doc/examplefolder/ -H "{'x-cos-storage-class':'STANDARD_IA'}"
ストレージタイプを変更し、コピー後のオブジェクトに対応するストレージタイプをアーカイブストレージに変更し、photo.jpgにリネームします。
coscmd -b examplebucket1-1250000000 -r ap-guangzhou copy examplebucket2-1250000000.cos.ap-beijing.myqcloud.com/doc/picture.jpg doc/examplefolder/photo.jpg -H "{'x-cos-storage-class':'Archive'}"

フォルダのコピー

コマンド形式。
coscmd copy -r <sourcepath> <cospath>
操作例：examplebucket2-1250000000バケット下のexamplefolderディレクトリをexamplebucket1-1250000000バケットのdocディレクトリにコピーします。
coscmd -b examplebucket1-1250000000 -r ap-guangzhou copy -r examplebucket2-1250000000.cos.ap-guangzhou.myqcloud.com/examplefolder doc/
説明：
「<>」内のパラメータを、コピー元のCOSファイルパス（sourcepath）とコピー先のCOSファイルパス（cospath）に置き換えてください。
sourcepathの形式は：<BucketName-APPID>.cos.<region>.myqcloud.com/<cospath>です。
-dパラメータを使用してx-cos-metadata-directiveパラメータを設定できます。オプション値はCopyとReplacedで、デフォルトはCopyです。
-Hパラメータを使用してHTTPヘッダーを設定する場合、必ずJSON形式で指定してください。例：coscmd copy -H -d Replaced "{'x-cos-storage-class':'Archive','Content-Language':'zh-CN'}" <localpath> <cospath>。その他のヘッダーについては、PUT Object - Copyドキュメントを参照してください。

ファイルまたはフォルダを移動する

注意：
移動コマンドの<sourcepath>と<cospath>は同一にできません。同一の場合、ファイルが削除される可能性があります。これはmoveコマンドがコピー後に削除を行うため、<sourcepath>パス下のファイルが最終的に削除されるためです。

ファイルを移動する

コマンド形式。
coscmd move <sourcepath> <cospath>
操作例：同一バケット内で移動を行い、examplebucket-1250000000バケット下のpicture.jpgをdocフォルダ下に移動します。
coscmd -b examplebucket-1250000000 -r ap-chengdu move examplebucket-1250000000.cos.ap-chengdu.myqcloud.com/picture.jpg doc/
操作例：異なるバケット間で移動を行い、examplebucket2-1250000000バケット下のpicture.jpgオブジェクトをexamplebucket1-1250000000バケットのdoc/folder/に移動します。
coscmd -b examplebucket1-1250000000 -r ap-guangzhou move examplebucket2-1250000000.cos.ap-beijing.myqcloud.com/picture.jpg doc/folder/
操作例：ターゲットバケットに移動されたオブジェクトに対応するストレージタイプを低頻度ストレージに変更します。
coscmd -b examplebucket1-1250000000 -r ap-guangzhou move examplebucket2-1250000000.cos.ap-beijing.myqcloud.com/picture.jpg doc/folder/ -H "{'x-cos-storage-class':'STANDARD_IA'}"
操作例：ターゲットバケットに移動されたオブジェクトに対応するストレージタイプをアーカイブストレージに変更します。
coscmd -b examplebucket1-1250000000 -r ap-guangzhou move examplebucket2-1250000000.cos.ap-beijing.myqcloud.com/data/exampleobject data/examplefolder/exampleobject -H "{'x-cos-storage-class':'Archive'}"

フォルダを移動する

コマンド形式。
coscmd move -r <sourcepath> <cospath>
操作例：examplebucket2-1250000000バケット下のexamplefolderディレクトリをexamplebucket1-1250000000バケットのdocディレクトリに移動します。
coscmd -b examplebucket1-1250000000 -r ap-guangzhou move -r examplebucket2-1250000000.cos.ap-guangzhou.myqcloud.com/examplefolder doc/
説明：
「<>」内のパラメータを、移動元のCOSファイルのパス（sourcepath）と移動先のCOSファイルのパス（cospath）に置き換えてください。
sourcepathの形式は：<BucketName-APPID>.cos.<region>.myqcloud.com/<cospath>です。
-dパラメータを使用してx-cos-metadata-directiveパラメータを設定できます。オプション値はCopyとReplacedで、デフォルトはCopyです。
-Hパラメータを使用してHTTPヘッダーを設定する際は、必ずJSON形式で指定してください。例：coscmd move -H -d Replaced "{'x-cos-storage-class':'Archive','Content-Language':'zh-CN'}" <sourcepath> <cospath>。その他のヘッダーについては、PUT Object - copyドキュメントを参照してください。

オブジェクトのアクセス権限を設定する

コマンド形式。
coscmd putobjectacl --grant-<permissions> <UIN> <cospath>
説明：
オブジェクトのアクセス権限は--grant-read（ユーザーに読み取り権限を付与）または--grant-full-control（ユーザーに完全制御権限を付与）に設定できます。フォルダの場合は、さらに--grant-write（ユーザーに書き込み権限を付与）に設定することもできます。
操作例：アカウント100000000001にpicture.jpgの読み取り権限を付与します。
coscmd putobjectacl --grant-read 100000000001 picture.jpg
操作例：ファイルのアクセス権限を表示します。
coscmd getobjectacl picture.jpg

バージョニングの有効化/一時停止

コマンド形式。
coscmd putbucketversioning <status>
操作例：バージョニングを有効化します。
coscmd putbucketversioning Enabled
操作例：バージョニングを一時停止します。
coscmd putbucketversioning Suspended
操作例：バージョニングを表示します。
coscmd getbucketversioning
注意：
"<>"内のパラメータを必要なバージョニングステータス（status）に置き換えてください。
ストレージバケットでバージョニングを有効化すると、未設定状態（初期状態）に戻せません。ただし、当該バケットのバージョニングを一時停止することは可能です。これにより、以降にアップロードするオブジェクトに対して複数バージョンが生成されることはありません。

アーカイブファイルを復元します

アーカイブファイル復元コマンド形式。
coscmd restore <cospath>
操作例：クイック取得モードでpicture.jpgを復元し、有効期限は3日間です。
coscmd restore -d 3 -t Expedited picture.jpg
バッチアーカイブファイル復元コマンド形式。
coscmd restore -r <cospath>
操作例：クイック取得モードでexamplefolder/ディレクトリを復元し、有効期限は3日間です。
coscmd restore -r -d 3 -t Expedited examplefolder/
説明：
"<>"内のパラメータを、照会する必要があるファイルリストのCOSファイルパス（cospath）に置き換えてください。
-d <day> を使用して一時的なコピーの有効期限を設定します。デフォルト値：7。
-t <tier> を使用して復元モードを指定します。列挙値：Expedited（クイック取得モード）、Standard（標準取得モード）、Bulk（バルク取得モード）。デフォルト値：Standard。

よくあるご質問

COSCMDツールの使用中にご質問がある場合は、COSCMDツールに関するよくある質問をご参照ください。

おわりに

もちろん、COSは上記のアプリケーションやサービスを提供するだけでなく、多くの人気オープンソースアプリケーションも提供しており、Tencent Cloud COSプラグインも統合されています。こちらをクリックしてワンクリックで起動し、すぐにご利用ください。
前の記事へ: よくある質問次の記事へ: COS Migrationツール

ヘルプとサポート

この記事はお役に立ちましたか？

フィードバック