非同期処理リクエストはタスク ID のみを返します。データ処理が完了した後にタスクの結果を取得するには、処理リクエストにメッセージ通知パラメーターを追加する必要があります。
注意事項
メッセージ通知は、非同期処理でのみサポートされます。
メッセージ通知は、Simple Message Queue (SMQ) の Topic のみをサポートします。SMQ は以前 MNS と呼ばれていました。SMQ の詳細については、「SMQ クイックスタート」をご参照ください。
パラメーターの説明
notify パラメーターを使用する場合は、次のオプションを含めます。
パラメーター | 必須 | 説明 |
topic | はい | SMQ Topic の名前。
SMQ Topic 名の取得方法については、「コンソールで SMQ Topic の名前を確認する方法」をご参照ください。 |
REST API の使用
プログラムで高度なカスタマイズが必要な場合は、REST API リクエストを直接開始できます。そのためには、手動でコードを記述して署名を計算する必要があります。
PostObject 操作を呼び出してオブジェクトを処理する際、リクエストボディに x-oss-async-process パラメーターを渡します。次に、リクエストに notify パラメーターを追加して、結果に関するメッセージ通知を受信します。メッセージ通知は SMQ Topic のみをサポートします。SMQ の使用方法の詳細については、「Python SDK バージョンガイド」をご参照ください。
以下のセクションでは、さまざまなシナリオで SMQ メッセージ通知を受信する例を示します。
処理パラメーターを使用したドキュメント変換と SMQ メッセージ通知の受信
変換情報
変換前
ファイルタイプ：DOCX
ファイル名：
example.docx
変換後
ファイルタイプ：PNG
ストレージパス：
oss://test-bucket/doc_images/
メッセージ通知
変換結果の通知は、
test-topicという名前の SMQ Topic に送信されます。
処理例
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 Topic に送信します。
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 Topic に送信されます。
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 Topic に送信します。
x-oss-async-process=style/examplestyle|sys/saveas,b_b3V0YnVja2V0,o_b3V0b2JqcHJlZml4LnthdXRvZXh0fQ/notify,topic_dGVzdC10b3BpYwx-oss-process 操作のメッセージフォーマット
機能モジュール | x-oss-process 操作 | メッセージフォーマット |
ドキュメント処理 | ||
ApsaraVideo Media Processing | ||
ファイル処理 | ||
イメージ処理 |
よくある質問
コンソールで SMQ Topic の名前を確認する方法
OSS イベント通知用に Simple Message Queue (SMQ) Topic を設定するには、ご利用の OSS バケットと同じリージョンにある Topic を使用する必要があります。以下の手順に従って、SMQ Topic の名前を確認します。SMQ は以前 MNS と呼ばれていました。
コンソールの上部のナビゲーションバーで、ご利用の OSS バケットと同じリージョンを選択していることを確認します。
左側のナビゲーションウィンドウで、[トピックベースのモデル] > [Topic リスト] をクリックすると、現在のリージョンで作成されたすべての Topic を表示できます。
Topic リストを参照して、OSS イベント通知の設定に使用する Topic の名前を見つけます。
これらの手順に従うことで、ご利用の OSS バケットと同じリージョンにある SMQ Topic の名前を見つけることができます。正しい Topic 名を使用することで、OSS イベントが処理のためにメッセージキューに確実に送信されます。