ファイル ID に基づいて、音声ファイルと動画ファイルのトランスコーディングの概要を照会します。トランスコーディングの概要には、トランスコーディングのステータスと進捗が含まれます。
操作説明
1 つの音声ファイルまたは動画ファイルが複数回トランスコードされる場合があります。この操作は、最新のトランスコーディングの概要のみを返します。
1 回のリクエストで最大 10 個の音声ファイルと動画ファイルのトランスコーディングの概要を照会できます。
ListTranscodeTask 操作を呼び出して、過去のトランスコーディングタスクを照会できます。
**この操作を呼び出して、過去 1 年以内に作成されたトランスコーディングタスクに関する情報のみを照会できます。
今すぐお試しください
テスト
RAM 認証
|
アクション |
アクセスレベル |
リソースタイプ |
条件キー |
依存アクション |
|
vod:GetTranscodeSummary |
get |
*All Resource
|
なし | なし |
リクエストパラメーター
|
パラメーター |
型 |
必須 / 任意 |
説明 |
例 |
| VideoIds |
string |
必須 |
音声ファイルまたは動画ファイルの ID。最大 10 個の ID を指定できます。ID はコンマ (,) で区切ります。次のいずれかの方法で ID を取得できます。
|
"d4860fcc6ae9fed52e8938244****,e1db68cc586644b83e562bcd94****,hhhhhhh" |
レスポンスフィールド
|
フィールド |
型 |
説明 |
例 |
|
object |
|||
| RequestId |
string |
リクエストの ID。 |
25818875-5F78-4A*****F6-D7393642CA58 |
| NonExistVideoIds |
array |
存在しない音声ファイルまたは動画ファイルの ID。 |
|
|
string |
存在しない音声ファイルまたは動画ファイルの ID。 |
["hhhhhhh"] |
|
| TranscodeSummaryList |
array<object> |
ファイルのトランスコーディングの概要。 |
|
|
array<object> |
|||
| CreationTime |
string |
トランスコーディングタスクが作成された時間。時間は yyyy-MM-ddTHH:mm:ssZ 形式で、UTC で表示されます。 |
2019-01-23T12:35:12Z |
| VideoId |
string |
音声ファイルまたは動画ファイルの ID。 |
e1db68cc586644b83e562bcd94**** |
| CompleteTime |
string |
トランスコーディングタスクが完了した時間。時間は yyyy-MM-ddTHH:mm:ssZ 形式で、UTC で表示されます。 |
2019-01-23T12:40:12Z |
| TranscodeStatus |
string |
トランスコーディングタスクのステータス。有効な値：
|
Processing |
| TranscodeTemplateGroupId |
string |
トランスコーディングテンプレートグループの ID。 |
44f9e406bbb*****736a9abe876ecc0 |
| TranscodeJobInfoSummaryList |
array<object> |
トランスコーディングジョブの概要。 |
|
|
object |
|||
| CreationTime |
string |
トランスコーディングジョブが作成された時間。時間は yyyy-MM-ddTHH:mm:ssZ 形式で、UTC で表示されます。 |
2019-02-27T03:34:46Z |
| ErrorMessage |
string |
トランスコーディングジョブが失敗した場合に返されるエラーメッセージ。 |
ErrorMessage |
| Height |
string |
出力動画の高さ。単位：ピクセル。 |
960 |
| TranscodeProgress |
integer |
トランスコーディングの進捗。有効な値： |
100 |
| TranscodeTemplateId |
string |
トランスコーディングテンプレートの ID。 |
57496724ae2*****0968d6e08acc8f6 |
| Bitrate |
string |
出力動画の平均ビットレート。単位：Kbit/s。 |
749 |
| ErrorCode |
string |
トランスコーディングジョブが失敗した場合に返されるエラーコード。 |
200 |
| CompleteTime |
string |
トランスコーディングジョブが完了した時間。時間は yyyy-MM-ddTHH:mm:ssZ 形式で、UTC で表示されます。 |
2019-02-27T03:40:51Z |
| Width |
string |
出力動画の幅。単位：ピクセル。 |
544 |
| Duration |
string |
出力動画の長さ。単位：秒。 |
12 |
| Fps |
string |
出力動画のフレームレート。単位：フレーム/秒。 |
30 |
| TranscodeJobStatus |
string |
トランスコーディングジョブのステータス。有効な値：
|
Transcoding |
| Filesize |
integer |
出力動画のサイズ。単位：バイト。 |
1144259 |
| Format |
string |
出力動画のコンテナフォーマット。 |
mp4 |
| WatermarkIdList |
array |
出力動画に適用されるウォーターマークの ID。 |
|
|
string |
出力動画に適用されるウォーターマークの ID。 |
["af2afe4761992c*****d947dae97337"] |
例
成功レスポンス
JSONJSON
{
"RequestId": "25818875-5F78-4A*****F6-D7393642CA58",
"NonExistVideoIds": [
"[\"hhhhhhh\"]"
],
"TranscodeSummaryList": [
{
"CreationTime": "2019-01-23T12:35:12Z",
"VideoId": "e1db68cc586644b83e562bcd94****",
"CompleteTime": "2019-01-23T12:40:12Z",
"TranscodeStatus": "Processing",
"TranscodeTemplateGroupId": "44f9e406bbb*****736a9abe876ecc0",
"TranscodeJobInfoSummaryList": [
{
"CreationTime": "2019-02-27T03:34:46Z",
"ErrorMessage": "ErrorMessage",
"Height": "960",
"TranscodeProgress": 100,
"TranscodeTemplateId": "57496724ae2*****0968d6e08acc8f6",
"Bitrate": "749",
"ErrorCode": "200",
"CompleteTime": "2019-02-27T03:40:51Z",
"Width": "544",
"Duration": "12",
"Fps": "30",
"TranscodeJobStatus": "Transcoding",
"Filesize": 1144259,
"Format": "mp4",
"WatermarkIdList": [
"[\"af2afe4761992c*****d947dae97337\"]"
]
}
]
}
]
}エラーコード
完全なリストについては、「エラーコード」をご参照ください。
変更履歴
完全なリストについては、「変更履歴」をご参照ください。