文档首页/数据治理中心 DataArts Studio/API参考/数据开发API（V1）/资源管理API/查询资源详情 - ShowResource
更新时间：2025-11-04 GMT+08:00
在线调试
CLI示例
查看PDF
分享

查询资源详情 - ShowResource

功能介绍

查询资源详情，一个资源包含jar、zip、properties等文件，已经创建的资源在DLI Spark、MRS Spark等作业节点中使用。

调试

您可以在API Explorer中调试该接口，支持自动认证鉴权。

授权信息

账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。

  • 如果使用角色与策略授权，具体权限要求请参见权限和授权项。
  • 如果使用身份策略授权，当前API调用无需身份策略权限。

URI

  • URI格式

    GET /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工作空间下的数据。
  • 如果需要查询其他工作空间的数据，需要带上该消息头。
    说明：
    • 多个DataArts Studio实例需要指定工作空间。
    • 当工作空间里面没有default工作空间时，工作空间为必填参数，否则会报错。

响应参数

表3 Resource参数说明

参数名

是否必选

参数类型

说明

name

是

String

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

type

是

String

资源类型，包含：

  • archive
  • file
  • jar

location

是

String

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

dependFiles

否

List<String>

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

desc

否

String

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

directory

否

String

资源所在目录。

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

请求示例

查询资源详情 
GET /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状态码 400

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

状态码

状态码请参见状态码。

父主题： 资源管理API

相关文档