REST APIリファレンス

前へ次へ

ファイル取り込みタスクの表示

GET要求を使用して

ファイル取り込み

タスクを表示します。

GET要求

特定の

ファイル取り込み

タスクの詳細を表示するには、次のURIに

ファイル取り込み

を含めます。

mftsaas/api/v1/mitasks/{{TASK-ID}}

組織のすべての

ファイル取り込み

タスクの詳細を表示するには、

ファイル取り込み

IDを省略します。

mftsaas/api/v1/mitasks

以下に例を示します。

GET https://na1.dm-us.informaticacloud.com/mftsaas/api/v1/mitasks

GET応答

成功した場合はタスクオブジェクトを、エラーが発生した場合はエラーオブジェクトを返します。

タスクオブジェクトには、組織のそれぞれの

ファイル取り込み

タスクについて以下の情報が含まれます。

フィールド	タイプ	説明
taskId	String	タスクに関連付けられているID番号。
taskName	String	タスクの名前。
description	String	タスクの説明。
location	String	タスクが存在するプロジェクトおよびフォルダパス。
createTime	Date/Time	タスクが作成された時刻。
updateTime	Date/Time	タスクが最後に更新された時刻。

応答に含まれる作成日時と更新日時はUTC時間です。

すべての
ファイル取り込み
タスクを表示するGET応答の例

次の応答の例は、組織に3つの

ファイル取り込み

タスクがあることを示しています。


{
    "mitasks": [
        {
            "id": "1ONE5Vewzztl0tuKR0EDum",
            "name": "A01_UMAR_MITASK2318",
            "description": "",
            "sourceType": "CONNECTION",
            "sourceConnection": {
                "id": "",
                "name": "",
                "type": "local"
            },
            "targetConnection": {
                "id": "0100000B000000000002",
                "name": "ftps",
                "type": "Advanced FTPS"
            },
            "agentGroupId": "01000025000000000002",
            "updatedTime": "2019-01-30T11:17:49Z"
        },
        {
            "id": "9D1tGkAxopJeFmUWoG4s48",
            "name": "A01_UMAR_MITASK3354",
            "description": "",
            "sourceType": "CONNECTION",
            "sourceConnection": {
                "id": "0100000B00000000000M",
                "name": "AzureBlob",
                "type": "Azure Blob"
            },
            "targetConnection": {
                "id": "0100000B00000000000L",
                "name": "SFTP_Conn",
                "type": "Advanced SFTP"
            },
            "agentGroupId": "01000025000000000002",
            "updatedTime": "2019-01-30T06:42:19Z"
        },
        {
            "id": "4hcTFqKVOQrl1z4d6pGUMP",
            "name": "A01_UMAR_MITASK5124",
            "description": "",
            "sourceType": "CONNECTION",
            "sourceConnection": {
                "id": "0100000B0000000004IO",
                "name": "S3",
                "type": "AmazonS3"
            },
            "targetConnection": {
                "id": "",
                "name": "",
                "type": "local"
            },
            "agentGroupId": "01000025000000000002",
            "updatedTime": "2019-01-30T06:35:01Z"
        }]
		}

ファイルピックアップオプションとしてファイルパターンを使用した
ファイル取り込み
タスクを示すGET応答の例

次の応答の例は、

ファイル取り込み

タスクの詳細を示しています。

IDS-SESSION-ID:{{IDS-SESSION-ID}}
Accept:application/json
{
    "id": "j9OLB12nqYObykdFSUMpO2",
    "name": "FTPSrcTarget",
    "location": {
        "projectId": "dNC6zbp2lI8ghrKPo6hpwn",
        "projectName": "Hardening"
    },
    "description": "",
    "sourceType": "CONNECTION",
    "sourceConnection": {
        "id": "0100000B00000000028M",
        "name": "CCI_FTPS",
        "type": "Advanced FTPS V2"
    },
    "targetConnection": {
        "id": "0100000B0000000001JR",
        "name": "CCI_FTP_Lin",
        "type": "Advanced FTP V2"
    },
    "sourceParameters": {
        "filePattern": "*.txt",
        "sourceTransferMode": "AUTO",
        "filePatternType": "WILDCARD",
        "includeSubfolder": "false",
        "sourceDirectory": "/root/suraj/qa/test/automation/RSFiles",
        "checkDuplicate": "false",
        "fileStability": "true",
        "stabilityCheckInterval": "60",
        "postPickupAction": "KEEP"
    },
    "targetParameters": {
        "fileExistsAction": "APPEND_TIMESTAMP",
        "targetDirectory": "/",
        "targetTransferMode": "AUTO"
    },
    "agentGroupId": "01000025000000000003",
    "createdTime": "2019-02-04T10:34:08Z",
    "updatedTime": "2019-02-04T11:04:02Z",
	"filePickupOption": "PATTERN"
}

