Image processing (IMG) provides the old and new versions. This topic describes the differences between the two versions.

Differences between the old and new versions of IMG

When you add processing parameters, the formats of the parameters are different for the old and new versions. This section describes the formats of the parameters:

  • Parameter format for the new version: http://bucket.<endpoint>/object?x-oss-process=image/action,parame_value

    All IMG actions are passed through the x-oss-process header. Each action is sequentially executed.

  • Parameter format for the old version: http://channel.<endpoint>/object@action.format

    Actions are separated by @.

Differences between access to processed images by using OSS domain names and IMG domain names

If you use the old version of IMG to process an image, a dedicated IMG domain name is generated to access the image. If you use the new version of IMG to process an image, the Object Storage Service (OSS) domain name is used to access the image. The following table describes the difference between access to processed images by using IMG domain names and OSS domain names.

ItemAccess by using IMG domain namesAccess by using OSS domain names
MethodOSS domain names are used for image storage and IMG domain names are used for image processing.OSS domain names are used for object upload, management, processing, and distribution.
API operations for the new versionSupportedSupported
API operations for the old versionSupportedNot supported by default
HTTPSNot supportedSupported
VPCNot supportedSupported
IP address associated with multiple domain namesNot supportedSupported
Automatic refresh of content cached on Alibaba Cloud CDN POPs when the resources on the origin are updatedNot supportedSupported
Note
  • OSS domain names support IMG, but you can use only the API operations for the new version. The IMG domain names support the old and new versions of the API operations.
  • If you want Alibaba Cloud CDN to accelerate access to the image by using the IMG domain name, you can set the origin host to the IMG domain name on the Alibaba Cloud CDN. You do not need to map the IMG domain name to the bucket.

Differences between buckets that use the old and new versions of IMG

Buckets for which the old version of IMG is enabled:

  • The image domain names are the IMG domain name generated when the old version of IMG is used, and the custom domain name that was mapped.
  • Configurations by using the old version of IMG, such as source image protection, are valid only for the previously generated IMG domain names and do not take effect on the OSS domain name of the object. When cross-region replication (CRR) is enabled, the source image protection and style delimiter are synchronized to the OSS domain names.
  • When you disable IMG for the current bucket, the style configurations and domain name mapping are cleared, and the page of the new version of IMG is displayed.

New buckets or buckets for which the old version of IMG is not enabled:

  • By default, you can use IMG without the need to enable it.
  • You do not need to map a domain name.

How do I switch from the old version of IMG to the new version of IMG?

You cannot use the API operations of the old version of IMG in the new version of IMG. If you have special requirements, submit a ticket to contact after-sales technical support. However, if you access an image only by using an image style in the old version of IMG, you can perform the following steps:

  • Enable configuration synchronization in the current Image Service configurations. This way, the image style delimiters and source image protection can be synchronized to the new version of IMG.
  • If you use a custom domain name, change the CNAME of the custom domain name to that of the OSS domain name.

Are the image style configurations of the new and old versions of IMG the same?

All image style configurations are shared in the new and old versions of IMG. You can use the image style configurations of the old version of IMG in the new version of IMG.