GetTranscodeTask - - Alibaba Cloud Dokümantasyon Merkezi

Kullanım notları

Bu işlemle yalnızca son bir yıl içinde oluşturulan kod dönüştürme görevlerini sorgulayabilirsiniz.

Saniye başına sorgu (QPS) sınırı

Bu işlemi hesap başına saniyede en fazla 15 kez çağırabilirsiniz. Bu sınırı aşan istekler reddedilir ve hizmet kesintileri yaşanır. Bu işlemi çağırırken bu sınıra dikkat etmenizi öneririz. Daha fazla bilgi için bkz. ApsaraVideo VoD'daki API işlemlerinde QPS sınırları.

Hata ayıklama

OpenAPI Explorer, imza değerini otomatik olarak hesaplar. Kolaylık sağlaması açısından bu işlemi OpenAPI Explorer'da çağırmanızı öneririz. OpenAPI Explorer, farklı SDK'lar için işlemin örnek kodunu dinamik olarak oluşturur.

İstek parametreleri

Parametre

Tür

Zorunlu

Örnek

Açıklama

Action

String

Evet

GetTranscodeTask

Gerçekleştirmek istediğiniz işlem. Değeri GetTranscodeTask olarak ayarlayın.

TranscodeTaskId

String

Evet

b1b65ab107e14*****3dbb900f6c1fe0

Kod dönüştürme görevinin kimliği. Kimliği almak için aşağıdaki yöntemlerden birini kullanabilirsiniz:

TranscodeTaskId değerini SubmitTranscodeJobs işlemine verilen yanıttan alın.
TranscodeTaskId değerini ListTranscodeTask işlemine verilen yanıttan alın.

Yanıt parametreleri

