メディアIDに基づいて、アップロード時間、アップロード率、アップロードソースなどのアップロードの詳細を照会します。

使用上の注意

  • この操作では、オーディオおよびビデオファイルに関するアップロードの詳細のみを取得できます。
  • ApsaraVideo VODコンソールを使用してオーディオおよびビデオファイルをアップロードする場合、この操作を呼び出してアップロード率などの情報を照会できます。 アップロードSDKを使用してオーディオおよびビデオファイルをアップロードする場合は、アップロードSDKのバージョンが次のいずれかの要件を満たしていることを確認してください。
    • Java用アップロードSDKのバージョンは1.4.4以降です。
    • C ++ 用のアップロードSDKのバージョンは1.0.0以降です。
    • PHP用アップロードSDKのバージョンは1.0.2以降です。
    • Python用アップロードSDKのバージョンは1.3.0以降です。
    • JavaScript用アップロードSDKのバージョンは1.4.0以降です。
    • Android用アップロードSDKのバージョンは1.5.0以降です。
    • iOS用アップロードSDKのバージョンは1.5.0以降です。

QPS制限

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

デバッグ

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

リクエストパラメーター

パラメーター データ型 必須/任意 説明
操作 String 必須 GetUploadDetails

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

MediaId String 必須 61ccbdb06fa83012be4d8083f6 ****,7d2fbc380b0e08e55f ****

メディアファイルのID、つまりオーディオまたはビデオID。 最大20個のIDを指定できます。 ID が複数ある場合は、カンマ (,) で区切ります。 次のいずれかの方法を使用して、オーディオIDまたはビデオIDを取得できます。

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

メディアファイルのタイプ。 値をvideoに設定します。これは、オーディオファイルとビデオファイルを示します。

レスポンスパラメーター

パラメーター データ型 説明
RequestId String 9E290613-04F4-47F4-795D30732077 ****

リクエストの ID です。

ForbiddenMediaIds 文字列の配列 7d2fbc380b0e08e55f ****

アクセスできないメディアファイルのID。

NonExistMediaIds 文字列の配列 dfsg ****

存在しないメディアファイルのID。

UploadDetails UploadDetailの配列

アップロードの詳細。

ステータス String アップロード

ビデオのステータス。 パラメーターの有効な値と値の説明の詳細については、基本構造の「ステータス: ビデオのステータス」セクションを参照してください。

CreationTime String 2019-04-28T09:42:07Z

アップロードジョブが作成された時刻。 日時は ISO 8601 規格 (yyyy-MM-ddTHH:mm:ssZ 形式) に準拠します。 時刻は UTC 表示です。

UploadSource String WebSDK

メディアファイルのアップロードに使用されるメソッド。

アップロードIP String 192.168.0.1

メディアファイルをアップロードするサーバーのIPアドレス。

DeviceModel String Chrome

デバイスモデル。

ModificationTime String 2019-04-28T09:43:12Z

メディアファイルに関する情報が更新された時刻。 日時は ISO 8601 規格 (yyyy-MM-ddTHH:mm:ssZ 形式) に準拠します。 時刻は UTC 表示です。

CompletionTime String 2019-04-28T09:45:07Z

アップロードジョブが完了した時刻。 日時は ISO 8601 規格 (yyyy-MM-ddTHH:mm:ssZ 形式) に準拠します。 時刻は UTC 表示です。

MediaId String 61ccbdb06fa83012be4d8083f6 ****

アップロードされたオーディオまたはビデオのID。

UploadSize Long 346

アップロードのサイズ。 単位: バイト。

UploadRatio Float 0.038

アップロード率。

UploadStatus String アップロード

アップロードジョブのステータス。 パラメーターの有効な値と値の説明の詳細については、基本構造の「ステータス: URLベースのアップロードジョブのステータス」セクションを参照してください。

タイトル String テストファイルの詳細をアップロードする

メディアファイルのタイトル。

FileSize Long 46

アップロードされたファイルのサイズ。 単位: バイト。

リクエストの例

http(s):// vod.cn-shanghai.aliyuncs.com/?Action=GetUploadDetails
&MediaIds=61ccbdb06fa83012be4d8083f6 ****,7d2fbc380b0e08e55f ****
&MediaType=ビデオ
&<共通リクエストパラメーター>

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

XML 形式

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

<GetUploadDetailsResponse>
    <RequestId>9E290613-04F4-47F4-795D30732077 ****</RequestId>
    <ForbiddenMediaIds>7d2fbc380b0e08e55f ****</ForbiddenMediaIds>
    <NonExistMediaIds>dfsg ****</NonExistMediaIds>
    <UploadDetails>
      <UploadDetail>
        <Status> アップロード </Status>
        <CreationTime>2019-04-28T09:42:07Z</CreationTime>
        <UploadSource>WebSDK</UploadSource>
        <UploadIP>192.168.0.1</UploadIP>
        <DeviceModel>Chrome</DeviceModel>
        <ModificationTime>2019-04-28T09:43:12Z</ModificationTime>
        <CompletionTime>2019-04-28T09:45:07Z</CompletionTime>
        <MediaId>61ccbdb06fa83012be4d8083f6 ****</MediaId>
        <UploadSize>346</UploadSize>
        <UploadRatio>0.038</UploadRatio>
        <UploadStatus> アップロード </UploadStatus>
        <Title> テストファイルの詳細をアップロード </Title>
        <FileSize>46</FileSize>
      </UploadDetail>
    </UploadDetails>
</GetUploadDetailsResponse>

JSON 形式

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

{
  "RequestId" : "9E290613-04F4-47F4-795D30732077 ****" 、
  "ForbiddenMediaIds" : [ "7d2fbc380b0e08e55f ****"] 、
  "NonExistMediaIds" : [ "dfsg ****"] 、
  "UploadDetails" : [ {
    "ステータス" : "アップロード" 、
    "CreationTime" : "2019-04-28T09:42:07Z" 、
    "UploadSource" : "WebSDK",
    "UploadIP" : "192.168.0.1" 、
    "DeviceModel" : "Chrome" 、
    "ModificationTime" : "2019-04-28T09:43:12Z" 、
    "CompletionTime" : "2019-04-28T09:45:07Z" 、
    "MediaId" : "61ccbdb06fa83012be4d8083f6 ****" 、
    "UploadSize" : 346、
    "UploadRatio" : 0.038、
    "UploadStatus" : "Uploading" 、
    "タイトル" : "テストファイルの詳細をアップロード" 、
    "FileSize" : 46
  } ]
}

エラーコード

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

共通エラー

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

エラーコード

エラーメッセージ

HTTP ステータスコード

説明

LimitExceeded.MediaIds

入力パラメーター 'MediaIds' が制限を超えています。

400

メディアIDの数が20を超えた場合に返されるエラーメッセージ。