上传分组资源
功能介绍
该API用于上传分组资源到某个project下。该API对应控制台的创建程序包功能。
URI
- URI格式:
- 参数说明
表1 URI参数说明 参数名称
是否必选
参数类型
说明
project_id
是
String
项目编号,用于资源隔离。获取方式请参考获取项目ID。
请求消息
参数名称 |
是否必选 |
参数类型 |
说明 |
---|---|---|---|
paths |
是 |
Array of Strings |
用户OBS对象路径列表,OBS对象路径为OBS对象URL。 |
kind |
是 |
String |
分组资源文件的类型。
说明:
上传的同一组资源包含不同文件类型时,均选择“file”类型作为这次上传文件的类型。 |
group |
是 |
String |
将要创建的分组名。 |
is_async |
否 |
Boolean |
是否使用异步方式上传资源包。默认值为“false”,表示不使用异步方式。推荐使用异步方式上传资源包。 |
tags |
否 |
Array of Objects |
资源标签。具体请参考表3。 |
响应消息
参数名称 |
是否必选 |
参数类型 |
说明 |
---|---|---|---|
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 |
资源包拥有者。 |
参数名称 |
是否必选 |
参数类型 |
说明 |
---|---|---|---|
create_time |
是 |
Long |
资源包上传的unix时间。是单位为“毫秒”的时间戳。 |
update_time |
否 |
Long |
更新已上传资源包的unix时间。是单位为“毫秒”的时间戳。 |
resource_type |
是 |
String |
资源类型。 |
resource_name |
否 |
String |
资源名。 |
status |
否 |
String |
|
underlying_name |
否 |
String |
资源包在队列中的名字。 |
is_async |
否 |
Boolean |
是否使用异步方式上传资源包。默认值为“false”,表示不使用异步方式。推荐使用异步方式上传资源包。 |
请求示例
{ "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 }
错误码
调用接口出错后,将不会返回上述结果,而是返回错误码和错误信息,更多介绍请参见错误码。