更新时间:2024-03-15 GMT+08:00

上传分组资源(废弃)

功能介绍

该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

内部服务器错误。

错误码

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