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