SubmitPreprocessJobs - ApsaraVideo VOD - Alibaba Cloud Documentation Center

Preprocesses a video by using the production studio.

Operation description

During video preprocessing, videos are transcoded to meet the playback requirements of the production studio. Therefore, you are charged for video preprocessing. You can submit a ticket for information about the production studio service.
You can obtain the preprocessing result in the TranscodeComplete event notification. If the value of the Preprocess parameter is true in the event notification, the video is preprocessed.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer.

Debug

Authorization information

There is currently no authorization information disclosed in the API.

Request parameters

Parameter	Type	Required	Description	Example
VideoId	string	Yes	The ID of the video.	d3e680e618708efbf2cae7cc9312****
PreprocessType	string	Yes	The preprocessing type. Set the value to LivePreprocess, which indicates that the video is preprocessed in the production studio.	LivePreprocess

Response parameters

Parameter	Type	Description	Example
	object	The returned data.
RequestId	string	The ID of the request.	E4EBD2BF-5EB0-4476-8829-9D94E1B1****
PreprocessJobs	array<object>	The job information.
	object	The detailed information of the job.
JobId	string	The ID of the job.	bb396607fd11fee9effbb99c4****

Examples

Sample success responses

JSONformat

{
  "RequestId": "E4EBD2BF-5EB0-4476-8829-9D94E1B1****",
  "PreprocessJobs": {
    "PreprocessJob": [
      {
        "JobId": "bb396607fd11fee9effbb99c4****"
      }
    ]
  }
}

Error codes

For a list of error codes, visit the Service error codes.

Change history

Change time	Summary of changes	Operation

No change history

Common errors

The following table describes the common errors that this operation can return.

Error code	Error message	HTTP status code	Description
InvalidVideo.NotFound	The video does not exist.	404	The error message returned because the video does not exist.
NoSuchResource	The specified resource %s does not exist.	404	The error message returned because the specified resource does not exist.
Forbidden.IllegalStatus	Status of the video is illegal.	400	The error message returned because the video status is invalid. You can preprocess a video only in the UploadSucces, Normal, Checking, or Transcoding state.