查询训练作业指定任务的日志(OBS链接)
功能介绍
查询训练作业指定任务的日志(OBS链接)接口用于获取指定训练作业任务的日志文件在OBS(对象存储服务)中的访问链接。
该接口适用于以下场景:当用户需要查看或下载训练作业任务的详细日志信息时,可以通过此接口获取日志文件的OBS链接。使用该接口的前提条件是训练作业任务已存在且用户具有相应的权限。查询操作完成后,接口将返回指定任务的日志文件的OBS链接。若训练作业任务不存在或用户无权限操作,接口将返回相应的错误信息。
调试
您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。
URI
GET /v2/{project_id}/training-jobs/{training_job_id}/tasks/{task_id}/logs/url
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
project_id |
是 |
String |
参数解释:用户项目ID。获取方法请参见获取项目ID和名称。 约束限制:1 - 64字符,字母、数字和中划线。 取值范围:不涉及。 默认取值:不涉及。 |
|
training_job_id |
是 |
String |
参数解释:训练作业ID。获取方法请参见查询训练作业列表。 约束限制:不涉及。 取值范围:不涉及。 默认取值:不涉及。 |
|
task_id |
是 |
String |
参数解释:训练作业的任务名称。可从训练作业详情中的status.tasks字段中获取。 约束限制:单节点默认为"worker-0",多节点则为"worker-0"、"worker-1",依次类推。 取值范围:不涉及。 默认取值:不涉及。 |
请求参数
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
Content-Type |
否 |
String |
参数解释:消息体的类型。设置为text/plain,返回临时预览链接。设置为application/octet-stream,返回临时下载链接。 约束限制:不涉及。 取值范围:不涉及。 默认取值:不涉及。 |
响应参数
状态码:200
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
obs_url |
String |
参数解释:日志OBS临时链接(复制到浏览器可查看当前全量日志)。 取值范围:不涉及。 |
请求示例
如下以查询uuid为2cd88daa-31a4-40a8-a58f-d186b0e93e4f的训练作业对应work-0日志OBS临时链接为例。
GET https://endpoint/v2/{project_id}/training-jobs/2cd88daa-31a4-40a8-a58f-d186b0e93e4f/tasks/worker-0/logs/url?Content-Type=text/plain
响应示例
状态码:200
ok
{
"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"
}
状态码
|
状态码 |
描述 |
|---|---|
|
200 |
ok |
错误码
请参见错误码。