tencent cloud

ダウンロードとインストール設定
PDFファイルをダウンロード
最終更新日:2025-11-12 16:22:47
ダウンロードとインストール設定
最終更新日: 2025-11-12 16:22:47
PDFファイルをダウンロード
COSCLIツールは、Windows、macOS、およびLinuxオペレーティングシステムのバイナリパッケージを提供しているため、簡単なインストールと設定後、使用可能です。

手順1：COSCLIツールをダウンロードする

操作シナリオに基づいてCOSCLIツールのダウンロードアドレスを選択してください。お使いのサーバーが中国にある場合は、中国国内サイトのダウンロードアドレスを使用することを推奨します（こちらのリンク先のツールバージョンはすべて最新版です。旧バージョンをご利用の場合は、 release にアクセスして履歴バージョンを取得できます）。
国内サイトのダウンロードアドレス
GitHubダウンロードアドレス (海外サイトでの使用を推奨)

SHA256 チェック
77c26d2e0226e16c1affa0e0c220cec2f3fd256461d0679162223d54336e5038
3bebe5d4dc0b82a0bc4e4e266ee9223b50aae3dd8c66fe3b54c9f1f2d03b4c97
af76ceebe450d2c9656a221112ca0c64e6662545be7a6ad1a39ac888a978cd72
66b910ec6cc9d182c6b6625b3c6c7c9336fff1967198e5ca9b5581e6b6b8c0ac
Linux-386
Linux-386
78801347f02aa4fac820fa5684b41a256e5c25f8fe9ed2be7a3c7dce90f892a4
fc8d33b5b654b5a0d00c6f01019193c67c0855180b036cdb42cda18b735b736b
Linux-arm
Linux-arm
54a6ee193a19a35b57179bcb8e9bb977063e400b76ba25c7f073fba4574ce553
ca24967718c37e6961bf6167ea10b42b165d8a6fe3a7fa5f07225f0129461dbc
また、国内サイトのmacOSとLinux環境におけるCOSCLIツールファイルをコマンドラインから取得することも可能です。
macOS-amd64：wget https://cosbrowser.cloud.tencent.com/software/coscli/coscli-darwin-amd64
macOS-arm64：wget https://cosbrowser.cloud.tencent.com/software/coscli/coscli-darwin-arm64
Linux-386：wget https://cosbrowser.cloud.tencent.com/software/coscli/coscli-linux-386
Linux-amd64：wget https://cosbrowser.cloud.tencent.com/software/coscli/coscli-linux-amd64
Linux-arm：wget https://cosbrowser.cloud.tencent.com/software/coscli/coscli-linux-arm
Linux-arm64：wget https://cosbrowser.cloud.tencent.com/software/coscli/coscli-linux-arm64
説明：
GitHubでは、現在のバージョン番号はv1.0.7です。ツールの最新バージョン、過去のバージョンおとび更新ログを取得しようとする場合は、 releaseにアクセスして確認してください。

手順2：COSCLIツールをインストールする

Windows

1. Windows-amd64を例として、ダウンロードされたWindowsバージョンのCOSCLIツールをC:\\Users\\<ユーザー名>ディレクトリに移動してください。
2. を coscli-windows.exe にリネームします coscli.exe。
3. win+ｒキーを押して実行プログラムを開きます。
4. ダイアログボックスで、cmdを入力して Enter を押すと、コマンドラインウィンドウが表示されます。
5. コマンドプロンプトで、次のコマンドを入力します。
  coscli --version
出力がcoscli version v1.0.7であれば、インストールは成功です。
説明：
シ Windows ステムにおいて、異なるコマンドラインクライアントでCOSCLIを使用する方式がやや異なる可能性があります。 coscli [command] を入力した後にCOSCLIが正しく動作できない場合は、 ./coscli [command] のフォーマットをお試しください。

macOS

1. macOS-amd64を例として、次のコマンドを実行し、リネームmacOSバージョンのCOSCLIファイルは下記のとおりです。
mv coscli-darwin-amd64 coscli
2. 次のコマンドを実行してファイルの実行権限を修正します。
chmod 755 coscli
3. コマンドプロンプトで、次のコマンドを入力します。
./coscli --version
出力がcoscli version v1.0.7であれば、インストールは成功です。
説明：
macOSシステムにおいてCOSCLIを使用する場合、「開発者が確認できないため、coscliが開けられない」というプロンプトが表示された場合、設定〉安全性とプライバシー〉通用で「coscliを引き続き開く」を選択した後、COSCLIが正常に使用可能になります。

Linux

1. Linux-amd64を例として、次のコマンドを実行し、 リネームLinuxバージョンのCOSCLIファイルは下記のとおりです。
mv coscli-linux-amd64 coscli
2. 次のコマンドを実行してファイルの実行権限を修正します。
chmod 755 coscli
3. コマンドプロンプトで、次のコマンドを入力します。
./coscli --version
出力がcoscli version v1.0.7であれば、インストールは成功です。

