更新时间:2026-10-10 GMT+08:00
分享

如何按前缀生成临时url?

ObsClient.createGetTemporarySignature接口支持按前缀生成临时url,可用于访问包含指定前缀的任意对象。

  1. 该接口生成的URL包含指定前缀的所有对象的下载权限,如只需下载指定对象,请参考代码示例:下载对象。
  2. 可以通过替换该接口生成的URL中的对象名来下载包含指定前缀的其他对象,无需重新生成url。
  3. 当前缀为空时将会对整个桶生效,使用时请注意。

代码示例:

按前缀生成examplebucket桶中包含examplePrefix前缀对象的临时下载url,URL有效期设置为3600秒。

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
import com.obs.services.ObsClient;
import com.obs.services.exception.ObsException;
import com.obs.services.model.TemporarySignatureResponse;
public class GetObjectByPrefix001 {
    public static void main(String[] args) {
        // 您可以通过环境变量获取访问密钥AK/SK,也可以使用其他外部引入方式传入。如果使用硬编码可能会存在泄露风险。
        // 您可以登录访问管理控制台获取访问密钥AK/SK
        String ak = System.getenv("ACCESS_KEY_ID");
        String sk = System.getenv("SECRET_ACCESS_KEY_ID");
        // 【可选】如果使用临时AK/SK和SecurityToken访问OBS,同样建议您尽量避免使用硬编码,以降低信息泄露风险。
        // 您可以通过环境变量获取访问密钥AK/SK/SecurityToken,也可以使用其他外部引入方式传入。使用临时访问密钥调用接口可将下面一行的注释取消。
        // String securityToken = System.getenv("SECURITY_TOKEN");
        // endpoint填写桶所在的endpoint, 此处以华北-北京四为例,其他地区请按实际情况填写。
        String endPoint = "https://obs.cn-north-4.myhuaweicloud.com";
        // 您可以通过环境变量获取endPoint,也可以使用其他外部引入方式传入。
        //String endPoint = System.getenv("ENDPOINT");
        
        // 创建ObsClient实例
        // 使用永久AK/SK初始化客户端
        ObsClient obsClient = new ObsClient(ak, sk, endPoint);
        // 使用临时AK/SK和SecurityToken初始化客户端
        // ObsClient obsClient = new ObsClient(ak, sk, securityToken, endPoint);

        try {
            // URL有效期,3600秒
            long expireSeconds = 3600L;
            String bucketName = "examplebucket";
            // 对象名,需包含前缀
            String objectKey = "examplePrefix/objectname";
            // 对象名前缀,当前缀为空时将会对整个桶生效,使用时请注意
            String prefix = "examplePrefix";
            TemporarySignatureResponse response = obsClient.createGetTemporarySignature(bucketName,
                objectKey, prefix, expireSeconds, null, null);
            // 可以通过替换该URL中的对象名来下载其他对象,无需重新生成url
            System.out.println("SignedUrl:" + response.getSignedUrl());
        } catch (ObsException e) {
            System.out.println("getSignedUrl failed");
            // 请求失败,打印http状态码
            System.out.println("HTTP Code:" + e.getResponseCode());
            // 请求失败,打印服务端错误码
            System.out.println("Error Code:" + e.getErrorCode());
            // 请求失败,打印详细错误信息
            System.out.println("Error Message:" + e.getErrorMessage());
            // 请求失败,打印请求id
            System.out.println("Request ID:" + e.getErrorRequestId());
            System.out.println("Host ID:" + e.getErrorHostId());
            e.printStackTrace();
        } catch (Exception e) {
            System.out.println("getSignedUrl failed");
            // 其他异常信息打印
            e.printStackTrace();
        }
    }
}

相关文档