Parametre	Tür	Örnek	Açıklama
RequestId	String	F4C6D5BE-BF13-45*****6C-516EA8906DCD	İsteğin kimliği.
TranscodeTask	Object		Kod dönüştürme görevleriyle ilgili ayrıntılar.
CreationTime	String	2019-01-23T12:35:12Z	Kod dönüştürme görevinin oluşturulduğu zaman. Zaman, UTC olarak görüntülenir ve yyyy-MM-ddTHH:mm:ssZ biçimindeki ISO 8601 standardını izler.
Trigger	String	Auto	Kod dönüştürme görevinin tetiklenme modu. Geçerli değerler: Auto: Video yüklendiğinde kod dönüştürme görevi otomatik olarak tetiklenir. Manual: Kod dönüştürme görevi, SubmitTranscodeJobs işlemi çağrılarak tetiklenir.
TaskStatus	String	Processing	Kod dönüştürme görevinin durumu. Geçerli değerler: Processing: Devam ediyor. Partial: Bazı kod dönüştürme işleri tamamlandı. CompleteAllSucc: Tüm kod dönüştürme işleri başarılı oldu. CompleteAllFail: Tüm kod dönüştürme işleri başarısız oldu. Kaynak dosyada bir özel durum oluşursa hiçbir kod dönüştürme işi başlatılmaz ve kod dönüştürme görevi başarısız olur. CompletePartialSucc: Tüm kod dönüştürme işleri tamamlandı ancak yalnızca bazıları başarılı oldu.
VideoId	String	883f5d98107*****b7f20aaa352f	Ses veya video dosyasının kimliği.
CompleteTime	String	2019-01-23T12:40:12Z	Kod dönüştürme görevinin tamamlandığı zaman. Zaman, UTC olarak görüntülenir ve yyyy-MM-ddTHH:mm:ssZ biçimindeki ISO 8601 standardını izler.
TranscodeTemplateGroupId	String	b500c7094bd241*****3e9900752d7c3	Kod dönüştürme şablonu grubunun kimliği.
TranscodeTaskId	String	b1b65ab107e14*****3dbb900f6c1fe0	Kod dönüştürme görevinin kimliği.
TranscodeJobInfoList	Array of TranscodeJobInfo		Kod dönüştürme işleriyle ilgili ayrıntılar.
Definition	String	LD	Video çözünürlüğü. Geçerli değerler: LD: düşük çözünürlük SD: standart çözünürlük HD: yüksek çözünürlük FHD: ultra yüksek çözünürlük OD: orijinal çözünürlük 2K: 2K 4K: 4K SQ: standart ses kalitesi HQ: yüksek ses kalitesi AUTO: uyarlanabilir bit hızı Uyarlanabilir bit hızı akışları yalnızca kod dönüştürme şablonunda PackageSetting ayarlanmışsa döndürülür. Daha fazla bilgi için bkz. Temel yapılar. Not Bu parametre, kod dönüştürme şablonunda yapılandırılan çözünürlüğü belirtir ve çıkış videosunun gerçek çözünürlüğünü belirtmez.
CreationTime	String	2019-02-26T08:27:16Z	Kod dönüştürme işinin oluşturulduğu zaman. Zaman, UTC olarak görüntülenir ve yyyy-MM-ddTHH:mm:ssZ biçimindeki ISO 8601 standardını izler.
InputFileUrl	String	http://outin-40564***e1403e7.oss-cn-shanghai.aliyuncs.com/customerTrans/5b95e568f8e*47f38e/31f1184c-***b2a2-f94-c213f.wmv	Giriş dosyasının Object Storage Service (OSS) URL'si.
ErrorMessage	String	ErrorMessage	Kod dönüştürme işi başarısız olduğunda döndürülen hata mesajı.
ErrorCode	String	200	Kod dönüştürme işi başarısız olduğunda döndürülen hata kodu.
CompleteTime	String	2019-02-26T08:30:16Z	Kod dönüştürme işinin tamamlandığı zaman. Zaman, UTC olarak görüntülenir ve yyyy-MM-ddTHH:mm:ssZ biçimindeki ISO 8601 standardını izler.
TranscodeProgress	Long	100	Kod dönüştürme işinin ilerleme durumu. Geçerli değerler: `[0,100]`.
Priority	String	6	Kod dönüştürme işinin önceliği.
TranscodeJobStatus	String	Transcoding	Kod dönüştürme işinin durumu. Transcoding TranscodeSuccess TranscodeFail
TranscodeTemplateId	String	174b0534fea3*****b51c8f0ad1374	Kod dönüştürme şablonunun kimliği.
TranscodeJobId	String	38f0e513c88*****85515f9d50be188	Kod dönüştürme işinin kimliği.
OutputFile	Object		Çıkış dosyası hakkında bilgiler.
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\"}]	Video akışları.
OutputFileUrl	String	http://outin-40564***e1403e7.oss-cn-shanghai.aliyuncs.com/883f5d*f20aaa352f/c3be4f073***7d5193ec8-{DestMd5}-od-S00000001-200000.mp4	Çıkış dosyasının OSS URL'si.
Encryption	String	{\"EncryptType\":\"AliyunVoDEncryption\"}	Çıkış dosyasının şifreleme yöntemi. Geçerli değerler: AliyunVoDEncryption: Alibaba Cloud'a özgü kriptografi HLSEncryption: HTTP Live Streaming (HLS) şifrelemesi
Height	String	360	Çıkış videosunun yüksekliği. Birim: piksel.
SubtitleStreamList	String	[]	Altyazı akışları.
Bitrate	String	964	Çıkış dosyasının ortalama bit hızı. Birim: Kbit/s.
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\"}]	Ses akışları.
Width	String	640	Çıkış videosunun genişliği. Birim: piksel.
Fps	String	25	Çıkış dosyasının kare hızı. Birim: saniye başına kare.
Duration	String	12	Çıkış dosyasının uzunluğu. Birim: saniye.
Format	String	m3u8	Çıkış dosyasının kapsayıcı biçimi.
FileSize	Long	851076	Çıkış dosyasının boyutu. Birim: bayt.
WatermarkIdList	Array of String	["64079a0e3e286*****b48a8c9413"]	Çıkış dosyasına uygulanan filigranların kimlikleri.

Örnekler

Örnek istekler

https://vod.{ApiRegion}.aliyuncs.com/?Action=GetTranscodeTask
&TranscodeTaskId=b1b65ab107e14*****3dbb900f6c1fe0
&<Common request parameters>

Örnek yanıtlar

XML biçimi

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

<GetTranscodeTaskResponse>
<RequestId>F4C6D5BE-BF13-45*****6C-516EA8906DCD</RequestId>
<TranscodeTask>
    <TranscodeJobInfoList>
        <TranscodeTemplateId>174b0534fea3*****b51c8f0ad1374</TranscodeTemplateId>
        <Priority>6</Priority>
        <InputFileUrl>http://outin-40564*****e1403e7.oss-cn-shanghai.aliyuncs.com/customerTrans/5b95e568f8e*****47f38e/31f1184c-*****b2a2-f94-c213f.wmv</InputFileUrl>
        <Definition>LD</Definition>
        <CreationTime>2019-02-26T08:27:16Z</CreationTime>
        <TranscodeJobStatus>Transcoding</TranscodeJobStatus>
        <TranscodeJobId>38f0e513c88*****85515f9d50be188</TranscodeJobId>
        <ErrorCode>200</ErrorCode>
        <TranscodeProgress>100</TranscodeProgress>
        <ErrorMessage>ErrorMessage</ErrorMessage>
        <CompleteTime>2019-02-26T08:30:16Z</CompleteTime>
    </TranscodeJobInfoList>
    <TranscodeJobInfoList>
        <OutputFile>
            <OutputFileUrl>http://outin-40564*****e1403e7.oss-cn-shanghai.aliyuncs.com/883f5d*****f20aaa352f/c3be4f073*****7d5193ec8-{DestMd5}-od-S00000001-200000.mp4</OutputFileUrl>
            <Fps>25</Fps>
            <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\"}]</VideoStreamList>
            <Duration>12</Duration>
            <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\"}]</AudioStreamList>
            <Encryption>{\"EncryptType\":\"AliyunVoDEncryption\"}</Encryption>
            <Filesize>851076</Filesize>
            <Bitrate>964</Bitrate>
            <WatermarkIdList>["64079a0e3e286*****b48a8c9413"]</WatermarkIdList>
            <Format>m3u8</Format>
            <SubtitleStreamList>[]</SubtitleStreamList>
            <Height>360</Height>
            <Width>640</Width>
        </OutputFile>
    </TranscodeJobInfoList>
    <Trigger>Auto </Trigger>
    <VideoId>883f5d98107*****b7f20aaa352f</VideoId>
    <TranscodeTemplateGroupId>b500c7094bd241*****3e9900752d7c3</TranscodeTemplateGroupId>
    <CreationTime>2019-01-23T12:35:12Z</CreationTime>
    <TaskStatus>Processing</TaskStatus>
    <CompleteTime>2019-01-23T12:40:12Z</CompleteTime>
    <TranscodeTaskId>b1b65ab107e14*****3dbb900f6c1fe0</TranscodeTaskId>
</TranscodeTask>
</GetTranscodeTaskResponse>

JSON biçimi

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

{
  "RequestId" : "F4C6D5BE-BF13-45*****6C-516EA8906DCD",
  "TranscodeTask" : {
    "TranscodeJobInfoList" : [ {
      "TranscodeTemplateId" : "174b0534fea3*****b51c8f0ad1374",
      "Priority" : "6",
      "InputFileUrl" : "http://outin-40564*****e1403e7.oss-cn-shanghai.aliyuncs.com/customerTrans/5b95e568f8e*****47f38e/31f1184c-*****b2a2-f94-c213f.wmv",
      "Definition" : "LD",
      "CreationTime" : "2019-02-26T08:27:16Z",
      "TranscodeJobStatus" : "Transcoding",
      "TranscodeJobId" : "38f0e513c88*****85515f9d50be188",
      "ErrorCode" : "200",
      "TranscodeProgress" : "100",
      "ErrorMessage" : "ErrorMessage",
      "CompleteTime" : "2019-02-26T08:30:16Z"
    }, {
      "OutputFile" : {
        "OutputFileUrl" : "http://outin-40564*****e1403e7.oss-cn-shanghai.aliyuncs.com/883f5d*****f20aaa352f/c3be4f073*****7d5193ec8-{DestMd5}-od-S00000001-200000.mp4",
        "Fps" : "25",
        "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\\\"}]",
        "Duration" : "12",
        "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\\\"}]",
        "Encryption" : "{\\\"EncryptType\\\":\\\"AliyunVoDEncryption\\\"}",
        "Filesize" : "851076",
        "Bitrate" : "964",
        "WatermarkIdList" : "[\"64079a0e3e286*****b48a8c9413\"]",
        "Format" : "m3u8",
        "SubtitleStreamList" : "[]",
        "Height" : "360",
        "Width" : "640"
      }
    } ],
    "Trigger" : "Auto ",
    "VideoId" : "883f5d98107*****b7f20aaa352f",
    "TranscodeTemplateGroupId" : "b500c7094bd241*****3e9900752d7c3",
    "CreationTime" : "2019-01-23T12:35:12Z",
    "TaskStatus" : "Processing",
    "CompleteTime" : "2019-01-23T12:40:12Z",
    "TranscodeTaskId" : "b1b65ab107e14*****3dbb900f6c1fe0"
  }
}

Hata kodları

Hata kodlarının listesi için API Hata Merkezi adresini ziyaret edin.

Yaygın hatalar

Aşağıdaki tabloda, bu işlemin döndürebileceği yaygın hatalar açıklanmaktadır.

Hata kodu	Hata mesajı	HTTP durum kodu	Açıklama
NoSuchResource	The specified resource %s does not exist.	404	Belirtilen bilgiler mevcut olmadığı için döndürülen hata mesajı. %s, belirtilen bilgileri gösterir.