ApsaraVideo Media Processing（MPS）ジョブは、同期モードまたは非同期モードで実行できます。非同期ジョブの結果はリアルタイムで受信できません。 MPS キューまたはワークフロー内の非同期ジョブのステータス変更を監視する場合は、ジョブの通知機能を有効にできます。 この機能を有効にすると、トランスコーディングジョブが成功したかどうか、または自動レビュージョブが完了したかどうかを監視できます。 このトピックでは、MPS ジョブまたはワークフローの通知機能を有効にする方法について説明します。
通知機能を有効にするには、次の手順を実行します。
ビジネス要件に基づいて、SMQ でキューまたはトピックを作成します。 詳細については、このトピックの以下のセクションを参照してください。
説明キューベースモデルは、1 対 1 の方法で信頼性が高く、同時消費モデルです。 トピックベースモデルは、1 対多の方法で公開およびサブスクリプションモデルです。
オプション。 SMQ のキューまたはトピックを MPS キューに関連付けます。 詳細については、このトピックのキューまたはトピックを関連付けるセクションを参照してください。
ジョブまたはワークフローの通知機能を有効にします。 詳細については、このトピックの以下のセクションを参照してください。
手順 1：Simple Message Queue (formerly MNS)をアクティブ化する
通知機能は SMQ に依存しています。 MPS ではこの機能を無料で使用できますが、SMQ の使用には料金が発生します。 請求の詳細については、請求の概要を参照してください。
Simple Message Queue (formerly MNS)をアクティブ化し、現在のユーザーに SMQ へのアクセスを承認します。 詳細については、SMQ をアクティブ化し、RAM ユーザーに SMQ へのアクセスを承認するを参照してください。
[コンソール]をクリックして、Simple Message Queue (formerly MNS)コンソールに移動します。
手順 2：SMQ でトピックまたはキューを作成する
MPS は、ジョブとワークフローに関する通知を SMQ のトピックまたはキューに送信できます。 ビジネス要件に基づいて、SMQ でトピックまたはキューを作成できます。
トピックを作成する
SMQ コンソールの左側のナビゲーションペインで、[トピックモデル] > [トピック] を選択します。 [トピック] ページで、[トピックの作成] をクリックします。
トピックの作成パネルで、次の表に示すパラメーターを設定します。
パラメーター
説明
名前
SMQ トピックの名前。
説明名前は最大 120 文字で、文字、数字、ハイフン（-）を含めることができます。 名前の先頭は文字にする必要があります。
メッセージの最大長
SMQ トピックに送信できるメッセージの最大サイズ。 単位：バイト。 有効な値：1024 ～ 65536。 デフォルト値：65536。
ログ機能を有効にする
ログ機能を有効にするかどうかを指定します。
[OK] をクリックします。 SMQ トピックが作成され、SMQ トピックの詳細ページが表示されます。
[サブスクリプション] タブで、[サブスクリプションの作成] をクリックします。 サブスクリプションの作成パネルで、次の表に示すパラメーターを設定します。
パラメーター
説明
トピック名
サブスクリプションの名前。
説明名前は最大 255 文字で、文字、数字、ハイフン（-）を含めることができます。 名前の先頭は文字にする必要があります。
サブスクリプション
プッシュタイプ。 デフォルト値：HTTP。
レシーバーエンドポイント
メッセージレシーバーのエンドポイント。
説明エンドポイントは、http:// または https:// で始まる HTTP URL です。
メッセージフィルタリングタグ
メッセージのフィルタリングに使用されるタグ。 このパラメーターはオプションです。
説明タグは最大 16 文字です。
再試行ポリシー
SMQ トピックからレシーバーへのメッセージ配信中にエラーが発生した場合に適用される再試行ポリシー。 有効な値：
バックオフ再試行：3 回再試行します。 再試行間隔は、10 ～ 20 の範囲のランダムな値です。 単位：秒。
指数関数的減衰再試行：1 日以内に 176 回、次の再試行間隔（秒単位）で再試行します：2^0、2^1、...、512、512、...、および 512。
メッセージ形式
メッセージがレシーバーにプッシュされる形式。 有効な値：
簡略化：メッセージには、公開されたメッセージ本文のみが含まれ、属性情報は含まれません。
JSON：メッセージは JSON 形式で、メッセージ本文とメッセージ属性が含まれています。
XML：メッセージは XML 形式で、メッセージ本文とメッセージ属性が含まれています。
[OK] をクリックします。 サブスクリプションが作成されます。
SMQ キューを作成する
SMQ コンソールの左側のナビゲーションペインで、[キューモデル] > [キュー] を選択します。
[キュー] ページで、[キューの作成] をクリックします。 キューの作成パネルで、次の表に示すパラメーターを設定します。
パラメーター
説明
名前
SMQ キューの名前。
メッセージの最大長
SMQ キューに送信できるメッセージの最大サイズ。
ロングポーリング期間
ReceiveMessage リクエストが SMQ キューにメッセージが入るまで待機できる最大期間。
可視性タイムアウト期間
受信したメッセージが非アクティブ状態のままである期間。
メッセージ保持期間
メッセージを SMQ キューに保持できる最大期間。 指定された期間が終了すると、メッセージが消費されているかどうかに関係なく、メッセージは削除されます。
スケジュールされた期間
SMQ キューに送信されたすべてのメッセージを消費できるようになるまでの期間。
ログ機能を有効にする
ログ機能を有効にするかどうかを指定します。
[OK] をクリックします。 SMQ キューが作成されます。
手順 3：（オプション）SMQ キューまたはトピックを MPS キューに関連付ける
通常の MPS キューに追加されたジョブを実行し、ジョブに関する通知を受信する場合は、MPS キューを SMQ トピックまたはキューに関連付けます。 ジョブを作成するときに、MNS トピックまたはキューに関連付けられている MPS キューを選択します。
ワークフローを実行する場合、MPS キューを SMQ キューまたはトピックに関連付ける必要はありません。 ワークフロー内のジョブの通知は、別のロジックに基づいて送信できます。 これらのジョブに関する通知を受信するには、ワークフローの 入力ノードの SMQ トピックまたはキューのみを設定する必要があります。 詳細については、このトピックのワークフローの通知機能を有効にするセクションを参照してください。
MPS コンソールにログオンします。
上部のナビゲーションバーで、リージョンを選択します。
説明MPS ジョブを送信するリージョンを選択していることを確認してください。 そうしないと、メッセージを受信できません。
左側のナビゲーションペインで、 を選択します。
[MPS キューとコールバック] ページで、通知機能を有効にする MPS キューを見つけ、[アクション] 列の [通知の設定] をクリックします。
[通知設定] ダイアログボックスで、次の表に示すパラメーターを設定します。
パラメーター
説明
通知
通知をオンにします。
メッセージタイプ
ビジネス要件に基づいて、[キュー] または [トピック] を選択します。
キュー名
[メッセージタイプ] パラメーターを [キュー] に設定した場合は、[キュー名] ドロップダウンリストからキューを選択します。
トピック名
[メッセージタイプ] パラメーターを [トピック] に設定した場合は、[トピック名] ドロップダウンリストからトピックを選択します。
[OK] をクリックします。 MPS キューは、SMQ キューまたはトピックに関連付けられています。
手順 4：通知機能を有効にする
ジョブの通知機能を有効にする
ジョブを作成するときに、SMQ キューまたはトピックに関連付けられている MPS キューを選択します。 ジョブのステータスが変更されると、MPS は MPS キューに関連付けられた SMQ キューまたはトピックに通知を送信します。
選択する MPS キューのタイプは、ジョブのタイプと同じである必要があります。 たとえば、インテリジェントサムネイルジョブを作成する場合は、SMQ キューまたはトピックに関連付けられているインテリジェントサムネイル用の MPS キューを選択する必要があります。
ワークフローの通知機能を有効にする
ワークフローの通知機能を有効にすると、ワークフローが開始および終了したときに、MPS は関連付けられた SMQ キューまたはトピックに通知を送信します。
MPS コンソールで、左側のナビゲーションペインの を選択します。
[ワークフローオーケストレーション] ページで、[ワークフローの作成] をクリックします。 ワークフローの作成ページが表示されます。
ワークフローの作成ページの [タスク設定（トポロジー）] セクションで、[入力] ノードの横にあるペンアイコンをクリックします。
[入力] ダイアログボックスで、[通知] をオンにし、次の表に示すパラメーターを設定します。
説明通知をオンにし、[エンコーディングパイプライン] パラメーターの MPS キューを選択すると、ワークフロー内のジョブに関する通知は、MPS キューを SMQ キューまたはトピックに関連付けているかどうかに関係なく、[入力] ダイアログボックスで選択した SMQ キューまたはトピックのみに送信されます。
パラメーター
説明
入力バケット
このパラメーターを設定する必要はありません。 入力パス パラメーターを設定すると、入力バケットの名前が自動的に表示されます。
入力パス
[入力パス] フィールドの横にある [選択] をクリックし、[入力パスの選択] ダイアログボックスでパラメーターを設定して、[OK] をクリックして、処理するファイルの入力パスを指定します。
エンコーディングパイプライン
前の手順で通知機能を有効にした、トランスコーディング用の MPS キューを選択します。
通知
通知をオンにします。
メッセージタイプ
MPS キューの通知機能を有効にしたときに設定した [メッセージタイプ] パラメーターに基づいて、[キュー] または [トピック] を選択します。
キュー名またはトピック名
SMQ キューまたはトピックを選択します。
他のノードの設定方法の詳細については、ワークフローを作成するを参照してください。
FAQ
通知機能に関するよくある質問（FAQ）への回答については、メッセージに関する FAQ を参照してください。