Skip to content

resource manage

Jump to bottom
qifeng dai edited this page Jun 13, 2017 · 27 revisions

1.新增资源

说明：增加项目的资源信息，需对项目有 "修改权限或项目所有者" 才能调用。如果资源已经存在，则新增失败。

POST	/projects/:project-name/resources/:resource-name
Parameters: desc={desc}&file={binary file data}
内容上传的 Content-Type 使用：multipart/form-data

Response:
Status: 201 Created
{
  "name": "casbah",
  "desc": "udf 自定义函数 jar",
  "createTime": 1468391778000,
  "modifyTime": 1468391778000,
  "projectName": "the name of project",
  "owner": "bdi_user",
  "suffix": "jar",
  "originFilename": "casbah-alldep_2.10-2.8.1.jar"
}

请求参数：

参数 类型 是否必选 描述 说明
desc string 否 资源描述 长度为 [0,256]
file binary 是 文件信息 表单中类型使用 "file", 大小为 (0,256M]

注意：上传的资源，会被命名为 name + suffix。

2.修改并创建资源

说明：修改项目的资源信息，需对项目有 "修改权限或项目所有者" 才能调用。如果资源不存在，会创建。

PUT	/projects/:project-name/resources/:resource-name

Response:
Status: 200 OK

请求和返回同上。

3.修改资源

说明：修改项目的资源信息，需对项目有 "修改权限或项目所有者" 才能调用。如果资源不存在，则修改失败。

PATCH	/projects/:project-name/resources/:resource-name

Response:
Status: 200 OK

请求说明：所有参数都是可选的。

请求和返回同上。

4.资源拷贝

说明：拷贝某资源信息到另外一个资源，目标资源如果事先没有创建，会自动创建。需对项目有 "修改权限或项目所有者" 才能调用。

POST	/projects/:project-name/resource-copy
Parameters: srcResName={srcResName}&destResName={destResName}&desc={desc}

Response:
Status: 201 Created
{
  "name": "casbah",
  "desc": "udf 自定义函数 jar",
  "createTime": 1468391778000,
  "modifyTime": 1468391778000,
  "projectName": "the name of project",
  "owner": "bdi_user",
  "suffix": "jar",
  "originFilename": "casbah-alldep_2.10-2.8.1.jar"
}

请求参数：

参数 类型 是否必选 描述 说明
srcResName string 是 原资源名称
destResName string 是 目标资源描述
desc string 否 资源描述 长度为 [0,256]

5.删除资源

说明：项目有 "修改权限或项目所有者" 能够调用，同时会删除服务器上保存的资源文件。

DELETE	 /projects/:project-name/resources/:resource-name

Response:
Status: 200 OK

6.查看所有资源

说明：项目有 "查看权限或项目所有者" 能够查看资源，这里是所有资源。

GET  /projects/:project-name/resources

Response:
Status: 200 OK
[
  {
    "name": "udf.jar",
    "desc": "udf 自定义函数 jar",
    "createTime": 1468391778000,
    "modifyTime": 1468391778000,
    "projectName": "the name of project",
    "owner": "bdi_user",
    "suffix": "jar",
    "originFilename": "casbah-alldep_2.10-2.8.1.jar"
  }
]

7.查看具体某个资源

说明：项目有 "查看权限或项目所有者" 能够查看资源。

GET  /projects/:project-name/resources/:resource-name

Response:
Status: 200 OK
[
  {
    "name": "udf.jar",
    "desc": "udf自定义函数jar",
    "createTime": 1468391778000,
    "modifyTime": 1468391778000,
    "projectName": "the name of project",
    "owner": "bdi_user",
    "suffix": "jar",
    "originFilename": "casbah-alldep_2.10-2.8.1.jar"
  }
]

8.下载资源

说明：项目有 "查看权限或项目所有者" 能够下载资源。

GET  /projects/:project-name/resources/:resource-name/file

Response:
Status: 200 OK
binary-files
Clone this wiki locally