動画のアップロードがタイムアウトした後、新しいアップロード資格情報を取得します。

使用上の注意

ビデオまたはオーディオのソースファイルを上書きする場合は、この操作を呼び出してソースファイルのアップロードURLを取得できます。 その後、ビデオIDやオーディオIDを変更せずに、新しいソースファイルをアップロードできます。 ただし、これらのジョブが設定されている場合、ファイルの上書きによってトランスコードとスナップショットジョブが自動的にトリガーされる場合があります。 詳細については、「URLと資格情報のアップロード」をご参照ください。

QPS制限

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

デバッグ

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

リクエストパラメーター

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

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

VideoId String 必須 c6a23a870c8c4ffcd40cbd381333 ****

オーディオファイルまたはビデオファイルのID。 次のいずれかの方法を使用してIDを取得できます。

  • ApsaraVideo VODコンソールにログインします。 左側のナビゲーションウィンドウで、[メディアファイル] > [オーディオ /ビデオ] を選択します。 [ビデオとオーディオ] ページで、オーディオファイルまたはビデオファイルのIDを表示できます。
  • オーディオファイルまたはビデオファイルをアップロードするために呼び出したCreateUploadVideo操作によって返されるVideoIdパラメーターの値を表示します。
  • ファイルをアップロードした後、オーディオまたはビデオファイルのIDを照会するために呼び出したSearchMedia操作によって返されたVideoIdパラメーターの値を表示します。

レスポンスパラメーター

パラメーター データ型 例 説明
RequestId String 25818875-5F78-4A43-7DF6-D7393642 ****

リクエストの ID です。

UploadAddress String eyJTZWN1cml0eVRiQ0FJU3p3TjFxNkZ0NUIyeW ****

アップロードURL。

注 この操作で返されるアップロードURLはBase64-encodedです。 SDKまたはAPI操作を使用してアップロードURLに基づいてメディアアセットをアップロードする前に、Base64アルゴリズムを使用してアップロードURLをデコードする必要があります。 アップロードにネイティブObject Storage Service (OSS) SDKまたはOSS APIを使用する場合にのみ、アップロードURLを解析する必要があります。
VideoId String c6a23a870c8c4ffcd40cbd381333 ****

オーディオファイルまたはビデオファイルのID。

UploadAuth String FJU3p3TZ0NUIyeW ****

アップロード資格情報。

注 この操作で返されるアップロード資格情報はBase64-encodedです。 SDKまたはAPI操作を使用してアップロード資格情報に基づいてメディアアセットをアップロードする前に、Base64アルゴリズムを使用してアップロード資格情報をデコードする必要があります。 アップロードにネイティブOSS SDKまたはOSS APIを使用する場合にのみ、アップロード資格情報を解析する必要があります。

例

リクエストの例

http(s):// vod.cn-shanghai.aliyuncs.com/?Action=RefreshUploadVideo
&VideoId=c6a23a870c8c4ffcd40cbd381333 ****
&<共通リクエストパラメーター>

正常に処理された場合のレスポンス例

XML 形式 

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

<RefreshUploadVideoResponse>
    <RequestId>25818875-5F78-4A43-7DF6-D7393642 ****</RequestId>
    <UploadAddress>eyJTZWN1cml0eVRiQ0FJU3p3TjFxNkZ0NUIyeW ****</UploadAddress>
    <VideoId>c6a23a870c8c4ffcd40cbd381333 ****</VideoId>
    <UploadAuth>FJU3p3TZ0NUIyeW ****</UploadAuth>
</RefreshUploadVideoResponse>

JSON 形式 

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

{
  "RequestId" : "25818875-5F78-4A43-7DF6-D7393642 ****" 、
  "UploadAddress" : "eyJTZWN1cml0eVRiQ0FJU3p3TjFxNkZ0NUIyeW ****" 、
  "VideoId" : "c6a23a870c8c4ffcd40cbd381333 ****" 、
  "UploadAuth" : "FJU3p3TZ0NUIyeW ****"
}

エラーコード

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

共通エラー

次の表に、この操作で返される一般的なエラーを示します。

エラーコード

エラーメッセージ

HTTP ステータスコード

説明

InvalidVideo.Damaged

ビデオが破損しました。

400

ビデオの作成中にエラーが発生した場合、またはビデオが破損した場合に返されるエラーメッセージ。

InvalidVideo.NotFound

ビデオは存在しません。

404

ビデオが存在しない場合に返されるエラーメッセージ。

SDK サンプル

この操作を呼び出すには、サーバーSDKを使用することを推奨します。 さまざまな言語でこの操作を呼び出すために使用されるサンプルコードの詳細については、次のトピックを参照してください。