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

Envia uma tarefa de atualização ou pré-carregamento para arquivos de áudio ou vídeo por ID de áudio ou vídeo.

Descrição da operação

O ApsaraVideo VOD fornece recursos de limpeza e pré-carregamento de recursos. O recurso de limpeza exclui recursos em cache nos pontos de presença e força os pontos de presença a recuperar os recursos mais recentes do servidor de origem por meio de solicitações back-to-origin. O recurso de pré-carregamento permite baixar e armazenar em cache recursos populares nos pontos de presença antes dos horários de pico para melhorar a eficiência de acesso.
Esta operação envia diretamente um nó de atualização ou pré-carregamento por ID de áudio ou vídeo e suporta filtragem por formato de streaming e definição, o que permite atualizar ou pré-carregar streams específicos conforme necessário.
Você pode enviar um nó de atualização ou pré-carregamento para até 20 arquivos de áudio ou vídeo por vez.

Limite de QPS

O limite de QPS para um único usuário nesta operação é de 50 chamadas por segundo. Se o limite for excedido, a invocação da API será limitada, o que pode afetar seus negócios. Invoque esta operação adequadamente. 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:RefreshMediaPlayUrls

update

*全部资源

*

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
MediaIds	string	Sim	Os IDs dos arquivos de áudio ou vídeo que você deseja atualizar ou pré-carregar. Você pode especificar um ou mais IDs. Separe vários IDs com vírgulas (,). Você pode especificar até 20 IDs. Você pode obter IDs de áudio ou vídeo usando os seguintes métodos: Para arquivos de áudio ou vídeo enviados pelo console, faça login no console do ApsaraVideo VOD e escolha Arquivos de mídia > Áudio/Vídeo para visualizar o ID do áudio ou vídeo. Ao chamar a operação CreateUploadVideo para obter a URL e a credencial de upload, o ID do áudio ou vídeo é o valor do parâmetro de resposta VideoId. Após o upload do arquivo de áudio ou vídeo, você pode chamar a operação SearchMedia para consultar o ID do áudio ou vídeo, que é o valor do parâmetro de resposta VideoId.	ca3a8f6e4957b658067095869**, a6e49sfgd23p5g9ja7095863**
TaskType	string	Sim	O tipo da tarefa. Valores válidos: Refresh: limpeza. Preload: pré-carregamento.	Preload.
Formats	string	Não	Os formatos de streaming que você deseja atualizar ou pré-carregar. Você pode especificar vários formatos. Separe vários formatos com vírgulas (,). Se você não especificar este parâmetro, streams em todos os formatos serão atualizados ou pré-carregados por padrão. Valores válidos: mp4 m3u8 mp3 flv webm ts	mp4,m3u8
Definitions	string	Não	Especifica as definições dos streams que você deseja limpar ou pré-carregar. Você pode especificar várias definições. Separe várias definições com vírgulas (,). Se você não especificar este parâmetro, streams em todas as definições serão limpos ou pré-carregados por padrão. Nota O valor deve ser um dos valores definidos em Definition na Descrição de métricas para ativos de mídia.	HD, SD
StreamType	string	Não	Os tipos de streams que você deseja atualizar ou pré-carregar. Você pode especificar vários tipos de stream. Separe vários tipos de stream com vírgulas (,). Se você não especificar este parâmetro, todos os tipos de stream serão atualizados ou pré-carregados por padrão. Valores válidos: video: vídeo. audio: áudio.	video.
ResultType	string	Não	O tipo de resultado da tarefa de atualização ou pré-carregamento. Valores válidos: Single (padrão): Apenas o stream transcodificado mais recente para cada definição e formato é atualizado ou pré-carregado. Multiple: Todos os streams transcodificados para cada definição e formato são atualizados ou pré-carregados.	Single.
SliceFlag	boolean	Não	Especifica se deve atualizar ou pré-carregar as URLs de reprodução de arquivos TS em streams M3U8. Valores válidos: false (padrão): Não. true: Sim.	false.
SliceCount	integer	Não	O número de URLs de reprodução de arquivos TS a serem atualizadas ou pré-carregadas para streams M3U8. Apenas as primeiras N URLs de reprodução de arquivos TS de cada stream M3U8 são atualizadas ou pré-carregadas. Valores válidos: 1 a 20. Valor padrão: 5.	5
UserData	string	Não	As configurações personalizadas. O valor é uma string JSON que suporta configurações como callbacks de mensagens e aceleração de upload. Para mais informações, consulte UserData. Nota Para usar callbacks de mensagens neste parâmetro, configure uma URL de callback HTTP e selecione os tipos de evento de callback correspondentes no console. Caso contrário, as configurações de callback não terão efeito. Para obter informações sobre como configurar callbacks HTTP no console, consulte Configurações de callback. Para usar o recurso de aceleração de upload, envie um ticket para ativá-lo. Para mais informações, consulte Instruções de upload. Para obter informações sobre como enviar um ticket, consulte Fale conosco.	{"MessageCallback":{"CallbackURL":"http://example.aliyundoc.com"}, "Extend":{"localId":"xxx","test":"www"}}

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	Os parâmetros de resposta.
MediaRefreshJobId	string	O ID da tarefa de atualização ou pré-carregamento.	41d465e31957****
NonExistMediaIds	string	A lista de IDs de áudio ou vídeo que não existem.	ca3a8f6e4957b658067095869****
ForbiddenMediaIds	string	A lista de IDs de áudio ou vídeo que são proibidos. Isso ocorre normalmente porque você não tem permissões de multiaplicação. Para mais informações, consulte Multiaplicação.	a6e49sfgd23p5g9ja7095863****
RequestId	string	O ID da solicitação.	25818875-5F78-4AF6-04D5-D7393642****

Exemplos

Resposta de sucesso

JSON formato

{
  "MediaRefreshJobId": "41d465e31957****",
  "NonExistMediaIds": "ca3a8f6e4957b658067095869****",
  "ForbiddenMediaIds": "a6e49sfgd23p5g9ja7095863****",
  "RequestId": "25818875-5F78-4AF6-04D5-D7393642****"
}

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.