Submits a job of clearing or deleting a media fingerprint library.

Usage notes

You can call this operation to clear or delete a specified media fingerprint library based on the library ID. If you clear a media fingerprint library, the content in the library is deleted, but the library is not deleted. If you delete a media fingerprint library, both the library and the content in the library are deleted. If you do not specify the operation type, the system clears the media fingerprint library by default.

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 SubmitFpDBDeleteJob

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

PipelineId String No fb712a6890464059b1b2ea7c8647****

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 88c6ca184c0e47098a5b665e2a12****

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.

DelType String No Purge

The operation type. Valid values:

  • Purge: clears the media fingerprint library. If you set the DelType parameter to Purge, the content in the library is deleted, but the library is not deleted.
  • Delete: deletes the media fingerprint library. If you set the DelType parameter to Delete, both the library and the content in the library are deleted.
  • Default value: Purge.

Response parameters

Parameter Type Example Description
RequestId String 4247B23C-26DE-529F-8D9F-FD6811AE979B

The ID of the request.

JobId String d98459323c024947a104f6a50cbf****

The ID of the job. We recommend that you keep this ID for subsequent operation calls.

Examples

Sample requests

http(s)://mts.cn-shanghai.aliyuncs.com/?Action=SubmitFpDBDeleteJob
&PipelineId=fb712a6890464059b1b2ea7c8647****
&FpDBId=88c6ca184c0e47098a5b665e2a12****
&UserData=example data
&DelType=Purge
&<Common request parameters>

Sample success responses

XML format 

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

<SubmitFpDBDeleteJobResponse>
    <RequestId>4247B23C-26DE-529F-8D9F-FD6811AE979B</RequestId>
    <JobId>d98459323c024947a104f6a50cbf****</JobId>
</SubmitFpDBDeleteJobResponse>

JSON format 

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

{
  "RequestId" : "4247B23C-26DE-529F-8D9F-FD6811AE979B",
  "JobId" : "d98459323c024947a104f6a50cbf****"
}

Error codes

HTTP status code Error code Error message Description
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.