Object Storage Service:変数

コンソールでのユースケース

• タスク：処理タスクの出力パスで、ソースオブジェクトの情報を参照できます。たとえば、ドキュメントを JPG 画像に変換するには、出力パスを oss://test-bucket/output/{dirname}/{barename}/{index}.{autoext} に設定します。処理中に、{autoext} は jpg に置き換えられます。生成された画像は oss://test-bucket/output/source-directory/source-filename/image-sequence-number.jpg に保存されます。

  [タスクの作成] ダイアログボックスで、[スタイル] で doc_to_jpg を選択します。[出力パス] の下に、完全なオブジェクトキーを入力する必要があること、オブジェクトキーには変数を含めることができること、および入力パスと出力パスは異なる必要があることを示すプロンプトが表示されます。[通知設定] セクションで、[メッセージキュー] を選択できます。設定が完了したら、[OK] をクリックします。

• バッチ処理：バッチ処理ジョブを作成すると、システムは既存の各オブジェクトに対してタスクを生成します。データの上書きを避けるため、出力パスで変数を使用することを推奨します。たとえば、動画からフレームを抽出して PNG 画像として保存するには、出力パスを oss://test-bucket/output/{dirname}/{barename}/{index}.{autoext} に設定します。処理中に、{autoext} は png に置き換えられます。生成された PNG 画像は oss://test-bucket/output/source-directory/source-filename/frame-number.png に保存されます。

  [出力設定] セクションで出力パスを設定した後、key、barename、または basename 変数を使用する場合は、出力パスが入力パスと異なることを確認してください。これにより、ソースオブジェクトの上書きを防ぎ、無限ループを回避できます。[権限設定] セクションで、[サービスロール] で [AliyunIMMBatchTriggerRole (デフォルトロール)] を選択し、[OK] をクリックします。

• トリガー：トリガーを作成すると、新しいオブジェクトごとにタスクが生成されます。オブジェクトの上書きを避けるため、出力パスで変数を使用することを推奨します。たとえば、ドキュメントを JPG 画像に変換するためにドキュメント変換トリガーが作成された場合、出力パスを oss://test-bucket/output/{dirname}/{barename}/{index}.{autoext} に設定します。処理中に、{autoext} は jpg に置き換えられます。生成された JPG 画像は oss://test-bucket/output/source-directory/source-filename/image-sequence-number.jpg に保存されます。

  オブジェクトキー、barename、または basename 変数を使用する場合は、オブジェクトの上書きを防ぐため、出力パスが入力パスと異なることを確認してください。[権限設定] セクションで、[サービスロール] で [AliyunIMMBatchTriggerRole (デフォルトロール)] を選択し、[OK] をクリックします。

API のユースケース

• 名前を付けて保存 (sys/saveas)：名前を付けて保存 (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 ディレクトリに、ページ番号に基づいたファイル名 (例: 1.png) で保存されます。

• タスク：タスクの出力パスは変数をサポートします。たとえば、CreateOfficeConversionTask API を呼び出してドキュメント変換タスクを作成する場合、TargetURI パラメーターを拡張子を含む完全な出力パスに設定する必要があります。TargetURI には、oss://test-bucket/output/{dirname}/{barename}/{index}.jpg のような変数を含めることができます。

例 1：ドキュメント形式の変換

次の RESTful API の例は、処理パラメーターを PostObject リクエストに追加して example.docx の形式を変換する方法を示しています。名前を付けて保存 (sys/saveas) 操作の b (バケット) および o (オブジェクト) パラメーターでは変数を使用できます。

• pages_MS0xMA：ドキュメントの 1 ページから 10 ページを変換します。MS0xMA は "1-10" の Base64 エンコードされた値です。

• target_png：ドキュメントを PNG 画像形式に変換します。

• source_docx：ソースオブジェクトのタイプが DOCX であることを指定します。

• sys/saveas：名前を付けて保存。

  • b_e2J1Y2tldH0：トランスコーディング完了後、{bucket} 変数によって、生成された画像がソースバケットに保存されます。e2J1Y2tldH0 は {bucket} の Base64 エンコードされた値です。

  • o_ZG9jX2ltYWdlcy97aW5kZXh9LnBuZw：オブジェクトを doc_images ディレクトリに保存します。オブジェクトキーでは、example.docx のページ番号に対応する {index} 変数を使用します。ZG9jX2ltYWdlcy97aW5kZXh9LnBuZw は doc_images/{index}.png の Base64 エンコードされた値です。

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: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e
 // example.docx オブジェクトの 1 ページから 10 ページを PNG 画像に変換します。処理されたオブジェクトは oss://source-bucket/doc_images/page-number.png に保存されます。
x-oss-async-process=doc/convert,pages_MS0xMA,target_png,source_docx|sys/saveas,b_e2J1Y2tldH0,o_ZG9jX2ltYWdlcy97aW5kZXh9LnBuZw

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

この例では、複数の処理パラメーターを設定して example.avi オブジェクトをトランスコードする方法を示します。

• f_mp4：トランスコードされたメディアファイルのコンテナを MP4 に設定します。

• vcodec_h265：ビデオストリームの形式を H.265 に設定します。

• s_1920x1080：解像度を 1920x1080 に設定します。

• vb_2000000：ビデオビットレートを 2 Mbps に設定します。

• fps_30：ビデオフレームレートを 30 fps に設定します。

• acodec_aac：オーディオエンコーディング形式を AAC に設定します。

• ab_100000：オーディオビットレートを 100 Kbps に設定します。

• sn_1：字幕ストリームを無効にします。

• sys/saveas：名前を付けて保存。

  • b_e2J1Y2tldH0：トランスコーディング完了後、{bucket} 変数を使用して、生成されたオブジェクトがソースバケットに保存されます。e2J1Y2tldH0 は {bucket} の Base64 エンコードされた値です。

  • o_b3V0cHV0LnthdXRvZXh0fQ：{autoext} 変数によってオブジェクトに自動的に拡張子が追加され、output.mp4 という名前のオブジェクトとして保存されます。b3V0cHV0LnthdXRvZXh0fQ は output.{autoext} の Base64 エンコードされた値です。

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: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e
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