ApsaraVideo Media Processing:ワークフローをトリガーする

トリガーモードの比較

モード 1：自動トリガー

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

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

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

   • ファイルパスは、パス一致ルールに準拠しています。詳細については、このトピックの「パス一致ルール」セクションをご参照ください。

   • ファイル名は、ファイル名拡張子一致ルールに準拠しています。詳細については、このトピックの「ファイル名拡張子一致ルール」セクションをご参照ください。

   • ファイルは、OSS の次の API オペレーションのいずれかを呼び出すことによってアップロードされます。

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

モード 2：手動トリガー（検証済みパス以下のファイル用）

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

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

   • ファイルパスは パス一致ルール に準拠しています。詳細については、このトピックの「パス一致ルール」セクションをご参照ください。

   • ファイル名は ファイル名拡張子一致ルール に準拠しています。詳細については、このトピックの「ファイル名拡張子一致ルール」セクションをご参照ください。

   • ファイルは、任意の OSS の API オペレーションを呼び出すことによってアップロードされます。

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

モード 3：手動トリガー（異なるパス以下のファイル用）

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

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

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

   • ファイルは、任意の OSS の API オペレーションを呼び出すことによってアップロードされます。

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

ファイル一致ルール

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

ワークフローの 入力パス が 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 はトリガーされます。

パス一致ルール

入力ファイルの パス が、ワークフローの 入力ノード に指定した入力パス以下の場合、入力ファイルはワークフローをトリガーできます。それ以外の場合、入力ファイルはワークフローをトリガーできません。例：