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

Obtém arquivos de mídia de áudio e vídeo para upload com base nas URLs dos arquivos de origem. O upload em lote é suportado.

Descrição da operação

Antes de usar esta operação, certifique-se de compreender totalmente os métodos de cobrança e os preços do ApsaraVideo VOD. O upload de arquivos de mídia para o ApsaraVideo VOD gera taxas de armazenamento. Para detalhes sobre a cobrança, consulte Cobrança de armazenamento de ativos de mídia. Se você ativou a aceleração de transferência de armazenamento, o upload de arquivos de mídia para o ApsaraVideo VOD também gera taxas de aceleração de upload. Para detalhes sobre a cobrança, consulte Cobrança de aceleração de transferência de armazenamento.
Para os formatos de arquivo de mídia suportados por esta operação, consulte Formatos de mídia.
Esta operação é aplicável principalmente a cenários em que os arquivos não estão armazenados em um servidor ou terminal local e precisam ser carregados por meio de uma URL com acesso à rede pública.
Esta operação é uma operação de upload assíncrona. Ela não é em tempo real e não garante tempestividade. Geralmente, o upload de migração é concluído em horas ou até dias após o envio do nó. Se você tiver requisitos rigorosos de tempestividade, use o SDK de upload.
Se um callback estiver configurado, você receberá a notificação de evento Upload de vídeo por URL concluído após a conclusão do upload. Você pode chamar a operação GetURLUploadInfos para consultar o status do upload.
Após o envio de um nó de upload, um nó assíncrono é gerado na nuvem para execução. Todos os nós de upload por URL enviados pelos usuários na região de serviço correspondente são colocados em fila para execução. O tempo de conclusão é afetado pelo número de nós existentes. Após a conclusão do upload, você pode associar a URL ao ID do vídeo com base nas informações retornadas na notificação de evento (callback de mensagem).
Atualmente, esta operação suporta apenas as regiões China (Xangai), China (Pequim), China (Shenzhen), Singapura e EUA (Vale do Silício).
Cada vez que você envia um nó de upload para a mesma URL de arquivo de mídia, um novo recurso de mídia é gerado no ApsaraVideo VOD (ou seja, um novo ID de mídia é gerado).
Se um único arquivo exceder 20 GB, o upload falhará. Se você precisar fazer upload de um único arquivo maior que 20 GB, use o SDK de upload. Para mais informações, consulte Visão geral do SDK de upload.

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:UploadMediaByURL

create

*全部资源

*

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
UploadURLs	string	Sim	As URLs dos arquivos de origem de mídia. A URL deve incluir uma extensão de nome de arquivo. Por exemplo, mp4 é a extensão de nome de arquivo em `https://**.mp4`. Se a URL não incluir uma extensão de nome de arquivo, você pode especificar o parâmetro FileExtension em `UploadMetadatas`. Se a URL incluir uma extensão de nome de arquivo e o parâmetro `FileExtension` também for especificado, o valor de `FileExtension` terá precedência. Para extensões de nome de arquivo suportadas, consulte Visão geral do upload. Nota** Separe várias URLs com vírgulas (,). São suportadas no máximo 20 URLs. Para evitar falhas de upload causadas por caracteres especiais, codifique cada URL antes de uni-las com vírgulas.	https://****.mp4
TemplateGroupId	string	Não	O ID do grupo de modelos de transcodificação. Você pode obter o ID usando um dos seguintes métodos: Faça login no console do ApsaraVideo VOD e escolha Gerenciamento de Configuração > Processamento de Mídia > Grupos de Modelos de Transcodificação para visualizar o ID do grupo de modelos de transcodificação. Obtenha o valor de TranscodeTemplateGroupId da resposta ao chamar a operação AddTranscodeTemplateGroup. Obtenha o valor de TranscodeTemplateGroupId da resposta ao chamar a operação ListTranscodeTemplateGroup. Nota Se você não especificar um ID de grupo de modelos de transcodificação, o grupo de modelos de transcodificação padrão será usado. Se você especificar um ID de grupo de modelos de transcodificação, o grupo de modelos especificado será usado. Você também pode definir este parâmetro em `UploadMetadatas`. Se TemplateGroupId estiver definido tanto em UploadMetadatas quanto neste parâmetro, o valor em UploadMetadatas terá precedência.	ca3a8f6e4957b65806709586****
StorageLocation	string	Não	O endereço de armazenamento do arquivo de mídia. Faça login no console do ApsaraVideo VOD e escolha Gerenciamento de Configuração > Gerenciamento de Ativos de Mídia > Armazenamento para visualizar o endereço de armazenamento. Se você não especificar este parâmetro, o endereço de armazenamento padrão será usado.	outin-bfefbb90a47c******163e1c7426.oss-cn-shanghai.aliyuncs.com.
UploadMetadatas	string	Não	Os metadados dos arquivos de mídia a serem carregados. O valor é uma string JSON. Os metadados entram em vigor apenas quando correspondem a uma URL em UploadURLs. Formato JSON: `[UploadMetadata, UploadMetadata,…]`. O valor deve ser convertido em uma string JSON. Para mais informações, consulte a tabela UploadMetadata abaixo.	[{"SourceURL":"https://example.aliyundoc.com/video01.mp4","Title":"urlUploadTest"}]
UserData	string	Não	As configurações personalizadas. O valor é uma string JSON que suporta configurações de callback de mensagem e aceleração de upload. Para mais informações, consulte UserData. Nota Para usar callbacks de mensagem neste parâmetro, você deve configurar uma URL de callback HTTP e selecionar os tipos de evento de callback correspondentes no console. Caso contrário, as configurações de callback não entrarão em vigor. 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"}}
AppId	string	Não	O ID do aplicativo. Valor padrão: app-1000000. Para mais informações, consulte Multiaplicativo.	app-****
WorkflowId	string	Não	O ID do fluxo de trabalho. Faça login no console do ApsaraVideo VOD e escolha Gerenciamento de Configuração > Processamento de Mídia > Fluxos de Trabalho para visualizar o ID do fluxo de trabalho. Nota Se WorkflowId e TemplateGroupId forem especificados, WorkflowId terá precedência. Para instruções de uso, consulte Fluxos de trabalho.	e1e243b42548248197d6f74f9****
SessionId	string	Não	O identificador de deduplicação personalizado. Se este parâmetro for especificado e uma solicitação com o mesmo identificador tiver sido enviada nos últimos 10 minutos, um erro será retornado para a solicitação atual. Nota Este identificador de deduplicação é definido pelo usuário. Pode ter até 50 caracteres e conter letras maiúsculas e minúsculas, dígitos, hifens (-) e sublinhados (_). Se este parâmetro não for especificado ou for definido como uma string vazia, a deduplicação não será realizada.	5c62d40299034bbaa4c195da330****
EnableFirstFrameCover	boolean	Não
GenerateThumbnail	boolean	Não

