Todos os produtos
Search
Central de documentação

Object Storage Service:Differences between the old and new versions of IMG

Última atualização: Sep 22, 2026

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

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 IMG implementation modes.

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

As versões antiga e nova possuem formatos de parâmetros do IMG diferentes. Esta seção descreve os formatos desses parâmetros:

  • 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 com o uso de x-oss-process. O IMG executa as ações em sequência.

  • 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 por meio de nomes de domínio do OSS e do IMG

Se você usar a versão antiga do IMG para processar uma imagem, a imagem processada ficará acessível por meio do nome de domínio dedicado do IMG. Caso utilize a nova versão do IMG, a imagem processada ficará acessível pelo nome de domínio do OSS. A tabela a seguir descreve as diferenças no acesso a imagens processadas com o uso de nomes de domínio do IMG e do OSS.

Item

Acesso com nomes de domínio do IMG

Acesso com nomes de domínio do OSS

Método

Nomes de domínio do OSS para armazenamento de imagens e nomes de domínio 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

Suportado

Suportado

Operações de API da versão antiga

Suportado

Não suportado por padrão

HTTPS

Não suportado

Suportado

VPC

Não suportado

Suportado

Mapeamentos de múltiplos domínios

Não suportado

Suportado

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

Não suportado

Suportado

Nota
  • Os nomes de domínio do OSS suportam todos os recursos do IMG, mas permitem apenas o uso das operações de API da nova versão. Já os nomes de domínio do IMG suportam as operações de API das versões antiga e nova.

  • Para que o Alibaba Cloud CDN acelere o acesso às imagens por meio dos nomes de domínio do IMG, defina o host de origem como os nomes 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 nomes de domínio correspondem aos nomes de domínio do IMG gerados durante o uso da versão antiga do IMG e ao nome de domínio personalizado que foi mapeado.

  • As configurações feitas com a versão antiga do IMG, como a proteção de imagem source, são válidas apenas para os nomes de domínio do IMG gerados anteriormente e não se aplicam ao nome de domínio do OSS dos objetos. Quando a replicação entre regiões (CRR) está ativada, a proteção de imagem source e o delimitador de estilo são sincronizados com os nomes de domínio do OSS.

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

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

  • Por padrão, é possível usar o IMG sem a necessidade de ativá-lo.

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

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

Não é possível usar as operações de API da versão antiga do IMG na nova versão. Caso tenha requisitos especiais, envie um ticket para entrar em contato com o suporte técnico. No entanto, se você processar uma imagem usando apenas um estilo de imagem na versão antiga do IMG, execute as seguintes etapas:

  • Ative a sincronização de configurações nas configurações atuais do IMG. Dessa forma, os delimitadores de estilo de imagem e a proteção de imagem source serão sincronizados com a nova versão do IMG.

  • Se você usar um nome de domínio personalizado, altere o CNAME do nome de domínio personalizado para o nome de domínio do OSS.

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

Todas as configurações de estilo de imagem são compartilhadas entre as versões nova e antiga do IMG. Você pode utilizar as configurações de estilo de imagem da versão antiga do IMG na nova versão.