Todos os produtos
Search

Este produto

    ApsaraVideo VOD:CreateUploadImage

    Central de documentação

    ApsaraVideo VOD:CreateUploadImage

    Última atualização: Jul 04, 2026

    O ApsaraVideo VOD retorna a URL de upload e a credencial para garantir autorização e segurança, prevenir uploads maliciosos e criar automaticamente um ID de imagem para gerenciamento. Obtém uma URL de upload e uma credencial de upload para fazer upload de um arquivo de áudio ou vídeo e gera o ID do áudio ou vídeo.

    Descrição da operação

    • Certifique-se de que você compreende o método de cobrança e o preço do ApsaraVideo VOD antes de chamar esta operação. Você será cobrado por taxas de armazenamento após fazer upload de arquivos de mídia para o ApsaraVideo VOD. Para mais informações, consulte Cobrança de armazenamento de ativos de mídia. Se você ativou o serviço de aceleração, serão cobradas taxas de aceleração ao fazer upload de arquivos de mídia para o ApsaraVideo VOD. Para mais informações, consulte Cobrança de tráfego de aceleração.

    • Você deve obter uma URL e uma credencial antes de fazer upload de uma imagem para o ApsaraVideo VOD. O ApsaraVideo VOD fornece vários métodos de upload. Você pode fazer upload de arquivos usando SDKs de upload do servidor, SDKs de upload do cliente, URLs, API do Object Storage Service (OSS) ou SDKs do OSS. Cada método de upload tem requisitos diferentes para obter URLs e credenciais de upload. Para mais informações, consulte a seção "Notas de uso" do tópico URLs e credenciais de upload.

    • Você não pode atualizar a URL ou a credencial de upload ao fazer upload de imagens. Se a credencial de upload de imagem expirar, você pode chamar esta operação para obter uma nova URL e credencial de upload. Por padrão, o período de validade de uma credencial de upload de imagem é de 3.000 segundos.

    • Você pode chamar a operação CreateUploadAttachedMedia para fazer upload de marcas d'água de imagem.

    • Você pode configurar um callback para ImageUploadComplete para receber notificações sobre o status do upload de imagem.

    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

    *All Resource

    *

    		 Nenhuma Nenhuma

    Parâmetros da solicitação

    Parâmetro

    Tipo

    Obrigatório

    Descrição

    Exemplo
    Title

    string

    Não

    O título da imagem. As seguintes regras se aplicam:

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

    • O valor deve ser codificado em UTF-8.

    mytitle
    ImageType

    string

    Sim

    O tipo da imagem. Valores válidos:

    • default: o tipo de imagem padrão.

    • cover: a miniatura.

    Nota

    Você pode gerenciar apenas imagens do tipo default no console do ApsaraVideo VOD.

    default
    ImageExt

    string

    Não

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

    • png (padrão)

    • jpg

    • jpeg

    • gif

    png
    OriginalFileName

    string

    Não

    O nome do arquivo de origem.

    Nota

    O nome deve conter uma extensão de arquivo. A extensão do arquivo não diferencia maiúsculas de minúsculas.

    D:\picture_01
    Tags

    string

    Não

    As tags da imagem. As seguintes regras se aplicam:

    • Cada tag pode ter até 32 caracteres de comprimento.

    • Você pode especificar no máximo 16 tags para uma imagem.

    • Separe múltiplas tags com vírgulas (,).

    • O valor deve ser codificado em UTF-8.

    Test
    StorageLocation

    string

    Não

    O endereço de armazenamento. Execute as seguintes operações para obter o endereço de armazenamento: Faça login no console do ApsaraVideo VOD. No painel de navegação à esquerda, escolha Gerenciamento de Configuração > Gerenciamento de Mídia > Armazenamento. Na página Armazenamento, visualize o endereço de armazenamento.

    Nota

    Se você especificar um endereço de armazenamento, os arquivos de mídia serão enviados para o endereço especificado.

    outin-****..oss-cn-shanghai.aliyuncs.com
    CateId

    integer

    Não

    O ID da categoria da imagem. Você pode usar um dos seguintes métodos para obter o ID da categoria:

    • Faça login no console do ApsaraVideo VOD. No painel de navegação à esquerda, escolha Gerenciamento de Configuração > Gerenciamento de Mídia > Categorias. Na página Categorias, você pode visualizar o ID da categoria da imagem.

    • Obtenha o valor de CateId na resposta da operação AddCategory.

    • Obtenha o valor de CateId na resposta da operação GetCategories.

    100036****
    UserData

    string

    Não

    As configurações personalizadas, incluindo configurações de callback e configurações de aceleração de upload. O valor deve ser uma string JSON. Para mais informações, consulte a seção "UserData: especifica as configurações personalizadas para upload de mídia" do tópico Parâmetros de solicitação.

    Nota

    • As configurações de callback entram em vigor somente após você especificar a URL de callback HTTP e selecionar eventos de callback específicos no console do ApsaraVideo VOD. Para mais informações sobre como definir configurações de callback HTTP no console do ApsaraVideo VOD, consulte Configurar definições de callback.

    • Se você deseja ativar o recurso de aceleração de upload, envie um ticket. Para mais informações, consulte Visão geral. 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.

    • O valor deve ser codificado em UTF-8.

    Image upload test
    AppId

    string

    Não

    O ID da aplicação. Valor padrão: app-1000000. Para mais informações, consulte Visão geral.

    app-1000000

    Elementos de resposta

    Elemento

    Tipo

    Descrição

    Exemplo

    object

    O resultado retornado.

    FileURL

    string

    A URL do OSS do arquivo. A URL não contém as informações usadas para assinatura de URL. Você pode especificar FileUrl ao chamar 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 é uma URL codificada em Base64. Você deve decodificar a URL codificada em Base64 antes de usar um SDK ou chamar uma operação de API para fazer upload de ativos de mídia auxiliares. Você precisa analisar UploadAddress somente se usar o SDK do OSS ou chamar uma operação de API do OSS para fazer upload de ativos de mídia auxiliares.

    eyJTZWN1cmuIjoiQ0FJU3p3TjF****
    ImageURL

    string

    A URL da imagem.

    Nota

    Se a URL retornada estiver inacessível a partir de um navegador e o código de status HTTP 403 for retornado, o recurso de assinatura de URL no ApsaraVideo VOD está ativado. Para resolver esse problema, você pode desativar o recurso de assinatura de URL ou gerar uma URL assinada.

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

    string

    O ID do arquivo de imagem.

    93ab850b4f6f46e91d24d81d4****
    UploadAuth

    string

    A credencial de upload.

    Nota

    A credencial de upload retornada é um valor codificado em Base64. Você deve decodificar a credencial codificada em Base64 antes de usar um SDK ou chamar uma operação de API para fazer upload de ativos de mídia auxiliares. Você precisa analisar UploadAuth somente se usar o SDK do OSS ou chamar uma operação de API do OSS para fazer upload de ativos de mídia auxiliares.

    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.