すべてのプロダクト
Search
ドキュメントセンター

Object Storage Service:トリガー

最終更新日:Jul 07, 2025

トリガーは、Object Storage Service (OSS) バケットに格納されている一致した増分オブジェクトのデータ処理タスクを開始します。 たとえば、バケットの特定のディレクトリにある増分DOCXオブジェクトをPDFオブジェクトに変換したり、増分MOVオブジェクトをMP4オブジェクトにトランスコードしたりするトリガーを作成できます。 バッチプロセッサとは異なり、トリガーはバケット内の増分オブジェクトに対してのみタスクを開始し、バケット内の既存のオブジェクトに対しては開始しません。

説明

新しいバージョンのIntelligent Media Management (IMM) の機能は、API操作を呼び出すか、SDKを使用することで、サポートされているすべてのリージョンで使用できます。

使用上の注意

  • トリガーは、指定された条件を満たすすべてのオブジェクトのデータ処理タスクを開始します。 トリガーを作成した後、いくつかのオブジェクトをアップロードしてトリガーをテストできます。

  • トリガーを一時停止すると、トリガーは新しいデータ処理タスクを開始しなくなります。 ただし、既に送信されたタスクは影響を受けません。

  • トリガーループやソースオブジェクトの上書きなどの予期しない動作を防ぐには、入力パスで始まる出力パスを指定しないでください。

  • 出力パスはスラッシュ (/) で終わることはできません。 出力パスには、拡張子付きのオブジェクト名を含める必要があります。 オブジェクト名には変数を使用できます。 変数の詳細については、「変数」をご参照ください。

  • 出力パスには少なくとも1つの変数を含める必要があります。 そうしないと、出力オブジェクトが互いに上書きされます。

  • {key} 、{barename} 、または {basename} 変数を出力パスとして使用する場合は、出力パスが入力パスと異なることを確認してください。 それ以外の場合、ソースオブジェクトは上書きされるか、タスクはループで実行されます。

  • トリガーの出力オブジェクトは、別のトリガーの入力オブジェクトとして使用できません。

  • トリガーは標準オブジェクトのみをサポートします。

トリガーの作成

  1. OSS コンソールにログインします。

  2. 左側のナビゲーションウィンドウで、[バケット] をクリックします。 [バケットリスト] ページで、バケットの名前をクリックします。

  3. 左側のナビゲーションツリーで、[データ処理] をクリックします。

  4. ビジネス要件に基づいて、[ドキュメント処理][メディア処理] 、またはIMMが提供するその他のデータ処理機能をクリックします。 この例では、ドキュメント処理が使用されます。

  5. トリガー タブをクリックします。 次に、[トリガーの作成] をクリックします。

  6. [トリガーの作成] パネルで、[入力設定][出力設定][権限設定] 、および [通知設定] セクションでパラメーターを設定します。

    image

    パラメーター

    説明

    入力ストレージバケット

    処理するオブジェクトを含むバケットの名前。

    パスプレフィックス

    処理するオブジェクトのパスプレフィックス。

    フィルタールール

    指定されたパスプレフィックス内のオブジェクトをフィルタリングするためのフィルタ

    • すべて: Path Prefixパラメーターで指定されたディレクトリ内のすべてのオブジェクトが処理されます。

    • Prefix: Path prefixパラメーターで指定されたディレクトリ内の特定のプレフィックスを名前に含むオブジェクトが処理されます。 複数のプレフィックスを指定するには、コンマ (,) で区切ります。

    • サフィックス: Path Prefixパラメーターで指定されたディレクトリ内の特定のサフィックスを名前に含むオブジェクトが処理されます。 複数のサフィックスを指定するには、コンマ (,) で区切ります。

    スタイル

    オブジェクトの処理に使用するスタイル。 利用可能なスタイルがない場合は、ドロップダウンリストから [スタイルの追加] を選択してスタイルを作成します。

    出力パス

    処理されたオブジェクトのストレージパス。

    ストレージパスはスラッシュ (/) で終わることはできません。 出力パスで変数を使用することを推奨します。 そうしないと、複数の出力オブジェクトが互いに上書きされます。 詳細については、「変数」をご参照ください。

    サービスロール

    サービスロール。 IMMは、OSSなどの他のクラウドサービスのリソースにアクセスするためのサービスロールを引き受けます。 AliyunIMMBatchTriggerRoleを選択することを推奨します。 [クラウドリソースアクセス権限付与] ページで、AliyunIMMBatchTriggerRoleロールを作成できます。

    メッセージキュー (Message Queue)

    タスク通知の送信先のシンプルメッセージキュー (SMQ) トピック。 詳細については、「概要」をご参照ください。

  7. OK をクリックします。

    トリガーが作成された後、対応するデータ処理タスクが、バケット内の一致した増分オブジェクトごとに開始されます。 データ処理タスクは、対応する料金を生成する。 詳細については、「課金項目」をご参照ください。

トリガーの照会

  1. OSS コンソールにログインします。

  2. 左側のナビゲーションウィンドウで、[バケット] をクリックします。 [バケットリスト] ページで、トリガーが属するバケットをクリックします。

  3. 左側のナビゲーションツリーで、インテリジェントデータ処理 をクリックし、[ドキュメント処理][メディア処理] などのタスクの種類をクリックします。

  4. トリガー タブをクリックします。

    次の表に、トリガーのステータスを示します。

    ステータス

    説明

    準備完了

    トリガーの準備ができました。

    Running

    トリガーが実行中です。

    成功

    トリガーが成功しました。

    Suspended (中断)

    トリガーが中断されます。 トリガーがタスクを開始しなくなりました。 ただし、開始されて完了していないタスクは引き続き実行されます。

    失敗した

    トリガーに失敗しました。

  5. 特定のトリガーを検索するには、[トリガーID] 検索ボックスにトリガーのIDを入力します。

  6. トリガーの詳細を表示するには、操作 列の 詳細 をクリックします。

  7. トリガーIDの横にあるアイコンをクリックすると、トリガーによって開始されるすべてのデータ処理タスクに関する情報が表示されます。 ソースオブジェクトのパスとステータスに基づいて、データ処理タスクを検索できます。