更新时间:2022-02-22 GMT+08:00

查询数据源列表

功能介绍

查询所有的数据源列表。该接口兼容Sahara。

URI

  • URI格式

    GET /v1.1/{project_id}/data-sources

  • 参数说明
    表1 参数说明

    名称

    是否必选

    说明

    project_id

    项目编号。获取方法,请参见获取项目ID

    limit

    返回数据中最大对象个数。

    取值范围:1~1073741822

    marker

    数据源ID

    查询数据源列表,选择一个数据源ID作为Marker,这个ID为列表中最后一个元素的ID,该元素不会出现在返回数据中。

    sort_by

    排序字段,-号表示降序排列。例如:

    • sort_by=name表示按name升序排序
    • sort_by=-name表示按name降序排序

请求消息

请求参数

无。

响应消息

表2 响应参数说明

名称

参数类型

说明

markers

Object

markers对象。参数说明,请参见表3

data_sources

Array

数据源列表。参数说明,请参见表4

表3 markers参数说明

名称

参数类型

说明

prev

String

上一页的marker。

next

String

下一页的marker。

表4 data_sources参数说明

名称

参数类型

说明

name

String

数据源名称。

type

String

数据源类型。

url

String

数据源URL。

description

String

数据源描述信息。

created_at

String

数据源创建时间。

updated_at

String

数据源更新时间。

id

String

数据源ID。

tenant_id

String

项目编号。获取方法,请参见获取项目ID

is_public

Bool

数据源是否公开。

  • true
  • false

当前版本不支持该功能。

is_protected

Bool

数据源是否受保护。

  • true
  • false

当前版本不支持该功能。

示例

  • 请求示例
    GET /v1.1/{project_id}/data-sources?sort_by=name&limit=2&marker=81a2d48b-029a-4160-830b-2d0ac51fa3ba
  • 响应示例
    {
        "markers": {
            "prev": "948b92e5-8213-4f5d-975a-435a67c6b93d",
            "next": null
        },
        "data_sources": [
            {
                "name": "my-data-source-update",
                "type": "hdfs",
                "url": "/simple/mapreduce/input",
                "description": "this is the data source template",
                "created_at": "2017-06-22T08:28:57",
                "updated_at": "2017-06-22T08:30:08",
                "id": "e275a927-fe72-4b8b-a634-e47a11dca181",
                "tenant_id": "5a3314075bfa49b9ae360f4ecd333695",
                "is_public": false,
                "is_protected": false
            },
            {
                "name": "my-datasource",
                "type": "hdfs",
                "url": "/simple/mapreduce/input",
                "description": "this is the data source template",
                "created_at": "2017-06-22T08:22:06",
                "updated_at": null,
                "id": "e68164d5-5897-41a7-a550-5de635fffe20",
                "tenant_id": "5a3314075bfa49b9ae360f4ecd333695",
                "is_public": false,
                "is_protected": false
            }
        ]
    }

状态码

状态码如表5所示。

表5 状态码

状态码

描述

200

查询数据源列表成功。

异常状态码请参见状态码