更新时间:2022-04-16 GMT+08:00
分享

上传分组资源

功能介绍

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

调试

您可以在API Explorer中调试该接口。

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

标签的键。

value

String

标签的值。

响应消息

表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”,表示不使用异步方式。推荐使用异步方式上传资源包。

示例

  • 请求样例:
    {
        "paths": [
            "https://xkftest.obs.huawei.com/txr_test/jars/spark-sdv-app.jar",
            "https://xkftest.obs.huawei.com/txr_test/jars/wordcount",
            "https://xkftest.obs.huawei.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

内部服务器错误。

错误码

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

分享:

    相关文档

    相关产品

close