GetTranscodeTask - : Central de Documentação do Alibaba Cloud

Observações de uso

Esta operação consulta apenas tarefas de transcodificação criadas no último ano.

Limite de QPS

O limite é de 15 chamadas por segundo por conta. O sistema descarta solicitações que excedam esse limite, o que pode causar interrupções no serviço. Considere essa restrição ao chamar esta operação. Para mais informações, consulte Limites de QPS em operações de API no ApsaraVideo VoD.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Recomendamos chamar esta operação no OpenAPI Explorer para maior conveniência. A ferramenta gera dinamicamente códigos de exemplo da operação para diferentes SDKs.

Parâmetros da solicitação

Parâmetro

Tipo

Obrigatório

Exemplo

Descrição

Action

String

Sim

GetTranscodeTask

Operação a executar. Defina o valor como GetTranscodeTask.

TranscodeTaskId

String

Sim

b1b65ab107e14*****3dbb900f6c1fe0

ID da tarefa de transcodificação. Obtenha esse ID por um dos métodos abaixo:

Obtenha o valor de TranscodeTaskId na resposta da operação SubmitTranscodeJobs.
Obtenha o valor de TranscodeTaskId na resposta da operação ListTranscodeTask.

Parâmetros de resposta

Parâmetro	Tipo	Exemplo	Descrição
RequestId	String	F4C6D5BE-BF13-45*****6C-516EA8906DCD	ID da solicitação.
TranscodeTask	Object		Detalhes das tarefas de transcodificação.
CreationTime	String	2019-01-23T12:35:12Z	Horário de criação da tarefa de transcodificação. Segue o padrão ISO 8601 no formato aaaa-MM-ddTHH:mm:ssZ e é exibido em UTC.
Trigger	String	Auto	Modo de acionamento da tarefa de transcodificação. Valores válidos: Auto: a tarefa é acionada automaticamente ao carregar o vídeo. Manual: a tarefa é acionada mediante chamada à operação SubmitTranscodeJobs.
TaskStatus	String	Processing	Status da tarefa de transcodificação. Valores válidos: Processing: em andamento. Partial: alguns jobs de transcodificação foram concluídos. CompleteAllSucc: todos os jobs de transcodificação foram bem-sucedidos. CompleteAllFail: todos os jobs de transcodificação falharam. Se ocorrer uma exceção no arquivo source, nenhum job será iniciado e a tarefa falhará. CompletePartialSucc: todos os jobs foram concluídos, mas apenas parte deles teve sucesso.
VideoId	String	883f5d98107*****b7f20aaa352f	ID do arquivo de áudio ou vídeo.
CompleteTime	String	2019-01-23T12:40:12Z	Horário de conclusão da tarefa de transcodificação. Segue o padrão ISO 8601 no formato aaaa-MM-ddTHH:mm:ssZ e é exibido em UTC.
TranscodeTemplateGroupId	String	b500c7094bd241*****3e9900752d7c3	ID do grupo de modelos de transcodificação.
TranscodeTaskId	String	b1b65ab107e14*****3dbb900f6c1fe0	ID da tarefa de transcodificação.
TranscodeJobInfoList	Array of TranscodeJobInfo		Detalhes dos jobs de transcodificação.
Definition	String	LD	Resolução do vídeo. Valores válidos: LD: baixa definição SD: definição padrão HD: alta definição FHD: ultra-alta definição OD: definição original 2K: 2K 4K: 4K SQ: qualidade de som padrão HQ: alta qualidade de som AUTO: taxa de bits adaptativa. Os fluxos de taxa de bits adaptativa são retornados somente se PackageSetting estiver definido no modelo de transcodificação. Para mais informações, consulte Estruturas básicas. Nota Este parâmetro indica a definição configurada no modelo de transcodificação e não reflete necessariamente a resolução real do vídeo de saída.
CreationTime	String	2019-02-26T08:27:16Z	Horário de criação do job de transcodificação. Segue o padrão ISO 8601 no formato aaaa-MM-ddTHH:mm:ssZ e é exibido em UTC.
InputFileUrl	String	http://outin-40564***e1403e7.oss-cn-shanghai.aliyuncs.com/customerTrans/5b95e568f8e*47f38e/31f1184c-***b2a2-f94-c213f.wmv	URL do Object Storage Service (OSS) do arquivo de entrada.
ErrorMessage	String	ErrorMessage	Mensagem de erro retornada quando o job de transcodificação falha.
ErrorCode	String	200	Código de erro retornado quando o job de transcodificação falha.
CompleteTime	String	2019-02-26T08:30:16Z	Horário de conclusão do job de transcodificação. Segue o padrão ISO 8601 no formato aaaa-MM-ddTHH:mm:ssZ e é exibido em UTC.
TranscodeProgress	Long	100	Progresso do job de transcodificação. Valores válidos: `[0,100]`.
Priority	String	6	Prioridade do job de transcodificação.
TranscodeJobStatus	String	Transcoding	Status do job de transcodificação. Transcoding TranscodeSuccess TranscodeFail
TranscodeTemplateId	String	174b0534fea3*****b51c8f0ad1374	ID do modelo de transcodificação.
TranscodeJobId	String	38f0e513c88*****85515f9d50be188	ID do job de transcodificação.
OutputFile	Object		Informações sobre o arquivo de saída.
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\"}]	Fluxos de vídeo.
OutputFileUrl	String	http://outin-40564***e1403e7.oss-cn-shanghai.aliyuncs.com/883f5d*f20aaa352f/c3be4f073***7d5193ec8-{DestMd5}-od-S00000001-200000.mp4	URL do OSS do arquivo de saída.
Encryption	String	{\"EncryptType\":\"AliyunVoDEncryption\"}	Método de criptografia do arquivo de saída. Valores válidos: AliyunVoDEncryption: criptografia proprietária da Alibaba Cloud HLSEncryption: criptografia HTTP Live Streaming (HLS)
Height	String	360	Altura do vídeo de saída. Unidade: pixels.
SubtitleStreamList	String	[]	Fluxos de legendas.
Bitrate	String	964	Taxa de bits média do arquivo de saída. Unidade: 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\"}]	Fluxos de áudio.
Width	String	640	Largura do vídeo de saída. Unidade: pixels.
Fps	String	25	Taxa de quadros do arquivo de saída. Unidade: quadros por segundo.
Duration	String	12	Duração do arquivo de saída. Unidade: segundos.
Format	String	m3u8	Formato de contêiner do arquivo de saída.
FileSize	Long	851076	Tamanho do arquivo de saída. Unidade: bytes.
WatermarkIdList	Array of String	["64079a0e3e286*****b48a8c9413"]	IDs das marcas d'água aplicadas ao arquivo de saída.

Exemplos

Exemplos de solicitações

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

Exemplos de respostas

Formato XML

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>

Formato JSON

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

Códigos de erro

Para obter uma lista de códigos de erro, visite a Central de Erros de API.

Erros comuns

A tabela a seguir descreve os erros comuns retornados por esta operação.

Código de erro	Mensagem de erro	Código de status HTTP	Descrição
NoSuchResource	The specified resource %s does not exist.	404	Mensagem de erro retornada porque as informações especificadas não existem. %s representa as informações especificadas.