ファイルピックアップオプションとしてファイルリスト（ファイルパス）を使用した
ファイル取り込み
タスクを示すGET応答の例

次の応答の例は、filePickupOptionタイプをFILELISTとして、そのsourceParametersにfilePickupFilePathを指定した

ファイル取り込み

タスクを示しています。このタスクは指定されたピックアップファイルを読み取って、処理する必要のあるファイルを識別することを示しています。


{
	"id": "aFHWKrr1RwycuBRBLTtt2t",
	"name": "FilePath_CheckStability",
	"location": {
		"projectId": "0ggRhrI8ZziguyBxHBzuG0",
		"projectName": "Default"
	},
	"description": "",
	"sourceType": "CONNECTION",
	"sourceConnection": {
		"id": "",
		"name": "",
		"type": "local"
	},
	"targetConnection": {
		"id": "",
		"name": "",
		"type": "local"
	},
	"sourceParameters": {
		"filePickupFilePath": "test.txt",
		"sourceDirectory": "/root/test",
		"checkDuplicate": "false",
		"stabilityCheckInterval": "60",
		"postPickupAction": "KEEP",
		"filepickupByName": "FILEPATH",
		"batchSize": "5",
                "fileStability": "true",
                "stabilityCheckInterval": "60"
	},
	"targetParameters": {
		"fileExistsAction": "OVERWRITE",
		"targetDirectory": "/root/testCheckStability"
	},
	"agentGroupId": "01001D25000000000002",
	"createdTime": "2021-08-13T09:38:03Z",
	"updatedTime": "2021-08-13T09:39:02Z",
	"logLevel": "NORMAL",
	"filePickupOption": "FILELIST"
}

ファイルピックアップオプションとしてファイルリストを使用した
ファイル取り込み
タスクを示すGET応答の例

次の応答の例は、filePickupOptionタイプをFILELISTとし、filepickupByNameをLISTOFFILESとして、そのsourceParametersにfilePickupFileListを指定した

ファイル取り込み

タスクを示しています。このタスクは処理する指定されたピックアップファイルを読み取って、識別することを示しています。


{
    "id": "2bTlAolXbAGlE7I5qauSAW",
    "name": "DedupFilelist_pushdown",
    "location": {
        "projectId": "0ggRhrI8ZziguyBxHBzuG0",
        "projectName": "Default"
    },
    "description": "",
    "sourceType": "CONNECTION",
    "sourceConnection": {
        "id": "01001D0B0000000005PP",
        "name": "ADLSGen2",
        "type": "Azure Data Lake Gen2"
    },
    "targetConnection": {
        "id": "01001D0B0000000005PU",
        "name": "AzureDW_Gen2",
        "type": "Azure DW"
    },
    "sourceParameters": {
        "sourceDirectory": "/B2B/MI",
        "checkDuplicate": "true",
        "postPickupAction": "KEEP",
        "filepickupByName": "LISTOFFILES",
        "blockSize": "8388608",
        "filePickupFileList": "File1.txt,File2.txt",
        "batchSize": "5",
        "timeoutInterval": "60",
        "fileStability": "true",
        "stabilityCheckInterval": "60"
    },
    "targetParameters": {
        "commandType": "auto",
        "targetTableName": "test1234",
        "isPushdown": "true",
        "ingestionMethod": "polybase",
        "targetSchemaName": "testing",
        "isTruncateTarget": "true"
    },
    "agentGroupId": "01001D25000000000002",
    "createdTime": "2021-04-29T08:47:57Z",
    "updatedTime": "2021-04-29T08:47:57Z",
    "logLevel": "NORMAL",
    "filePickupOption": "FILELIST"
}

tasksリソース

ガイドをダウンロード

ページをウォッチ

フィードバックを送信

コミュニティ

Knowledge Base

Success Portal