REST APIリファレンス

前へ次へ

ファイルの解凍と転送

アップロードしたファイルを解凍して、リモートサーバーのホームディレクトリから目的の場所に転送します。

POST要求

ファイルを解凍して転送するには、次のURIに接続IDを含めます。

mftsaas/api/v1/filetransferTask/execute/1004

要求に次の情報を含めます。

フィールド	タイプ	必須	説明
agentGroupId	String	○	エージェントグループのID。
portalUser	String	-	ユーザーがポータルユーザーであるかどうかを示します。デフォルトは［false］です。
relativeSourceLocation	文字列	-	リモートサーバーのホームディレクトリ内の相対的なソースの場所。
pattern	String	○	ファイルを解凍した後に、指定したターゲットの場所にリリースするファイルのファイルパターン。正規表現パターンがサポートされています。
targetLocation	String	○	解凍後にファイルが移動されるターゲットディレクトリ。
relativeTargetLocation	文字列	-	リモートサーバーのホームディレクトリ内の相対的なターゲットの場所。
connectionId	String	○	Advanced FTP、Advanced FTPS、またはAdvanced SFTP V2コネクタの接続ID。
afterFilePickupAction	文字列	-	ファイル転送後のソースファイルの処理を決定します。以下のフィルタオプションのいずれか1つを選択してください。 KEEP。ソースディレクトリ内でファイルを保持します。 DELETE。ソースディレクトリからファイルを削除します。 RENAME。ソースディレクトリ内でファイルの名前を変更します。 ARCHIVE。別の場所にファイルをアーカイブします。アーカイブディレクトリを指定する必要があります。デフォルトは、KEEPです。
renameSuffix	String	○	afterFilePickupActionに［RENAME］が選択されている場合に、ソースディレクトリ内のファイルに追加するファイル名のサフィックス。次のサフィックスタイプを使用できます。 $date $time $runId $timestamp
archiveDirectoryPath	String	○	afterFilePickupActionに［ARCHIVE］が選択されている場合、ファイルをアーカイブするアーカイブディレクトリ。
skipDuplicateFiles	文字列	-	docstoreの場所にすでに存在するソースファイルをスキップするかどうかを示します。デフォルトはfalseです。
processFilesRecursively	文字列	-	ベースディレクトリ内のすべてのサブフォルダからファイルを処理するかどうかを示します。デフォルトはfalseです。
DECOMPRESSION_TYPE	String	○	解凍するファイルの形式。次のいずれかの解凍方式を選択します。郵便番号 Tar Gzip 値の大文字と小文字は区別されません。
PATTERN_TO_COLLECT	String	○	ファイルサーバーユーザーのホームディレクトリから解凍するために収集するファイルのパターン。正規表現を使用してファイル名のパターンを照合します。

例えば、ファイルを解凍して転送するには、次の要求を使用します。

POST <serverUrl>/mftsaas/api/v1/filetransferTask/execute/1004
Accept:application/json
IDS-SESSION-ID: <icSessionId or INFA-SESSION-ID>
{
    "agentGroupId": "01000125000000000002",
    "portalUser": "false",
    "pattern": "arun_zip.txt",
    "relativeSourceLocation": "/",
    "targetLocation": "C:\\Informatica_Target",
    "relativeTargetLocation": "",
    "connectionId": "0100010B000000000002",
    "afterFilePickupAction": "RENAME",
    "renameSuffix":"_RENAME_",
    "archiveDirectoryPath" :"",
    "skipDuplicateFiles": true,
    "processFilesRecursively": false,
   "taskVariables": {
       "DECOMPRESSION_TYPE": "gunzip",
        "PATTERN_TO_COLLECT": ".*gz"
    }
}

POST応答

成功すると、

Informatica Intelligent Cloud Services

からジョブの実行IDが返されます。その実行IDを使用してジョブステータスを監視します。

成功時の応答の例を以下に示します。

{
       "projectId": 0,
    "timeTaken": 0,
    "queuePriority": 0,
    "runPriority": 0,
    "runMode": "UNKNOWN",
    "submitSourceId": -1,
    "runModeInteractive": false,
    "runModeBatch": false,
    "runModeDebug": false,
    "runModeUnknown": true,
    "formattedTimeTaken": "0.00",
    "id": 1000000007171,
    "runId": 30
}

失敗すると、応答にエラーの理由が含まれます。

リモートファイルの転送タスク

ガイドをダウンロード

ページをウォッチ

フィードバックを送信

コミュニティ

Knowledge Base

Success Portal