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

Descrição da operação

Visão geral

Obter um endereço de upload e uma credencial de upload é um pré-requisito para todos os uploads no Intelligent Media Service.
Se uma credencial de upload expirar (a validade padrão é de 3.000 segundos), chame a operação RefreshUploadMedia para obter uma nova.
Após a conclusão de um upload, você pode confirmar seu sucesso configurando um callback para notificações de eventos ou chamando a operação GetMediaInfo para verificar o status do ativo de mídia.
Use o MediaId retornado para o gerenciamento do ciclo de vida do ativo de mídia ou processamento de mídia.

Limitações

Esta operação suporta uploads apenas para o armazenamento VOD, e não para seus próprios buckets do Object Storage Service (OSS). Se você usar seus próprios buckets do OSS, primeiro faça o upload dos arquivos usando o OSS SDK e, em seguida, chame a operação RegisterMediaInfo para registrar os arquivos do OSS em sua biblioteca de mídia.
Esta operação está disponível apenas nas regiões China (Shanghai), China (Beijing) 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

*All Resource

*

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
AppId	string	Não	O ID do aplicativo. O 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 definir um esquema personalizado para metadados dinâmicos.	9e177cac2fb44f8b8c67b199fcc7bffd
FileInfo	string	Não	As informações do arquivo, fornecidas como uma string JSON contendo 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 arquivo.	{\"Type\":\"video\",\"Name\":\"test\",\"Size\":108078336,\"Ext\":\"mp4\"}
UserData	string	Não	Uma string JSON para configurações personalizadas, como a configuração de um callback de mensagem.	{"MessageCallback":{"CallbackURL":"http://example.aliyundoc.com"},"Extend":{"localId":"*****","test":"www"}}
UploadTargetConfig	string	Não	A configuração de armazenamento de destino, fornecida como uma string JSON. StorageType: Apenas oss é suportado. StorageLocation: Apenas o armazenamento VOD é suportado. Você não pode fazer upload para seus próprios buckets do OSS.	{\"StorageType\":\"oss\",\"StorageLocation\":\"outin-***.oss-cn-shanghai.aliyuncs.com\"}
MediaMetaData	string	Não	Os metadados do ativo de mídia, fornecidos como uma string JSON. Title (Obrigatório): O título pode ter até 128 caracteres de comprimento. O título deve ser codificado em UTF-8. Description (Opcional): A descrição pode ter até 1.024 caracteres de comprimento. A descrição deve ser codificada em UTF-8. CateId (Opcional): O ID da categoria. Tags (Opcional): As tags do ativo de mídia, separadas por vírgulas. BusinessType (Obrigatório): O tipo de negócio. Os valores válidos dependem do Type especificado em FileInfo. Se Type for video: opening ou ending. Se Type for image: default, cover ou watermark. Se Type for text: subtitles ou font. Se Type for other: general. CoverURL (Opcional): A URL da imagem de capa. DynamicMetaData (Opcional): Uma string para metadados dinâmicos personalizados.	{\"Title\": \"UploadTest\", \"Description\": \"UploadImageTest\", \"Tags\": \"tag1,tag2\",\"BusinessType\":\"cover\"}
PostProcessConfig	string	Não	A configuração de pós-processamento para uploads de video ou audio. Defina ProcessType como Workflow. Nota Este parâmetro especifica uma tarefa assíncrona, que é enfileirada e executada em segundo plano após o envio da solicitação.	{\"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 Esta será uma URL de CDN se um domínio de CDN estiver configurado, ou uma URL do OSS caso contrário. Se você receber um erro 403 ao acessar esta URL em um navegador, é provável que a autenticação de URL esteja ativada para o domínio VOD. Para resolver isso, desative a autenticação de URL ou gere uma URL assinada para acesso.	https://xxq-live-playback.oss-cn-shanghai.aliyuncs.com/capture/5d96d2b4-111b-4e5d-a0e5-20f44405bb55.mp4
FileURL	string	A URL do OSS do arquivo, sem parâmetros de 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 é codificado em Base64 e deve ser decodificado antes do uso. Você só precisa decodificar manualmente este endereço se estiver usando um SDK nativo do OSS ou uma API do OSS para realizar o upload.	eyJTZWN1cml0a2VuIjoiQ0FJU3p3TjF****
UploadAuth	string	A credencial de upload. Nota A credencial de upload retornada é codificada em Base64 e deve ser decodificada antes do uso. Você só precisa decodificar manualmente esta credencial se estiver usando um SDK nativo do OSS ou uma API do OSS para realizar o upload.	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.