上传分组资源
功能介绍
该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
}
错误码
调用接口出错后,将不会返回上述结果,而是返回错误码和错误信息,更多介绍请参见错误码。