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

Observações de uso

Um arquivo de mídia pode passar por várias transcodificações. Esta operação retorna apenas o resumo da transcodificação mais recente.
É possível consultar resumos de transcodificação de até 10 arquivos de mídia em uma única solicitação.
Para consultar tarefas históricas de transcodificação, chame a operação ListTranscodeTask.
Esta operação consulta informações apenas de tarefas de transcodificação criadas no último ano.

Limite de QPS

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

Depuração

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

Parâmetros da solicitação

Parameter

Type

Required

Example

Description

Action

String

Yes

GetTranscodeSummary

A operação a ser executada. Defina o valor como GetTranscodeSummary.

VideoIds

String

Yes

"d4860fcc6ae9fed52e8938244****,e1db68cc586644b83e562bcd94****,hhhhhhh"

ID do arquivo de áudio ou vídeo. Especifique até 10 IDs separados por vírgulas (,). Use um dos métodos a seguir para obter o ID:

Faça login no console do ApsaraVideo VOD. No painel de navegação à esquerda, escolha Media Files > Audio/Video. Na página Video and Audio, visualize o ID do arquivo. Este método aplica-se a arquivos enviados pelo console do ApsaraVideo VOD.
Obtenha o valor de VideoId na resposta da operação CreateUploadVideo, usada para obter a URL e a credencial de upload.
Obtenha o valor de VideoId chamando a operação SearchMedia. Este método aplica-se a arquivos já enviados.

Parâmetros de resposta

Parameter	Type	Example	Description
RequestId	String	25818875-5F78-4A*****F6-D7393642CA58	ID da solicitação.
NonExistVideoIds	Array of String	["hhhhhhh"]	IDs dos arquivos de áudio ou vídeo inexistentes.
TranscodeSummaryList	Array of TranscodeSummary		Resumo de transcodificação do arquivo.
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 yyyy-MM-ddTHH:mm:ssZ e é exibido em UTC.
VideoId	String	e1db68cc586644b83e562bcd94****	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 yyyy-MM-ddTHH:mm:ssZ e é exibido em UTC.
TranscodeStatus	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 de transcodificação foram concluídos, mas apenas alguns tiveram sucesso.
TranscodeTemplateGroupId	String	44f9e406bbb*****736a9abe876ecc0	ID do grupo de modelos de transcodificação.
TranscodeJobInfoSummaryList	Array of TranscodeJobInfoSummary		Resumos dos jobs de transcodificação.
CreationTime	String	2019-02-27T03:34:46Z	Horário de criação do job de transcodificação. Segue o padrão ISO 8601 no formato yyyy-MM-ddTHH:mm:ssZ e é exibido em UTC.
ErrorMessage	String	ErrorMessage	Mensagem de erro retornada quando o job de transcodificação falha.
Height	String	960	Altura do vídeo de saída. Unidade: pixels.
TranscodeProgress	Long	100	Progresso da transcodificação. Valores válidos: `[0,100]`.
TranscodeTemplateId	String	57496724ae2*****0968d6e08acc8f6	ID do modelo de transcodificação.
Bitrate	String	749	Taxa de bits média do vídeo de saída. Unidade: Kbit/s.
ErrorCode	String	200	Código de erro retornado quando o job de transcodificação falha.
CompleteTime	String	2019-02-27T03:40:51Z	Horário de conclusão do job de transcodificação. Segue o padrão ISO 8601 no formato yyyy-MM-ddTHH:mm:ssZ e é exibido em UTC.
Width	String	544	Largura do vídeo de saída. Unidade: pixels.
Duration	String	12	Duração do vídeo de saída. Unidade: segundos.
Fps	String	30	Taxa de quadros do vídeo de saída. Unidade: quadros por segundo.
TranscodeJobStatus	String	Transcoding	Status do job de transcodificação. Valores válidos: Transcoding TranscodeSuccess TranscodeFail
FileSize	Long	1.144.259	Tamanho do vídeo de saída. Unidade: bytes.
Format	String	mp4	Formato de contêiner do vídeo de saída.
WatermarkIdList	Array of String	["af2afe4761992c*****d947dae97337"]	IDs das marcas d'água aplicadas ao vídeo de saída.

Exemplos

Exemplos de solicitações

https://vod.{ApiRegion}.aliyuncs.com/?Action=GetTranscodeSummary
&VideoIds="d4860fcc6a*****e9fed52e893824,e1db68cc58664*****4b83e562bcd9,hhhhhhh"
&<Common request parameters>

Exemplos de respostas

Formato XML

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

