GetTranscodeTask でトランスコードジョブの詳細をクエリ - VOD - Alibaba Cloud - ApsaraVideo VOD

トランスコーディングタスク ID に基づいてトランスコーディングジョブの詳細を照会します。

操作説明

使用上の注意

この操作は、過去 1 年間のトランスコーディングタスクデータの照会のみをサポートしています。

QPS 制限

単一ユーザーは、毎秒最大 15 回のクエリ (QPS) を実行できます。この制限を超えると速度制限がトリガーされ、ビジネスに影響が出る可能性があります。詳細については、「QPS の使用制限」をご参照ください。

今すぐお試しください

この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

テスト

RAM 認証

下表に、この API を呼び出すために必要な認証情報を示します。認証情報は、RAM (Resource Access Management) ポリシーを使用して定義できます。以下で各列名について説明します。

アクション：特定のリソースに対して実行可能な操作。ポリシー構文ではAction要素として指定します。
API：アクションを具体的に実行するための API。
アクセスレベル：各 API に対して事前定義されているアクセスの種類。有効な値：create、list、get、update、delete。
リソースタイプ：アクションが作用するリソースの種類。リソースレベルでの権限をサポートするかどうかを示すことができます。ポリシーの有効性を確保するため、アクションの対象として適切なリソースを指定してください。
- リソースレベルの権限を持つ API の場合、必要なリソースタイプはアスタリスク (*) でマークされます。ポリシーのResource要素で対応する ARN を指定してください。
- リソースレベルの権限を持たない API の場合、「すべてのリソース」と表示され、ポリシーのResource要素でアスタリスク (*) でマークされます。
条件キー：サービスによって定義された条件のキー。このキーにより、きめ細やかなアクセス制御が可能になります。この制御は、アクション単体に適用することも、特定のリソースに対するアクションに適用することもできます。Alibaba Cloud は、サービス固有の条件キーに加えて、すべての RAM 統合サービスに適用可能な一連の共通条件キーを提供しています。
依存アクション：ある特定のアクションを実行するために、前提として実行が必要となる他のアクション。依存アクションの権限も RAM ユーザーまたは RAM ロールに付与する必要があります。

アクション

アクセスレベル

リソースタイプ

条件キー

依存アクション

vod:GetTranscodeTask

get

*All Resource

*

なし

リクエストパラメーター

パラメーター	型	必須 / 任意	説明	例
TranscodeTaskId	string	任意	トランスコーディングタスクの ID。以下のいずれかのメソッドで ID を取得できます。 SubmitTranscodeJobs 操作を呼び出してトランスコーディングタスクを送信します。応答内の TranscodeTaskId の値がトランスコーディングタスク ID です。 ListTranscodeTask 操作を呼び出します。応答内の TranscodeTaskId の値がトランスコーディングタスク ID です。	b1b65ab107e14*****3dbb900f6c1fe0
JobIds	string	任意	トランスコーディングジョブの ID。最大 10 個の ID を指定できます。複数の ID はコンマ (,) で区切ります。以下のメソッドで ID を取得できます。 SubmitTranscodeJobs 操作を呼び出してトランスコーディングタスクを送信します。応答内の JobId の値がトランスコーディングジョブ ID です。	86c1925fba0**,7afb201e7fa,2cc4997378**

レスポンスフィールド

フィールド	型	説明	例
	object
RequestId	string	リクエスト ID。	F4C6D5BE-BF13-45*****6C-516EA8906DCD。
NonExistJobIds	array	存在しないトランスコーディングジョブの ID。
	string	存在しないトランスコーディングジョブの ID。	["hhhhhhh"]
TranscodeJobInfoList	array<object>	トランスコーディングジョブ情報。
	array<object>	トランスコーディングジョブ情報。
