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

Object Storage Service:トリガー

最終更新日:Mar 21, 2026

トリガーは、Object Storage Service (OSS) バケットに格納された増分オブジェクトに対してデータ処理タスクを開始します。たとえば、新しくアップロードされた DOCX オブジェクトを PDF に変換したり、MOV オブジェクトを MP4 にトランスコードしたりできます。手動操作は不要です。バッチプロセッサとは異なり、トリガーは既存のオブジェクトではなく、新たに追加された(増分)オブジェクトに対してのみ動作します。

Intelligent Media Management (IMM) の機能は、すべての サポートされているリージョン で API オペレーションまたは SDK を介して利用できます。

トリガーの作成

前提条件

作業を開始する前に、以下の準備が完了していることを確認してください。

  • 処理対象のオブジェクトを含む OSS バケット

  • Document Processing または Media Processing 配下に設定済みの IMM 処理スタイル。スタイルが存在しない場合は、コンソールで [スタイルの追加] を選択して作成してください。

  • AliyunIMMBatchTriggerRole サービスロール。クラウドリソースアクセス認可ページから作成してください。

  • (任意)タスク通知を受信する場合の Simple Message Queue (SMQ) トピック

警告

トリガーループやソースオブジェクトの上書きなど、予期しない動作を回避するため、出力パスの先頭が入力パスと一致しないようにしてください。{key}{barename}、または {basename} 変数を使用する場合は、解決後の出力パスが入力パスと異なることを確認してください。

操作手順

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

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

  3. 左側のナビゲーションツリーで [Data Processing] をクリックします。

  4. [Document Processing][Media Processing]、または IMM が提供するその他のデータ処理機能をクリックします。

  5. [Trigger] タブをクリックし、[Create Trigger] をクリックします。

  6. [Create Trigger] パネルで、以下の各セクションを設定します。

    入力設定

    パラメーター説明
    Input Storage Bucket処理対象のオブジェクトを含むバケットです。
    Path Prefix監視対象パスのプレフィックスです。たとえば、images/images/ ディレクトリ配下のすべてのオブジェクトを監視します。
    Filter Ruleプレフィックス内のどのオブジェクトを処理するかを絞り込みます。以下のいずれかを選択します:All(ディレクトリ内のすべてのオブジェクト)、Prefix(指定した文字列で始まるオブジェクト名。例:raw-)、または Suffix(指定した拡張子を持つオブジェクト。例:.mov)。複数の値を指定する場合は、カンマで区切ります。

    出力設定

    パラメーター説明
    Style適用する処理スタイルです。スタイルが利用できない場合は、ドロップダウンリストから [Add Style] を選択します。
    Output Path処理済みオブジェクトの保存パスです。ファイル拡張子を含むオブジェクト名を必ず含め、出力オブジェクト同士が上書きされないように少なくとも 1 つの変数を含める必要があります。また、パスは / で終わってはいけません。

    権限設定

    パラメーター説明
    Service RoleIMM が OSS および他のクラウドサービスにアクセスするために偽装するロールです。AliyunIMMBatchTriggerRole を選択してください。

    通知設定

    パラメーター説明
    Message Queue(オプション)タスク通知を受信するための SMQ トピックです。設定の詳細については、「概要」をご参照ください。

    Create Trigger panel

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

トリガーが作成され、Ready ステータスになります。設定された条件に一致する新しいオブジェクトがアップロードされるたびに、データ処理タスクが開始されます。トリガーが正しく動作することを確認するには、バケットにいくつかのオブジェクトをアップロードし、タスクリストを確認してください。

データ処理タスクでは料金が発生します。詳細については、「課金項目」をご参照ください。

トリガーとタスクステータスの確認

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

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

  3. 左側のナビゲーションツリーで [Data Processing] をクリックし、タスクタイプ([Document Processing] または [Media Processing])をクリックします。

  4. [Trigger] タブをクリックします。トリガーリストには、各トリガーのステータスが表示されます。

    ステータス説明
    Readyトリガーは準備完了状態です。
    Runningトリガーは実行中です。
    Succeededトリガーは正常に完了しました。
    Suspendedトリガーは一時停止されており、新しいタスクを開始しません。すでに進行中のタスクは引き続き実行されます。
    Failedトリガーでエラーが発生しました。
  5. 特定のトリガーを検索するには、[Trigger ID] 検索ボックスにその ID を入力します。

  6. トリガーの詳細を表示するには、[Actions] 列の [View Details] をクリックします。

  7. トリガーによって開始されたすべてのタスクを表示するには、トリガー ID の横にあるアイコンをクリックします。ソースオブジェクトパスまたはステータスでタスクをフィルタリングできます。

制限事項

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

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

  • 出力パスには、ファイル拡張子付きのオブジェクト名を含める必要があります。出力パスを一意にするために、オブジェクト名に変数を使用します。

  • トリガーを一時停止すると、新しいタスクの開始が停止されます。すでに送信済みのタスクには影響しません。