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

修改资源

功能介绍

此接口可以修改指定资源,修改时,请指定资源ID。

  • 资源类型和资源目录不支持修改。

URI

  • URI格式

    PUT /v1/{project_id}/resources/{resource_id}

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

    参数名

    是否必选

    参数类型

    说明

    project_id

    String

    项目编号,获取方法请参见项目ID和账号ID

    resource_id

    String

    资源ID,获取方法请参见查询资源列表。返回的id即为resource_id。

请求参数

表2 请求Header参数

参数名

是否必选

参数类型

说明

workspace

String

工作空间id。

  • 如果不设置该参数,默认查询default工作空间下的数据。
  • 如果需要查询其他工作空间的数据,需要带上该消息头。
表3 Resource参数说明

参数名

是否必选

参数类型

说明

name

String

资源名称,只能包含英文字母、数字、中文字符、下划线或中划线,且长度为1-32个字符。

type

String

资源类型,包含:

  • archive
  • file
  • jar

location

String

资源文件所在OBS路径,当类型为jar时,location为主Jar包所在路径。最多1023个字符。示例:obs://myBucket/test.jar

dependFiles

List<String>

主Jar包所依赖的JAR包、properties文件。总的长度不能超过10240个字符。

dependPackages

List<DependPackage>

主Jar包所依赖的JAR包、properties文件。总的长度不能超过10240个字符。同时存在dependFiles和dependPackages时,优先解析该字段。

desc

String

描述,长度不能超过255个字符。

directory

String

资源所在目录。

通过DataArts Studio管理控制台 > 数据开发,左侧列表选择“配置管理 > 资源管理”。在资源的目录树上,可以查看到当前已经创建的目录,默认在根目录/。

表4 DependPackage参数说明

参数名

是否必选

参数类型

说明

type

String

文件类型

location

String

文件路径

响应参数

请求示例

修改资源名称为test的资源内容,资源类型为jar,资源文件所在OBS路径为obs://dlf-test/hadoop-mapreduce-examples-2.4.1.jar,资源主Jar包所依赖的JAR包、properties文件为obs://dlf-test/depend1.jar","obs://dlf-test/depend2.jar,描述为test,资源所在目录为/resource

PUT /v1/b384b9e9ab9b4ee8994c8633aabc9505/resources/3624d1c3-5df5-4f20-9af9-98eadad6c5f9
{
	"name": "test",
	"type": "jar",
	"location": "obs://dlf-test/hadoop-mapreduce-examples-2.4.1.jar",
	"dependFiles": ["obs://dlf-test/depend1.jar","obs://dlf-test/depend2.jar"],
	"desc": "test",
	"directory":"/resource"
}

响应示例

  • 成功响应

    HTTP状态码 204

  • 失败响应

    HTTP状态码 400

    {
        "error_code":"DLF.6241",
        "error_msg":"The resource information does not exist."
    }