非同期処理リクエストに対する応答には、処理タスクの ID のみが含まれます。タスクの結果を取得するには、リクエストにパラメーターを追加してメッセージ通知を有効にする必要があります。
使用上の注意
メッセージ 通知は、非同期処理リクエストに対してのみ有効にできます。
メッセージ通知は、Simple Message Queue（SMQ、旧MNS）のトピックベースのメッセージングモデルのみをサポートしています。詳細については、「概要」をご参照ください。
パラメーター
リクエストに notify パラメーターを追加する場合は、次の表に示すオプションを指定する必要があります。
パラメーター | 必須 | 説明 |
topic | はい | SMQ トピックの名前
詳細については、「SMQコンソールで SMQ のトピックを表示する方法」をご参照ください。 |
RESTful API の使用
高度なカスタマイズが必要なビジネスの場合、RESTful API を呼び出すことによって非同期処理リクエストを開始できます。この場合、署名を計算するためにアプリケーションで手動でコードを開発する必要があります。
PostObject 操作を呼び出すと、x-oss-async-process がリクエスト本文によって渡されます。リクエストに notify パラメーターを追加して、メッセージ通知を有効にできます。メッセージ通知は、SMQ（旧 MNS）のトピックベースのメッセージングモデルのみをサポートしています。SMQ の使用方法の詳細については、「リリースノート」をご参照ください。
次のセクションでは、メッセージ通知が有効になっている非同期タスクの例を示します。
処理パラメーターを使用して変換されたファイルのメッセージ通知を有効にする
変換タスクに関する情報
変換前
ファイルの種類: DOCX
ファイル名:
example.docx
変換後
ファイルの種類: PNG
保存パス:
oss://test-bucket/doc_images/
メッセージ通知
変換結果を
test-topicという名前の SMQ トピックに送信します。
リクエスト例
POST /exmaple.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
// DOCX 形式の example.docx を PNG 形式の画像に変換し、変換された画像を oss://test-bucket/doc_images/ に保存し、結果を test-topic という名前の SMQ トピックに送信します。
x-oss-async-process=doc/convert,target_png,source_docx|sys/saveas,b_dGVzdC1idWNrZXQ,o_ZG9jX2ltYWdlcy97aW5kZXh9LnBuZw/notify,topic_dGVzdC10b3BpYwスタイルパラメーターを使用してトランスコードされたビデオを特定のバケットに保存する
トランスコーディング タスクに関する情報
トランスコード前
ビデオ形式: AVI
ビデオ名:
example.avi
トランスコード後
ビデオ形式: MP4
ビデオ名:
outobjprefix.mp4保存パス:
oss://outbucket/outobjprefix.mp4
メッセージ通知
トランスコードの結果を
test-topicという名前の SMQ トピックに送信します。
POST /exmaple.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
// examplestyle という名前のスタイルを使用して example.avi をトランスコードし、トランスコードされたファイルを oss://outbucket/outobjprefix.mp4 として保存し、結果を test-topic という名前の SMQ トピックに送信します。
x-oss-async-process=style/examplestyle|sys/saveas,b_b3V0YnVja2V0,o_b3V0b2JqcHJlZml4LnthdXRvZXh0fQ/notify,topic_dGVzdC10b3BpYwx-oss-process 関連操作に対応するメッセージ形式
機能モジュール | x-oss-process コマンドを使用する操作 | メッセージ形式 |
ドキュメント処理 | ||
メディア処理 | ||
ファイル処理 |
よくある質問
SMQコンソールで SMQ のトピックを表示する方法
OSS イベント通知に関連する Simple Message Queue（旧 MNS）トピックをより明確に構成できるように、以下の手順に従って、OSS と同じリージョンにある SMQ トピック名を見つけて確認できます。
To assist you in configuring the Simple Message Queue (formerly MNS) topic for OSS event notifications more clearly, you can follow the steps below to locate and confirm the name of the SMQ topic in the same region as OSS.
SMQ コンソールにログインします。
上部のナビゲーションバーで、OSS と同じリージョンを選択していることを確認します。
左側のナビゲーションウィンドウで、メディア設定を構成する:これは太字のテキストです。 > をクリックし、現在のリージョンにある既存のすべてのトピックを一覧表示します。
トピックリストを表示し、OSS イベント通知構成に対応するトピック名を確認します。
上記の手順に従うことで、OSS と同じリージョンにある SMQ トピック名を効率的に見つけて構成し、OSS イベントが処理のために SMQ に正しく送信されるようにすることができます。