Object Storage Service:変数

コンソールでの使用例

タスク：ドキュメントを JPG イメージに変換します。出力パスを oss://test-bucket/output/{dirname}/{barename}/{index}.{autoext} と設定します。タスク実行中に {autoext} は jpg に解決され、処理済みオブジェクトは oss://test-bucket/output/<ソースオブジェクトのディレクトリ>/<ソースオブジェクト名>/<イメージのシリアル番号>.jpg に保存されます。

バッチ処理：複数の動画から同時に PNG フレームをキャプチャします。出力パスを oss://test-bucket/output/{dirname}/{barename}/{index}.{autoext} と設定します。{autoext} は png に解決され、フレームは oss://test-bucket/output/<ソース動画のディレクトリ>/<ソース動画名>/<フレームのシーケンス番号>.png に保存されます。

トリガー：ドキュメントを JPG イメージに変換するトリガーを作成します。出力パスを oss://test-bucket/output/{dirname}/{barename}/{index}.{autoext} と設定します。ソースバケットに新規オブジェクトが追加されるたびにタスクが起動し、出力は oss://test-bucket/output/<ソースオブジェクトのディレクトリ>/<ソースオブジェクト名>/<イメージのシーケンス番号>.jpg に保存されます。

API での使用例

`sys/saveas` パラメーター：b オプションおよび o オプションでは変数がサポートされています。example.docx の 1～10 ページを PNG イメージに変換する場合、sys/saveas を以下のように設定します：

b_e2J1Y2tldH0,o_ZG9jX2ltYWdlcy97aW5kZXh9LnBuZw

以下：

• e2J1Y2tldH0 は {bucket} の Base64 エンコード値 — ソースオブジェクトと同じバケットに保存されます

• ZG9jX2ltYWdlcy97aW5kZXh9LnBuZw は doc_images/{index}.png の Base64 エンコード値 — 出力パスは doc_images/<ページ番号>.png となります

`TargetURI` パラメーター: CreateOfficeConversionTask を呼び出す際、TargetURI を、ファイル拡張子を含む完全な出力パスに設定します。変数がサポートされています。例: oss://test-bucket/output/{dirname}/{barename}/{index}.jpg。

リクエスト送信時刻の変数

これらの変数は、同期または非同期のいずれかの方法でリクエストが送信された時点の時刻に解決されます。

リファレンス：リクエスト送信時刻 2022-09-01T02:06:57.798Z

適用対象：データ処理タスク（同期および非同期リクエスト）。

IMG 変数

これらの変数は、ソースオブジェクトのパスおよびアップロード時刻に基づいて解決されます。

リファレンス：ソースオブジェクト oss://test-bucket/path1/path2/name.png、アップロード時刻 2022-04-22 14:38:25

適用対象：IMG 処理タスク。

例：ソースオブジェクトが oss://test-bucket/videos/2024/clip.mp4 の場合、パス oss://output-bucket/{dirname}/{barename}_processed.{ext} は oss://output-bucket/videos/2024/clip_processed.mp4 に解決されます。

ドキュメント変換変数

これらの変数は、ソースオブジェクトのドキュメント構造（ページ番号、シート名）に基づいて解決されます。

リファレンス：シート名が sheet1 の Excel オブジェクトを JPG に変換

適用対象：ドキュメント変換タスク（Word、PDF、PPT、Excel）。

例：出力パス oss://test-bucket/output/{dirname}/{barename}/{index}.{autoext} を指定して、reports/Q1.docx の 3 ページを変換すると、oss://test-bucket/output/reports/Q1/3_1.jpg が出力されます（{autoext} は jpg に解決されます）。

メディア処理変数

これらの変数は、トランスコード出力のプロパティに基づいて解決されます。

リファレンス：動画 video.mp4 を 1920x1080 解像度で TS 形式にマルチパートトランスコード

適用対象：メディア処理タスク（動画トランスコーディング、マルチパートトランスコーディング、スナップショットキャプチャ）。

例：出力パス oss://test-bucket/output/{barename}_{resolution}_{index}.{autoext} を指定して、video.mp4 の 2 セグメント目を 1920x1080 解像度でトランスコードすると、oss://test-bucket/output/video_1920x1080_2.ts が出力されます。

autoext および index 変数は、ドキュメント変換およびメディア処理の両方で使用されますが、index のセマンティクスはそれぞれ異なります。ドキュメント変換ではページ番号またはシートサブインデックスを表し、メディア処理では出力セグメントのシーケンス番号を表します。

例 1：ドキュメント変換

example.docx の 1～10 ページを PNG イメージに変換し、ソースバケット内の doc_images/<ページ番号>.png に保存します。

POST /example.docx?x-oss-async-process HTTP/1.1
Host: doc-demo.oss-cn-hangzhou.aliyuncs.com
Date: Fri, 28 Oct 2022 06:40:10 GMT
Authorization: OSS qn6q**************:77Dv****************

x-oss-async-process=doc/convert,pages_MS0xMA,target_png,source_docx|sys/saveas,b_e2J1Y2tldH0,o_ZG9jX2ltYWdlcy97aW5kZXh9LnBuZw

パラメーター：

例 2：動画トランスコーディング

example.avi を H.265 エンコーディングで 1920x1080 解像度の MP4 にトランスコードし、ソースバケットの output.<autoext> として保存します。

POST /example.avi?x-oss-async-process HTTP/1.1
Host: video-demo.oss-cn-hangzhou.aliyuncs.com
Date: Fri, 28 Oct 2022 06:40:10 GMT
Authorization: OSS qn6q**************:77Dv****************

x-oss-async-process=video/convert,f_mp4,vcodec_h265,s_1920x1080,vb_2000000,fps_30,acodec_aac,ab_100000,sn_1|sys/saveas,b_e2J1Y2tldH0,o_b3V0cHV0LnthdXRvZXh0fQ

パラメーター：