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

Consulta os detalhes de trabalhos de transcodificação com base em um ID de tarefa de transcodificação.

Descrição da operação

Notas de uso

Esta operação suporta apenas a consulta de dados de tarefas de transcodificação do último ano.

Limite de QPS

Um único usuário pode realizar no máximo 15 consultas por segundo (QPS). O limitador é acionado se esse limite for excedido, o que pode afetar seus negócios. Para mais informações, consulte Limites de QPS.

Experimente agora

Experimente esta API no OpenAPI Explorer, sem necessidade de assinatura manual. Chamadas bem-sucedidas geram automaticamente código SDK correspondente aos seus parâmetros. Faça o download com segurança de credenciais integrada para uso local.

Testar

Autorização RAM

A tabela abaixo descreve a autorização necessária para chamar esta API. Você pode defini-la em uma política do Resource Access Management (RAM). As colunas da tabela estão detalhadas abaixo:

Ação: As ações que podem ser usadas no elemento Action das instruções de política de permissão do RAM para conceder permissões para executar a operação.
API: A API que você pode chamar para executar a ação.
Nível de acesso: O nível de acesso predefinido concedido para cada API. Valores válidos: create, list, get, update e delete.
Tipo de recurso: O tipo de recurso que suporta autorização para executar a ação. Indica se a ação suporta permissão em nível de recurso. O recurso especificado deve ser compatível com a ação. Caso contrário, a política será ineficaz.
- Para APIs com permissões em nível de recurso, os tipos de recursos obrigatórios são marcados com um asterisco (*). Especifique o Nome de Recurso Alibaba Cloud (ARN) correspondente no elemento Resource da política.
- Para APIs sem permissões em nível de recurso, é exibido como Todos os Recursos. Use um asterisco (*) no elemento Resource da política.
Chave de condição: As chaves de condição definidas pelo serviço. A chave permite controle granular, aplicando-se somente a ações ou a ações associadas a recursos específicos. Além das chaves de condição específicas do serviço, o Alibaba Cloud fornece um conjunto de chaves de condição comuns aplicáveis a todos os serviços compatíveis com RAM.
Ação dependente: As ações dependentes necessárias para executar a ação. Para concluir a ação, o usuário RAM ou a função RAM deve ter permissões para executar todas as ações dependentes.

Ação

Nível de acesso

Tipo de recurso

Chave de condição

Ação dependente

vod:GetTranscodeTask

get

*全部资源

*

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
TranscodeTaskId	string	Não	O ID da tarefa de transcodificação. Você pode obter o ID usando um dos seguintes métodos: Chame a operação SubmitTranscodeJobs para enviar uma tarefa de transcodificação. O valor de TranscodeTaskId na resposta é o ID da tarefa de transcodificação. Chame a operação ListTranscodeTask. O valor de TranscodeTaskId na resposta é o ID da tarefa de transcodificação.	b1b65ab107e14*****3dbb900f6c1fe0
JobIds	string	Não	Os IDs dos trabalhos de transcodificação. Você pode especificar no máximo 10 IDs. Separe vários IDs com vírgulas (,). Você pode obter os IDs usando o seguinte método: Chame a operação SubmitTranscodeJobs para enviar uma tarefa de transcodificação. O valor de JobId na resposta é o ID do trabalho de transcodificação.	86c1925fba0**,7afb201e7fa,2cc4997378**

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object
RequestId	string	O ID da solicitação.	F4C6D5BE-BF13-45*****6C-516EA8906DCD.
NonExistJobIds	array	Os IDs dos trabalhos de transcodificação que não existem.
	string	Os IDs dos trabalhos de transcodificação que não existem.	["hhhhhhh"]
TranscodeJobInfoList	array<object>	As informações do trabalho de transcodificação.
	array<object>	As informações do trabalho de transcodificação.
