镜像回源
更新时间：2023-07-21
若您为 Bucket 配置了镜像回源，当用户访问该 Bucket 中某一 Object 时，发现该 Object 在 BOS 中并不存在，则 BOS 会立刻向预先配置好的回源地址请求该 Object，保证访问正常进行。在请求过程中，源站返回的数据会自动给到请求用户而用户对该过程无感。同时，该数据也会自动存入 BOS，提升日后该类请求的流畅性。参考镜像回源。
设置镜像回源（PutBucketMirroring）
| 参数 | 说明 |
|---|---|
| bucketName | 请求的bucket名称 |
| bucketMirroringConfigurations | 镜像回源配置，具体参数与Api接口参数相同 |
如下代码通过构造对象参数来设置镜像回源：
Java
1// 构造镜像回源配置
2BucketMirroringConfiguration config = BucketMirroringConfiguration.builder()
3 .mode("fetch")
4 .sourceUrl("http://xxx.bj.bcebos.com")
5 .resource("*")
6 .build();
7List<BucketMirroringConfiguration> bucketMirroringConfigurations =
8 new ArrayList<BucketMirroringConfiguration>();
9bucketMirroringConfigurations.add(config);
10
11// 请求
12this.client.putBucketMirroring(bucketName, bucketMirroringConfigurations);如下代码通过直接传入Json来设置镜像回源：
Java
1// 构造镜像回源配置
2String configJson = "{\"bucketMirroringConfiguration\":[{\"mode\":\"fetch\"," +
3 "\"sourceUrl\":\"http://xxx.bj.bcebos.com\",\"resource\":\"*\",\"prefix\":\"\"," +
4 "\"suffix\":\"\"," +
5 "\"fixedKey\":\"\",\"version\":\"v1\",\"customHeaders\":[],\"storageClass\":\"STANDARD\"," +
6 "\"ignoreHeaders\":[],\"passHeaders\":[]}]}";
7
8// 请求
9this.client.putBucketMirroring(bucketName, configJson);获取镜像回源配置（GetBucketMirroring）
| 参数 | 说明 |
|---|---|
| bucketName | 请求的bucket名称 |
代码示例
Java
1// 请求
2GetBucketMirroringResponse response = this.client.getBucketMirroring(bucketName);
3System.out.println(response.getBucketMirroringConfiguration().toString());删除镜像回源配置（DeleteBucketMirroring）
| 参数 | 说明 |
|---|---|
| bucketName | 请求的bucket名称 |
代码示例
Java
1this.client.deleteBucketMirroring(bucketName);