Deleting a Migration Task
Function
This API is used to delete a migration task. In-progress tasks cannot be deleted. If you try to delete an in-progress task, the system will return a message indicating the deletion fails. To delete such a task, pause the task first.
Calling Method
For details, see Calling APIs.
URI
DELETE /v2/{project_id}/tasks/{task_id}
| 
        Parameter  | 
      
        Mandatory  | 
      
        Type  | 
      
        Description  | 
     
|---|---|---|---|
| 
        project_id  | 
      
        Yes  | 
      
        String  | 
      
        The project ID. Minimum length: 1 character Maximum length: 1,024 characters  | 
     
| 
        task_id  | 
      
        Yes  | 
      
        String  | 
      
        The migration task ID. Minimum length: 1 character Maximum length: 1,024 characters  | 
     
Request
| 
        Parameter  | 
      
        Mandatory  | 
      
        Type  | 
      
        Description  | 
     
|---|---|---|---|
| 
        X-Auth-Token  | 
      
        Yes  | 
      
        String  | 
      
        The token used for IAM authentication. Minimum length: 1 character Maximum length: 16,384 characters  | 
     
Response
Status code: 400
| 
        Parameter  | 
      
        Type  | 
      
        Description  | 
     
|---|---|---|
| 
        error_msg  | 
      
        String  | 
      
        The error message.  | 
     
| 
        error_code  | 
      
        String  | 
      
        The error code.  | 
     
Status code: 403
| 
        Parameter  | 
      
        Type  | 
      
        Description  | 
     
|---|---|---|
| 
        error_msg  | 
      
        String  | 
      
        The error message.  | 
     
| 
        error_code  | 
      
        String  | 
      
        The error code.  | 
     
Example Request
This example deletes the task 191297407830872 in the project 2c0689c860ad4728a497c91ec0844383.
DELETE https://{endpoint}/v2/2c0689c860ad4728a497c91ec0844383/tasks/191297407830872
 Example Response
None
Status Codes
| 
        Status Code  | 
      
        Description  | 
     
|---|---|
| 
        200  | 
      
        OK  | 
     
| 
        400  | 
      
        Bad Request  | 
     
| 
        403  | 
      
        Forbidden  | 
     
Error Codes
For details, see Error Codes.
Feedback
Was this page helpful?
Provide feedbackThank you very much for your feedback. We will continue working to improve the documentation.