Querying Resource Details

Function

This API is used to query resource details. A resource contains various files such as JAR, ZIP, and properties files. A created resource can be used in job nodes such as DLI Spark and MRS Spark.

URI

URI format
GET /v1/{project_id}/resources/{resource_id}

Parameter description

**Table 1** URI parameters
Parameter	Mandatory	Type	Description
project_id	Yes	String	Project ID. For details about how to obtain a project ID, see Project ID and Account ID.
resource_id	Yes	String	Resource ID. For details about how to obtain the resource ID, see Querying a Resource List. The returned ID is resource_id.

Request Parameters

**Table 2** Request header parameter
Parameter	Mandatory	Type	Description
workspace	No	String	Workspace ID. If this parameter is not set, data in the default workspace is queried by default. To query data in other workspaces, this header must be carried.

Response Parameters

**Table 3** Resource parameters
Parameter	Mandatory	Type	Description
name	Yes	String	Name of the resource. The name contains a maximum of 32 characters, including only letters, numbers, underscores (_), and hyphens (-).
type	Yes	String	Resource type. archive file jar
location	Yes	String	OBS path for storing the resource file. When type is set to jar, location is the path for storing the main JAR package. The path contains a maximum of 256 characters. For example, obs://myBucket/test.jar
dependFiles	No	List<String>	JAR package and properties file that the main JAR package depends on. The description contains a maximum of 10,240 characters.
desc	No	String	Description of the resource. The description contains a maximum of 255 characters.
directory	No	String	Directory for storing the resource. Log in to the DataArts Studio console and access the DataArts Factory console. In the navigation pane, choose Configuration > Configure. In the resource directory tree, you can view the created directories. The default directory is the root directory.

Example Request

View resource details.

GET /v1/b384b9e9ab9b4ee8994c8633aabc9505/resources/3624d1c3-5df5-4f20-9af9-98eadad6c5f9

Example Response

Success response

{
	"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"
}

Failure response

HTTP status code 400

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

Status Codes

See Status Codes.

Parent Topic: Resource Management APIs

Previous topic: Modifying a Resource

Next topic: Deleting a Resource

Feedback

Was this page helpful?

Helpful Not helpful

Provide feedback

Thank you very much for your feedback. We will continue working to improve the documentation.See the reply and handling status in My Cloud VOC.

The system is busy. Please try again later.

Which of the following issues have you encountered?

Content is inconsistent with the product UI

Unclear descriptions

Lack of examples or code

Incorrect steps

Can't find what I need

Lack of best practices

Feedback (optional)

0/500

Select at least one type of issue, and enter your comments or suggestions.

Enter a maximum of 500 characters.

Submit Cancel

For any further questions, feel free to contact us through the chatbot.

Chatbot