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

创建数据源

功能介绍

创建新的数据源。该接口兼容Sahara。

URI

  • URI格式

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

  • 参数说明
    表1 参数说明

    名称

    是否必选

    说明

    project_id

    是

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

请求消息

表2 请求参数说明

名称

是否必选

参数类型

说明

name

是

String

数据源名称。

只能由字母、数字、中划线和下划线组成，并且长度为1～80字符。

url

是

String

数据源URL信息，长度为1～255字符。

  • 当数据源类型为hdfs时，配置为“/数据源存放路径”
  • 当数据源类型为obs时，配置为“s3a://数据源存放路径”

credentials

否

Object

认证信息，当前版本不支持该功能。

is_protected

否

Bool

数据源是否受保护。

  • true
  • false

当前版本不支持该功能。

is_public

否

Bool

数据源是否公开。

  • true
  • false

当前版本不支持该功能。

type

是

String

数据源类型：

  • hdfs
  • obs
  • swift（当前不支持）

description

否

String

数据源描述信息，最大长度为65535字符。

响应消息

表3 响应参数说明

名称

参数类型

说明

description

String

数据源描述信息。

url

String

数据源URL。

tenant_id

String

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

created_at

String

数据源创建时间。

updated_at

String

数据源更新时间。若数据源未更新过则该参数显示“null”。

is_protected

Bool

数据源是否受保护。

is_public

Bool

数据源是否公开。

type

String

数据源类型。

id

String

数据源创建成功后系统返回的ID值。

name

String

数据源名称。

示例

  • 请求示例 
    { 
    "name": "my-data-source",  
    "url": "/simple/mapreduce/input",  
    "is_protected": false,  
    "is_public": false,  
    "type": "hdfs",  
    "description": "this is the data source template" 
}
  • 响应示例 
    {
    "data_source": {
        "name": "my-data-source",
        "type": "hdfs",
        "url": "/simple/mapreduce/input",
        "description": "this is the data source template",
        "created_at": "2017-06-22T08:28:57",
        "updated_at": null,
        "id": "e275a927-fe72-4b8b-a634-e47a11dca181",
        "tenant_id": "5a3314075bfa49b9ae360f4ecd333695",
        "is_public": false,
        "is_protected": false
    }
}

状态码

状态码如表4所示。

表4 状态码

状态码

描述

202

创建数据源成功。

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

父主题： 数据源接口