Setting Origin-Pull

Last updated: 2020-03-17 17:14:32


    You can configure origin-pull rules for buckets on COS Console. If the object you request does not exist in the bucket, or a specific request needs to be redirected, you can configure origin-pull rules to access corresponding data via COS. Origin-pull configurations are mainly used for data hot migration, redirection of specific requests, and other scenarios.

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


    1. Log into the COS Console, select Bucket List in the left pane to enter the Bucket List page. Click the bucket for which you want to configure CORS to enter the bucket details page.
    2. Click Basic Configuration on the left to enter the basic configuration page of the bucket.
    3. Scroll down to find the [Origin-Pull Configurations] item, change the current status to On, and enter the origin-pull address. The configuration items are described as follows:
      • Origin-Pull Address: Enter the domain name or IP address without the http:// or https prefix. You can also add the port number after the domain name or IP address.
      • Origin-Pull Protocol: The HTTP protocol when COS accesses the origin server you have specified. The options are Force HTTPS, Force HTTP, and Follow Request Protocol.
        • If you select Force HTTPS/HTTP, COS will access your origin server using HTTPS/HTTP protocol.
        • If you select Follow Request Protocol, COS will access your origin server with the protocol you use to request COS.
      • Origin-Pull Parameter: Specify whether to pass in request parameters used when accessing the COS to the origin server.
      • 3xx Following Policy: When the origin server returns a 3XX redirect status code, COS by default will follow 3XX to pull data from another origin server again. If you select Off, resources will not be pulled.
      • Add Origin-Pull Header: When COS accesses your origin server, it can carry the newly added header you have specified for access. Currently, up to 10 new custom headers can be added.
        Example of a correct address:
    1. Click Save.


    A user whose APPID is 1250000000 created a bucket named "examplebucket-1250000000", and enabled CDN accelerated domain name:

    Configure the origin-pull address of the bucket to:

    Store the image picture.jpg at the origin server

    Initial 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:

    The origin server then provides the object to the client to ensure 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 picture.jpg object in the root directory and returns it to the client.

    Was this page helpful?

    Was this page helpful?

    • Not at all
    • Not very helpful
    • Somewhat helpful
    • Very helpful
    • Extremely helpful
    Send Feedback