トランスコードやコンテンツモデレーションなどの非同期ジョブは、リアルタイムで結果を返しません。MPS キューまたはワークフローで通知を設定し、ジョブステータスの変更を監視します。
-
要件に基づいてトピックまたはキューを作成します。
説明キューは 1 対 1 の信頼性の高い同時実行コンシュームモデルを提供します。トピックは 1 対多のパブリッシュ/サブスクライブモデルを提供します。
-
(オプション) MPS キューのバインド
-
通知の設定
ステップ 1:Simple Message Queue (formerly MNS) の有効化
MPS 通知は、メッセージをプッシュするために Simple Message Queue (旧称:MNS) を利用します。MPS はこの機能に対して課金しませんが、Simple Message Queue (旧称:MNS) の使用には料金が発生します。「課金」をご参照ください。
-
Simple Message Queue (formerly MNS) を有効化し、必要な権限を付与します。詳細については、「Simple Message Queue (旧称:MNS) の有効化と権限の付与」をご参照ください。
-
[管理コンソール] をクリックして Simple Message Queue (formerly MNS) コンソールを開きます。
ステップ 2:トピックまたはキューの作成
MPS は、Simple Message Queue (旧称:MNS) のトピックまたはキューにメッセージをプッシュして通知を送信します。要件に応じてトピックまたはキューを作成します。
トピックの作成
-
SMQ コンソールの左側のナビゲーションペインで、トピック を選択します。「トピックリスト」ページで、トピックの作成 をクリックします。
-
[トピックの作成] ページで、次のパラメーターを設定します。
パラメーター
説明
[名前]
トピックの名前。
説明名前は英字で始まり、長さは最大 120 文字で、英字、数字、ハイフン (-) のみを含めることができます。
[メッセージの最大長さ]
メッセージ本文の最大サイズです。有効な値の範囲は 1024~65536 バイトです。デフォルト値は 65536 です。
[ログ機能の有効化]
このトピックのロギングを有効にします。
-
OK をクリックすると、トピックが作成され、トピック詳細ページにリダイレクトされます。
-
購読の作成 をクリックし、パラメーターを設定します。
パラメーター
説明
[名前]
サブスクリプションの名前。
説明名前は英字で始まり、長さは最大 255 文字で、英字、数字、ハイフン (-) のみを含めることができます。
[プッシュタイプ]
プッシュタイプを選択します。デフォルト値は HTTP です。
[受信側エンドポイント]
メッセージの受信側エンドポイント。
説明エンドポイントは、
http://またはhttps://で始まる URL である必要があります。(オプション) [メッセージのフィルタリングタグ]
メッセージのフィルタリングに使用されるタグ
説明タグの長さは最大 16 文字です。
[再試行ポリシー]
エンドポイントへのメッセージ配信が失敗した場合の再試行ポリシー
-
[バックオフ]: 10~20 秒のランダムな間隔で 3 回再試行します。
-
[指数減衰]: 1 日にわたって最大 176 回再試行します。間隔は 1 秒から始まり、指数関数的 (2n) に最大 512 秒まで増加します。
[メッセージプッシュ形式]
プッシュされるメッセージの形式
-
[SIMPLIFIED]:メッセージ本文のみを含み、属性は含まれません。
-
JSON:コンテンツと属性を含むJSON形式のメッセージ本文。
-
XML:コンテンツと属性を含むXML形式のメッセージ本文。
-
-
OK をクリックしてサブスクリプションを作成します。
キューの作成
-
SMQ コンソールの左側のナビゲーションペインで、キュー をクリックします。
-
「キューリスト」ページで、キューを作成 をクリックし、次のパラメーターを設定します。
パラメーター
説明
[名前]
キューの名前
[メッセージの最大長さ]
キューに送信されるメッセージ本文の最大サイズ
[ロングポーリング期間]
キューが空の場合の
ReceiveMessage呼び出しの最大待機時間[メッセージの可視性タイムアウト時間]
取得されたメッセージが、後続の取得リクエストから非表示になる期間です。
[メッセージの保持期間]
メッセージが取得されたかどうかに関わらず、削除されるまでキュー内に保持される最大時間です。
[配信遅延]
すべてのメッセージが消費可能になるまでの遅延時間です。
[ログ機能の有効化]
このキューのログ管理を有効にします。
-
パラメーターを設定した後、OK をクリックしてキューを作成します。
(オプション) ステップ 3:MPS キューのバインド
標準の MPS キュー内のジョブの通知を受信するには、キューを Simple Message Queue (旧称:MNS) のトピックまたはキューにバインドします。
ワークフロージョブは MPS キュー通知バインディングを無視します。ワークフローで通知を使用するには、ワークフローを作成するときに 入力 ノードで通知トピックまたはキューを選択します。ワークフロータスクの通知を設定する。
-
ApsaraVideo Media Processing (MPS) コンソール にログインします。
-
上部のナビゲーションバーで、リージョンを選択します。
説明通知を受信するには、MPS キューとジョブが同じリージョンにある必要があります。
-
左側のナビゲーションペインで、 を選択します。
-
MPS キューリストで、通知を有効にしたい MPS キューを探し、操作列の[メッセージ通知の設定]をクリックします。
-
[メッセージ通知の設定] ダイアログボックスで、以下のパラメーターを設定します。
パラメーター
説明
[メッセージ通知]
スイッチをオンにします。
[メッセージタイプ]
SMQ エンティティタイプに基づいて[キュー]または[トピック]を選択します。
[キュー名]
メッセージタイプ で [キュー] を選択した場合、[キュー名] ドロップダウンリストから目的のキューを選択します。
[メッセージ名]
メッセージタイプ で [トピック] を選択した場合は、メッセージ名 ドロップダウンリストから目的のトピックを選択します。
-
OK をクリックして、紐付けを完了します。
ステップ 4:通知の設定
単一ジョブの通知設定
ジョブを作成するときに、Simple Message Queue (旧称:MNS) のトピックまたはキューにバインドされた MPS キューを選択します。ジョブのステータスが変更されると、MPS は指定された宛先に通知を送信します。
MPS キューのタイプはジョブのタイプと一致する必要があります。たとえば、インテリジェントサムネイルジョブの通知を受信するには、通知が有効になっているインテリジェントサムネイル MPS キューを使用し、ジョブの作成時にそのキューを選択します。
ワークフローの通知設定
ワークフローのジョブが開始および終了したときに通知を受信するには、ワークフローの [入力] ノードで通知を有効にします。
-
ApsaraVideo Media Processing コンソールで、左側のナビゲーションペインのを選択します。
-
ワークフローの作成 をクリックして、ワークフローの作成ページに移動します。
-
ワークフローの トポロジー 編集セクションで、入力 ノードの編集アイコンをクリックします。
-
[入力設定] ダイアログボックスで、メッセージ通知 をオンにし、次のパラメーターを設定します。
説明ワークフロージョブの場合、入力 ノードの通知設定が MPS キュー設定を上書きします。
パラメーター
説明
[入力バケット]
入力パスを選択すると自動的に入力されます。
[入力パス]
処理する入力ファイルのパス
[MPS キューのトランスコード]
以前にバインドされたトランスコードパイプラインを選択します。
[メッセージ通知]
オンにすると通知が有効になります。
[メッセージタイプ]
メッセージの宛先タイプ。これは、以下で選択する Simple Message Queue (旧称:MNS) のエンティティタイプ ([キュー] または [トピック]) と一致する必要があります。
[キュー (トピック) 名]
宛先のキューまたはトピックを選択します。
-
「ワークフローの作成」で説明されているように、他のワークフローノードを設定します。