注意事項

• 生成簽名URL過程中，SDK利用本地存儲的密鑰信息，根據特定算法計算出簽名（signature），然后將其附加到URL上，以確保URL的有效性和安全性。這一系列計算和構造URL的操作都是在客戶端完成，不涉及網絡請求到服務端。因此，生成簽名URL時不需要授予調用者特定權限。但是，為避免第三方用戶無法對簽名URL授權的資源執行相關操作，需要確保調用生成簽名URL接口的身份主體被授予對應的權限。

  例如，通過簽名URL下載或預覽文件時，需要授予oss:GetObject權限。

• 您可以將生成的簽名URL提供給訪客進行臨時訪問。生成簽名URL時，您可以自定義URL的過期時間來限制訪客的訪問時長。

• 如果需要生成HTTPS協議的簽名URL，請將Endpoint中的通信協議設置為HTTPS。

• 通過以下示例生成的簽名URL中如果包含特殊符號+，可能出現無法正常訪問該簽名URL的現象。如需正常訪問該簽名URL，請將簽名URL中的+替換為%2B。

生成簽名URL并通過簽名URL下載文件

1. 生成用于下載的簽名URL。

   require 'aliyun/oss'
   
   client = Aliyun::OSS::Client.new(
     # Endpoint以華東1（杭州）為例，其它Region請按實際情況填寫。
     endpoint: 'https://oss-cn-hangzhou.aliyuncs.com',
     # 從環境變量中獲取訪問憑證。運行本代碼示例之前，請確保已設置環境變量OSS_ACCESS_KEY_ID和OSS_ACCESS_KEY_SECRET。
     access_key_id: ENV['OSS_ACCESS_KEY_ID'],
     access_key_secret: ENV['OSS_ACCESS_KEY_SECRET']
   )
   # 填寫Bucket名稱，例如examplebucket。
   bucket = client.get_bucket('examplebucket')
   
   # 生成簽名URL，并指定URL有效時間為1小時（3600秒）。
   puts bucket.object_url('my-object', true, 3600)

2. 在移動端或者瀏覽器端通過簽名URL下載文件。
   Android-Java

   // 填寫生成的簽名URL。
   String url = "";
   OkHttpClient client = new OkHttpClient();
   // 通過簽名URL下載文件。
   Request getRequest = new Request.Builder()
           .url(url)
           .get()
           .build();
   client.newCall(getRequest).enqueue(new Callback() {
       @Override
       public void onFailure(Call call, IOException e) {
           e.printStackTrace();
       }
   
       @Override
       public void onResponse(Call call, Response response) throws IOException {
           if (response.code() == 203 || response.code() >= 300) {
               Log.d("download", "fail");
               Log.d("download", response.body().string());
               return;
           }
           // 請求成功。
           InputStream inputStream = response.body().byteStream();
   
           byte[] buffer = new byte[2048];
           int len;
   
           while ((len = inputStream.read(buffer)) != -1) {
               // 處理下載的數據，例如圖片展示或者寫入文件等。
           }
       }
   });

   Object C

   // 使用簽名URL下載文件。
   NSURL * url = [NSURL URLWithString:urlString];
   NSURLRequest * request = [NSURLRequest requestWithURL:url];
   NSURLSession * session = [NSURLSession sharedSession];
   NSURLSessionTask * sessionTask = [session dataTaskWithRequest:request
                                               completionHandler:^(NSData * _Nullable data, NSURLResponse * _Nullable response, NSError * _Nullable error) {
       if (error) {
           NSLog(@"download error: %@", error);
           return;
       } else if (((NSHTTPURLResponse*)response).statusCode == 203 ||
                  ((NSHTTPURLResponse*)response).statusCode >= 300) {
           NSString *body = [[NSString alloc] initWithData:data encoding:NSUTF8StringEncoding];
           NSLog(@"download error: %@", body);
           return;
       }
       NSLog(@"download success");
   }];
   [sessionTask resume];

   JavaScript

   // 通過HTML中<a>標簽的download屬性、Web API中的window.open等方式使用獲取的文件URL。