Updated on 2025-08-20 GMT+08:00

Deleting a Training Job

Function

This API is used to delete a training job from ModelArts.

This API applies to the following scenarios: When you need to delete completed or unnecessary training jobs, you can use this API to delete a specified training job. Before using this API, ensure that the training job exists and you have the permission to delete it. After the deletion is complete, the training job is permanently removed from the platform, and related resources and configurations are cleared. If the training job ID does not exist or you do not have the operation 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

DELETE /v2/{project_id}/training-jobs/{training_job_id}

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: ID of a training job

Constraints: For details, see Querying a Training Job List.

Range: N/A

Default Value: N/A

Request Parameters

None

Response Parameters

Status code: 202

No Content

None

Example Requests

The following shows how to delete a training job whose UUID is 3faf5c03-aaa1-4cbe-879d-24b05d997347.

DELETE https://endpoint/v2/{project_id}/training-jobs/3faf5c03-aaa1-4cbe-879d-24b05d997347

Example Responses

Status code: 202

No Content

""

Status Codes

Status Code

Description

202

No Content

Error Codes

See Error Codes.