Definition	string	ビデオの解像度。有効な値: LD: フルエント。 SD: 標準解像度。 HD: 高解像度。 FHD: 超高解像度。 OD: オリジナル品質。 2K: 2K。 4K: 4K。 SQ: 標準音質。 HQ: 高音質。 AUTO: アダプティブビットレートストリーミング。この解像度は、トランスコーディングテンプレートでパッケージングが構成されている場合にのみ使用できます。詳細については、「トランスコーディングテンプレートの構成 - PackageSetting」をご参照ください。説明この値はトランスコーディングテンプレートで構成された解像度ラベルであり、トランスコードされた出力ファイルの実際の解像度の範囲を示すものではありません。	LD
CreationTime	string	トランスコーディングジョブが作成された時間。時間は yyyy-MM-ddTHH:mm:ssZ フォーマット (協定世界時 (UTC)) です。	2019-02-26T08:27:16Z
InputFileUrl	string	トランスコーディングソースファイルの OSS URL。	http://outin-40564***e1403e7.oss-cn-shanghai.aliyuncs.com/customerTrans/5b95e568f8e*47f38e/31f1184c-***b2a2-f94-c213f.wmv。
ErrorMessage	string	トランスコーディングジョブが失敗した場合に返されるエラーメッセージ。	ErrorMessage。
ErrorCode	string	トランスコーディングジョブが失敗した場合に返されるエラーコード。	200
CompleteTime	string	トランスコーディングジョブが完了した時間。時間は yyyy-MM-ddTHH:mm:ssZ フォーマット (協定世界時 (UTC)) です。	2019-02-26T08:30:16Z
TranscodeProgress	integer	トランスコーディングジョブの進捗状況。有効値: `[0,100]`。	2019-02-26T08:30:16Z
Priority	string	トランスコーディングタスクの優先度。	6
TranscodeJobStatus	string	トランスコーディングジョブのステータス。有効な値: Transcoding: トランスコード中。 TranscodeSuccess: トランスコード成功。 TranscodeFail: トランスコード失敗。	Transcoding。
TranscodeTemplateId	string	トランスコードに使用されたトランスコーディングテンプレートの ID。	174b0534fea3*****b51c8f0ad1374
TranscodeJobId	string	トランスコーディングジョブの ID。	38f0e513c88*****85515f9d50be188
OutputFile	object	トランスコーディング出力ファイルの情報。
VideoStreamList	string	ビデオストリームのリスト。	[{\"AvgFPS\":\"30.0\",\"Bitrate\":\"933.814\",\"CodecLongName\":\"H.264 / AVC / MPEG-4 AVC / MPEG-4 part 10\",\"CodecName\":\"h264\",\"CodecTag\":\"0x31637661\",\"CodecTagString\":\"avc1\",\"CodecTimeBase\":\"1/60\",\"Dar\":\"9:16\",\"Duration\":\"12.033333\",\"Fps\":\"30.0\",\"HasBFrames\":\"2\",\"Height\":\"360\",\"Index\":\"0\",\"Lang\":\"und\",\"Level\":\"30\",\"PixFmt\":\"yuv420p\",\"Profile\":\"High\",\"Sar\":\"81:256\",\"StartTime\":\"0.000000\",\"Timebase\":\"1/15360\",\"Width\":\"640\"}]
OutputFileUrl	string	トランスコードされた出力ファイルの OSS アドレス。	http://outin-40564***e1403e7.oss-cn-shanghai.aliyuncs.com/883f5d*f20aaa352f/c3be4f073***7d5193ec8-{DestMd5}-od-S00000001-200000.mp4
Encryption	string	トランスコードされた出力ファイルに使用される暗号化構成。値： AliyunVoDEncryption：Alibaba Cloud 映像暗号化 (プライベート暗号化)。 HLSEncryption：HLS 標準暗号化。	{\"EncryptType\":\"AliyunVoDEncryption\"}
Height	string	トランスコードされた出力ファイルのビデオフレームの高さ。単位：ピクセル (px)。	360
SubtitleStreamList	string	字幕ストリームのリスト。	[]
Bitrate	string	トランスコードされた出力ファイルの平均ビットレート。単位：Kbps。	964
AudioStreamList	string	オーディオストリームのリスト。	"AudioStreamList": "[{\"Bitrate\":\"64.533\",\"ChannelLayout\":\"stereo\",\"Channels\":\"2\",\"CodecLongName\":\"AAC (Advanced Audio Coding)\",\"CodecName\":\"aac\",\"CodecTag\":\"0x6134706d\",\"CodecTagString\":\"mp4a\",\"CodecTimeBase\":\"1/44100\",\"Duration\":\"12.615533\",\"Index\":\"1\",\"Lang\":\"und\",\"SampleFmt\":\"fltp\",\"Samplerate\":\"44100\",\"StartTime\":\"-0.046440\",\"Timebase\":\"1/44100\"}]
Width	string	トランスコードされた出力ファイルのビデオフレームの幅。単位：ピクセル (px)。	640
Fps	string	トランスコードされた出力ファイルのフレームレート。単位：フレーム/秒 (fps)。	25
Duration	string	トランスコードされた出力ファイルの長さ。単位：秒 (s)。	12
Format	string	トランスコードされた出力ファイルのコンテナフォーマット。	m3u8
Filesize	integer	トランスコードされた出力ファイルのサイズ。単位：バイト (B)。	851076
WatermarkIdList	array	トランスコーディングに使用されるウォーターマークのリスト。
	string	トランスコーディングに使用されるウォーターマークのリスト。	["64079a0e3e286*****b48a8c9413"]
TranscodeTask	object	トランスコーディングタスク情報。
CreationTime	string	トランスコーディングタスクが作成された時間。時間は yyyy-MM-ddTHH:mm:ssZ フォーマット (協定世界時 (UTC)) です。	2019-01-23T12:35:12Z
Trigger	string	トリガータイプ。有効な値: Auto: ビデオのアップロード後に自動的にトリガーされます。 Manual: SubmitTranscodeJobs 操作の呼び出しによってトリガーされます。	Auto。
TaskStatus	string	トランスコーディングタスクのステータス。有効な値: Processing: 処理中。 Partial: 一部完了。 CompleteAllSucc: すべてのトランスコーディングジョブが完了し、成功しました。 CompleteAllFail: すべてのトランスコーディングジョブが完了しましたが、失敗しました。ソースファイルに問題がある場合、トランスコーディングジョブは開始されず、トランスコーディングタスク全体が失敗します。 CompletePartialSucc: すべてのトランスコーディングジョブが完了しましたが、一部のみ成功しました。	Processing。
VideoId	string	オーディオまたはビデオの ID。	883f5d98107*****b7f20aaa352f。
CompleteTime	string	トランスコーディングタスクが完了した時間。時間は yyyy-MM-ddTHH:mm:ssZ フォーマット (協定世界時 (UTC)) です。	2019-01-23T12:40:12Z
TranscodeTemplateGroupId	string	トランスコードに使用されたトランスコーディングテンプレートグループの ID。	b500c7094bd241*****3e9900752d7c3
TranscodeTaskId	string	トランスコーディングタスクの ID。	b1b65ab107e14*****3dbb900f6c1fe0
TranscodeJobInfoList	array<object>	トランスコーディングジョブ情報。
	array<object>	トランスコーディングジョブ情報。
Definition	string	ビデオの解像度。有効な値： LD：低解像度 SD：標準解像度 HD：高解像度 FHD：超高解像度 OD：オリジナル解像度 2K：2K 4K：4K SQ：標準音質 HQ：高音質 AUTO：アダプティブビットレート。アダプティブビットレートストリームは、トランスコーディングテンプレートで PackageSetting が設定されている場合にのみ返されます。詳細については、「基本構造」をご参照ください。説明このパラメーターは、トランスコーディングテンプレートで構成された解像度を示し、出力ビデオの実際の解像度を示すものではありません。	LD
CreationTime	string	トランスコーディングジョブが作成された時刻。時刻は ISO 8601 規格に準拠し、yyyy-MM-ddTHH:mm:ssZ の形式で表されます。時刻は UTC です。	2019-02-26T08:27:16Z
InputFileUrl	string	入力ファイルの Object Storage Service (OSS) URL。	http://outin-40564***e1403e7.oss-cn-shanghai.aliyuncs.com/customerTrans/5b95e568f8e*47f38e/31f1184c-***b2a2-f94-c213f.wmv
ErrorMessage	string	トランスコーディングジョブが失敗したときに返されるエラーメッセージ。	ErrorMessage
ErrorCode	string	トランスコーディングジョブが失敗したときに返されるエラーコード。	200
CompleteTime	string	トランスコーディングジョブが完了した時刻。時刻は ISO 8601 規格に準拠し、yyyy-MM-ddTHH:mm:ssZ の形式で表されます。時刻は UTC です。	2019-02-26T08:30:16Z
TranscodeProgress	integer	トランスコーディングジョブの進捗。有効な値：`[0,100]`。	100
Priority	string	トランスコーディングジョブの優先度。	6
TranscodeJobStatus	string	トランスコーディングジョブのステータス。 Transcoding TranscodeSuccess TranscodeFail	Transcoding
TranscodeTemplateId	string	トランスコーディングテンプレートの ID。	174b0534fea3*****b51c8f0ad1374
TranscodeJobId	string	トランスコーディングジョブの ID。	38f0e513c88*****85515f9d50be188
OutputFile	object	出力ファイルに関する情報。
VideoStreamList	string	ビデオストリーム。	[{\"AvgFPS\":\"30.0\",\"Bitrate\":\"933.814\",\"CodecLongName\":\"H.264 / AVC / MPEG-4 AVC / MPEG-4 part 10\",\"CodecName\":\"h264\",\"CodecTag\":\"0x31637661\",\"CodecTagString\":\"avc1\",\"CodecTimeBase\":\"1/60\",\"Dar\":\"9:16\",\"Duration\":\"12.033333\",\"Fps\":\"30.0\",\"HasBFrames\":\"2\",\"Height\":\"360\",\"Index\":\"0\",\"Lang\":\"und\",\"Level\":\"30\",\"PixFmt\":\"yuv420p\",\"Profile\":\"High\",\"Sar\":\"81:256\",\"StartTime\":\"0.000000\",\"Timebase\":\"1/15360\",\"Width\":\"640\"}]
OutputFileUrl	string	出力ファイルの OSS URL。	http://outin-40564***e1403e7.oss-cn-shanghai.aliyuncs.com/883f5d*f20aaa352f/c3be4f073***7d5193ec8-{DestMd5}-od-S00000001-200000.mp4
Encryption	string	出力ファイルの暗号化方式。有効な値： AliyunVoDEncryption：Alibaba Cloud 専用の暗号化 HLSEncryption：HTTP Live Streaming (HLS) 暗号化	{\"EncryptType\":\"AliyunVoDEncryption\"}
Height	string	出力ビデオの高さ。単位：ピクセル。	360
SubtitleStreamList	string	字幕ストリーム。	[]
Bitrate	string	出力ファイルの平均ビットレート。単位：Kbit/s。	964
AudioStreamList	string	オーディオストリーム。	"AudioStreamList": "[{\"Bitrate\":\"64.533\",\"ChannelLayout\":\"stereo\",\"Channels\":\"2\",\"CodecLongName\":\"AAC (Advanced Audio Coding)\",\"CodecName\":\"aac\",\"CodecTag\":\"0x6134706d\",\"CodecTagString\":\"mp4a\",\"CodecTimeBase\":\"1/44100\",\"Duration\":\"12.615533\",\"Index\":\"1\",\"Lang\":\"und\",\"SampleFmt\":\"fltp\",\"Samplerate\":\"44100\",\"StartTime\":\"-0.046440\",\"Timebase\":\"1/44100\"}]
Width	string	出力ビデオの幅。単位：ピクセル。	640
Fps	string	出力ファイルのフレームレート。単位：フレーム/秒。	25
Duration	string	出力ファイルの長さ。単位：秒。	12
Format	string	出力ファイルのコンテナフォーマット。	m3u8
Filesize	integer	出力ファイルのサイズ。単位：バイト。	851076
WatermarkIdList	array	出力ファイルで使用されるウォーターマークの ID。
	string	出力ファイルで使用されるウォーターマークの ID。	["64079a0e3e286*****b48a8c9413"]

例

成功レスポンス

JSONJSON

{
  "RequestId": "F4C6D5BE-BF13-45*****6C-516EA8906DCD",
  "NonExistJobIds": [
    "[\"hhhhhhh\"]"
  ],
  "TranscodeJobInfoList": [
    {
      "Definition": "LD",
      "CreationTime": "2019-02-26T08:27:16Z",
      "InputFileUrl": "http://outin-40564*****e1403e7.oss-cn-shanghai.aliyuncs.com/customerTrans/5b95e568f8e*****47f38e/31f1184c-*****b2a2-f94-c213f.wmv",
      "ErrorMessage": "ErrorMessage",
      "ErrorCode": "200",
      "CompleteTime": "2019-02-26T08:30:16Z\n",
      "TranscodeProgress": 0,
      "Priority": "6",
      "TranscodeJobStatus": "Transcoding",
      "TranscodeTemplateId": "174b0534fea3*****b51c8f0ad1374",
      "TranscodeJobId": "38f0e513c88*****85515f9d50be188",
      "OutputFile": {
        "VideoStreamList": "[{\\\"AvgFPS\\\":\\\"30.0\\\",\\\"Bitrate\\\":\\\"933.814\\\",\\\"CodecLongName\\\":\\\"H.264 / AVC / MPEG-4 AVC / MPEG-4 part 10\\\",\\\"CodecName\\\":\\\"h264\\\",\\\"CodecTag\\\":\\\"0x31637661\\\",\\\"CodecTagString\\\":\\\"avc1\\\",\\\"CodecTimeBase\\\":\\\"1/60\\\",\\\"Dar\\\":\\\"9:16\\\",\\\"Duration\\\":\\\"12.033333\\\",\\\"Fps\\\":\\\"30.0\\\",\\\"HasBFrames\\\":\\\"2\\\",\\\"Height\\\":\\\"360\\\",\\\"Index\\\":\\\"0\\\",\\\"Lang\\\":\\\"und\\\",\\\"Level\\\":\\\"30\\\",\\\"PixFmt\\\":\\\"yuv420p\\\",\\\"Profile\\\":\\\"High\\\",\\\"Sar\\\":\\\"81:256\\\",\\\"StartTime\\\":\\\"0.000000\\\",\\\"Timebase\\\":\\\"1/15360\\\",\\\"Width\\\":\\\"640\\\"}]",
        "OutputFileUrl": "http://outin-40564*****e1403e7.oss-cn-shanghai.aliyuncs.com/883f5d*****f20aaa352f/c3be4f073*****7d5193ec8-{DestMd5}-od-S00000001-200000.mp4",
        "Encryption": "{\\\"EncryptType\\\":\\\"AliyunVoDEncryption\\\"}",
        "Height": "360",
        "SubtitleStreamList": "[]",
        "Bitrate": "964",
        "AudioStreamList": "\"AudioStreamList\": \"[{\\\"Bitrate\\\":\\\"64.533\\\",\\\"ChannelLayout\\\":\\\"stereo\\\",\\\"Channels\\\":\\\"2\\\",\\\"CodecLongName\\\":\\\"AAC (Advanced Audio Coding)\\\",\\\"CodecName\\\":\\\"aac\\\",\\\"CodecTag\\\":\\\"0x6134706d\\\",\\\"CodecTagString\\\":\\\"mp4a\\\",\\\"CodecTimeBase\\\":\\\"1/44100\\\",\\\"Duration\\\":\\\"12.615533\\\",\\\"Index\\\":\\\"1\\\",\\\"Lang\\\":\\\"und\\\",\\\"SampleFmt\\\":\\\"fltp\\\",\\\"Samplerate\\\":\\\"44100\\\",\\\"StartTime\\\":\\\"-0.046440\\\",\\\"Timebase\\\":\\\"1/44100\\\"}]",
        "Width": "640",
        "Fps": "25",
        "Duration": "12",
        "Format": "m3u8",
        "Filesize": 851076,
        "WatermarkIdList": [
          "[\"64079a0e3e286*****b48a8c9413\"]"
        ]
      }
    }
  ],
  "TranscodeTask": {
    "CreationTime": "2019-01-23T12:35:12Z",
    "Trigger": "Auto ",
    "TaskStatus": "Processing",
    "VideoId": "883f5d98107*****b7f20aaa352f",
    "CompleteTime": "2019-01-23T12:40:12Z",
    "TranscodeTemplateGroupId": "b500c7094bd241*****3e9900752d7c3",
    "TranscodeTaskId": "b1b65ab107e14*****3dbb900f6c1fe0",
    "TranscodeJobInfoList": [
      {
        "Definition": "LD",
        "CreationTime": "2019-02-26T08:27:16Z",
        "InputFileUrl": "http://outin-40564*****e1403e7.oss-cn-shanghai.aliyuncs.com/customerTrans/5b95e568f8e*****47f38e/31f1184c-*****b2a2-f94-c213f.wmv",
        "ErrorMessage": "ErrorMessage",
        "ErrorCode": "200",
        "CompleteTime": "2019-02-26T08:30:16Z",
        "TranscodeProgress": 100,
        "Priority": "6",
        "TranscodeJobStatus": "Transcoding",
        "TranscodeTemplateId": "174b0534fea3*****b51c8f0ad1374",
        "TranscodeJobId": "38f0e513c88*****85515f9d50be188",
        "OutputFile": {
          "VideoStreamList": "[{\\\"AvgFPS\\\":\\\"30.0\\\",\\\"Bitrate\\\":\\\"933.814\\\",\\\"CodecLongName\\\":\\\"H.264 / AVC / MPEG-4 AVC / MPEG-4 part 10\\\",\\\"CodecName\\\":\\\"h264\\\",\\\"CodecTag\\\":\\\"0x31637661\\\",\\\"CodecTagString\\\":\\\"avc1\\\",\\\"CodecTimeBase\\\":\\\"1/60\\\",\\\"Dar\\\":\\\"9:16\\\",\\\"Duration\\\":\\\"12.033333\\\",\\\"Fps\\\":\\\"30.0\\\",\\\"HasBFrames\\\":\\\"2\\\",\\\"Height\\\":\\\"360\\\",\\\"Index\\\":\\\"0\\\",\\\"Lang\\\":\\\"und\\\",\\\"Level\\\":\\\"30\\\",\\\"PixFmt\\\":\\\"yuv420p\\\",\\\"Profile\\\":\\\"High\\\",\\\"Sar\\\":\\\"81:256\\\",\\\"StartTime\\\":\\\"0.000000\\\",\\\"Timebase\\\":\\\"1/15360\\\",\\\"Width\\\":\\\"640\\\"}]",
          "OutputFileUrl": "http://outin-40564*****e1403e7.oss-cn-shanghai.aliyuncs.com/883f5d*****f20aaa352f/c3be4f073*****7d5193ec8-{DestMd5}-od-S00000001-200000.mp4",
          "Encryption": "{\\\"EncryptType\\\":\\\"AliyunVoDEncryption\\\"}",
          "Height": "360",
          "SubtitleStreamList": "[]",
          "Bitrate": "964",
          "AudioStreamList": "\"AudioStreamList\": \"[{\\\"Bitrate\\\":\\\"64.533\\\",\\\"ChannelLayout\\\":\\\"stereo\\\",\\\"Channels\\\":\\\"2\\\",\\\"CodecLongName\\\":\\\"AAC (Advanced Audio Coding)\\\",\\\"CodecName\\\":\\\"aac\\\",\\\"CodecTag\\\":\\\"0x6134706d\\\",\\\"CodecTagString\\\":\\\"mp4a\\\",\\\"CodecTimeBase\\\":\\\"1/44100\\\",\\\"Duration\\\":\\\"12.615533\\\",\\\"Index\\\":\\\"1\\\",\\\"Lang\\\":\\\"und\\\",\\\"SampleFmt\\\":\\\"fltp\\\",\\\"Samplerate\\\":\\\"44100\\\",\\\"StartTime\\\":\\\"-0.046440\\\",\\\"Timebase\\\":\\\"1/44100\\\"}]",
          "Width": "640",
          "Fps": "25",
          "Duration": "12",
          "Format": "m3u8",
          "Filesize": 851076,
          "WatermarkIdList": [
            "[\"64079a0e3e286*****b48a8c9413\"]"
          ]
        }
      }
    ]
  }
}

エラーコード

完全なリストについては、「エラーコード」をご参照ください。

変更履歴

完全なリストについては、「変更履歴」をご参照ください。