バッチ処理を使用して、バケット内の既存のオブジェクトに対して一括操作を実行します。たとえば、特定のディレクトリにある拡張子が .docx のすべてのオブジェクトを PDF に変換したり、MOV 形式のすべてのオブジェクトを MP4 にトランスコードしたりできます。
データ処理用の最新の API と SDK は、IMM サービスエンドポイントで指定されたリージョンで利用できます。
注意事項
バッチ処理ジョブは、指定された条件に一致するすべてのオブジェクトに対してデータ処理タスクを作成します。意図しない操作やコストを避けるため、まず狭いパスプレフィックスを持つ少数のオブジェクトでジョブをテストすることを推奨します。
バッチ処理ジョブを一時停止すると、新しいデータ処理タスクの作成は直ちに停止します。ただし、すでに送信されたタスクは完了するまで実行され続けます。
再帰的トリガーやソースオブジェクトの上書きなどの意図しない動作を防ぐため、出力パスが入力パスのプレフィックスにならないようにしてください。
出力パスをフォワードスラッシュ (
/) で終えることはできません。ファイル拡張子を含む完全な出力オブジェクトパスを指定する必要があります。オブジェクト名には変数を含めることができます。変数についての詳細は、「変数」をご参照ください。出力パスがフォワードスラッシュ (
/) で終わらない場合、タスクが互いに上書きされるのを防ぐために、オブジェクト名には少なくとも 1 つの変数を含める必要があります。出力パスで変数 {key}、{barename}、または {basename} を使用する場合、ソースオブジェクトの上書きや再帰ループの作成を防ぐため、結果として得られる出力パスが入力パスと異なることを確認してください。
バッチ処理ジョブの作成
OSS コンソールにログインします。
左側のナビゲーションウィンドウで、[バケット] をクリックします。[バケット] ページで、対象のバケットをクリックします。
左側のナビゲーションウィンドウで、[データ処理] を選択します。
処理する必要があるオブジェクトの種類に応じて、[ドキュメント処理]、[メディア処理]、または Intelligent Media Management (IMM) が提供するその他のデータ処理機能を選択します。このトピックでは、ドキュメント処理を例として使用します。
[バッチ処理] タブをクリックし、[バッチ処理の作成] をクリックします。
[バッチ処理の作成] パネルで、[入力設定]、[出力設定]、[権限設定]、[通知設定] の各セクションで設定を行います。
パラメーター
説明
入力ストレージバケット
処理対象のオブジェクトが含まれるバケット。
モード
処理対象のオブジェクトを選択する方法を指定します。[ファイルの選択] または [プレフィックスの選択] のいずれかを選択できます。
[ファイルの選択]：選択した特定のオブジェクトを処理します。
[プレフィックスの選択]：指定したディレクトリ内で特定のルールに一致するオブジェクトを処理します。
入力パス
[モード] を [ファイルの選択] に設定した場合は、処理する 1 つ以上のオブジェクトを選択します。
パスプレフィックス
[モード] を [プレフィックスの選択] に設定した場合は、処理するオブジェクトを識別するためのパスプレフィックスを指定します。このパラメーターはフィルター ルールと組み合わせて使用できます。
フィルター ルール
[モード] を [プレフィックスの選択] に設定した場合、フィルター ルールを指定することで、処理するオブジェクトをさらに絞り込むことができます。
[すべて]：パスプレフィックスで指定されたディレクトリ内のすべてのオブジェクトを処理します。
[プレフィックス]：パスプレフィックスで指定されたディレクトリ内で、指定されたプレフィックスに名前が一致するオブジェクトを処理します。複数のプレフィックスはコンマ (,) で区切ります。
[サフィックス]：パスプレフィックスで指定されたディレクトリ内で、指定されたサフィックスに名前が一致するオブジェクトを処理します。複数のサフィックスはコンマ (,) で区切ります。
スタイル
オブジェクトの処理スタイルを選択します。利用可能なスタイルがない場合は、ドロップダウンリストから [スタイルの追加] をクリックして作成できます。
出力パス
処理されたオブジェクトのストレージパスを指定します。
パスはフォワードスラッシュ (/) で終えることはできません。一意の出力パスを確保し、上書きを防ぐために変数を使用することを推奨します。詳細については、「変数」をご参照ください。
サービスロール
IMM に OSS などの他のクラウドリソースへのアクセス権限を付与するサービスロールです。サービスロール
AliyunIMMBatchTriggerRoleを使用します。このロールが存在しない場合は、クラウドリソースアクセス承認ページで作成できます。メッセージキュー
Message Service (MNS) トピックを選択します。 タスクが完了したときに MNS トピックに通知を送信するようにジョブを設定できます。詳細については、「クイックスタート」をご参照ください。
[OK] をクリックします。
バッチ処理ジョブが作成されると、一致する各オブジェクトに対応するデータ処理タスクが生成されます。これらのタスクを実行すると料金が発生します。詳細については、「課金項目」をご参照ください。
バッチ処理ジョブのクエリ
左側のナビゲーションウィンドウで、[バケット] をクリックします。[バケット] ページで、対象のバケットをクリックします。
処理したオブジェクトの種類に基づいて、[ドキュメント処理]、[メディア処理]、または IMM が提供するその他のデータ処理機能を選択します。
[バッチ処理] タブをクリックして、バッチ処理ジョブのリストを表示します。ページ下部のページネーションコントロールを使用して、リストをナビゲートできます。
次の表に、バッチ処理ジョブのステータスを示します。
ステータス
説明
準備完了
ジョブの開始準備ができています。
実行中
ジョブは進行中です。
成功
ジョブは正常に完了しました。
一時停止
ジョブは手動で一時停止されています。
失敗
ジョブはエラーにより失敗し、自動的に回復できません。
特定のジョブを見つけるには、その ID を [バッチ処理 ID] 検索ボックスに入力し、検索アイコンをクリックします。
[操作] 列の [詳細] をクリックして、バッチ処理ジョブの詳細を表示します。
バッチ処理 ID の横にある展開アイコンをクリックすると、そのジョブ内のすべてのデータ処理タスクが表示されます。ソースオブジェクトパスまたはステータスでタスクを検索できます。特定のタスクの [操作] 列にある [詳細] をクリックすると、その詳細が表示されます。