# 查询数据血缘
#### 功能介绍
客户通过obs导入原始数据集，可基于该obs路径查询所有基于该路径创建的原始数据集及后续的血缘信息。
#### 授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/productdesc-pangulm/pangulm_01_0020.html)。
#### URI
GET /v1/{project_id}/workspaces/{workspace_id}/data-management/lineages
#### 请求参数
表1请求Header参数 
| 参数           | 是否必选 | 参数类型   | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
|:---|:---|:---|:---|
| X-Auth-Token | 是    | String | **参数解释：** 用户Token。 用于获取操作API的权限。如[图4](https://support.huaweicloud.com/api-pangulm/pangulm_05_0009.html#pangulm_05_0009__fig10797003103)中响应消息头中X-Subject-Token的值即为Token。 **约束限制：** 不涉及 **取值范围：** 不涉及 **默认取值：** 不涉及 |
| Content-Type | 是    | String | **参数解释：** 发送的实体的MIME类型。 **约束限制：** 不涉及 **取值范围：** 不涉及 **默认取值：** application/json                                                                                                                                                                       |
   
表2请求Query参数 
| 参数        | 是否必选 | 参数类型    | 描述                                                                                                                                                                                                                                                                                                                       |
|:---|:---|:---|:---|
| limit     | 是    | integer | **参数解释：** 接口返回的血缘数量上限。 **约束限制：** 不涉及。 **取值范围：** \[1, 1000\] **默认取值：** 100 |
| from_path | 是    | string  | **参数解释：** 来源obs路径。 **约束限制：** 最终租户桶下的OBS全路径。 **取值范围：** 不涉及。 **默认取值：** 不涉及。             |
   
#### 响应参数
| 参数       | 参数类型  | 描述                                                                                                                                                                                                                                                                                                                         |
|:---|:---|:---|
| lineages | array | **参数解释：** 数据集血缘列表。 **约束限制：** 列表内的item为Lineage类型。 **取值范围：** 不涉及。 **默认取值：** 不涉及。 |
   
#### 请求示例
```
GET https://{endpoint}/v1/{project_id}/workspaces/{workspace_id}/data-management/lineages?limit=100&from_path=bucket/folder1/folder2
Request Header:
Content_Type: application/json
X-Auth-Token: MIIVV...
Request Params:
limit: 1000
from_path: bucket/folder1/folder2
```
#### 响应示例
```
{
    "lineages": [
        {
            "id": null,
            "from_id": null,
            "from_name": null,
            "from_catalog": null,
            "from_type": "OBS",
            "to_id": "1352299121133883392",
            "to_name": null,
            "to_catalog": "ORIGINAL",
            "to_type": "DATASET",
            "process_id": null,
            "process_name": null,
            "process_type": null,
            "train_job_name": null,
            "model_type": null,
            "train_type": null,
            "create_time": null,
            "from_path": "bucket/folder",
            "from_path_existed": null
        },
        {
            "id": "1352299380551585793",
            "from_id": "1352299121133883392",
            "from_name": "时序-回归-test",
            "from_catalog": "ORIGINAL",
            "from_type": "DATASET",
            "to_id": "1352299379473649664",
            "to_name": "pub_时序回归",
            "to_catalog": "PUBLISH",
            "to_type": "DATASET",
            "process_id": "lt_97a2aa4cca744775aa5c7cfe3cb36121",
            "process_name": "pub_时序回归",
            "process_type": "PUBLISH",
            "train_job_name": null,
            "model_type": null,
            "train_type": null,
            "create_time": null,
            "from_path": null,
            "from_path_existed": null
        }
    ]
}
```
#### 状态码
请参见[状态码](https://support.huaweicloud.com/api-pangulm/pangulm_05_0019.html)。
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-pangulm/pangulm_05_0020.html)。