Cloud Parallel File Storage:CreateDataFlowTask

ファイルシステムの ID。

• CPFS General Purpose Edition：ID は cpfs- で始まる必要があります (例：cpfs-125487****)。

• CPFS AI-Computing Edition：ID は bmcpfs- で始まる必要があります (例：bmcpfs-0015****)。

データフローの ID。

SrcTaskId を指定する場合は、データフロータスクの ID を入力します。システムは、指定したタスクから TaskAction、DataType、および EntryList パラメーター情報をコピーします。これらのパラメーターを指定する必要はありません。

データフロータスクのタイプ。

有効な値：

• Import：ソースストレージから CPFS ファイルシステムに指定されたデータをインポートします。

• Export：CPFS ファイルシステムからソースストレージに指定されたデータをエクスポートします。

• StreamImport：ソースストレージから CPFS ファイルシステムに大量の指定されたデータをインポートします。

• StreamExport：CPFS ファイルシステムからソースストレージに大量の指定されたデータをエクスポートします。

• Evict：CPFS ファイルシステムからファイルのデータブロックをエビクトします。エビクト後は、ファイルのメタデータのみが保持されます。ファイルのクエリは引き続き可能ですが、データブロックはクリアされ、ストレージ容量を占有しなくなります。ファイルデータにアクセスすると、ソースストレージからオンデマンドで読み込まれます。

• Inventory：CPFS ファイルシステムのデータフローによって管理されているファイルのインベントリを取得します。これにより、データフロー内のファイルのキャッシュステータスが提供されます。

データフロータスクが扱うデータタイプ。

有効な値：

• Metadata：タイムスタンプ、所有権、権限などの属性を含むファイルのメタデータ。Metadata を選択すると、ファイルのメタデータのみがインポートされます。ファイルは表示できますが、ファイルデータにアクセスすると、ソースストレージからオンデマンドで読み込まれます。

• Data：ファイルのデータブロック。

• MetaAndData：ファイルのメタデータとデータブロック。

データのソースディレクトリ。

制限：

• 長さは 1～1,023 文字である必要があります。

• ディレクトリは UTF-8 でエンコードされている必要があります。

• ディレクトリの先頭と末尾はスラッシュ (/) である必要があります。

• 一度に指定できるディレクトリは 1 つだけです。

• TaskAction が Export の場合、このディレクトリは FileSystemPath 内の相対パスである必要があります (例：/path_in_cpfs/)。

• TaskAction が Import の場合、このディレクトリは SourceStoragePath 内の相対パスである必要があります (例：/path_in_oss/)。

• TaskAction が StreamExport の場合、このディレクトリは FileSystemPath 内の相対パスである必要があります。

• TaskAction が StreamImport の場合、このディレクトリは SourceStoragePath 内の相対パスである必要があります。

データフロータスクが実行するファイルのリスト。

制限：

• リストは UTF-8 でエンコードされている必要があります。

• ファイルリストの合計長は 64 KB 未満である必要があります。

• ファイルリストは JSON 形式である必要があります。

• 単一ファイルのパスは、長さが 1～1,023 文字で、先頭がスラッシュ (/) である必要があります。

• TaskAction が Import の場合、リスト内の各要素は OSS オブジェクト名を表します (例：["object/file1.txt", "object/file2.txt"])。

• TaskAction が Export の場合、リスト内の各要素は CPFS ファイルパスを表します (例：["/path_in_cpfs/file1", "/path_in_cpfs/file2"])。

この作成リクエストに対してドライランを実行するかどうかを指定します。

ドライランは、インスタンスを作成したり料金を発生させたりすることなく、パラメーターの妥当性とインベントリをチェックします。

有効な値：

• true：インスタンスを作成せずにチェックリクエストを送信します。システムは、必須パラメーター、リクエスト形式、仕様上の制限、および NAS インベントリをチェックします。チェックが失敗した場合、エラーが返されます。チェックが成功した場合、HTTP 200 ステータスコードが返されますが、TaskId は空です。

• false (デフォルト)：通常のリクエストを送信し、チェックが成功した後にインスタンスを作成します。

リクエストのべき等性を保証するクライアント生成トークン。トークンは異なるリクエスト間で一意である必要があります。

ClientToken には ASCII 文字のみを含めることができ、64 文字を超えてはなりません。詳細については、「べき等性を確保する方法」をご参照ください。

同じ名前のファイルに対するコンフリクトポリシー。 有効な値：

• SKIP_THE_FILE：同じ名前のファイルをスキップします。

• KEEP_LATEST：更新時刻を比較し、最新バージョンを保持します。

• OVERWRITE_EXISTING：同じ名前のファイルを強制的に上書きします。

データフロータスクマッピングの宛先ディレクトリ。 制限：

• ディレクトリの先頭と末尾はスラッシュ (/) である必要があります。/../ シーケンスはサポートされていません。

• 長さは 1～1,023 文字である必要があります。

• ディレクトリは UTF-8 でエンコードされている必要があります。

• 一度に指定できるディレクトリは 1 つだけです。

• TaskAction が Export の場合、このディレクトリは SourceStoragePath 内の相対パスである必要があります (例：/path_in_oss/)。

• TaskAction が Import の場合、このディレクトリは FileSystemPath 内の相対パスである必要があります (例：/path_in_cpfs/)。

• TaskAction が StreamExport の場合、このディレクトリは SourceStoragePath 内の相対パスである必要があります。

• TaskAction が StreamImport の場合、このディレクトリは FileSystemPath 内の相対パスである必要があります。

ディレクトリが存在しない場合に自動的に作成するかどうかを指定します。 有効な値：

• true：ディレクトリを自動的に作成します。

• false (デフォルト)：ディレクトリを自動的に作成しません。

Directory パラメーター配下のサブディレクトリをフィルタリングし、フィルタリングされたサブディレクトリのコンテンツを転送します。

OSS ディレクトリを指定します。データはこのディレクトリ内の CSV ファイルの内容に基づいて同期されます。このパスには以下の制限があります。

• パスの先頭と末尾はスラッシュ (/) である必要があります。

• パスは大文字と小文字を区別します。

• 長さは 1～1,023 文字である必要があります。

• パスは UTF-8 でエンコードされている必要があります。