ApsaraVideo Media Processing:ワークフローのトリガー

トリガーモードの比較

モード 1：自動トリガー

1. ワークフローを作成し、トリガーモードを自動トリガーに設定します。デフォルトでは、ワークフローを作成すると、そのトリガーモードは自動トリガーになります。ワークフローの作成方法の詳細については、「ワークフローの作成」をご参照ください。

2. ファイルを追加します。次の要件を満たす必要があります：

   • ファイルは、MPS または Intelligent Media Services (IMS) によって生成されたものではありません。詳細については、本トピックの「MPS または IMS によって生成されないファイル」のセクションをご参照ください。

   • ファイルパスは、パスマッチングルール に準拠する必要があります。詳細については、本トピックの「パスマッチングルール」のセクションをご参照ください。

   • ファイル名は、ファイル名拡張子マッチングルール に準拠する必要があります。詳細については、本トピックの「ファイル名拡張子マッチングルール」のセクションをご参照ください。

   • ファイルは、次のいずれかの OSS API を呼び出してアップロードされている必要があります。

     オペレーション	説明
     PutObject	オブジェクトをアップロードします。
     PostObject	HTML フォームを使用して、特定のバケットにオブジェクトをアップロードします。
     CopyObject	同じリージョン内のバケット内またはバケット間でオブジェクトをコピーします。
     CompleteMultipartUpload	オブジェクトのすべてのパートがアップロードされた後、アップロードされたパートを 1 つのオブジェクトに結合します。
     PutSymlink	オブジェクトのシンボリックリンクを作成します。これにより、シンボリックリンクを使用してオブジェクトにアクセスできます。

モード 2：検証済みパス配下のファイルに対する手動トリガー

1. ワークフローを作成します。ファイルを追加する前に、UpdateMediaWorkflowTriggerMode API を呼び出して、ワークフローのトリガーモードを 手動トリガー に変更する必要があります。ワークフローの作成方法の詳細については、「ワークフローの作成」をご参照ください。

2. ファイルを追加します。次の要件を満たす必要があります：

   • ファイルパスは、パスマッチングルール に準拠する必要があります。詳細については、本トピックの「パスマッチングルール」のセクションをご参照ください。

   • ファイル名は、ファイル名拡張子マッチングルール に準拠する必要があります。詳細については、本トピックの「ファイル名拡張子マッチングルール」のセクションをご参照ください。

   • ファイルは、任意の OSS API を呼び出してアップロードされている必要があります。

3. ファイルを追加した後、ビジネス要件に基づいて、処理するファイルとトリガーするワークフローの ID を指定するために AddMedia API を呼び出します。

モード 3：異なるパス配下のファイルに対する手動トリガー

1. ワークフローを作成します。ファイルを追加する前に、UpdateMediaWorkflowTriggerMode API を呼び出して、ワークフローのトリガーモードを 手動トリガー に変更する必要があります。ワークフローの作成方法の詳細については、「ワークフローの作成」をご参照ください。

2. ファイルを追加します。次の要件を満たす必要があります：

   • ファイルは、MPS がアクティブ化されているリージョンに保存されている必要があります。

   • ファイルは、任意の OSS API を呼び出してアップロードされている必要があります。

3. ファイルを追加した後、ビジネス要件に基づいて、処理するファイルとトリガーするワークフローの ID を指定するために AddMedia API を呼び出します。さらに、InputUnbind パラメータを false に設定します。これにより、MPS はファイルを パスマッチングルール または ファイル名拡張子マッチングルール に対してチェックしません。

ファイルマッチングルール

MPS または IMS によって生成されないファイル

ワークフローの 入力パス が MPS または IMS ジョブの 出力パス と同じ場合、そのジョブによって生成されたファイルはワークフローをトリガーできません。これにより、入力パスと出力パスが重複することによる循環トリガーを防ぎます。例：

ワークフロー A の 出力 パスとワークフロー B の 入力 パスがどちらも http://bucket.oss-cn-hangzhou.aliyuncs.com/A/ です。

• 入力ファイル http://bucket.oss-cn-hangzhou.aliyuncs.com/A/example.flv がワークフロー A によって生成された場合、ワークフロー B はトリガーされません。

• 入力ファイル http://bucket.oss-cn-hangzhou.aliyuncs.com/A/example.flv がパス http://bucket.oss-cn-hangzhou.aliyuncs.com/A/ に直接アップロードされた場合、ワークフロー B はトリガーされます。

パスマッチングルール

入力ファイルがワークフローをトリガーできるのは、そのファイルのパスがワークフローの入力ノードに指定された入力パス配下にある場合のみです。例：