Tüm Ürünler
Search
Belge Merkezi

:ListTranscodeTask

Son Güncelleme:Oct 05, 2026

Medya kimliğine göre kod dönüştürme görevlerini sorgular. Bu işlem, belirli iş bilgilerini döndürmez.

Kullanım notları

  • Kod dönüştürme işleri hakkında ayrıntılı bilgi sorgulamak için GetTranscodeTask işlemini çağırabilirsiniz.

  • 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 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 örnek kodlar dinamik olarak oluşturur.

İstek parametreleri

Parameter Type Required Example Description
Action String Yes ListTranscodeTask

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

VideoId String Yes d4860fcc6a5*****bce9fed52e893824

Ses veya video dosyasının kimliği. Dosya kimliğini elde etmek için aşağıdaki yöntemlerden birini kullanabilirsiniz:

  • ApsaraVideo VOD konsolunda oturum açın. Sol gezinme bölmesinde Media Files > Audio/Video seçeneğini belirleyin. Video ve Ses sayfasında ses veya video dosyasının kimliğini görüntüleyin. Bu yöntem, ApsaraVideo VOD konsolu kullanılarak yüklenen dosyalar için geçerlidir.
  • Yükleme URL'sini ve kimlik bilgisini elde etmek için çağırdığınız CreateUploadVideo işleminin yanıtından VideoId değerini alın.
  • SearchMedia işlemini çağırarak VideoId değerini alın. Bu yöntem, daha önce yüklenmiş olan dosyalar için geçerlidir.
StartTime String No 2019-01-23T12:35:12Z

Sorgulanacak zaman aralığının başlangıcı. Zamanı UTC cinsinden, ISO 8601 standardında yyyy-MM-ddTHH:mm:ssZ biçiminde belirtin.

EndTime String No 2019-01-23T12:40:12Z

Sorgulanacak zaman aralığının bitişi. Bitiş zamanı başlangıç zamanından sonra olmalıdır. Zamanı UTC cinsinden, ISO 8601 standardında yyyy-MM-ddTHH:mm:ssZ biçiminde belirtin.

PageSize Integer No 10

Her sayfada döndürülecek giriş sayısı. Maksimum değer: 50. Varsayılan değer: 10.

PageNo Integer No 1

Döndürülecek sayfanın numarası. Belirtilen sayfadaki verileri döndürmek için bir sayfa numarası belirtebilirsiniz. Varsayılan değer: 1.

Yanıt parametreleri

Parameter Type Example Description
RequestId String 25818875-5F78-4A*****F6-D7393642CA58

İsteğin kimliği.

TranscodeTaskList Array of TranscodeTask

Kod dönüştürme görevlerinin ayrıntıları.

CreationTime String 2019-01-23T12:35:12Z

Kod dönüştürme görevinin oluşturulma zamanı. Zaman, UTC olarak görüntülenir ve ISO 8601 standardında yyyy-MM-ddTHH:mm:ssZ biçimini takip eder.

Trigger String Auto

Kod dönüştürme görevinin tetiklenme modu. Geçerli değerler:

  • Auto: Kod dönüştürme görevi, video yüklendiğinde 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 d4860fcc6a5*****bce9fed52e893824

Ses veya video dosyasının kimliği.

CompleteTime String 2019-01-23T12:40:12Z

Kod dönüştürme görevinin tamamlanma zamanı. Zaman, UTC olarak görüntülenir ve ISO 8601 standardında yyyy-MM-ddTHH:mm:ssZ biçimini takip eder.

TranscodeTemplateGroupId String b500c7094bd24*****f3e9900752d7c3

Kod dönüştürme şablon grubunun kimliği.

TranscodeTaskId String b1b65ab107*****ba3dbb900f6c1fe0

Kod dönüştürme görevinin kimliği.

Örnekler

Örnek istekler

https://vod.{ApiRegion}.aliyuncs.com/?Action=ListTranscodeTask
&VideoId=d4860fcc6a5*****bce9fed52e893824
&<Common request parameters>

Örnek yanıtlar

XML biçimi

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

<ListTranscodeTaskResponse>
    <RequestId>25818875-5F78-4A*****F6-D7393642CA58</RequestId>
	<TranscodeTaskList>
		<TranscodeTaskId>b1b65ab107*****ba3dbb900f6c1fe0</TranscodeTaskId>
		<VideoId>d4860fcc6a5*****bce9fed52e893824</VideoId>
		<TaskStatus>Processing</TaskStatus>
		<TranscodeTemplateGroupId>b500c7094bd24*****f3e9900752d7c3</TranscodeTemplateGroupId>
		<CreationTime>2019-01-23T12:35:12Z</CreationTime>
		<CompleteTime>2019-01-23T12:40:12Z</CompleteTime>
	</TranscodeTaskList>
	<TranscodeTaskList>
		<TranscodeTaskId>91449a74a9d7*****31e179a1ec1e</TranscodeTaskId>
		<VideoId>d4860fcc6a5*****bce9fed52e893824</VideoId>
		<TaskStatus>CompeleteAllSucc</TaskStatus>
		<TranscodeTemplateGroupId>947b9f5b0eb*****3d985df69d76b7</TranscodeTemplateGroupId>
		<CreationTime>2019-01-23T12:35:12Z</CreationTime>
		<CompleteTime>2019-01-23T12:40:12Z</CompleteTime>
	</TranscodeTaskList>
</ListTranscodeTaskResponse>

JSON biçimi

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

{
  "RequestId" : "25818875-5F78-4A*****F6-D7393642CA58",
  "TranscodeTaskList" : [ {
    "TranscodeTaskId" : "b1b65ab107*****ba3dbb900f6c1fe0",
    "VideoId" : "d4860fcc6a5*****bce9fed52e893824",
    "TaskStatus" : "Processing",
    "TranscodeTemplateGroupId" : "b500c7094bd24*****f3e9900752d7c3",
    "CreationTime" : "2019-01-23T12:35:12Z",
    "CompleteTime" : "2019-01-23T12:40:12Z"
  }, {
    "TranscodeTaskId" : "91449a74a9d7*****31e179a1ec1e",
    "VideoId" : "d4860fcc6a5*****bce9fed52e893824",
    "TaskStatus" : "CompeleteAllSucc",
    "TranscodeTemplateGroupId" : "947b9f5b0eb*****3d985df69d76b7",
    "CreationTime" : "2019-01-23T12:35:12Z",
    "CompleteTime" : "2019-01-23T12:40:12Z"
  } ]
}

Hata kodları

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