# 查询数据集导入任务的详情 #### 功能介绍 查询数据集导入任务的详情。 #### 调试 您可以在[API Explorer](https://console.huaweicloud.com/apiexplorer/#/openapi/ModelArts/doc?api=DescImportTask)中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。 #### URI GET /v2/{project_id}/datasets/{dataset_id}/import-tasks/{task_id} 表1路径参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | dataset_id | 是 | String | 数据集ID。 | | project_id | 是 | String | 用户项目ID。获取方法请参见[获取项目ID和名称](https://support.huaweicloud.com/api-modelarts/modelarts_03_0147.html)。 | | task_id | 是 | String | 任务ID。 | #### 请求参数 无 #### 响应参数 **状态码： 200** 表2响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | annotated_sample_count | Long | 已标注样本数量。 | | create_time | Long | 任务创建时间。 | | data_source | [DataSource] object | 数据来源。 | | dataset_id | String | 数据集ID。 | | elapsed_time | Long | 任务运行时间，单位秒。 | | error_code | String | 错误码。 | | error_msg | String | 错误信息。 | | file_statistics | [FileCopyProgress] object | 文件复制进度。 | | finished_file_count | Long | 传输完成文件数。 | | finished_file_size | Long | 传输完成文件大小（字节）。 | | import_path | String | 导入的OBS路径或manifest路径。 - 导入manifest时，path必须精确到具体manifest文件。 - 导入为目录时，目前仅支持数据集类型为图片分类、物体检测、文本分类、声音分类。 | | import_type | Integer | 导入方式。可选值如下： - 0：目录导入 - 1：按manifest文件导入 | | imported_sample_count | Long | 已导入的样本数量。 | | imported_sub_sample_count | Long | 已导入的子样本数量。 | | processor_task_id | String | 预处理任务ID。 | | processor_task_status | Integer | 预处理任务状态。 | | status | String | 导入任务的当前状态。可选值如下： - QUEUING：排队中 - STARTING：开始执行 - RUNNING：运行中 - COMPLETED：已完成 - FAILED：已失败 - NOT_EXIST：不存在 | | task_id | String | 任务ID。 | | total_file_count | Long | 总文件数。 | | total_file_size | Long | 总文件大小(字节)。 | | total_sample_count | Long | 样本总数量。 | | total_sub_sample_count | Long | 从父样本生成的子样本总数。 | | unconfirmed_sample_count | Long | 待确认样本数量。 | | update_ms | Long | 任务更新时间。 | 表3DataSource | 参数 | 参数类型 | 描述 | |:---|:---|:---| | data_path | String | 数据源所在路径。 | | data_type | Integer | 数据类型。可选值如下： - 0：OBS桶（默认值） - 1：GaussDB(DWS)服务 - 2：DLI服务 - 3：RDS服务 - 4：MRS服务 - 5：AI Gallery - 6：推理服务 | | schema_maps | Array of [SchemaMap] objects | 表格数据对应的schema映射信息。 | | source_info | [SourceInfo] object | 导入表格数据源所需的信息。 | | with_column_header | Boolean | 文件中首行是否是列名，用于表格数据集。可选值如下： - true：文件首行为列名 - false：文件首行不为列名 | 表4SchemaMap | 参数 | 参数类型 | 描述 | |:---|:---|:---| | dest_name | String | 目的方的列名。 | | src_name | String | 来源方的列名。 | 表5SourceInfo | 参数 | 参数类型 | 描述 | |:---|:---|:---| | cluster_id | String | MRS集群ID。可登录MRS控制台查看。 | | cluster_mode | String | MRS集群运行模式。可选值如下： - 0：普通集群 - 1：安全集群 | | cluster_name | String | MRS集群名称。可登录MRS控制台查看。 | | database_name | String | 导入表格数据集，数据库名字。 | | input | String | 表格数据集，HDFS路径。例如/datasets/demo。 | | ip | String | 用户GaussDB(DWS)集群的IP地址。 | | port | String | 用户GaussDB(DWS)集群的端口。 | | queue_name | String | 表格数据集，DLI队列名。 | | subnet_id | String | MRS集群的子网ID。 | | table_name | String | 导入表格数据集，表名。 | | user_name | String | 用户名，GaussDB(DWS)数据需提供此参数。 | | user_password | String | 用户密码，GaussDB(DWS)数据需提供此参数。 | | vpc_id | String | MRS集群所在的vpc的ID。 | 表6FileCopyProgress | 参数 | 参数类型 | 描述 | |:---|:---|:---| | file_num_finished | Long | 传输完成文件数。 | | file_num_total | Long | 总文件数。 | | file_size_finished | Long | 传输完成文件大小（字节）。 | | file_size_total | Long | 总文件大小(字节)。 | #### 请求示例 查询导入任务详情 ``` GET https://{endpoint}/v2/{project_id}/datasets/{dataset_id}/import-tasks/{task_id} ``` #### 响应示例 **状态码： 200** OK ``` { "status" : "COMPLETED", "task_id" : "gfghHSokody6AJigS5A_RHJ1zOkIoI3Nzwxj8nh", "dataset_id" : "gfghHSokody6AJigS5A", "import_path" : "obs://test-obs/daoLu_images/animals/", "import_type" : 0, "total_sample_count" : 20, "imported_sample_count" : 20, "annotated_sample_count" : 20, "total_sub_sample_count" : 0, "imported_sub_sample_count" : 0, "total_file_size" : 0, "finished_file_count" : 0, "finished_file_size" : 0, "total_file_count" : 0, "update_ms" : 1606114833955, "create_time" : 1606114833874, "elapsed_time" : 2 } ``` #### 状态码 | 状态码 | 描述 | |:---|:---| | 200 | OK | | 401 | Unauthorized | | 403 | Forbidden | | 404 | Not Found | #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-modelarts/modelarts_03_0095.html)。