tencent cloud

Cloud Object Storage

署名付きURLの取得 - signurl

PDF
フォーカスモード
フォントサイズ
最終更新日: 2026-03-17 10:21:29
signurlコマンドは、オブジェクトの事前署名付きURLを取得するために使い、このURLからオブジェクトに匿名でアクセスすることができます。

コマンド形式

./coscli signurl cos://<bucket-name>/<key> [flag]
signurlコマンドには以下のパラメータが含まれています:
パラメータ形式
パラメータ用途
cos://<bucket-name>/<key>
アクセスするバケットを指定します。パラメータ設定 のバケットの別名、またはバケット名を使用してアクセスすることがサポートされております。バケット名でアクセスする場合は、追加の endpoint flag が必要になります。
バケットの別名でアクセス:cos://example-alias/test.txt
バケット名を使用してアクセス:cos://examplebucket-1250000000/test.txt
signurlコマンドには、以下のオプションflagが含まれます。
flagの略称
flagの正式名称
flagの用途
-h
--help
ヘルプ情報を出力
-t
--time
URLの有効期限を設定(デフォルトは1000s)
--simple-output
シンプル出力モードを有効にします。デフォルト値はfalseです。trueに設定された場合、署名付きURLのみを出力し、戻り結果を簡素化します。
説明:
このコマンドのその他の一般的なオプション(バケットの切り替え、ユーザーアカウントの切り替えなど)については、一般オプション ドキュメンテーションを参照してください。

操作事例

bucket1内にあるpicture.jpgの事前署名付きURLを取得します

./coscli signurl cos://bucket1/picture.jpg
返される結果の例は以下の通りです:
INFO[2026-02-04 11:36:10] Signed URL:
INFO[2026-02-04 11:36:10] https://bucket1-1234124.cos.ap-guangzhou.myqcloud.com/picture.jpg?q-sign-algorithm=sha1&q-ak=************************************&q-sign-time=1770176170%3B1770186170&q-key-time=1770176170%3B1770186170&q-header-list=host&q-url-param-list=&q-signature=****************************************

bucket2内のpicture.jpgの事前署名付きURLを取得し、URLの有効期限を1314秒に設定します

./coscli signurl cos://bucket2/picture.jpg --time 1314
返される結果の例は以下の通りです:
INFO[2026-02-04 11:36:10] Signed URL:
INFO[2026-02-04 11:36:10] https://bucket2-1234124.cos.ap-guangzhou.myqcloud.com/picture.jpg?q-sign-algorithm=sha1&q-ak=************************************&q-sign-time=1770176170%3B1770186170&q-key-time=1770176170%3B1770186170&q-header-list=host&q-url-param-list=&q-signature=****************************************

バケット「bucket3」内の「picture.jpg」の署名付きURLを取得し、シンプルモードで出力します。

./coscli signurl cos://bucket3/picture.jpg --simple-output
返される結果の例は以下の通りです:
https://bucket3-1234124.cos.ap-guangzhou.myqcloud.com/picture.jpg?q-sign-algorithm=sha1&q-ak=************************************&q-sign-time=1770176267%3B1770186267&q-key-time=1770176267%3B1770186267&q-header-list=host&q-url-param-list=&q-signature=****************************************

ヘルプとサポート

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

フィードバック