Help Center> VAS> API Reference> Video Analysis Service APIs> Deleting a Job
View PDF

Deleting a Job

Function

Delete a specified job of the selected video analysis service based on the job ID.

URI

  • URI format: 
    DELETE /v2/{project_id}/services/{service_name}/tasks/{task_id}
  • Parameters

    Parameter

    Mandatory

    Type

    Description

    project_id

    Yes

    String

    Project ID

    service_name

    Yes

    String

    Name of the selected video analysis service

    task_id

    Yes

    String

    Job ID

Request Parameters

Example request 
DELETE /v2/6204a5bd270343b5885144cf9c8c158d/services/video-analyze/tasks/f18320e61e4c4dc685aa2dfc22a28dc5

Response Parameters

  • Example response when the deletion fails 
    {   
    "error_code": "IVA.0005",
    "error_msg": "The requested resource is NOT found. The taskId f18320e61e4c4dc685aa2dfc22a28dc5 is not found."
}
  • Response parameters

    Parameter

    Description

    error_code

    Error code

    error_msg

    Error message

Status Codes

  • Normal

    If the output type is hosting, status code 202 is returned. Otherwise, status code 200 is returned.

  • Abnormal

    Status Code

    Description

    400 Bad Request

    Request error. For details about the returned error code, see Error Codes.

    401 Unauthorized

    Authentication failed.

    403 Forbidden

    No operation permission.

    404 Not Found

    The requested resource was not found.

    500 Internal Server Error

    Internal service error.

    503 Service Unavailable

    Service unavailable.