sign コマンドを実行すると、OSS オブジェクトの署名付き URL が生成され、サードパーティユーザーと共有できます。この URL を使用すると、オブジェクトのアクセス制御リスト（ACL）、バケットポリシー、RAM ポリシーに関係なく、ダウンロードまたはプレビューのための期間限定アクセスが可能になります。
ossutil バージョン V1.6.16 以降では、バイナリ名として直接 ossutil を使用してください。それ以前のバージョンでは、ご利用のオペレーティングシステムに対応するバイナリ名を指定してください。詳細については、「ossutil コマンド リファレンス」をご参照ください。
構文
ossutil sign cloud_url
[--timeout <値>]
[--version-id <値>]
[--trafic-limit <値>]
[--disable-encode-slash]
[--payer <値>]
[--query-param <値>]パラメーター
| パラメーター | 説明 |
|---|---|
cloud_url | バケット名を含むオブジェクトの完全なパス。形式： oss://bucket/object |
--timeout | 署名付き URL の有効期間（秒単位）。デフォルト値： 60。現在の UNIX タイムスタンプとこの値の合計は、9223372036854775807 を超えてはなりません。たとえば、現在のタイムスタンプが 1643341269 の場合、最大値は 9223372035211434538 です。 |
--version-id | オブジェクトのバージョン ID。バージョン管理が有効化または一時停止されているバケット内のオブジェクトにのみ適用されます。 |
--trafic-limit | HTTP 経由でのオブジェクトへのアクセス速度の上限（ビット/秒）。デフォルト値： 0（制限なし）。有効な値の範囲： 819200～838860800（100 KB/s～100 MB/s）。 |
--disable-encode-slash | /（スラッシュ）を cloud_url 内で URL エンコーディングしないようにします。 |
--payer | リクエストの支払者を指定します。requester を設定すると、リクエスタペイ（リクエスト者負担）が有効になります。 |
--query-param | 署名付き URL に埋め込む追加のクエリパラメーターです。サポートされるパラメーター： x-oss-process、x-oss-traffic-limit、response-content-language、response-expires、response-cache-control、response-content-disposition、response-content-encoding、x-oss-ac-source-ip、x-oss-ac-subnet-mask、x-oss-ac-vpc-id、および x-oss-ac-forward-allow。各パラメーターの詳細については、「署名バージョン 1 を使用した署名付き URL の作成」および「GetObject」をご参照ください。説明 ossutil バージョン V1.7.15 以降で利用可能です。 |
例
以下のいずれかのコマンドを実行し、成功すると、出力は下記の例と同様になります。出力には、署名付き URL の生成に要した時間、URL の有効期間、および URL 内の署名情報が含まれます：
https://examplebucket.ss-cn-hangzhou.aliyuncs.com/exampleobject.png?Expires=1608282224&OSSAccessKeyId=LTAI****************&Signature=jo4%2FGykfuc1A4fvyvKRpRyymYH****
0.368676(s) 経過デフォルトの有効期間で署名付き URL を生成する
次のコマンドは、exampleobject.png（examplebucket 内）の署名付き URL を生成します。URL の有効期間は 60 秒（デフォルト）です。
ossutil sign oss://examplebucket/exampleobject.pngカスタムの有効期間で署名付き URL を生成する
次のコマンドは、有効期間が 3,600 秒の署名付き URL を生成します。
ossutil sign oss://examplebucket/exampleobject.png --timeout 3600有効期間とダウンロード速度制限を指定して署名付き URL を生成する
次のコマンドは、有効期間が 7,200 秒、最大アクセス速度が 100 MB/s（838,860,800 ビット/秒）の署名付き URL を生成します。
ossutil sign oss://examplebucket/exampleobject.png --timeout 7200 --trafic-limit 838860800特定のオブジェクトバージョンに対して署名付き URL を生成する
次のコマンドは、exampleobject.jpg の特定のバージョン（有効期間 1,800 秒）の署名付き URL を生成します。
ossutil sign oss://examplebucket/exampleobject.jpg --timeout 1800 --version-id CAEQARiBgID8rumR2hYiIGUyOTAyZGY2MzU5MjQ5ZjlhYzQzZjNlYTAyZDE3****処理パラメーターを指定した画像に対して署名付き URL を生成する
次のコマンドは、exampleobject.jpg を 100×100 ピクセルにサイズ変更し、90 度回転させ、その処理済み画像の署名付き URL を生成します。
ossutil sign oss://examplebucket/exampleobject.jpg --query-param x-oss-process:image/resize,m_fixed,w_100,h_100/rotate,90処理済み画像に対して速度制限を指定して署名付き URL を生成する
次のコマンドは、上記と同じ画像処理を適用し、アクセス速度を 100 KB/s（819,200 ビット/秒）に制限します。
ossutil sign oss://examplebucket/exampleobject.jpg --query-param x-oss-process:image/resize,m_fixed,w_100,h_100/rotate,90 --query-param x-oss-traffic-limit:819200共通オプション
別のリージョンまたは別の Alibaba Cloud アカウントが所有するバケットにアクセスする場合は、以下のオプションを追加してください：
| オプション | 説明 |
|---|---|
-e | バケットが配置されているリージョンのエンドポイント |
-i | 対象アカウントの AccessKey ID |
-k | 対象アカウントの AccessKey Secret |
例：中国（上海）リージョンに配置され、別のアカウントが所有する exampletest.jpg（testbucket 内）の署名付き URL を、有効期間 3,600 秒で生成します。
ossutil sign oss://testbucket/exampletest.jpg --timeout 3600 -e oss-cn-shanghai.aliyuncs.com -i LTAI**************** -k yourAccessKeySecret共通オプションの一覧については、「共通オプション」をご参照ください。