Todos os produtos
Search

Este produto

    ApsaraVideo VOD:CreateUploadImage

    Central de documentação

    ApsaraVideo VOD:CreateUploadImage

    Última atualização: Oct 27, 2026

    Emite a URL e a credencial de upload para garantir a autorização e a segurança, previne uploads maliciosos e cria automaticamente um ID de imagem para gerenciamento. Você pode invocar esta operação para obter a URL e a credencial de upload necessárias e criar as informações da imagem.

    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 transferência de armazenamento, 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 transferência de armazenamento.

    • 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, consulte Upload de ativos de mídia usando a API do ApsaraVideo VOD.

    • Você não pode atualizar a URL e a credencial de upload para uploads de imagens. Se a credencial de upload de imagem expirar (o período de validade padrão é de 3.000 segundos), chame esta operação novamente para obter a URL e a credencial de upload.

    • Você pode configurar um callback para receber a notificação de evento de conclusão do upload de imagem para determinar se o upload foi bem-sucedido.

    • 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.

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

    create

    *Todos os recursos.

    *

    		 Nenhuma Nenhuma

    Parâmetros da solicitação

    Parâmetro

    Tipo

    Obrigatório

    Descrição

    Exemplo
    Title

    string

    Não

    O título da imagem. Regras:

    • O título pode ter até 128 caracteres de comprimento.

    • O título deve ser codificado em UTF-8.

    mytitle
    ImageType

    string

    Sim

    O tipo de imagem. Valores válidos:

    • default: imagem comum. Este é o valor padrão.

    • cover: miniatura de vídeo.

    Nota

    O console do ApsaraVideo VOD atualmente suporta a visualização e o gerenciamento apenas de imagens do tipo default.

    default
    ImageExt

    string

    Não

    A extensão do nome do arquivo de origem da imagem a ser carregada. Valores válidos:

    • png: Este é o valor padrão.

    • jpg

    • jpeg

    • gif

    • heic

    • webp

    png
    OriginalFileName

    string

    Não

    O endereço do arquivo de origem da imagem a ser carregado.

    Nota

    O endereço pode omitir a extensão do nome do arquivo. Se o endereço incluir uma extensão de nome de arquivo diferente da extensão especificada em ImageExt, a extensão especificada em ImageExt prevalecerá.

    D:\picture_01
    Tags

    string

    Não

    As tags da imagem. Regras:

    • Uma única tag pode ter até 32 caracteres de comprimento.

    • Podem ser adicionadas no máximo 16 tags.

    • Separe várias tags com vírgulas (,).

    • As tags devem ser codificadas em UTF-8.

    Test
    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, a imagem será carregada no endereço de armazenamento padrão. Se você especificar este parâmetro, a imagem será carregada no endereço de armazenamento especificado.

    outin-****..oss-cn-shanghai.aliyuncs.com
    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 e escolha Gerenciamento de Configuração > Configuração de Gerenciamento de Ativos de Mídia > Gerenciamento de Categorias para visualizar o ID da categoria.

    • Chame a operação AddCategory para criar uma categoria. O ID da categoria é o valor do parâmetro de resposta CateId.

    • Chame a operação GetCategories para consultar categorias. O ID da categoria é o valor do parâmetro de resposta CateId.

    100036****
    UserData

    string

    Não

    As configurações personalizadas. O valor é uma string JSON que suporta configurações como callbacks de mensagens e aceleração de upload. Para mais informações, consulte UserData.

    Nota

    • Para usar o recurso de callback de mensagens neste parâmetro, você deve configurar uma URL de callback HTTP no console e selecionar o tipo de evento de callback correspondente. Caso contrário, as configurações de callback não entrarão em vigor. 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, envie um ticket para solicitar a ativação. Para mais informações, consulte Instruções de upload. Para mais informações sobre como enviar um ticket, consulte Fale conosco.

    {"MessageCallback":{"CallbackURL":"http://example.aliyundoc.com"},"Extend":{"localId":"xxx","test":"www"}}
    Description

    string

    Não

    A descrição da imagem.

    • A descrição pode ter até 1.024 caracteres de comprimento.

    • A descrição deve ser codificada em UTF-8.

    Image upload test
    AppId

    string

    Não

    O ID do aplicativo. Valor padrão: app-1000000. Se você ativou o sistema de múltiplos aplicativos, pode especificar um ID de aplicativo para carregar a imagem em um aplicativo especificado. Para mais informações, consulte Múltiplos aplicativos.

    app-1000000

    Elementos de resposta

    Elemento

    Tipo

    Descrição

    Exemplo

    object

    A resposta.

    FileURL

    string

    A URL do OSS do arquivo de imagem (sem autenticação).

    Ao adicionar um modelo de marca d'água de imagem, esta URL pode ser usada como o parâmetro de solicitação FileUrl para a operação AddWatermark.

    http://example.aliyundoc.com/cover/2017-34DB-4F4C-9373-003AA060****.png
    RequestId

    string

    O ID da solicitação.

    25818875-5F78-AEF6-D7393642****
    UploadAddress

    string

    A URL de upload.

    Nota

    A URL de upload retornada pela operação é codificada em Base64. Ao chamar um SDK ou operação para carregar ativos de mídia, você deve decodificar a URL em Base64 antes de usá-la. Você só precisa analisar o UploadAddress quando usar o SDK nativo do OSS ou a API do OSS para upload.

    eyJTZWN1cmuIjoiQ0FJU3p3TjF****
    ImageURL

    string

    A URL de acesso da imagem.

    Nota

    Se a ImageURL retornada não puder ser acessada em um navegador (erro 403), é porque você ativou o recurso de autenticação para o nome de domínio do VOD. Você pode desativar a autenticação de URL ou gerar uma assinatura de autenticação por conta própria.

    http://example.aliyundoc.com/cover/2017-34DB-4F4C-9373-003AA060****.png
    ImageId

    string

    O ID da imagem. Pode ser usado como parâmetro de solicitação para operações como GetImageInfo, GetImageInfos, UpdateImageInfos e DeleteImage.

    93ab850b4f6f46e91d24d81d4****
    UploadAuth

    string

    A credencial de upload.

    Nota

    A credencial de upload retornada pela operação é codificada em Base64. Ao chamar um SDK ou operação para carregar ativos de mídia, você deve decodificar a credencial em Base64 antes de usá-la. Você só precisa analisar o UploadAuth quando usar o SDK nativo do OSS ou a API do OSS para upload.

    eyJFbmmRCI6Im****

    Exemplos

    Resposta de sucesso

    JSON formato

    {
  "FileURL": "http://example.aliyundoc.com/cover/2017-34DB-4F4C-9373-003AA060****.png",
  "RequestId": "25818875-5F78-AEF6-D7393642****",
  "UploadAddress": "eyJTZWN1cmuIjoiQ0FJU3p3TjF****",
  "ImageURL": "http://example.aliyundoc.com/cover/2017-34DB-4F4C-9373-003AA060****.png",
  "ImageId": "93ab850b4f6f46e91d24d81d4****",
  "UploadAuth": "eyJFbmmRCI6Im****"
}

    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.