Todos os produtos
Search
Central de documentação

Object Storage Service:Diferenças entre as versões antiga e nova do IMG

Última atualização: Jul 03, 2026

O processamento de imagens (IMG) está disponível em duas versões: antiga e nova. Este tópico descreve as diferenças entre elas.

Nota

A versão antiga não receberá mais atualizações. Recomendamos o uso da nova versão do IMG. Para mais informações, consulte Modos de implementação do IMG.

Diferenças entre a versão antiga e a nova

As versões antiga e nova utilizam formatos diferentes para os parâmetros do IMG. Esta seção descreve esses formatos:

  • Formato de parâmetro da nova versão: http://bucket.<endpoint>/object?x-oss-process=image/action,parame_value

    Todas as ações do IMG são especificadas por meio de x-oss-process. As ações são executadas sequencialmente.

  • Formato de parâmetro da versão antiga: http://channel.<endpoint>/object@action.format

    As ações são especificadas após o delimitador @.

Diferenças no acesso a imagens processadas usando nomes de domínio do OSS e do IMG

Ao usar a versão antiga do IMG para processar uma imagem, o resultado fica acessível pelo nome de domínio dedicado do IMG. Na nova versão, a imagem processada fica acessível pelo nome de domínio do OSS. A tabela a seguir detalha as diferenças de acesso entre os dois tipos de domínio.

Item

Acesso via nomes de domínio do IMG

Acesso via nomes de domínio do OSS

Método

Nomes de domínio do OSS para armazenamento e do IMG para processamento de imagens

Nomes de domínio do OSS para upload, gerenciamento, processamento e distribuição de objetos

Operações de API da nova versão

Compatível

Compatível

Operações de API da versão antiga

Compatível

Incompatível por padrão

HTTPS

Incompatível

Compatível

VPC

Incompatível

Compatível

Mapeamento de múltiplos domínios

Incompatível

Compatível

Atualização automática de cache do Alibaba Cloud CDN após alterações na source

Incompatível

Compatível

Nota
  • Os nomes de domínio do OSS oferecem suporte a todos os recursos do IMG, mas aceitam apenas as operações de API da nova versão. Os nomes de domínio do IMG são compatíveis com as operações de API das versões antiga e nova.

  • Para acelerar o acesso às imagens via nomes de domínio do IMG com o Alibaba Cloud CDN, defina o host de source como o nome de domínio do IMG no Alibaba Cloud CDN. Não é necessário mapear os nomes de domínio do IMG para o bucket.

Diferenças entre buckets com as versões antiga e nova do IMG ativadas

Buckets com a versão antiga do IMG ativada:

  • Os domínios incluem tanto os nomes de domínio do IMG gerados pela versão antiga quanto o nome de domínio personalizado previamente mapeado.

  • Configurações da versão antiga, como proteção de imagem original, aplicam-se exclusivamente aos nomes de domínio do IMG já gerados e não afetam o nome de domínio do OSS dos objetos. Se a replicação entre regiões (CRR) estiver ativada, a proteção de imagem original e o delimitador de estilo serão sincronizados com os nomes de domínio do OSS.

  • Ao desativar o IMG no bucket atual, as configurações de estilo e o mapeamento de domínio são removidos, e a página da nova versão do IMG é exibida.

Novos buckets ou buckets sem a versão antiga do IMG ativada:

  • O IMG pode ser usado por padrão, sem necessidade de ativação prévia.

  • Não é necessário mapear um nome de domínio.

Como migrar da versão antiga para a nova versão do IMG?

As operações de API da versão antiga não funcionam na nova versão do IMG. Caso tenha requisitos específicos, envie um ticket para entrar em contato com o suporte técnico. No entanto, se você processar imagens exclusivamente por estilos de imagem na versão antiga, siga os passos abaixo:

  • Ative a sincronização de configurações nas definições atuais do IMG. Isso permite que os delimitadores de estilo de imagem e a proteção de imagem original sejam sincronizados com a nova versão.

  • Se utilizar um nome de domínio personalizado, altere o CNAME desse domínio para o nome de domínio do OSS.

As configurações de estilo de imagem são iguais nas versões nova e antiga do IMG?

Sim, todas as configurações de estilo de imagem são compartilhadas entre as versões nova e antiga do IMG. É possível usar as configurações de estilo definidas na versão antiga diretamente na nova versão.