すべてのプロダクト
Search
ドキュメントセンター

:GetTranscodeTask

最終更新日:Dec 15, 2025

トランスコーディングタスク ID を使用して、トランスコーディングジョブの詳細を照会します。

操作説明

この操作では、過去 1 年以内に作成されたトランスコーディングタスクのみを照会できます。

今すぐお試しください

この 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 を取得できます:

b1b65ab107e14*****3dbb900f6c1fe0

JobIds

string

任意

トランスコーディングジョブの ID。最大 10 個の ID をサポートし、複数の ID はコンマ (,) で区切る必要があります。次の方法でこの値を取得できます:

SubmitTranscodeJobs インターフェイスを介してトランスコーディングタスクを開始する場合、返されるパラメーター JobId の値です。

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

解像度と音質のタイプは次のように定義されます:

  • SD:標準解像度。

  • HD:高解像度。

  • FHD:フル HD。

  • OD:オリジナル解像度。

  • 2K:2K。

  • 4K:4K。

  • SQ:標準音質。

  • HQ:高音質。

  • AUTO:アダプティブビットレート。これは、トランスコーディングテンプレートにパッケージング設定が構成されている場合にのみ利用可能です。詳細については、「トランスコーディングテンプレートの構成 - パッケージ設定」をご参照ください。

説明

この値は、トランスコーディングテンプレートで構成された解像度のラベルを表し、トランスコードされた出力ファイルの実際の解像度範囲を示すものではありません。

LD

CreationTime

string

トランスコーディングジョブの作成時刻。フォーマットは yyyy-MM-dd'T'HH:mm:ssZ (UTC 時間) です。

2019-02-26T08:27:16Z

InputFileUrl

string

トランスコーディング用のソースファイルの OSS アドレス。

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-dd'T'HH:mm:ssZ (UTC 時間) です。

2019-02-26T08:30:16Z

TranscodeProgress

integer

トランスコーディングジョブの処理進捗。値の範囲は [0, 100] です。

80

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

トランスコーディングタスクが作成された時刻。時刻は ISO 8601 規格に準拠し、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

トランスコーディングタスクが完了した時刻。時刻は ISO 8601 規格に準拠し、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": 80,
      "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\"]"
          ]
        }
      }
    ]
  }
}

エラーコード

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

変更履歴

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