Help Center/ ModelArts/ API Reference/ Training Management/ Querying the Logs of a Specified Task in a Training Job (OBS Link)

Updated on 2025-11-19 GMT+08:00

View PDF

Querying the Logs of a Specified Task in a Training Job (OBS Link)

Function

This API is used to obtain the OBS link where the log files of a specified training job are stored.

This API is used when you need to view or download the detailed log information of a training job task. Before using this API, ensure that the training job task exists and you have the required permission. After the query, the API returns the OBS link where the log files of the specified task are stored. If the training job task does not exist or you do not have the required permission, the API will return an error message.

Debugging

You can debug this API through automatic authentication in API Explorer or use the SDK sample code generated by API Explorer.

URI

GET /v2/{project_id}/training-jobs/{training_job_id}/tasks/{task_id}/logs/url

**Table 1** Path Parameters
Parameter	Mandatory	Type	Description
project_id	Yes	String	Definition: Project ID. For details, see Obtaining a Project ID and Name. Constraints: The value can contain 1 to 64 characters. Letters, digits, and hyphens (-) are allowed. Range: N/A Default Value: N/A
training_job_id	Yes	String	Definition: Training job ID. For details, see Obtaining Training Jobs. Constraints: N/A Range: N/A Default Value: N/A
task_id	Yes	String	Definition: Name of a training job. You can obtain the value from the status.tasks field in the training job details. Constraints: For one node, the default is worker-0. For multiple nodes, it includes worker-0, worker-1, and so on. Range: N/A Default Value: N/A

Request Parameters

**Table 2** Request header parameters
Parameter	Mandatory	Type	Description
Content-Type	No	String	Definition: Message body type. If this parameter is set to text/plain, the temporary preview link is returned. If this parameter is set to application/octet-stream, the temporary download link is returned. Constraints: N/A Range: N/A Default Value: N/A

Response Parameters

Status code: 200

**Table 3** Response body parameters
Parameter	Type	Description
obs_url	String	Definition: Temporary OBS URL of logs. You can copy the URL to the browser to view all logs. Range: N/A

Example Requests

The following shows how to query the temporary OBS URL for the work-0 tasks of the training job whose UUID is 2cd88daa-31a4-40a8-a58f-d186b0e93e4f.

GET https://endpoint/v2/{project_id}/training-jobs/2cd88daa-31a4-40a8-a58f-d186b0e93e4f/tasks/worker-0/logs/url?Content-Type=text/plain

Example Responses

Status code: 200

{
  "obs_url" : "http://10.155.101.248:20000/cnnorth4-test/xk/00chess_test/test11/logs/modelarts-job-0f2ccdbb-4f34-4d53-afb9-d526f3be8c68-ma-platform-init-worker-0-172.16.24.51-01909681.log?AWSAccessKeyId=xxxxx"
}