Para fazer upload de arquivos de rede, automatizar uploads ou realizar migrações em lote, chame as APIs do Intelligent Media Services (IMS) para obter uma URL e uma credencial de upload. Em seguida, use as APIs nativas do Object Storage Service (OSS) para concluir o upload.
Pré-requisitos
Conheça os formatos de arquivo compatíveis. Para mais informações, consulte Formatos de arquivo compatíveis.
Ative o Object Storage Service (OSS). Para mais informações, consulte Ativar o OSS.
Informações básicas
Antes de fazer upload de um ativo de mídia com uma API do OSS, obtenha uma URL e uma credencial de upload no IMS. A URL de upload especifica o endereço de armazenamento no OSS, e a credencial autoriza a operação. O IMS emite ambos para garantir a segurança e evitar uploads maliciosos. Ao emitir a URL e a credencial, o IMS também cria automaticamente um ID de ativo de mídia. Use esse ID para gerenciar o ciclo de vida do ativo ou processá-lo com o ApsaraVideo Media Processing.
Observações
O tamanho máximo de um único arquivo de áudio ou vídeo é 5 GB.
As extensões de arquivo não diferenciam maiúsculas de minúsculas durante o upload. Se a extensão não for compatível, o upload falhará porque o formato do arquivo não corresponde à credencial de upload.
Etapa 1: Obter uma URL e uma credencial de upload
Chame a operação CreateUploadMedia para obter a URL e a credencial de upload de um ativo de mídia. Integre o SDK do lado do servidor (recomendado) ou crie sua própria solicitação HTTP(S). Para mais informações, consulte Mecanismo RPC.
Cada URL e credencial de upload serve apenas para um único ativo de mídia. Não as reutilize para vários ativos para evitar a substituição de arquivos.
Se você solicitar uma URL e uma credencial de upload para o mesmo ativo de mídia várias vezes, cada solicitação retornará uma URL e uma credencial diferentes.
O Intelligent Media Services atribui as URLs de upload automaticamente. URLs personalizadas não são suportadas.
A credencial de upload tem validade de 3000 segundos. Para arquivos de vídeo grandes, a credencial pode expirar durante o upload. Nesse caso, chame a operação RefreshUploadMedia para renová-la. A nova credencial também terá validade de 3000 segundos, e a URL de upload permanecerá inalterada.
Para arquivos menores, como imagens e ativos de mídia auxiliares (legendas e fontes), obtenha uma nova credencial se a atual expirar.
Etapa 2: Chamar uma API do OSS para fazer upload do ativo de mídia
Decodifique a URL e a credencial de upload em Base64. Em seguida, chame uma API de upload do OSS para enviar o ativo de mídia. Para mais informações, consulte Cabeçalhos HTTP comuns e Fazer upload de arquivos para o OSS.