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

Consulta informações de tarefas, como status da tarefa e políticas de filtragem, para uma tarefa de atualização ou pré-carregamento de vídeo.

Descrição da operação

Notas de uso

Você pode consultar informações de tarefas para todos os arquivos de áudio ou vídeo em uma tarefa de atualização ou pré-carregamento, ou consultar informações de tarefas para um arquivo de áudio ou vídeo específico.

Limite de QPS

O limite de QPS por usuário para esta operação é de 50 chamadas por segundo. Se o limite for excedido, a chamada de API será limitada, o que pode afetar seus negócios. Chame esta operação conforme necessário. Para mais informações, consulte Limite 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:GetMediaRefreshJobs

list

*全部资源

*

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
MediaRefreshJobId	string	Sim	O ID da tarefa de atualização ou pré-carregamento de áudio ou vídeo. Este é o valor de MediaRefreshJobId retornado pela operação SubmitMediaRefreshJob.	41d465e31957****
MediaId	string	Não	O ID do áudio ou vídeo, que é o valor `MediaIds` especificado ao chamar a operação SubmitMediaRefreshJob. Apenas um ID de áudio ou vídeo pode ser especificado. Se este parâmetro não for especificado, as informações da tarefa para todos os arquivos de áudio ou vídeo sob o `MediaRefreshJobId` especificado serão retornadas. Se este parâmetro for especificado, apenas as informações da tarefa para o ID de áudio ou vídeo especificado sob o `MediaRefreshJobId` serão retornadas.	ca3a8f6e4957b658067095869****

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	Os parâmetros de resposta.
RequestId	string	O ID da solicitação.	25818875-5F78-4AF6-D7393642CA58****
MediaRefreshJobs	array<object>	A lista de informações de tarefas de atualização ou pré-carregamento de áudio ou vídeo.
	object	Os detalhes da tarefa de atualização ou pré-carregamento de áudio ou vídeo.
MediaRefreshJobId	string	O ID da tarefa de atualização ou pré-carregamento de áudio ou vídeo.	41d465e31957****
MediaId	string	O ID do áudio ou vídeo.	ca3a8f6e4957b658067095869****
TaskType	string	O tipo de tarefa. Valores válidos: Refresh: atualização Preload: pré-carregamento	Preload.
FilterPolicy	string	A política de filtragem para streams de reprodução. O valor está no formato JSON e contém os parâmetros de solicitação da operação SubmitMediaRefreshJob.	{"Formats":"mp4,m3u8", "Definitions":"HD,SD", " StreamType":"video", "ResultType":"Single", " SliceFlag":false, "SliceCount": 3}
Status	string	O status da tarefa. Valores válidos: success: bem-sucedido fail: falhou	success.
SuccessPlayUrls	string	As URLs de reprodução que foram atualizadas ou pré-carregadas com sucesso.	https://shenzhen.**.aliyuncdn.com/74401a4f546007bf845cd8840.m3u8,https://shenzhen..aliyuncdn.com/24041e7d13582d86604d8**.m3u8
TaskIds	string	Os IDs das tarefas para a atualização ou pré-carregamento das URLs de reprodução. Cada URL corresponde a um ID de tarefa. Você pode usar o ID da tarefa para chamar a operação DescribeVodRefreshTasks para consultar o status de atualização ou pré-carregamento de cada URL de reprodução.	70422**,9524**
ErrorCode	string	O código de erro. Este campo é retornado quando a tarefa de atualização ou pré-carregamento falha ao ser enviada.	PreloadQueueFull.
ErrorMessage	string	A mensagem de erro. Este campo é retornado quando a tarefa de atualização ou pré-carregamento falha ao ser enviada.	Preload queue is full, please try again later!
UserData	string	As informações de UserData especificadas quando a tarefa de atualização ou pré-carregamento foi enviada.	{"MessageCallback":{"CallbackURL":"http://example.aliyundoc.com"}, "Extend":{"localId":"xxx","test":"www"}}
GmtCreate	string	A hora em que a tarefa foi criada.	2022-05-20 08:23:22
GmtModified	string	A hora em que a tarefa foi modificada pela última vez.	2022-05-21 08:23:22

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "25818875-5F78-4AF6-D7393642CA58****",
  "MediaRefreshJobs": [
    {
      "MediaRefreshJobId": "41d465e31957****",
      "MediaId": "ca3a8f6e4957b658067095869****",
      "TaskType": "Preload",
      "FilterPolicy": "{\"Formats\":\"mp4,m3u8\", \"Definitions\":\"HD,SD\",  \" StreamType\":\"video\",  \"ResultType\":\"Single\",  \" SliceFlag\":false, \"SliceCount\": 3}",
      "Status": "success",
      "SuccessPlayUrls": "https://shenzhen.****.aliyuncdn.com/74401a4f546007bf845cd8840****.m3u8,https://shenzhen.****.aliyuncdn.com/24041e7d13582d86604d8****.m3u8",
      "TaskIds": "70422****,9524****",
      "ErrorCode": "PreloadQueueFull",
      "ErrorMessage": "Preload queue is full, please try again later!",
      "UserData": "{\"MessageCallback\":{\"CallbackURL\":\"http://example.aliyundoc.com\"}, \"Extend\":{\"localId\":\"xxx\",\"test\":\"www\"}}",
      "GmtCreate": "2022-05-20 08:23:22",
      "GmtModified": "2022-05-21 08:23:22"
    }
  ]
}

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.