文档首页/ 数据湖探索 DLI/ API参考/ 历史API/ 分组资源相关API（废弃）/ 上传分组资源（废弃）
更新时间：2024-03-15 GMT+08:00
在线调试
CLI示例
查看PDF
分享

上传分组资源（废弃）

功能介绍

该API用于上传分组资源到某个project下。该API对应控制台的创建程序包功能。

当前接口已废弃，不推荐使用。

URI

  • URI格式：

    POST /v2.0/{project_id}/resources

  • 参数说明
    表1 URI参数说明

    参数名称

    是否必选

    参数类型

    说明

    project_id

    是

    String

    项目编号，用于资源隔离。获取方式请参考获取项目ID。

请求消息

表2 请求参数

参数名称

是否必选

参数类型

说明

paths

是

Array of Strings

用户OBS对象路径列表，OBS对象路径为OBS对象URL。

kind

是

String

分组资源文件的类型。

  • jar：用户jar文件。
  • pyFile：用户python文件。
  • file：用户文件。
  • modelFile：用户AI模型文件。
说明：

上传的同一组资源包含不同文件类型时，均选择“file”类型作为这次上传文件的类型。

group

是

String

将要创建的分组名。

is_async

否

Boolean

是否使用异步方式上传资源包。默认值为“false”，表示不使用异步方式。推荐使用异步方式上传资源包。

tags

否

Array of Objects

资源标签。具体请参考表3。
表3 tags参数

参数名称

是否必选

参数类型

说明

key

是

String

标签的键。

说明：

标签的键的最大长度为128个字符，标签的键可以包含任意语种字母、数字、空格和_ . : =+-@ ,但首尾不能含有空格，不能以_sys_开头。

value

是

String
说明：

标签值的最大长度为255个字符，标签的值可以包含任意语种字母、数字、空格和_ . : =+-@ ,但首尾不能含有空格。

响应消息

表4 响应参数

参数名称

是否必选

参数类型

说明

group_name

否

String

分组名称。

status

否

String

上传分组资源状态。

resources

否

Array of strings

该模块包含的资源包名列表。

details

否

Array of body

分组资源包的详细信息。具体请参考表5。

create_time

否

Long

模块上传的unix时间戳。

update_time

否

Long

模块更新的unix时间戳。

is_async

否

Boolean

是否使用异步方式上传资源包。默认值为“false”，表示不使用异步方式。推荐使用异步方式上传资源包。

owner

否

String

资源包拥有者。
表5 details参数说明

参数名称

是否必选

参数类型

说明

create_time

是

Long

资源包上传的unix时间。是单位为“毫秒”的时间戳。

update_time

否

Long

更新已上传资源包的unix时间。是单位为“毫秒”的时间戳。

resource_type

是

String

资源类型。

resource_name

否

String

资源名。

status

否

String
  • "UPLOADING"表示正在上传。
  • "READY"表示资源包已上传。
  • "FAILED"表示资源包上传失败。

underlying_name

否

String

资源包在队列中的名字。

is_async

否

Boolean

是否使用异步方式上传资源包。默认值为“false”，表示不使用异步方式。推荐使用异步方式上传资源包。

请求示例

从OBS上传jar包至DLI，并定义分组名称为gatk。

{
    "paths": [
        "https://xkftest.obs.xxx.com/txr_test/jars/spark-sdv-app.jar",
        "https://xkftest.obs.xxx.com/txr_test/jars/wordcount",
        "https://xkftest.obs.xxx.com/txr_test/jars/wordcount.py"
    ],
    "kind": "jar",
    "group": "gatk",
    "is_async":"true"
}

响应示例

{
    "group_name": "gatk",
    "status": "READY",
    "resources": [
        "spark-sdv-app.jar",
        "wordcount",
        "wordcount.py"
    ],
    "details": [
        {
            "create_time": 0,
            "update_time": 0,
            "resource_type": "jar",
            "resource_name": "spark-sdv-app.jar",
            "status": "READY",
            "underlying_name": "987e208d-d46e-4475-a8c0-a62f0275750b_spark-sdv-app.jar"
        },
        {
            "create_time": 0,
            "update_time": 0,
            "resource_type": "jar",
            "resource_name": "wordcount",
            "status": "READY",
            "underlying_name": "987e208d-d46e-4475-a8c0-a62f0275750b_wordcount"
        },
        {
            "create_time": 0,
            "update_time": 0,
            "resource_type": "jar",
            "resource_name": "wordcount.py",
            "status": "READY",
            "underlying_name": "987e208d-d46e-4475-a8c0-a62f0275750b_wordcount.py"
        }
    ],
    "create_time": 1551334579654,
    "update_time": 1551345369070
}

状态码

状态码如表6所示。

表6 状态码

状态码

描述

201

上传成功。

400

请求错误。

500

内部服务器错误。

错误码

调用接口出错后，将不会返回上述结果，而是返回错误码和错误信息，更多介绍请参见错误码。