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

Obtém a URL e a credencial de upload para um arquivo de áudio ou vídeo e cria as informações de mídia. O ApsaraVideo VOD emite a URL e a credencial de upload para garantir autorização e segurança, evitar uploads maliciosos e criar automaticamente um ID de mídia (MediaId), também conhecido como ID de vídeo (VideoId), para gerenciamento. Você pode invocar esta operação para obter a URL e a credencial de upload necessárias e criar as informações de áudio e vídeo.

Descrição da operação

Antes de chamar esta operação, certifique-se de compreender totalmente os métodos de cobrança e os preços do ApsaraVideo VOD. O upload de ativos de mídia para o ApsaraVideo VOD incorre em taxas de armazenamento. Para mais informações sobre cobrança, consulte Cobrança de armazenamento de ativos de mídia. Se você ativou a aceleração de armazenamento e transmissão, o upload de ativos de mídia para o ApsaraVideo VOD também incorre em taxas de aceleração de upload. Para mais informações sobre cobrança, consulte Cobrança de aceleração de armazenamento e transmissão. As taxas de armazenamento são calculadas a partir do momento em que o arquivo é carregado. As taxas de aceleração são calculadas quando você faz o upload de arquivos após ativar o recurso. Chamar apenas esta operação não incorre em taxas.
Obter a URL e a credencial de upload é a base fundamental do ApsaraVideo VOD e uma etapa obrigatória para cada operação de upload. O ApsaraVideo VOD fornece vários métodos de upload, cada um com requisitos diferentes para obter a URL e a credencial de upload. Para mais informações, consulte URLs e credenciais de upload.
Esta operação é usada apenas para obter a URL e a credencial de upload e criar informações básicas de ativos de mídia. Ela não faz o upload de arquivos. Para um exemplo completo de upload de arquivos chamando operações de API, consulte Fazer upload de arquivos de ativos de mídia usando a API do ApsaraVideo VOD.
Esta operação suporta a obtenção da URL e da credencial de upload para arquivos de vídeo e áudio. Para mais informações, consulte URLs e credenciais de upload.
Se a credencial de upload de vídeo expirar (o período de validade padrão é de 3.000 segundos), chame a operação RefreshUploadVideo para obter uma nova credencial de upload.
Após o upload, você pode configurar um callback para receber notificações de eventos de upload ou chamar a operação GetMezzanineInfo para verificar o status do arquivo na resposta e determinar se o upload foi bem-sucedido.
O parâmetro VideoId retornado por esta operação pode ser usado para gerenciamento do ciclo de vida de ativos de mídia ou processamento de mídia.

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

create

*Todos os recursos.