手順3：COSCLIツールの構成

注意：
一時的な許可の使用方法によってツール使用の安全性がさらに向上できるため、ユーザーは 一時的キー でツールを使用することを推奨します。一時的キーを申請するときは、ターゲットストレージバケットやオブジェクト以外のリソースの漏洩を防止するために、 最小限の権限ガイドライン原則 に準拠してください。
永久キーを使用する必要がある場合は、 最小限の権限ガイドライン原則 に準拠して永久キーの権限範囲を制限することを推奨します。
ユーザーはCOSCLIを初めて使用する場合、設定ファイルを初期化する必要があります。設定ファイルには次の2つの部分が含まれています。
COSCLIにユーザーのTencent Cloudアカウントへのアクセスを許可するには、ユーザーはキーID、キーKey、一時的キーTokenを構成する必要があります。
通常バケットにエイリアスを追加するには、通常バケット名、バケットのリージョン情報、およびバケットエイリアスを構成する必要があります。通常バケットの情報を構成した後、ユーザーはバケット名やリージョン情報を入力せずに、エイリアスを使用してバケット操作を行うことが可能です。複数の通常バケット構成を追加した後、クロスバケットまたはクロスドメインの操作をより便利に行うことが可能です。通常バケット情報を構成する必要がない場合は、 Enter をクリックして次へ進みます。
初めて使用する場合、COSCLIが自動的に ./coscli config init を呼び出して ~/.cos.yaml で設定ファイルを生成するが、ユーザーはコマンドラインでインタラクティブに構成を完了することが可能です。その後、ユーザーは ./coscli config init コマンドを使用して他の位置でCOSCLIのために設定ファイルをインタラクティブに生成することも可能です。ユーザーは./coscli config showを使用して設定ファイルの場所と構成パラメーター情報を確認することが可能です。
設定ファイルの中の各設定項目の説明は次のとおりです。
設定項目の
必須入力
説明
Secret ID
はい
キーIDであり、使用上のリスクを軽減するために、サブアカウントキーを使用し、最小限の権限ガイドラインに準拠するよう許可することを推奨します。サブアカウントキーを取得するには、 サブアカウントのアクセス キーの管理 を参照してください。
注意：
初期化またはコマンドで設定したSecret IDは暗号化されて保存されます。設定ファイルを手動で変更する必要がある場合は、Disable Encryptionパラメータを設定してキーの暗号化を無効にする必要があります。
Secret Key
はい
キーKeyであり、使用上のリスクを軽減するために、サブアカウントキーを使用し、最小限の権限ガイドラインに準拠するよう許可することを推奨します。サブアカウントキーを取得するには、 サブアカウントのアクセス キーの管理 を参照してください。
注意：
初期化またはコマンドで設定したSecret Keyは暗号化されて保存されます。設定ファイルを手動で変更する必要がある場合は、Disable Encryptionパラメータを設定してキーの暗号化を無効にする必要があります。
Session Token
いいえ
一時的キーtokenであり、一時キーを使用するときに設定する必要があるが、使用しない場合は、直接 Enter を押して次へ進みます。一時的キーの詳細については、 一時的キーを使用してCOS にアクセスする を参照してください。
注意：
初期化またはコマンドで設定したSession Tokenは暗号化されて保存されます。設定ファイルを手動で変更する必要がある場合は、Disable Encryptionパラメータを設定してキーの暗号化を無効にする必要があります。
Mode
いいえ
はIDモードを設定し、列挙値の SecretKey と CvmRoleをサポートします。空にすることが可能です。空である場合、値がデフォルトでは SecretKeyになり、キーを使用してCOSをリクエストすることを示します。ModeがCvmRoleになる場合、 インスタンスロールの管理 を使用してCOSをリクエストすることを示します。
Cvm Role Name
いいえ
CVMロールのインスタンス名を設定します。 詳細については、 インスタンスロールの管理 を参照してください。
protocol
いいえ
ネットワーク伝送プロトコルであり、デフォルトではhttpsです。Httpに変更する必要がある場合は、設定プロファイルに直接入って修正しても可能です。
APPID
はい
APPIDは、ユーザーがTencent Cloudアカウントを申請した後に得られたアカウントであり、システムに自動的に割り当てられ、 アカウント情報 から取得できます。ストレージバケットのフルネームはBucket Name と APPID という2つの要素からなり、フォーマットが <BucketName-APPID>です。詳細については、 ストレージバケットの命名ルール を参照してください。
Bucket Name
はい
ストレージバケット名であり、APPIDとともにストレージバケットのフルネームを構成します。フォーマットが <BucketName-APPID>です。詳細については、 ストレージバケットの命名ルール を参照してください。
Bucket Endpoint
はい
ストレージバケットが存在するリージョンのドメイン名であり、ドメイン名のフォーマットがデフォルトではcos.<region>.myqcloud.comです。その中、 <region> がストレージバケットのリージョンを表し、たとえば、ap-guangzhou、ap-beijingなどです。COSがサポートするリージョンリストは リージョンとアクセスドメイン名 を参照してください。
ストレージバケットではアクセラレーションが有効になっている場合は、グローバルアクセラレーションドメイン名を構成することことが可能です。たとえば、グローバルアクセラレーションドメイン名をcos.accelerate.myqcloud.comに構成し、イントラネットグローバルアクセラレーションドメイン名をcos-internal.accelerate.tencentcos.cnに構成します。
Bucket Alias
いいえ
ストレージバケットのエイリアスであり、入力する必要があるコマンドの長さを減らすために、設定後に、使用時に BucketName-APPIDの代わりに BucketAliasを使用することが可能です。この項目を構成しない場合は、BucketAlias の値が BucketName-APPID の値になります。
OFS Bucket
いいえ
メタデータアクセラレーションバケットのマークであり、該当のバケットでは メタデータアクセラレーション 機能が有効になっているかどうかを識別するために使用されます。
CloseAutoSwitchHost
いいえ
バックアップドメインの自動切り替えを無効にするかどうかを設定します。値は true｜false を選択可能で、空にすることもできます。
設定されていないか、値が false の場合、バックアップドメインの切り替えが実行されます。
true に設定された場合、バックアップドメインの切り替えは実行されません。
DisableEncryption
いいえ
キー暗号化の無効化を設定します。選択可能の値はtrue | false、空にすることもできます。
設定しないか、値がfalseの場合、設定ファイル内のキー関連情報が暗号化されます。
true に設定すると、設定ファイル内のキー関連情報は暗号化されません。
DisableAutoFetchBucketType
いいえ
バケットタイプの自動取得を無効にするかどうかを設定します。選択可能な値はtrue | falseで、空にすることもできます。
設定しない、または値がfalseの場合、ツールは自動的にバケットタイプを取得します。これにはcos:HeadBucket権限が必要です。
trueに設定した場合、ツールはバケットタイプを自動認識せず、まず--bucket-typeに基づいてバケットタイプを決定します。このパラメータが設定されていない場合は、設定ファイル内のバケット情報のofsパラメータに基づいて決定します（trueはOFSバケット、falseはCOSバケット）。設定ファイルにバケット情報が含まれていない場合は、デフォルトでCOSバケットタイプが使用されます。
初回構成時には、COSCLIは1つのストレージバケットの構成のみを要求するが、複数のストレージバケットを構成しようとする場合は、後で ./coscli config add コマンドを使用してストレージバケットの構成を追加することが可能です。設定ファイルを変更する必要がある場合、または設定ファイルに関する操作をさらに取得しようとする場合、 config コマンド を参照するか、または ./coscli config --help コマンドを使用して設定ファイルに関連するコマンドを迅速に確認してください。
コマンドを正式に使用し開始する前に、 ./coscli --help コマンドを使用してCOSCLIの使用方法を迅速に確認することが可能です。