Definition	string	A definição do vídeo. Valores válidos: LD: fluido. SD: definição padrão. HD: alta definição. FHD: ultra-alta definição. OD: qualidade original. 2K: 2K. 4K: 4K. SQ: qualidade de som padrão. HQ: alta qualidade de som. AUTO: streaming de taxa de bits adaptativa. Esta definição está disponível apenas quando o empacotamento estiver configurado no modelo de transcodificação. Para mais informações, consulte Configuração do modelo de transcodificação - PackageSetting. Nota Este valor é o rótulo de definição configurado no modelo de transcodificação e não indica o intervalo de resolução real do arquivo de saída transcodificado.	LD
CreationTime	string	A hora em que o trabalho de transcodificação foi criado. A hora está no formato aaaa-MM-ddTHH:mm:ssZ (UTC).	2019-02-26T08:27:16Z
InputFileUrl	string	A URL do OSS do arquivo de origem da transcodificação.	http://outin-40564***e1403e7.oss-cn-shanghai.aliyuncs.com/customerTrans/5b95e568f8e*47f38e/31f1184c-***b2a2-f94-c213f.wmv.
ErrorMessage	string	A mensagem de erro retornada quando o trabalho de transcodificação falhou.	ErrorMessage.
ErrorCode	string	O código de erro retornado quando o trabalho de transcodificação falhou.	200
CompleteTime	string	A hora em que o trabalho de transcodificação foi concluído. A hora está no formato aaaa-MM-ddTHH:mm:ssZ (UTC).	2019-02-26T08:30:16Z
TranscodeProgress	integer	O progresso do trabalho de transcodificação. Intervalo de valores: `[0,100]`.	2019-02-26T08:30:16Z
Priority	string	A prioridade da tarefa de transcodificação.	6
TranscodeJobStatus	string	O status do trabalho de transcodificação. Valores válidos: Transcoding: transcodificação em andamento. TranscodeSuccess: transcodificação bem-sucedida. TranscodeFail: falha na transcodificação.	Transcoding.
TranscodeTemplateId	string	O ID do modelo de transcodificação usado para a transcodificação.	174b0534fea3*****b51c8f0ad1374
TranscodeJobId	string	O ID do trabalho de transcodificação.	38f0e513c88*****85515f9d50be188
OutputFile	object	As informações sobre o arquivo de saída da transcodificação.
VideoStreamList	string	A lista de streams de vídeo.	[{\"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\"}]
OutputFileUrl	string	O URL do OSS do arquivo de saída transcodificado.	http://outin-40564***e1403e7.oss-cn-shanghai.aliyuncs.com/883f5d*f20aaa352f/c3be4f073***7d5193ec8-{DestMd5}-od-S00000001-200000.mp4
Encryption	string	A configuração de criptografia usada para o arquivo de saída transcodificado. Valores válidos: AliyunVoDEncryption: Criptografia de vídeo do Alibaba Cloud (criptografia proprietária). HLSEncryption: Criptografia padrão HLS.	{\"EncryptType\":\"AliyunVoDEncryption\"}
Height	string	A altura do quadro de vídeo no arquivo de saída transcodificado. Unidade: pixels (px).	360
SubtitleStreamList	string	A lista de streams de legendas.	[]
Bitrate	string	A taxa de bits média do arquivo de saída transcodificado. Unidade: Kbps.	964
AudioStreamList	string	A lista de streams de áudio.	"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\"}]
Width	string	A largura do quadro de vídeo no arquivo de saída transcodificado. Unidade: pixels (px).	640
Fps	string	A taxa de quadros do arquivo de saída transcodificado. Unidade: quadros por segundo (fps).	25
Duration	string	A duração do arquivo de saída transcodificado. Unidade: segundos (s).	12
Format	string	O formato de contêiner do arquivo de saída transcodificado.	m3u8
Filesize	integer	O tamanho do arquivo de saída transcodificado. Unidade: bytes (B).	851076
WatermarkIdList	array	A lista de marcas d'água usadas para transcodificação.
	string	A lista de marcas d'água usadas para transcodificação.	["64079a0e3e286*****b48a8c9413"]
TranscodeTask	object	As informações da tarefa de transcodificação.
CreationTime	string	A hora em que a tarefa de transcodificação foi criada. A hora está no formato aaaa-MM-ddTHH:mm:ssZ (UTC).	2019-01-23T12:35:12Z
Trigger	string	O tipo de gatilho. Valores válidos: Auto: acionado automaticamente após o upload de um vídeo. Manual: acionado chamando a operação SubmitTranscodeJobs.	Auto.
TaskStatus	string	O status da tarefa de transcodificação. Valores válidos: Processing: processamento em andamento. Partial: parcialmente concluído. CompleteAllSucc: todos os trabalhos de transcodificação foram concluídos e bem-sucedidos. CompleteAllFail: todos os trabalhos de transcodificação foram concluídos, mas falharam. Se o arquivo de origem tiver problemas, nenhum trabalho de transcodificação será iniciado e toda a tarefa de transcodificação falhará. CompletePartialSucc: todos os trabalhos de transcodificação foram concluídos, mas apenas alguns foram bem-sucedidos.	Processing.
VideoId	string	O ID do áudio ou vídeo.	883f5d98107*****b7f20aaa352f.
CompleteTime	string	A hora em que a tarefa de transcodificação foi concluída. A hora está no formato aaaa-MM-ddTHH:mm:ssZ (UTC).	2019-01-23T12:40:12Z
TranscodeTemplateGroupId	string	O ID do grupo de modelos de transcodificação usado para a transcodificação.	b500c7094bd241*****3e9900752d7c3
TranscodeTaskId	string	O ID da tarefa de transcodificação.	b1b65ab107e14*****3dbb900f6c1fe0
TranscodeJobInfoList	array<object>	As informações do trabalho de transcodificação.
	array<object>	As informações do trabalho de transcodificação.
Definition	string	A resolução do vídeo. Valores válidos: LD: Baixa definição. SD: Definição padrão. HD: Alta definição. FHD: Full HD. OD: Definição original. 2K: 2K. 4K: 4K. SQ: Qualidade de áudio padrão. HQ: Alta qualidade de áudio. AUTO: Taxa de bits adaptável. Streams de taxa de bits adaptável são retornados apenas 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 indica a resolução real do vídeo de saída.	LD
CreationTime	string	A hora em que o trabalho de transcodificação foi criado. A hora segue o padrão ISO 8601 no formato yyyy-MM-ddTHH:mm:ssZ. A hora é exibida em UTC.	2019-02-26T08:27:16Z
InputFileUrl	string	A URL do Object Storage Service (OSS) do arquivo de entrada.	http://outin-40564***e1403e7.oss-cn-shanghai.aliyuncs.com/customerTrans/5b95e568f8e*47f38e/31f1184c-***b2a2-f94-c213f.wmv
ErrorMessage	string	A mensagem de erro retornada quando o trabalho de transcodificação falhou.	ErrorMessage
ErrorCode	string	O código de erro retornado quando o trabalho de transcodificação falhou.	200
CompleteTime	string	A hora em que o trabalho de transcodificação foi concluído. A hora segue o padrão ISO 8601 no formato yyyy-MM-ddTHH:mm:ssZ. A hora é exibida em UTC.	2019-02-26T08:30:16Z
TranscodeProgress	integer	O progresso do trabalho de transcodificação. Valores válidos: `[0,100]`.	100
Priority	string	A prioridade do trabalho de transcodificação.	6
TranscodeJobStatus	string	O status do trabalho de transcodificação. Transcoding TranscodeSuccess TranscodeFail	Transcoding
TranscodeTemplateId	string	O ID do modelo de transcodificação.	174b0534fea3*****b51c8f0ad1374
TranscodeJobId	string	O ID do trabalho de transcodificação.	38f0e513c88*****85515f9d50be188
OutputFile	object	As informações sobre o arquivo de saída.
VideoStreamList	string	Os streams de vídeo.	[{\"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\"}]
OutputFileUrl	string	A URL do OSS do arquivo de saída.	http://outin-40564***e1403e7.oss-cn-shanghai.aliyuncs.com/883f5d*f20aaa352f/c3be4f073***7d5193ec8-{DestMd5}-od-S00000001-200000.mp4
Encryption	string	O método de criptografia do arquivo de saída. Valores válidos: AliyunVoDEncryption: Criptografia proprietária do Alibaba Cloud. HLSEncryption: Criptografia HTTP Live Streaming (HLS).	{\"EncryptType\":\"AliyunVoDEncryption\"}
Height	string	A altura do vídeo de saída. Unidade: pixels.	360
SubtitleStreamList	string	Os streams de legendas.	[]
Bitrate	string	A taxa de bits média do arquivo de saída. Unidade: Kbit/s.	964
AudioStreamList	string	Os streams de áudio.	"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\"}]
Width	string	A largura do vídeo de saída. Unidade: pixels.	640
Fps	string	A taxa de quadros do arquivo de saída. Unidade: quadros por segundo.	25
Duration	string	A duração do arquivo de saída. Unidade: segundos.	12
Format	string	O formato de contêiner do arquivo de saída.	m3u8
Filesize	integer	O tamanho do arquivo de saída. Unidade: byte.	851076
WatermarkIdList	array	Os IDs das marcas d'água usadas pelo arquivo de saída.
	string	Os IDs das marcas d'água usadas pelo arquivo de saída.	["64079a0e3e286*****b48a8c9413"]

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "F4C6D5BE-BF13-45*****6C-516EA8906DCD",
  "NonExistJobIds": [
    "[\"hhhhhhh\"]"
  ],
  "TranscodeJobInfoList": [
    {
      "Definition": "LD",
      "CreationTime": "2019-02-26T08:27:16Z",
      "InputFileUrl": "http://outin-40564*****e1403e7.oss-cn-shanghai.aliyuncs.com/customerTrans/5b95e568f8e*****47f38e/31f1184c-*****b2a2-f94-c213f.wmv",
      "ErrorMessage": "ErrorMessage",
      "ErrorCode": "200",
      "CompleteTime": "2019-02-26T08:30:16Z\n",
      "TranscodeProgress": 0,
      "Priority": "6",
      "TranscodeJobStatus": "Transcoding",
      "TranscodeTemplateId": "174b0534fea3*****b51c8f0ad1374",
      "TranscodeJobId": "38f0e513c88*****85515f9d50be188",
      "OutputFile": {
        "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\\\"}]",
        "OutputFileUrl": "http://outin-40564*****e1403e7.oss-cn-shanghai.aliyuncs.com/883f5d*****f20aaa352f/c3be4f073*****7d5193ec8-{DestMd5}-od-S00000001-200000.mp4",
        "Encryption": "{\\\"EncryptType\\\":\\\"AliyunVoDEncryption\\\"}",
        "Height": "360",
        "SubtitleStreamList": "[]",
        "Bitrate": "964",
        "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\\\"}]",
        "Width": "640",
        "Fps": "25",
        "Duration": "12",
        "Format": "m3u8",
        "Filesize": 851076,
        "WatermarkIdList": [
          "[\"64079a0e3e286*****b48a8c9413\"]"
        ]
      }
    }
  ],
  "TranscodeTask": {
    "CreationTime": "2019-01-23T12:35:12Z",
    "Trigger": "Auto ",
    "TaskStatus": "Processing",
    "VideoId": "883f5d98107*****b7f20aaa352f",
    "CompleteTime": "2019-01-23T12:40:12Z",
    "TranscodeTemplateGroupId": "b500c7094bd241*****3e9900752d7c3",
    "TranscodeTaskId": "b1b65ab107e14*****3dbb900f6c1fe0",
    "TranscodeJobInfoList": [
      {
        "Definition": "LD",
        "CreationTime": "2019-02-26T08:27:16Z",
        "InputFileUrl": "http://outin-40564*****e1403e7.oss-cn-shanghai.aliyuncs.com/customerTrans/5b95e568f8e*****47f38e/31f1184c-*****b2a2-f94-c213f.wmv",
        "ErrorMessage": "ErrorMessage",
        "ErrorCode": "200",
        "CompleteTime": "2019-02-26T08:30:16Z",
        "TranscodeProgress": 100,
        "Priority": "6",
        "TranscodeJobStatus": "Transcoding",
        "TranscodeTemplateId": "174b0534fea3*****b51c8f0ad1374",
        "TranscodeJobId": "38f0e513c88*****85515f9d50be188",
        "OutputFile": {
          "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\\\"}]",
          "OutputFileUrl": "http://outin-40564*****e1403e7.oss-cn-shanghai.aliyuncs.com/883f5d*****f20aaa352f/c3be4f073*****7d5193ec8-{DestMd5}-od-S00000001-200000.mp4",
          "Encryption": "{\\\"EncryptType\\\":\\\"AliyunVoDEncryption\\\"}",
          "Height": "360",
          "SubtitleStreamList": "[]",
          "Bitrate": "964",
          "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\\\"}]",
          "Width": "640",
          "Fps": "25",
          "Duration": "12",
          "Format": "m3u8",
          "Filesize": 851076,
          "WatermarkIdList": [
            "[\"64079a0e3e286*****b48a8c9413\"]"
          ]
        }
      }
    ]
  }
}

Códigos de erro

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.