すべてのプロダクト
Search

このプロダクト

    Object Storage Service:バッチ処理

    ドキュメントセンター

    Object Storage Service:バッチ処理

    最終更新日:Apr 24, 2026

    バッチ処理を使用すると、バケット内の既存のオブジェクトに対して大規模な操作を実行できます。たとえば、特定のディレクトリ内のすべての .docx オブジェクトを PDF 形式に変換したり、すべての MOV オブジェクトを MP4 形式にトランスコードしたりできます。

    説明

    新しいデータ処理 API と SDK は、IMM エンドポイントがあるリージョンで利用できます。

    注意事項

    • バッチ処理ジョブは、指定された条件を満たす各オブジェクトに対応するデータ処理タスクを生成します。より具体的なプレフィックスを使用して、少数のオブジェクトで設定をテストし、結果を確認することを推奨します。

    • バッチ処理ジョブを一時停止すると、新しいデータ処理タスクの作成は直ちに停止します。ただし、すでに送信されたタスクは完了するまで実行され続けます。

    • 再帰処理やソースオブジェクトの上書きなどの予期しない動作を防ぐため、入力パスが出力パスのプレフィックスにならないようにしてください。

    • 出力パスをフォワードスラッシュ (/) で終了させることはできません。拡張子を含む完全な出力オブジェクトパスを指定する必要があります。オブジェクト名には変数を含めることができます。変数の詳細については、「変数」をご参照ください。

    • 出力パスが / で終わらない場合、ファイル名には少なくとも 1 つの変数を含める必要があります。そうしないと、複数の出力ファイルが互いに上書きされます。

    • 出力パスで {key}、{barename}、または {basename} 変数を使用する場合、出力パスが入力パスと異なることを確認してください。そうしないと、ソースオブジェクトが上書きされたり、再帰処理がトリガーされたりする可能性があります。

    バッチ処理ジョブの作成

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

    2. 左側のナビゲーションウィンドウで、バケットをクリックし、次に対象のバケットをクリックします。

    3. 左側のナビゲーションウィンドウで、[データ処理]を選択します。

    4. 処理したいオブジェクトの種類に応じて、ドキュメント処理、ApsaraVideo Media Processing、または Intelligent Media Management (IMM) が提供する他のデータ処理機能を選択します。本トピックでは、ドキュメント処理を例に説明します。

    5. バッチ処理 タブをクリックし、次に [バッチ処理の作成] をクリックします。

    6. [バッチ処理の作成] パネルで、[入力設定]、[出力設定]、[権限設定]、および[通知設定] の各セクションで設定を行います。

      パラメータ

      説明

      入力バケット

      バッチ処理ジョブのソースオブジェクトが含まれるバケットです。

      モード

      ファイルを選択 または プレフィックスを選択 のいずれかを選択できます。

      • ファイルを選択：1 つまたは複数の特定のオブジェクトを処理します。

      • プレフィックスを選択：指定されたディレクトリ内で、フィルター ルールに一致するすべてのオブジェクトを処理します。

      入力パス

      [モード] を ファイルを選択 に設定した場合、処理するソースオブジェクトを 1 つ以上選択します。

      パスプレフィックス

      [モード] を プレフィックスを選択 に設定した場合は、パスプレフィックスを指定して、ソースオブジェクトが含まれるディレクトリを特定します。フィルター ルールを使用して、処理するオブジェクトをさらに絞り込むことができます。

      フィルター ルール

      [モード] を プレフィックスを選択 に設定すると、パス プレフィックスとフィルター ルールを使用して、処理するオブジェクトを選択できます。

      • すべて: パスプレフィックスで指定されたディレクトリ内のすべてのオブジェクトを処理します。

      • ファイルプレフィックス: 指定されたディレクトリ内で、名前が特定のプレフィックスに一致するオブジェクトを処理します。複数のプレフィックスを指定するには、コンマ (,) で区切ります。

      • ファイルのサフィックス: 指定されたディレクトリ内で、名前が特定のサフィックスに一致するオブジェクトを処理します。複数のサフィックスを指定する場合は、カンマ (,) で区切ります。

      スタイル

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

      出力パス

      処理済みオブジェクトのストレージパスを指定します。

      パスはスラッシュ (/) で終わることはできません。複数のタスクの出力が互いに上書きされるのを防ぐために、出力パスで変数を使用する必要があります。詳細については、「変数」をご参照ください。

      サービスロール

      Intelligent Media Management (IMM) が、OSS などの他のクラウドリソースにアクセスするための権限を付与するサービスロールです。 AliyunIMMBatchTriggerRole サービスロールを使用することをお勧めします。 このロールが存在しない場合は、[クラウドリソースのアクセス承認] ページで作成できます。

      メッセージキュー

      タスクが完了すると、処理結果を含む通知が指定された MNS トピックに送信されます。詳細については、「概要」をご参照ください。

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

      バッチ処理ジョブを作成すると、システムは各ソースオブジェクトに対してデータ処理タスクを生成します。これらのタスクの実行に対して課金されます。詳細については、「課金」をご参照ください。

    バッチ処理ジョブのクエリ

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

    2. 左側のナビゲーションウィンドウで、バケット をクリックし、次に目的のバケットをクリックします。

    3. 左側のナビゲーションウィンドウで、[データ処理]を選択します。

    4. オブジェクトタイプに基づいて、ドキュメント処理、ApsaraVideo Media Processing、または Intelligent Media Management (IMM) が提供するその他のデータ処理機能を選択します。

    5. バッチ処理 タブをクリックすると、バッチ処理ジョブの一覧が表示されます。ページの下部にあるページネーションコントロールを使用して、リスト内を移動できます。

      次の表に、ジョブのステータスを示します。

      ステータス

      説明

      準備完了

      ジョブは実行準備ができています。新しく作成されたジョブはこの状態になります。

      実行中

      ジョブは実行中です。

      成功

      ジョブは正常に完了しました。

      一時停止中

      ジョブは一時停止中です。

      失敗

      回復不能なエラーのため、ジョブは失敗しました。

    6. [バッチ処理 ID] 検索ボックスにジョブ ID を入力し、検索アイコンをクリックすると、特定のジョブを検索できます。

    7. [操作] 列で 詳細 をクリックすると、バッチ処理ジョブの詳細を表示できます。

    8. ジョブ ID の横にある展開アイコンをクリックすると、そのジョブ内のすべてのタスクが表示されます。ソースオブジェクトパスまたはステータスでタスクを検索できます。タスクの [操作] 列で、詳細 をクリックすると、その詳細が表示されます。