Submits a job of deleting media files from a media fingerprint library.

Limits

You can call this operation to delete up to 200 media files from a media fingerprint library at a time.

QPS limit

You can call this operation up to 150 times per second per account. If the number of calls per second exceeds the limit, throttling is triggered. As a result, your business may be affected. We recommend that you take note of the limit when you call this operation. For more information, see QPS limit.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. OpenAPI Explorer dynamically generates the sample code of the operation for different SDKs.

Request parameters

Parameter Type Required Example Description
Action String Yes SubmitFpFileDeleteJob

The operation that you want to perform. Set the value to SubmitFpFileDeleteJob.

PipelineId String No ed450ea0bfbd41e29f80a401fb4d****

The ID of the ApsaraVideo Media Processing (MPS) queue. This ID can be used to associate the job with a notification method. To view the MPS queue ID, log on to the MPS console and choose Global Settings > Pipelines in the left-side navigation pane.

FpDBId String Yes 88c6ca184c0e432bbf5b665e2a15****

The ID of the media fingerprint library. You can obtain the library ID from the response parameters of the CreateFpShotDB operation.

UserData String No example data

The custom data. The value can contain letters and digits and can be up to 128 bytes in length.

FileIds String Yes 41e6536e4f2250e2e9bf26cdea19****

The IDs of the media files that you want to delete. Separate multiple file IDs with commas (,). You can delete up to 200 media files at a time. You can obtain the file IDs from the response parameters of the ListFpShotFiles operation.

Response parameters

Parameter Type Example Description
RequestId String D127C68E-F1A1-4CE5-A874-8FF724881A12

The ID of the request.

JobId String 39f8e0bc005e4f309379701645f4****

The ID of the deleted media file.

Examples

Sample requests

http(s)://mts.cn-hangzhou.aliyuncs.com/?Action=SubmitFpFileDeleteJob
&PipelineId=ed450ea0bfbd41e29f80a401fb4d****
&FpDBId=88c6ca184c0e432bbf5b665e2a15****
&UserData=example data
&FileIds=41e6536e4f2250e2e9bf26cdea19****
&<Common request parameters>

Sample success responses

XML format 

HTTP/1.1 200 OK
Content-Type:application/xml

<SubmitFpFileDeleteJobResponse>
    <RequestId>D127C68E-F1A1-4CE5-A874-8FF724881A12</RequestId>
    <JobId>39f8e0bc005e4f309379701645f4****</JobId>
</SubmitFpFileDeleteJobResponse>

JSON format 

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "D127C68E-F1A1-4CE5-A874-8FF724881A12",
  "JobId" : "39f8e0bc005e4f309379701645f4****"
}

Error codes

HTTP status code Error code Error message Description
400 InvalidParameter.DBNotExist The DNA database does not exist. The error message returned because the media fingerprint library does not exist.
500 InternalError The operation has failed due to some unknown error, exception or failure. The error message returned because an internal error has occurred. Try again later.

For a list of error codes, visit the API Error Center.