*

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
CoverURL	string	Não	A URL da miniatura de vídeo personalizada.	https://example.aliyundoc.com/image/D22F553TEST****.jpeg
Description	string	Não	A descrição do arquivo de áudio ou vídeo exibida no ApsaraVideo VOD após a conclusão do upload. A descrição pode ter até 1.024 caracteres. A descrição deve ser codificada em UTF-8.	UploadTest
FileName	string	Sim	O nome do arquivo de origem de áudio ou vídeo a ser carregado. O nome do arquivo deve conter uma extensão. A extensão não diferencia maiúsculas de minúsculas. Para extensões suportadas, consulte Visão geral do upload.	D:\video_01.mp4
FileSize	integer	Não	O tamanho do arquivo de origem de áudio ou vídeo a ser carregado. Unidade: bytes.	123
Title	string	Sim	O título do arquivo de áudio ou vídeo exibido no ApsaraVideo VOD após a conclusão do upload. O título pode ter até 128 caracteres. O título deve ser codificado em UTF-8.	UploadTest
CateId	integer	Não	O ID da categoria. Você pode obter o ID da categoria usando um dos seguintes métodos: Faça login no console do ApsaraVideo VOD. No painel de navegação à esquerda, escolha Gerenciamento de Configuração > Configuração de Gerenciamento de Ativos de Mídia > Gerenciamento de Categorias para visualizar o ID da categoria. Ao criar uma categoria chamando a operação AddCategory, o ID da categoria é o valor do parâmetro CateId na resposta. Ao consultar categorias chamando a operação GetCategories, o ID da categoria é o valor do parâmetro CateId na resposta.	100036****
Tags	string	Não	As tags do arquivo de áudio ou vídeo. Você pode especificar até 16 tags. Separe várias tags com vírgulas (,). Cada tag pode ter até 32 caracteres. As tags devem ser codificadas em UTF-8.	tag1,tag2
UserData	string	Não	As configurações personalizadas. O valor é uma string JSON que suporta configurações como callback de mensagens e aceleração de upload. Para mais informações, consulte UserData. Nota Para usar o recurso de callback de mensagens, você deve configurar uma URL de callback HTTP e selecionar os tipos de eventos de callback correspondentes no console. Caso contrário, as configurações de callback não terão efeito. Se nenhuma URL de callback for especificada para tarefas subsequentes, as notificações serão enviadas para esta URL por padrão. Para mais informações sobre como configurar callbacks HTTP no console, consulte Configurações de callback. Para usar o recurso de aceleração de upload, você deve enviar uma solicitação para ativá-lo. Para mais informações, consulte Instruções de upload.	{"MessageCallback":{"CallbackURL":"http://example.aliyundoc.com"},"Extend":{"localId":"*****","test":"www"}}
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. No painel de navegação à esquerda, escolha Gerenciamento de Configuração > Configuração de Processamento de Mídia > Grupos de Modelos de Transcodificação para visualizar o ID do grupo de modelos de transcodificação. Ao criar um grupo de modelos de transcodificação chamando a operação Criar um grupo de modelos de transcodificação, o ID é o valor do parâmetro TranscodeTemplateGroupId na resposta. Ao consultar grupos de modelos de transcodificação chamando a operação Consultar lista de configuração de transcodificação, o ID é o valor do parâmetro TranscodeTemplateGroupId na resposta. Nota Se WorkflowId e TemplateGroupId forem especificados, o WorkflowId terá precedência. Se você não especificar este parâmetro, o grupo de modelos de transcodificação padrão será usado. Se você especificar este parâmetro, o grupo de modelos de transcodificação especificado será usado. Se você definir este parâmetro para o grupo de modelos integrado Sem Transcodificação, apenas a notificação de evento de conclusão de upload de vídeo será gerada após o upload do arquivo de áudio ou vídeo. A notificação de evento de conclusão de transcodificação de definição única não será gerada. A tarefa acionada por este parâmetro é uma tarefa assíncrona. Após a tarefa ser enviada, ela é enfileirada e executada de forma assíncrona em segundo plano. Para garantir a reprodução normal, se você definir este parâmetro para o grupo de modelos integrado Sem Transcodificação, apenas os seguintes formatos suportam reprodução direta sem transcodificação após o upload do arquivo de áudio ou vídeo: MP4, FLV, MP3, M3U8 e WEBM. Outros formatos são suportados apenas para armazenamento (preste atenção à extensão do FileName). Se você usar o ApsaraVideo Player para reprodução, a versão deve ser 3.1.0 ou posterior.	405477f9e214d19ea2c7c854****
WorkflowId	string	Não	O ID do fluxo de trabalho. Você pode fazer login no console do ApsaraVideo VOD e escolher Gerenciamento de Configuração > Configuração de Processamento de Mídia > Fluxos de Trabalho para visualizar o ID do fluxo de trabalho. Nota Se WorkflowId e TemplateGroupId forem especificados, o WorkflowId terá precedência. Para mais informações, consulte Fluxos de trabalho. A tarefa acionada por este parâmetro é uma tarefa assíncrona. Após a tarefa ser enviada, ela é enfileirada e executada de forma assíncrona em segundo plano.	613efff3887ec34af685714cc461****
StorageLocation	string	Não	O endereço de armazenamento. Você pode obter o endereço de armazenamento usando o seguinte método: Faça login no console do ApsaraVideo VOD e escolha Gerenciamento de Configuração > Configuração de Gerenciamento de Ativos de Mídia > Gerenciamento de Armazenamento para visualizar o endereço de armazenamento. Nota Se você não especificar este parâmetro, o arquivo de áudio ou vídeo será carregado no endereço de armazenamento padrão. Se nenhum endereço de armazenamento padrão estiver configurado, o arquivo será carregado no primeiro endereço de armazenamento na lista de armazenamento. Se você especificar este parâmetro, o arquivo de áudio ou vídeo será carregado no endereço de armazenamento especificado.	out-****.oss-cn-shanghai.aliyuncs.com
AppId	string	Não	O ID do aplicativo. Valor padrão: app-1000000. Para mais informações, consulte Multiaplicativo.	app-1000000
ReferenceId	string	Não	O ID personalizado. O ID pode ter de 6 a 64 caracteres e pode conter apenas letras minúsculas, letras maiúsculas, dígitos, hifens (-) e sublinhados (_). O ID deve ser exclusivo dentro da dimensão do usuário.	123-123
EnableFirstFrameCover	boolean	Não	Especifica se o primeiro quadro do vídeo deve ser usado como miniatura.
GenerateThumbnail	boolean	Não	Especifica se uma miniatura deve ser gerada para o vídeo.

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	A resposta.
RequestId	string	O ID da solicitação.	25818875-5F78-4AF6-04D5-D7393642****
UploadAddress	string	A URL de upload. Nota A URL de upload retornada pela operação é codificada em Base64. Ao chamar um SDK ou uma operação de API para fazer o upload do ativo de mídia, você deve decodificar a URL antes de usá-la. Você só precisa analisar o UploadAddress quando usar o SDK nativo do OSS ou a API do OSS para o upload.	eyJTZWN1cml0a2VuIjoiQ0FJU3p3TjF****
VideoId	string	O ID de áudio ou vídeo. Você pode usar este ID como um parâmetro de solicitação para operações de gerenciamento de ativos de mídia, processamento de mídia e revisão de mídia.	93ab850b4f6f54b6e91d24d81d44****
UploadAuth	string	A credencial de upload. Nota A credencial de upload retornada pela operação é codificada em Base64. Ao chamar um SDK ou uma operação de API para fazer o upload do ativo de mídia, você deve decodificar a credencial antes de usá-la. Você só precisa analisar o UploadAuth quando usar o SDK nativo do OSS ou a API do OSS para o upload.	eyJFbmRwb2ludCI6Imm****

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "25818875-5F78-4AF6-04D5-D7393642****",
  "UploadAddress": "eyJTZWN1cml0a2VuIjoiQ0FJU3p3TjF****",
  "VideoId": "93ab850b4f6f54b6e91d24d81d44****",
  "UploadAuth": "eyJFbmRwb2ludCI6Imm****"
}

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.