CreateUploadMedia - Intelligent Media Services: Central de Documentação do Alibaba Cloud

Descrição da operação

Obter a URL de upload e a credencial é uma base fundamental do Intelligent Media Services e um procedimento obrigatório para cada operação de upload.
Se a credencial de upload de vídeo expirar (o período de validade padrão é de 3000 segundos), invoque a operação de atualização de credencial de upload de vídeo para obter uma nova credencial de upload.
Após o upload, você pode configurar callbacks para receber notificações de eventos de upload ou invocar a operação GetMediaInfo para verificar o status do ativo de mídia retornado e determinar se o upload foi bem-sucedido.
O parâmetro MediaId retornado por esta operação pode ser usado para gerenciamento do ciclo de vida de ativos de mídia ou processamento de mídia.

Limites

Esta operação suporta uploads apenas para o armazenamento VOD. Uploads para armazenamento OSS de propriedade do usuário não são suportados. Se você usar seu próprio armazenamento OSS, faça o upload dos arquivos para o OSS usando o SDK do OSS e, em seguida, invoque a operação RegisterMediaInfo para registrar o arquivo do OSS na biblioteca de mídia.
Atualmente, esta operação suporta apenas as regiões China (Xangai), China (Pequim) e China (Shenzhen).

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

ice:CreateUploadMedia

create

*Todos os recursos.

*

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
AppId	string	Não	O ID do aplicativo. Valor padrão: app-1000000.	app-1000000
EntityId	string	Não	O ID da entidade. Você pode chamar a operação CreateEntity para criar uma entidade e personalizar a estrutura de metadados dinâmicos.	9e177cac2fb44f8b8c67b199fcc7bffd
FileInfo	string	Não	As informações do arquivo no formato JSON. Este parâmetro contém os seguintes campos: Type (obrigatório): o tipo de arquivo. Valores válidos: video, image, audio, text e other. Name (obrigatório): o nome do arquivo sem a extensão. Size (opcional): o tamanho do arquivo. Ext (obrigatório): a extensão do nome do arquivo.	{\"Type\":\"video\",\"Name\":\"test\",\"Size\":108078336,\"Ext\":\"mp4\"}
UserData	string	Não	As configurações personalizadas. O valor é uma string JSON que suporta configurações como callbacks de mensagens.	{"MessageCallback":{"CallbackURL":"http://example.aliyundoc.com"},"Extend":{"localId":"*****","test":"www"}}
UploadTargetConfig	string	Não	O endereço de armazenamento de destino. StorageType: apenas oss é suportado. StorageLocation: apenas o armazenamento VOD é suportado. O armazenamento OSS de propriedade do usuário não é suportado.	{\"StorageType\":\"oss\",\"StorageLocation\":\"outin-***.oss-cn-shanghai.aliyuncs.com\"}
MediaMetaData	string	Não	Os metadados do ativo de mídia a ser enviado, no formato JSON. Title (obrigatório): O comprimento máximo é de 128 caracteres. Codificado em UTF-8. Description (opcional): O comprimento máximo é de 1024 caracteres. Codificado em UTF-8. CateId (opcional): o ID da categoria. Tags (opcional): as tags. BusinessType (obrigatório): o tipo de negócio. Valores válidos: Quando Type = video: opening: créditos de abertura. ending: créditos finais. Quando Type = image: default: padrão. cover: imagem de capa. Quando Type = text: subtitles: legendas. font: fonte. Quando Type = material: watermark: marca d'água. general: uso geral. CoverURL (opcional): a URL da capa. DynamicMetaData: os metadados dinâmicos. O valor é uma string.	{\"Title\": \"UploadTest\", \"Description\": \"UploadImageTest\", \"Tags\": \"tag1,tag2\",\"BusinessType\":\"cover\"}
PostProcessConfig	string	Não	Especifica a ação de processamento pós-upload quando Type = video ou audio. ProcessType: defina como Workflow. Nota Este parâmetro aciona uma tarefa assíncrona. Após o envio, a tarefa não é concluída imediatamente e entra em uma fila em segundo plano para execução assíncrona.	{\"ProcessType\":\"Workflow\",\"ProcessID\":\"74ba870f1a4873a3ba238e0bf6fa9***\"}

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	Os parâmetros de resposta.
RequestId	string	O ID da solicitação.	4E84BE44-58A7-**-**-FBEBEA16EF94
MediaId	string	O ID do ativo de mídia.	**20b48fb04483915d4f2cd8ac**
MediaURL	string	A URL do ativo de mídia. Nota Se um nome de domínio CDN estiver configurado, uma URL CDN será retornada. Caso contrário, uma URL OSS será retornada. Se a MediaURL retornada estiver inacessível (403) em um navegador, a assinatura de URL está ativada para o nome de domínio VOD. Desative a assinatura de URL ou gere uma assinatura.	https://xxq-live-playback.oss-cn-shanghai.aliyuncs.com/capture/5d96d2b4-111b-4e5d-a0e5-20f44405bb55.mp4
FileURL	string	A URL OSS do arquivo (sem autenticação).	http://outin-***.oss-cn-north-2-gov-1.aliyuncs.com/sv/40360f05-181f63c3110-0004-cd8e-27f-de3c9.mp4
UploadAddress	string	O endereço de upload. Nota O endereço de upload retornado pela operação é um valor codificado em Base64. Ao chamar um SDK ou API para fazer upload de ativos de mídia, decodifique o valor usando Base64 antes de usar. Apenas uploads através do SDK nativo do OSS ou da API OSS exigem que você analise o UploadAddress.	eyJTZWN1cml0a2VuIjoiQ0FJU3p3TjF****
UploadAuth	string	A credencial de upload. Nota A credencial de upload retornada pela operação é um valor codificado em Base64. Ao chamar um SDK ou API para fazer upload de ativos de mídia, decodifique o valor usando Base64 antes de usar. Apenas uploads através do SDK nativo do OSS ou da API OSS exigem que você analise o UploadAuth.	eyJFbmRwb2ludCI6Imm****

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "4E84BE44-58A7-****-****-FBEBEA16EF94",
  "MediaId": "****20b48fb04483915d4f2cd8ac****",
  "MediaURL": "https://xxq-live-playback.oss-cn-shanghai.aliyuncs.com/capture/5d96d2b4-111b-4e5d-a0e5-20f44405bb55.mp4",
  "FileURL": "http://outin-***.oss-cn-north-2-gov-1.aliyuncs.com/sv/40360f05-181f63c3110-0004-cd8e-27f-de3c9.mp4",
  "UploadAddress": "eyJTZWN1cml0a2VuIjoiQ0FJU3p3TjF****",
  "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.