文档首页/ AI开发平台ModelArts/ API参考/ 训练管理/ 创建训练诊断任务 - CreateTrainingJobDiagnosisTask
更新时间:2026-02-25 GMT+08:00
分享

创建训练诊断任务 - CreateTrainingJobDiagnosisTask

功能介绍

创建训练诊断任务接口用于在ModelArts平台上基于已有训练任务创建诊断任务。

该接口适用于以下场景:当训练作业异常后,用户可以通过作业ID直接创建对应的诊断任务。若作业ID不存在、状态不允许或用户无权限操作,接口将返回相应的错误信息

调试

您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。

授权信息

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

  • 如果使用角色与策略授权,具体权限要求请参见权限和授权项
  • 如果使用身份策略授权,需具备如下身份策略权限。

    授权项

    访问级别

    资源类型(*为必须)

    条件键

    别名

    依赖的授权项

    modelarts:trainJob:create

    Write

    trainJob *

    -

    -

    -

    -

    • g:RequestTag/<tag-key>

    • g:TagKeys

    • modelarts:poolType

    • modelarts:poolId

URI

POST /v2/{project_id}/training-jobs/{job_id}/diagnosis-tasks

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

参数解释:用户项目ID。获取方法请参见获取项目ID和名称

约束限制:1 - 64字符,字母、数字和中划线。

取值范围:不涉及。

默认取值:不涉及。

job_id

String

参数解释:作业ID。

约束限制:不涉及。

取值范围:长度为32的英文字符、数字的组合。

默认取值:不涉及。

请求参数

表2 请求Body参数

参数

是否必选

参数类型

描述

type

String

参数解释:诊断作业的诊断子项配置。

取值范围

  • standard:标准诊断

默认取值:standard。

响应参数

状态码:202

表3 响应Body参数

参数

参数类型

描述

task_id

String

参数解释:诊断作业ID。

task_name

String

参数解释:诊断作业名称。

training_job_id

String

参数解释:诊断作业源训练作业ID。

create_time

String

参数解释:诊断作业创建时间。

update_time

String

参数解释:诊断作业更新时间。

task_status

String

参数解释:诊断作业状态。

description

String

参数解释:诊断作业描述。

请求示例

POST https://endpoint/v2/{project_id}/training-jobs/{job_id}/diagnosis-tasks

{
  "type" : "standard"
}

响应示例

状态码:202

OK

{
  "task_id" : "22816c67-4baa-4853-9ec6-1e8c47c0e85c",
  "task_name" : "job-9h2rl6j8-1762568484",
  "training_job_id" : "ae041d1c-c5c6-4ae9-bdb1-f9dd8fe4d2c5",
  "create_time" : "2025-11-07T03:00:43.000+00:00",
  "update_time" : "2025-11-07T03:00:43.000+00:00",
  "description" : "Created by ModelArts-Training",
  "task_status" : "CREATING"
}

状态码

状态码

描述

202

OK

错误码

请参见错误码

相关文档