メディア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制限」をご参照ください。
デバッグ
リクエストパラメーター
パラメーター | データ型 | 必須/任意 | 例 | 説明 |
---|---|---|---|---|
操作 | String | 必須 | GetUploadDetails |
実行する操作です。 値をGetUploadDetailsに設定します。 |
MediaId | String | 必須 | 61ccbdb06fa83012be4d8083f6 ****,7d2fbc380b0e08e55f **** |
メディアファイルのID、つまりオーディオまたはビデオID。 最大20個のIDを指定できます。 ID が複数ある場合は、カンマ (,) で区切ります。 次のいずれかの方法を使用して、オーディオIDまたはビデオIDを取得できます。
|
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を超えた場合に返されるエラーメッセージ。 |