镜像回源

更新时间：2026-09-21

若您为 Bucket 配置了镜像回源，当用户访问该 Bucket 中某一 Object 时，发现该 Object 在 BOS 中并不存在，则 BOS 会立刻向预先配置好的回源地址请求该 Object，保证访问正常进行。在请求过程中，源站返回的数据会自动给到请求用户，而用户对该过程无感。同时，该数据也会自动存入 BOS，提升日后该类请求的流畅性。参考镜像回源。

代码示例

                Python
                
            

                # -*- coding: utf-8 -*-

import logging

from baidubce.auth.bce_credentials import BceCredentials
from baidubce.bce_client_configuration import BceClientConfiguration
from baidubce.services.bos.bos_client import BosClient

logging.basicConfig(level=logging.DEBUG)
logger = logging.getLogger(__name__)

access_key_id = "your-access-key-id"
secret_access_key = "your-secret-access-key"
endpoint = "https://bj.bcebos.com"
bucket_name = "your-bucket-name"

config = BceClientConfiguration(
    credentials=BceCredentials(access_key_id, secret_access_key),
    endpoint=endpoint
)
bos_client = BosClient(config)

mirror_args = [
    {
        "mode": "fetch",
        "sourceUrl": "https://example.com",
        "backSourceUrl": "https://example.com",
        "resource": "*.jpeg",
        "version": "v2",
        "passQueryString": False,
        "storageClass": "STANDARD"
    }
]

response = bos_client.put_bucket_mirroring(bucket_name, mirror_args=mirror_args)
logger.debug("[Sample] put bucket mirroring response: %s", response)

response = bos_client.get_bucket_mirroring(bucket_name)
logger.debug("[Sample] get bucket mirroring response: %s", response)

response = bos_client.delete_bucket_mirroring(bucket_name)
logger.debug("[Sample] delete bucket mirroring response: %s", response)
            

put_bucket_mirroring 用于配置 Bucket 镜像回源，get_bucket_mirroring 用于查询 Bucket 镜像回源配置，delete_bucket_mirroring 用于删除 Bucket 镜像回源配置。接口调用成功后，SDK 返回对应请求的响应对象；查询镜像回源配置时，响应中包含当前 Bucket 的镜像回源配置内容。

参数说明

参数	必填	说明
`access_key_id`	是	用户的 Access Key ID。示例中使用占位符，请替换为实际值。
`secret_access_key`	是	用户的 Secret Access Key。示例中使用占位符，请替换为实际值。
`endpoint`	是	BOS 服务 Endpoint，例如 `https://bj.bcebos.com`。
`bucket_name`	是	需要配置镜像回源的 Bucket 名称。
`mirror_args`	是	镜像回源配置列表，传入 `put_bucket_mirroring` 方法。
`mode`	是	镜像回源模式，示例值为 `fetch`。
`sourceUrl`	是	镜像回源源站地址。
`backSourceUrl`	否	镜像回源备用源站地址。
`resource`	是	镜像回源匹配的资源范围，例如 `*.jpeg`。
`version`	是	镜像回源配置版本，示例值为 `v2`。
`passQueryString`	否	是否向源站透传请求中的 Query String。
`storageClass`	否	回源后写入 BOS 的存储类型，示例值为 `STANDARD`。

评价此篇文章

有帮助没帮助

bucket清单管理

数据加密

百度智能云

BOS 对象存储

BOS 对象存储

镜像回源

代码示例