その他の構成方法

./coscli config init を使用して設定ファイルをインタラクティブに生成するほか、COSCLIの設定ファイルを直接手動で作成することも可能です。COSCLIの設定ファイルのフォーマットは yaml です。設定ファイルのフォーマットの例は次のとおりです。
cos:

  base:

    secretid: XXXXXXXXXXXXXXX

    secretkey: XXXXXXXXXXXXXXXXX

    sessiontoken: ""

    protocol: https

  buckets:

  - name: examplebucket1-1250000000

    alias: bucket1

    region: ap-shanghai

    endpoint: cos.ap-shanghai.myqcloud.com

    ofs: false

  - name: examplebucket2-1250000000

    alias: bucket2

    region: ap-guangzhou

    endpoint: cos.ap-guangzhou.myqcloud.com

    ofs: false

  - name: examplebucket3-1250000000

    alias: bucket3

    region: ap-chengdu

    endpoint: cos.ap-chengdu.myqcloud.com

    ofs: False
注意：
COSCLI は、デフォルトでは~/.cos.yaml から構成項目を読み取ります。ユーザーがカスタム設定ファイルを使用しようとする場合は、コマンドの後に -c （--config-path）オプションを使用してください。設定ファイルに格納されている secretid/secretkey/sessiont secretid/secretkey/sessiontoken はすべて暗号化された文字列です。
この記事はお役に立ちましたか？
営業担当者に お問い合わせ いただくか チケットを提出 してサポートを求めることができます。
はい
いいえ

フィードバック