GetTranscodeTask - - Centre de documentation Alibaba Cloud

Notes d'utilisation

Cette opération permet d'interroger uniquement les tâches de transcodage créées au cours de l'année écoulée.

Limite QPS

Vous pouvez appeler cette opération jusqu'à 15 fois par seconde et par compte. Les requêtes dépassant cette limite sont rejetées, ce qui entraîne des interruptions de service. Tenez compte de cette limite lors de l'appel à cette opération. Pour plus d'informations, consultez la section Limites QPS sur les opérations API dans ApsaraVideo VoD.

Débogage

OpenAPI Explorer calcule automatiquement la valeur de signature. Par souci de commodité, nous vous recommandons d'appeler cette opération dans OpenAPI Explorer. OpenAPI Explorer génère dynamiquement l'exemple de code de l'opération pour différents SDK.

Paramètres de requête

Parameter

Type

Required

Example

Description

Action

String

Yes

GetTranscodeTask

L'opération à effectuer. Définissez la valeur sur GetTranscodeTask.

TranscodeTaskId

String

Yes

b1b65ab107e14*****3dbb900f6c1fe0

L'ID de la tâche de transcodage. Vous pouvez obtenir cet ID de l'une des manières suivantes :

Récupérez la valeur de TranscodeTaskId dans la réponse de l'opération SubmitTranscodeJobs.
Récupérez la valeur de TranscodeTaskId dans la réponse de l'opération ListTranscodeTask.

Paramètres de réponse

Parameter	Type	Example	Description
RequestId	String	F4C6D5BE-BF13-45*****6C-516EA8906DCD	L'ID de la requête.
TranscodeTask	Object		Détails sur les tâches de transcodage.
CreationTime	String	2019-01-23T12:35:12Z	L'heure de création de la tâche de transcodage. L'heure suit la norme ISO 8601 au format yyyy-MM-ddTHH:mm:ssZ. L'heure est affichée en UTC.
Trigger	String	Auto	Le mode de déclenchement de la tâche de transcodage. Valeurs valides : Auto : La tâche de transcodage est déclenchée automatiquement lors du chargement de la vidéo. Manual : La tâche de transcodage est déclenchée par l'appel à l'opération SubmitTranscodeJobs.
TaskStatus	String	Processing	L'état de la tâche de transcodage. Valeurs valides : Processing : En cours. Partial : Certaines tâches de transcodage sont terminées. CompleteAllSucc : Toutes les tâches de transcodage ont réussi. CompleteAllFail : Toutes les tâches de transcodage ont échoué. Si une exception se produit dans le fichier source, aucune tâche de transcodage n'est lancée et la tâche de transcodage échoue. CompletePartialSucc : Toutes les tâches de transcodage sont terminées, mais seules certaines ont réussi.
VideoId	String	883f5d98107*****b7f20aaa352f	L'ID du fichier audio ou vidéo.
CompleteTime	String	2019-01-23T12:40:12Z	L'heure de fin de la tâche de transcodage. L'heure suit la norme ISO 8601 au format yyyy-MM-ddTHH:mm:ssZ. L'heure est affichée en UTC.
TranscodeTemplateGroupId	String	b500c7094bd241*****3e9900752d7c3	L'ID du groupe de modèles de transcodage.
TranscodeTaskId	String	b1b65ab107e14*****3dbb900f6c1fe0	L'ID de la tâche de transcodage.
TranscodeJobInfoList	Array of TranscodeJobInfo		Détails sur les tâches de transcodage.
Definition	String	LD	La résolution vidéo. Valeurs valides : LD : basse définition SD : définition standard HD : haute définition FHD : ultra haute définition OD : définition originale 2K : 2K 4K : 4K SQ : qualité sonore standard HQ : haute qualité sonore AUTO : débit adaptatif. Les flux à débit adaptatif sont renvoyés uniquement si PackageSetting est défini dans le modèle de transcodage. Pour plus d'informations, consultez Structures de base. Remarque Ce paramètre indique la définition configurée dans le modèle de transcodage et non la résolution réelle de la vidéo de sortie.
CreationTime	String	2019-02-26T08:27:16Z	L'heure de création de la tâche de transcodage. L'heure suit la norme ISO 8601 au format yyyy-MM-ddTHH:mm:ssZ. L'heure est affichée en UTC.
InputFileUrl	String	http://outin-40564***e1403e7.oss-cn-shanghai.aliyuncs.com/customerTrans/5b95e568f8e*47f38e/31f1184c-***b2a2-f94-c213f.wmv	L'URL OSS (Object Storage Service) du fichier d'entrée.
ErrorMessage	String	ErrorMessage	Le message d'erreur renvoyé en cas d'échec de la tâche de transcodage.
ErrorCode	String	200	Le code d'erreur renvoyé en cas d'échec de la tâche de transcodage.
CompleteTime	String	2019-02-26T08:30:16Z	L'heure de fin de la tâche de transcodage. L'heure suit la norme ISO 8601 au format yyyy-MM-ddTHH:mm:ssZ. L'heure est affichée en UTC.
TranscodeProgress	Long	100	La progression de la tâche de transcodage. Valeurs valides : `[0,100]`.
Priority	String	6	La priorité de la tâche de transcodage.
TranscodeJobStatus	String	Transcoding	L'état de la tâche de transcodage. Transcoding TranscodeSuccess TranscodeFail
TranscodeTemplateId	String	174b0534fea3*****b51c8f0ad1374	L'ID du modèle de transcodage.
TranscodeJobId	String	38f0e513c88*****85515f9d50be188	L'ID de la tâche de transcodage.
OutputFile	Object		Informations relatives au fichier de sortie.
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\"}]	Les flux vidéo.
OutputFileUrl	String	http://outin-40564***e1403e7.oss-cn-shanghai.aliyuncs.com/883f5d*f20aaa352f/c3be4f073***7d5193ec8-{DestMd5}-od-S00000001-200000.mp4	L'URL OSS du fichier de sortie.
Encryption	String	{\"EncryptType\":\"AliyunVoDEncryption\"}	La méthode de chiffrement du fichier de sortie. Valeurs valides : AliyunVoDEncryption : cryptographie propriétaire Alibaba Cloud HLSEncryption : chiffrement HTTP Live Streaming (HLS)
Height	String	360	La hauteur de la vidéo de sortie. Unité : pixels.
SubtitleStreamList	String	[]	Les flux de sous-titres.
Bitrate	String	964	Le débit moyen du fichier de sortie. Unité : 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\"}]	Les flux audio.
Width	String	640	La largeur de la vidéo de sortie. Unité : pixels.
Fps	String	25	La fréquence d'images du fichier de sortie. Unité : images par seconde.
Duration	String	12	La durée du fichier de sortie. Unité : secondes.
Format	String	m3u8	Le format de conteneur du fichier de sortie.
FileSize	Long	851076	La taille du fichier de sortie. Unité : octets.
WatermarkIdList	Array of String	["64079a0e3e286*****b48a8c9413"]	Les ID des filigranes appliqués au fichier de sortie.

Exemples

Exemples de requêtes

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

Exemples de réponses

XML format

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 format

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"
  }
}

Codes d'erreur

Pour obtenir la liste des codes d'erreur, consultez le Centre d'erreurs API.

Erreurs courantes

Le tableau suivant décrit les erreurs courantes que cette opération peut renvoyer.

Error code	Error message	HTTP status code	Description
NoSuchResource	The specified resource %s does not exist.	404	L'erreur renvoyée car les informations spécifiées n'existent pas. %s indique les informations spécifiées.