UploadMetadata

Nome	Tipo	Obrigatório	Descrição
SourceURL	String	Sim	A URL do arquivo de origem de mídia a ser carregado.
Title	String	Não	O título do arquivo de mídia. O título pode ter até 128 bytes de comprimento. A codificação UTF-8 é usada.
FileSize	String	Não	O tamanho do arquivo.
Description	String	Não	A descrição. A descrição pode ter até 1024 bytes de comprimento. A codificação UTF-8 é usada.
CoverURL	String	Não	A URL personalizada da miniatura do vídeo.
CateId	String	Não	O ID da categoria. Faça login no console do ApsaraVideo VOD e escolha Gerenciamento de Configuração > Gerenciamento de Ativos de Mídia > Categorias para visualizar o ID da categoria.
Tags	String	Não	As tags. Cada tag pode ter até 32 bytes de comprimento. São suportadas no máximo 16 tags. Separe várias tags com vírgulas (,). A codificação UTF-8 é usada.
TemplateGroupId	String	Não	O ID do grupo de modelos de transcodificação. Este valor substitui o TemplateGroupId especificado no parâmetro externo.
WorkflowId	String	Não	O ID do fluxo de trabalho. Se WorkflowId e TemplateGroupId forem especificados, WorkflowId terá precedência. Para mais informações, consulte Fluxos de trabalho.
FileExtension	String	Não	A extensão do nome do arquivo de mídia. Para extensões de nome de arquivo suportadas, consulte Visão geral do upload.
ReferenceId	String	Não	O ID personalizado. Apenas letras minúsculas, letras maiúsculas, dígitos, hifens (-) e sublinhados (_) são suportados. O valor deve ter de 6 a 64 caracteres. O valor deve ser exclusivo dentro de uma conta de usuário.

Nota

Os parâmetros em UploadMetadata (como Title, Description e Tags) não podem conter caracteres emoji.
Para garantir a reprodução normal, ao fazer upload de arquivos de vídeo com TemplateGroupId definido como "VOD_NO_TRANSCODE" (sem transcodificação), apenas os seguintes formatos suportam reprodução direta sem transcodificação: MP4, FLV, MP3, M3U8 e WEBM. Outros formatos suportam apenas armazenamento (preste atenção à extensão do nome de arquivo de FileName). Se você usar o Alibaba Cloud Player, a versão deve ser 3.1.0 ou posterior.
Se você especificar um grupo de modelos sem transcodificação (TemplateGroupId definido como "VOD_NO_TRANSCODE"), apenas a notificação de evento upload de vídeo concluído será enviada após o upload do vídeo. A notificação de evento transcodificação de stream único concluída não será enviada.
Se um callback estiver configurado, após a conclusão do upload do vídeo, além das notificações de upload e transcodificação, a notificação de evento upload de vídeo por URL concluído também será enviada.
Ao enviar tarefas em lotes, cada SourceURL possui uma notificação independente.

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****
UploadJobs	array<object>	A lista de trabalhos de upload.
	object	Os detalhes de um trabalho de upload.
SourceURL	string	A URL do arquivo de origem do trabalho de upload.	http://example****.mp4
JobId	string	O ID do trabalho de upload.	ad90a501b1b94fb72374ad005046****

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "25818875-5F78-4AF6-D7393642CA58****",
  "UploadJobs": [
    {
      "SourceURL": "http://example****.mp4",
      "JobId": "ad90a501b1b94fb72374ad005046****"
    }
  ]
}

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.