バッチ処理を使用すると、一度にObject Storage Service (OSS) バケット内の複数のオブジェクトを処理できます。 たとえば、名前にを含むオブジェクトの形式を変換できます。バケットのディレクトリ内のdocxサフィックスをPDFに変換し、オブジェクトの形式をMOVからMP4にトランスコードします。
新しいバージョンのAPI操作を呼び出し、新しいバージョンのSDKをIntelligent Media Management (IMM) でサポートされているリージョンで使用できます。
使用上の注意
バッチ処理ジョブは、特定の条件を満たすすべてのオブジェクトのデータ処理タスクを作成します。 テスト用の少数のオブジェクトに対してバッチ処理ジョブを実行することをお勧めします。
バッチ処理ジョブが中断された場合、新しいデータ処理タスクは生成されませんが、送信されたデータ処理タスクは影響を受けません。
トリガーによるループやソースオブジェクトの上書きなどの予期しない動作を回避するには、入力パスのプレフィックスが付いた出力パスを指定しないでください。
出力パスはスラッシュ (
/) で終わることはできません。 出力パスには、拡張子付きのオブジェクト名を含める必要があります。 オブジェクト名には変数を使用できます。 変数の詳細については、「変数」をご参照ください。出力パスがスラッシュ (
/) で終わっていない場合は、出力オブジェクトの名前に少なくとも1つの変数を含めます。 そうしないと、複数の出力オブジェクトが互いに上書きされます。{key} 、{barename} 、または {basename} 変数を出力パスとして使用する場合は、出力パスが入力パスと異なることを確認してください。 それ以外の場合、ソースオブジェクトは上書きされるか、タスクはループで実行されます。
バッチ処理ジョブの作成
OSS コンソールにログインします。
左側のナビゲーションウィンドウで、[バケット] をクリックします。 [バケットリスト] ページで、バッチ処理ジョブを作成するバケットをクリックします。
左側のナビゲーションウィンドウで、[データ処理] をクリックします。
左側のナビゲーションウィンドウで、[ドキュメント処理] 、[メディア処理] 、またはビジネス要件に基づいてIntelligent Media Management (IMM) が提供するその他のデータ処理機能をクリックします。 次の例では、ドキュメント処理がクリックされています。
[バッチ処理] タブをクリックし、[バッチ処理の作成] をクリックします。
[バッチ処理の作成] パネルで、[入力設定] 、[出力設定] 、[権限設定] 、および [通知設定] セクションでパラメーターを設定します。
パラメーター
説明
入力ストレージバケット
処理するオブジェクトが保存されているバケットの名前。
モード
有効な値: [ファイルの選択] または [プレフィックスの選択] 。
ファイルの選択: 選択した複数のオブジェクトに対してデータ処理が実行されます。
プレフィックスの選択: 特定のディレクトリ内の特定のルールを満たすオブジェクトに対してデータ処理が実行されます。
入力パス
[モード] で [ファイルの選択] を選択した場合、データ処理用のオブジェクトを1つ以上選択できます。
パスプレフィックス
[モード] で [プレフィックスの選択] を選択した場合、オブジェクトのパスにプレフィックスを指定し、フィルタールールを使用してデータ処理用のオブジェクトを選択できます。
フィルタールール
[モード] で [プレフィックスの選択] を選択した場合、パスプレフィックスとフィルタールールを指定して、処理するオブジェクトをフィルター処理できます。
すべて: Path Prefixパラメーターで指定されたディレクトリ内のすべてのオブジェクトが処理されます。
Prefix: Path prefixパラメーターで指定されたディレクトリ内の特定のプレフィックスを名前に含むオブジェクトが処理されます。 複数のプレフィックスはコンマ (,) で区切ります。
サフィックス: Pathサフィックスパラメーターで指定されたディレクトリ内の特定のサフィックスを名前に含むオブジェクトが処理されます。 複数のサフィックスはコンマ (,) で区切ります。
スタイル
オブジェクトの処理スタイル。 使用できる処理スタイルがない場合は、ドロップダウンリストから [スタイルの追加] を選択して処理スタイルを作成します。
出力パス
処理されたオブジェクトのストレージパス。
ストレージパスはスラッシュ (/) で終わることはできません。 出力パスで変数を使用することを推奨します。 そうしないと、複数の出力オブジェクトが互いに上書きされます。 詳細については、「変数」をご参照ください。
サービスロール
サービスロール。 IMMは、OSSなどの他のクラウドサービスのリソースにアクセスするためのサービスロールを引き受けます。
AliyunIMMBatchTriggerRoleを選択することを推奨します。 [クラウドリソースアクセス権限付与] ページで、AliyunIMMBatchTriggerRoleロールを作成できます。メッセージキュー (Message Queue)
メッセージサービス (MNS) トピック。 データ処理ジョブが完了すると、通知を使用して処理結果がMNSに送信されます。 詳細については、「概要」をご参照ください。
[OK] をクリックします。
バッチ処理ジョブが作成された後、既存の各オブジェクトに対して対応するデータ処理タスクが生成されます。 タスクが実行されると、対応する料金が発生します。 詳細については、「課金項目」をご参照ください。
バッチ処理ジョブの照会
OSS コンソールにログインします。
左側のナビゲーションウィンドウで、[バケット] をクリックします。 [バケットリスト] ページで、バッチ処理ジョブをクエリするバケットをクリックします。
左側のナビゲーションウィンドウで、[データ処理] をクリックします。
左側のナビゲーションウィンドウで、[ドキュメント処理] 、[メディア処理] 、またはオブジェクトのタイプに基づいてIMMが提供するその他のデータ処理機能をクリックします。
[バッチ処理] タブをクリックして、バッチ処理ジョブのデータ処理タスクを表示します。 ページ下部のページ上下アイコンをクリックすると、前または次のページが表示されます。
バッチ処理ジョブのデータ処理タスクのステータスを次の表に示します。
ステータス
説明
準備完了
データ処理タスクが新しく作成され、準備完了です。
Running
データ処理タスクが実行中です。
成功
データ処理タスクが完了しました。
Suspended (中断)
データ処理タスクが中断されました。
失敗した
データ処理タスクは失敗し、自動的に回復できません。
[バッチ処理ID] 検索ボックスにIDを入力し、検索アイコンをクリックして特定のバッチ処理ジョブを検索します。
[操作] 列の [詳細] をクリックして、バッチ処理ジョブの詳細を表示します。
バッチ処理IDの横にあるアイコンをクリックして、バッチ処理ジョブのすべてのデータ処理タスクに関する情報を表示します。 ソースファイルのパスとステータスに基づいて、データ処理タスクを検索できます。 [操作] 列の [詳細] をクリックすると、データ処理タスクの詳細が表示されます。