Updated on 2026-02-12 GMT+08:00

Notes and Constraints

Operations

  • All image processing operations will not change original images.
  • Archive storage does not support image processing.
  • Deep Archive storage does not support image processing.
  • OBS buckets that use SSE-KMS do not support image processing.
  • Only version 3.0 buckets support image processing. To check the version of a bucket, go to OBS Console, click the bucket name and go to the Overview page, and find the version in the Basic Information area.
  • If images allow anonymous access, they can be accessed in a web browser through image processing requests that do not include a signature. A request URL example is given as follows:

    https://bucketname.obs.ap-southeast-1.myhuaweicloud.com/example.jpg?x-image-process=style/stylename

    For details about how to make images accessible to anonymous users, see Granting Anonymous Users the Public Read Permission for a Bucket.

    If images do not allow anonymous access, the image processing requests must include a signature. To calculate a signature and construct a URL with the signature included, see Using a Pre-Signed URL.

  • For security and compliance purposes, using a default bucket domain name (bucket domain name or static website domain name) to preview objects in the bucket will be prohibited by OBS. When you use such domain name to access objects (such as videos, images, and web pages) through a browser, no content will be displayed. Instead, the content is downloaded as an attachment.

    For details, see How Do I Preview OBS Objects in a Browser Online?

  • A single image processing request can last up to 30 seconds. Due to factors such as image size and resolution, some cases may experience higher latency, which could result in request timeouts.
  • Image processing encodes and decodes images, so the preview image size differs from the actual size.

Images

  • Supported original image formats include JPG, JPEG, PNG, BMP, WebP, GIF, TIFF, HEIC, and AVIF.
  • Supported formats after image processing include JPG, PNG, BMP, and WebP.
  • An original image allowed for processing cannot exceed 25 MB in size, and its width and height after processing cannot exceed 4,096 pixels and 5,000 pixels, respectively.
  • An animated image (like a GIF or WebP image) will be returned without processing if it is greater than 2 MB in size or has over 50 frames.
  • Currently, processing images in CMYK may change their color.
  • An input image can contain 250 megapixels at most.
  • Only JPG and WebP images support quality changes.

Commands

A maximum of 20 commands is allowed, with a total length of no more than 512 characters.