调用DeleteStream删除媒体流(视频流,音频流)信息及存储文件。
使用说明
支持批量删除。
QPS限制
本接口的单用户QPS限制为50次/秒。超过限制,API调用会被限流,这可能会影响您的业务,请合理调用。更多信息,请参见QPS限制。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | DeleteStream |
系统规定参数。取值:DeleteStream。 |
JobIds | String | 是 | 35eb4dbda18c49cc0025df374b46**** |
媒体流转码的作业ID列表,由一个或多个JobId组成。
|
VideoId | String | 是 | 95948ddba24446b6aed5db985e78**** |
视频ID。可通过以下方式获取:
|
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
RequestId | String | 25818875-5F78-4A7U43F6-D7393642**** |
请求ID。 |
示例
请求示例
http(s)://vod.cn-shanghai.aliyuncs.com/?Action=DeleteStream
&JobIds=35eb4dbda18c49cc0025df374b46****
&VideoId=95948ddba24446b6aed5db985e78****
&公共请求参数
正常返回示例
XML
格式
HTTP/1.1 200 OK
Content-Type:application/xml
<DeleteStreamResponse>
<RequestId>25818875-5F78-4A7U43F6-D7393642****</RequestId>
</DeleteStreamResponse>
JSON
格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"RequestId" : "25818875-5F78-4A7U43F6-D7393642****"
}
错误码
访问错误中心查看更多错误码。
接口错误码
下表列举了本接口特有的错误码。
错误代码 |
错误信息 |
HTTP 状态码 |
说明 |
---|---|---|---|
JobIdsExceededMax |
The JobIds exceeded maximum. |
400 |
作业ID列表超过最大长度。 |
InvalidVideo.NotFound |
The video does not exist. |
404 |
视频不存在。 |
InvalidStream.NotFound |
The stream does not exist. |
404 |
媒体流不存在。 |
DeleteStreamFailed |
Deleting stream has failed due to some unknown error. |
503 |
删除媒体流失败,请稍后重试。 |
SDK示例
建议使用服务端SDK来调用API,此API各语言调用的示例代码,请参见: