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

Observações de uso

Para consultar detalhes sobre jobs de transcodificação, chame a operação GetTranscodeTask.
Esta operação consulta apenas tarefas de transcodificação criadas no último ano.

Limite de QPS

Você pode chamar esta operação até 15 vezes por segundo por conta. Solicitações que excedem esse limite são descartadas, causando interrupções no serviço. Considere essa restrição 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 chamar esta operação no OpenAPI Explorer. O OpenAPI Explorer 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	ListTranscodeTask	Operação a ser executada. Defina o valor como ListTranscodeTask.
VideoId	String	Sim	d4860fcc6a5*****bce9fed52e893824	ID do arquivo de áudio ou vídeo. Utilize um dos métodos a seguir para obter o ID do arquivo: 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 de áudio ou vídeo. 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. Método aplicável a arquivos já enviados.
StartTime	String	Não	2019-01-23T12:35:12Z	Início do intervalo de tempo a ser consultado. Especifique a hora no padrão ISO 8601, no formato yyyy-MM-ddTHH:mm:ssZ. A hora deve estar em UTC.
EndTime	String	Não	2019-01-23T12:40:12Z	Fim do intervalo de tempo a ser consultado. O horário final deve ser posterior ao inicial. Especifique a hora no padrão ISO 8601, no formato yyyy-MM-ddTHH:mm:ssZ. A hora deve estar em UTC.
PageSize	Integer	Não	10	Número de entradas retornadas por página. Valor máximo: 50. Valor padrão: 10.
PageNo	Integer	Não	1	Número da página a ser retornada. Especifique um número para retornar dados dessa página específica. Valor padrão: 1.

Parâmetros de resposta

Parâmetro	Tipo	Exemplo	Descrição
RequestId	String	25818875-5F78-4A*****F6-D7393642CA58	ID da solicitação.
TranscodeTaskList	Array of TranscodeTask		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 yyyy-MM-ddTHH:mm:ssZ. O horário é exibido em UTC.
Trigger	String	Auto	Modo de acionamento da tarefa de transcodificação. Valores válidos: Auto: A tarefa de transcodificação é acionada automaticamente ao enviar o vídeo. Manual: A tarefa de transcodificação é acionada pela chamada da 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 de transcodificação foram concluídos, mas apenas alguns tiveram sucesso.
VideoId	String	d4860fcc6a5*****bce9fed52e893824	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. O horário é exibido em UTC.
TranscodeTemplateGroupId	String	b500c7094bd24*****f3e9900752d7c3	ID do grupo de modelos de transcodificação.
TranscodeTaskId	String	b1b65ab107*****ba3dbb900f6c1fe0	ID da tarefa de transcodificação.

Exemplos

Exemplos de solicitações

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

Exemplos de respostas

Formato XML

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>

Formato JSON

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

Códigos de erro

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