Image processing (IMG) provides the old and new versions. This topic describes the differences between the two versions.
No updates will be available to the old version. We recommend that you use the new IMG version. For more information, see IMG implementation modes.
Differences between the old version and new version
The old and new versions have different IMG parameter formats. This section describes the formats of the parameters:
Parameter format for the new version:
http://bucket.<endpoint>/object?x-oss-process=image/action,parame_valueAll IMG actions are specified by using
x-oss-process. Actions are sequentially executed.Parameter format for the old version:
http://channel.<endpoint>/object@action.formatActions are specified after the
@delimiter.
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, the processed image is accessible by using the dedicated IMG domain name. If you use the new version of IMG to process an image, the processed image is accessible by using the OSS domain name. The following table describes the differences in accessing processed images by using IMG domain names and OSS domain names.
Item | Access using IMG domain names | Access using OSS domain names |
Method | OSS domain names for image storage and IMG domain names for image processing | OSS domain names for object upload, management, processing, and distribution |
API operations for the new version | Supported | Supported |
API operations for the old version | Supported | Not supported by default |
HTTPS | Not supported | Supported |
VPC | Not supported | Supported |
Multi-domain mappings | Not supported | Supported |
Automatic Alibaba Cloud CDN cache refresh upon origin-side updates | Not supported | Supported |
OSS domain names support all IMG features, but you can use only the API operations for the new version. IMG domain names support the old and new versions of the API operations.
If you want Alibaba Cloud CDN to accelerate access to images by using IMG domain names, you can set the origin host to the IMG domain names on Alibaba Cloud CDN. You do not need to map the IMG domain names to the bucket.
Differences between buckets for which the old and new versions of IMG are enabled
Buckets for which the old version of IMG is enabled:
The domain names are the IMG domain names 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 objects. 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 technical support. However, if you process 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 IMG 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 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.