文档首页> MapReduce服务 MRS> API参考(巴黎区域)> API V1.1> 数据源接口> 查询数据源列表
更新时间：2022-02-22 GMT+08:00
查看PDF

查询数据源列表

功能介绍

查询所有的数据源列表。该接口兼容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

查询数据源列表成功。

异常状态码请参见状态码。

父主题： 数据源接口