<GetTranscodeSummaryResponse>
<RequestId>25818875-5F78-4A*****F6-D7393642CA58</RequestId>
	<TranscodeSummaryList>
		<VideoId>e1db68cc58664*****4b83e562bcd9</VideoId>
		<TranscodeStatus>Processing</TranscodeStatus>
		<TranscodeTemplateGroupId>44f9e406bbb*****736a9abe876ecc0</TranscodeTemplateGroupId>
		<CreationTime>2019-01-23T12:35:12Z</CreationTime>
		<CompleteTime>2019-01-23T12:40:12Z</CompleteTime>
		<TranscodeJobInfoSummaryList>
			<Format>mp4</Format>
			<Encryption>{}</Encryption>
			<TranscodeProgress>100</TranscodeProgress>
			<Height>960</Height>
			<CreationTime>2019-02-27T03:34:46Z</CreationTime>
			<CompleteTime>2019-02-27T03:40:51Z</CompleteTime>
			<TranscodeJobStatus>TranscodeSuccess</TranscodeJobStatus>
			<Filesize>1144259</Filesize>
			<WatermarkIdList>af2afe4761992c*****d947dae97337</WatermarkIdList>
			<Duration>12</Duration>
			<TranscodeTemplateId>57496724ae2*****0968d6e08acc8f6</TranscodeTemplateId>
			<Width>544</Width>
			<Fps>30</Fps>
			<Bitrate>749</Bitrate>
			<Definition>LD</Definition>
		</TranscodeJobInfoSummaryList>
		<TranscodeJobInfoSummaryList>
			<Format>m3u8</Format>
			<Encryption>{&quot;EncryptType&quot;:&quot;AliyunVoDEncryption&quot;}</Encryption>
			<TranscodeProgress>100</TranscodeProgress>
			<Height>640</Height>
			<CreationTime>2019-02-27T03:34:46Z</CreationTime>
			<CompleteTime>2019-02-27T03:40:50Z</CompleteTime>
			<TranscodeJobStatus>TranscodeSuccess</TranscodeJobStatus>
			<Filesize>759520</Filesize>
			<Duration>12</Duration>
			<TranscodeTemplateId>4733b3a55b27*****82dae36ac22d34</TranscodeTemplateId>
			<Width>360</Width>
			<Fps>25</Fps>
			<Bitrate>499</Bitrate>
			<Definition>LD</Definition>
		</TranscodeJobInfoSummaryList>
	</TranscodeSummaryList>
	<NonExistVideoIds>hhhhhhh</NonExistVideoIds>
</GetTranscodeSummaryResponse>

Formato JSON

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

{
  "RequestId" : "25818875-5F78-4A*****F6-D7393642CA58",
  "TranscodeSummaryList" : [ {
    "VideoId" : "e1db68cc58664*****4b83e562bcd9",
    "TranscodeStatus" : "Processing",
    "TranscodeTemplateGroupId" : "44f9e406bbb*****736a9abe876ecc0",
    "CreationTime" : "2019-01-23T12:35:12Z",
    "CompleteTime" : "2019-01-23T12:40:12Z",
    "TranscodeJobInfoSummaryList" : [ {
      "Format" : "mp4",
      "Encryption" : "{}",
      "TranscodeProgress" : 100,
      "Height" : "960",
      "CreationTime" : "2019-02-27T03:34:46Z",
      "CompleteTime" : "2019-02-27T03:40:51Z",
      "TranscodeJobStatus" : "TranscodeSuccess",
      "Filesize" : 1144259,
      "WatermarkIdList" : [ "af2afe4761992c*****d947dae97337" ],
      "Duration" : "12",
      "TranscodeTemplateId" : "57496724ae2*****0968d6e08acc8f6",
      "Width" : "544",
      "Fps" : "30",
      "Bitrate" : "749",
      "Definition" : "LD"
    }, {
      "Format" : "m3u8",
      "Encryption" : "{\"EncryptType\":\"AliyunVoDEncryption\"}",
      "TranscodeProgress" : 100,
      "Height" : "640",
      "CreationTime" : "2019-02-27T03:34:46Z",
      "CompleteTime" : "2019-02-27T03:40:50Z",
      "TranscodeJobStatus" : "TranscodeSuccess",
      "Filesize" : 759520,
      "Duration" : "12",
      "TranscodeTemplateId" : "4733b3a55b27*****82dae36ac22d34",
      "Width" : "360",
      "Fps" : "25",
      "Bitrate" : "499",
      "Definition" : "LD"
    } ]
  } ],
  "NonExistVideoIds" : [ "hhhhhhh" ]
}

Códigos de erro

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