キュー内のURLベースのアップロードジョブをキャンセルします。

使用上の注意

  • キャンセルできるのは、[保留中] 状態のURLベースのアップロードジョブのみです。 GetURLUploadInfos操作を呼び出して、URLベースのアップロードジョブのステータスを照会できます。
  • すでに開始されているアップロードジョブはキャンセルできません。

QPS制限

この操作は、アカウントごとに1秒あたり最大50回呼び出すことができます。 1秒あたりの呼び出し数が制限を超えると、スロットリングがトリガーされます。 その結果、あなたのビジネスが影響を受ける可能性があります。 この操作を呼び出すときは、制限に注意することをお勧めします。 詳細については、「ApsaraVideo VODのAPI操作のQPS制限」をご参照ください。

デバッグ

OpenAPI Explorer は署名値を自動的に計算します。 この操作は、OpenAPI Explorer で呼び出すことを推奨します。 OpenAPI Explorer は、さまざまな SDK に対して操作のサンプルコードを動的に生成します。

リクエストパラメーター

パラメーター データ型 必須／任意 例 説明
操作 String 必須 CancelUrlUploadJobs

実行する操作です。 値をCancelUrlUploadJobsに設定します。

ジョブ String 任意 341c92e6c18dc435ee31253685 ****,0193d395194a83ad6ee2ef27a5b5 ****

アップロードジョブのID。 ジョブIDは、GetPlayInfo操作の応答パラメーターPlayInfoで取得できます。

  • 最大10個のIDを指定できます。
  • ID が複数ある場合は、カンマ (,) で区切ります。
注 JobIdsパラメーターとUploadUrlsパラメーターのいずれかを設定する必要があります。 JobIdsパラメーターとUploadUrlsパラメーターの両方を設定した場合、JobIdsパラメーターの値のみが有効になります。
UploadUrls String 任意 http://www.example.aliyundoc.com/***/video01.mp4、http://www.example.aliyundoc.com/***/video02.mp4

ソースファイルのアップロードURL。 複数のURLはコンマ (,) で区切ります。 最大10個のURLを指定できます。

注
  • URLを使用する前に、URLをエンコードする必要があります。
  • JobIdsパラメーターとUploadUrlsパラメーターのいずれかを設定する必要があります。 JobIdsパラメーターとUploadUrlsパラメーターの両方を設定した場合、JobIdsパラメーターの値のみが有効になります。

レスポンスパラメーター

パラメーター データ型 例 説明
RequestId String 25818875-5F78-4D5C-3C3D-D7393642 ****

リクエストの ID です。

CanceledJobs 文字列の配列 341c92e6c18dc435ee31253685 ****,0193d395194a83ad6ee2ef27a5b5 ****

キャンセルされたジョブのID。

非存在 文字列の配列 http://www.example.aliyundoc.com/***/video01.mp4、http://www.example.aliyundoc.com/***/video02.mp4

存在しないジョブIDまたはアップロードURL。

リクエストパラメーターJobIdsを設定すると、存在しないジョブIDが返されます。 リクエストパラメーター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>
    <非存在> http://www.example.aliyundoc.com/***/video01.mp4、http://www.example.aliyundoc.com/***/video02.mp4</非存在>
</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"]
}

エラーコード

エラーコードリストについては、「API エラーセンター」をご参照ください。