调用CancelUrlUploadJobs取消排队中的URL上传任务。

使用说明

  • 只能取消任务状态为Pending的URL上传任务，可通过GetURLUploadInfos接口查询任务状态。
  • 已经开始执行的上传任务无法取消。

QPS限制

本接口的单用户QPS限制为50次/秒。超过限制，API调用会被限流，这可能会影响您的业务，请合理调用。更多信息，请参见QPS限制。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String 是 CancelUrlUploadJobs

系统规定参数。取值：CancelUrlUploadJobs。

JobIds String 否 341c92e6c18dc435ee31253685****,0193d395194a83ad6ee2ef27a5b5****

任务ID列表，任务ID（JobId）可以通过GetPlayInfo接口中返回的PlayInfo结构体中获取。

  • 最多支持10个ID。
  • 多个ID之间使用半角逗号（,）分隔。
说明 JobIds和UploadUrls必须指定一个，二者同时传入时只处理JobIds。
UploadUrls String 否 http://www.example.aliyundoc.com/***/video01.mp4,http://www.example.aliyundoc.com/***/video02.mp4

上传源视频URL列表。多个URL之间使用半角逗号（,）分隔，最多支持10个。

说明
  • 使用前，先进行URL编码。
  • JobIds和UploadUrls必须指定一个，二者同时传入时只处理JobIds。

返回数据

名称 类型 示例值 描述
RequestId String 25818875-5F78-4D5C-3C3D-D7393642****

请求ID。
CanceledJobs Array of String 341c92e6c18dc435ee31253685****,0193d395194a83ad6ee2ef27a5b5****

取消成功的任务列表。返回值为JobId。
NonExists Array of String http://www.example.aliyundoc.com/***/video01.mp4,http://www.example.aliyundoc.com/***/video02.mp4

不存在的JobId或URL列表。

如果请求参数为JobIds，返回值为JobId；如果请求参数为UploadURLs，返回值为URL。

示例

请求示例

http(s)://vod.cn-shanghai.aliyuncs.com/?Action=CancelUrlUploadJobs
&JobIds=341c92e6c18dc435ee31253685****,0193d395194a83ad6ee2ef27a5b5****
&<公共请求参数>

正常返回示例

XML格式 

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

<CancelUrlUploadJobsResponse>
    <RequestId>25818875-5F78-4D5C-3C3D-D7393642****</RequestId>
    <CanceledJobs>341c92e6c18dc435ee31253685****,0193d395194a83ad6ee2ef27a5b5****</CanceledJobs>
    <NonExists>http://www.example.aliyundoc.com/***/video01.mp4,http://www.example.aliyundoc.com/***/video02.mp4</NonExists>
</CancelUrlUploadJobsResponse>

JSON格式 

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

{
  "RequestId" : "25818875-5F78-4D5C-3C3D-D7393642****",
  "CanceledJobs" : [ "341c92e6c18dc435ee31253685****,0193d395194a83ad6ee2ef27a5b5****" ],
  "NonExists" : [ "http://www.example.aliyundoc.com/***/video01.mp4,http://www.example.aliyundoc.com/***/video02.mp4" ]
}

错误码

访问错误中心查看更多错误码。