Setting Origin-Pull

Last updated: 2019-08-12 10:32:15



You can set origin-pull rules for buckets through the COS Console. When the object you requested does not exist in the bucket, or a specific request needs to be redirected, you can set the origin-pull rules to access corresponding data from COS. Origin-pull settings are mainly used for such scenarios as live migration of data and redirection of specific requests. You can set them as needed.

The success rate of origin-pull data depends on the network environment.


  1. Log in to the COS Console, select Bucket List from the left sidebar to go to the Bucket List page. Click the bucket for which you want to set the origin-pull.
  2. Click Basic Configuration to locate the origin-pull settings, change the status to Enabled, enter the origin server address, and click Save. The configuration items are as follows:
    Origin server address: Only enter the domain name or IP address without http:// or https (not supported). You can also add the port number after the domain name or IP address.
    Example of a correct address:


A user with APPID of 1250000000 created a bucket named "examplebucket-1250000000", and enabled the CDN accelerated domain name:

Set the origin server address for the bucket to:

Store the image picture.jpg at the origin server

The first access from the client:

When COS finds that the object cannot be hit, it returns the HTTP status code 302 to the client and is redirected to the following address:

Then the origin server provides the object to the client to ensure the access, and COS copies picture.jpg from the origin server and saves it to the root directory of the bucket "example".

The second access:

COS directly hits the object picture.jpg in the root directory and returns it to the client.