Object Storage Service：使用最後一次訪問時間的生命週期規則實現資料智能分層

1. 開啟訪問跟蹤。

   1. 登入OSS管理主控台。

   2. 單擊Bucket 列表，然後單擊目標Bucket名稱。

   3. 在左側導覽列，選擇資料管理 > 生命週期。

   4. 在生命週期頁面，開啟啟用訪問跟蹤開關。

      說明

      開啟訪問跟蹤後，OSS預設以訪問跟蹤開啟時間作為Bucket中所有Object的最後一次訪問時間。

2. 配置生命週期規則。

   1. 在生命週期頁面，單擊創建規則。

   2. 在建立生命週期規則面板，按以下說明分別配置基於首碼data/以及首碼log/的生命週期規則。

      基於data/的生命週期規則

      按以下說明配置基於data/的生命週期規則的必要參數，其他參數保留預設配置。

      配置項	說明
      狀態	選中啟動。
      策略	選中按首碼匹配。
      前綴	輸入data/。
      檔案時間策略	選中指定天數。
      生命週期管理規則	下拉選擇最後一次訪問時間，輸入200天后，資料自動轉換成低頻訪問類型（資料被訪問後，依舊停留在低頻檔）。

      基於log/的生命週期規則

      按以下說明配置基於log/的生命週期規則的必要參數，其他參數保留預設配置。

      配置項	說明
      狀態	選中啟動。
      策略	選中按首碼匹配。
      前綴	輸入log/。
      檔案時間策略	選中指定天數。
      生命週期管理規則	下拉選擇最後一次訪問時間，輸入120天后，資料自動轉換成低頻訪問類型（資料被訪問後，依舊停留在低頻檔）。 下拉選擇最後一次訪問時間，輸入250天后，資料自動轉換成歸檔類型。

   3. 單擊確定。

僅Java SDK、Python SDK、Go SDK支援基於最後一次訪問時間建立生命週期規則。建立基於最後一次訪問時間的生命週期規則前，您需要為指定Bucket開啟訪問跟蹤功能。

1. 開啟訪問跟蹤。

   Java

   import com.aliyun.oss.*;
   import com.aliyun.oss.common.auth.*;
   import com.aliyun.oss.common.comm.SignVersion;
   import com.aliyun.oss.model.AccessMonitor;
   
   public class Demo {
   
       public static void main(String[] args) throws Exception {
           // Endpoint以華東1（杭州）為例，其它Region請按實際情況填寫。
           String endpoint = "https://oss-cn-hangzhou.aliyuncs.com";
           // 從環境變數中擷取訪問憑證。運行本程式碼範例之前，請確保已設定環境變數OSS_ACCESS_KEY_ID和OSS_ACCESS_KEY_SECRET。
           EnvironmentVariableCredentialsProvider credentialsProvider = CredentialsProviderFactory.newEnvironmentVariableCredentialsProvider();
           // 填寫Bucket名稱，例如examplebucket。
           String bucketName = "examplebucket";
   
           // 填寫Bucket所在地區。以華東1（杭州）為例，Region填寫為cn-hangzhou。
           String region = "cn-hangzhou";
   
           // 建立OSSClient執行個體。
           // 當OSSClient執行個體不再使用時，調用shutdown方法以釋放資源。
           ClientBuilderConfiguration clientBuilderConfiguration = new ClientBuilderConfiguration();
           clientBuilderConfiguration.setSignatureVersion(SignVersion.V4);        
           OSS ossClient = OSSClientBuilder.create()
           .endpoint(endpoint)
           .credentialsProvider(credentialsProvider)
           .clientConfiguration(clientBuilderConfiguration)
           .region(region)               
           .build();
   
           try {
               // 開啟Bucket的訪問跟蹤狀態。Bucket開啟訪問跟蹤狀態後，如果需要修改Bucket的訪問跟蹤狀態為Disabled，請確保Bucket不存在基於Last Access Time匹配規則的生命週期規則。
               ossClient.putBucketAccessMonitor(bucketName, AccessMonitor.AccessMonitorStatus.Enabled.toString());
           } catch (OSSException oe) {
               System.out.println("Caught an OSSException, which means your request made it to OSS, "
                       + "but was rejected with an error response for some reason.");
               System.out.println("Error Message:" + oe.getErrorMessage());
               System.out.println("Error Code:" + oe.getErrorCode());
               System.out.println("Request ID:" + oe.getRequestId());
               System.out.println("Host ID:" + oe.getHostId());
           } catch (ClientException ce) {
               System.out.println("Caught an ClientException, which means the client encountered "
                       + "a serious internal problem while trying to communicate with OSS, "
                       + "such as not being able to access the network.");
               System.out.println("Error Message:" + ce.getMessage());
           } finally {
               if (ossClient != null) {
                   ossClient.shutdown();
               }
           }
       }
   }

   Python

   # -*- coding: utf-8 -*-
   import oss2
   from oss2.credentials import EnvironmentVariableCredentialsProvider
   
   # 從環境變數中擷取訪問憑證。運行本程式碼範例之前，請確保已設定環境變數OSS_ACCESS_KEY_ID和OSS_ACCESS_KEY_SECRET。
   auth = oss2.ProviderAuthV4(EnvironmentVariableCredentialsProvider())
   
   # 填寫Bucket所在地區對應的Endpoint。以華東1（杭州）為例，Endpoint填寫為https://oss-cn-hangzhou.aliyuncs.com。
   endpoint = "https://oss-cn-hangzhou.aliyuncs.com"
   # 填寫Endpoint對應的Region資訊，例如cn-hangzhou。注意，v4簽名下，必須填寫該參數
   region = "cn-hangzhou"
   
   # examplebucket填寫儲存空間名稱。
   bucket = oss2.Bucket(auth, endpoint, "examplebucket", region=region)
   
   # 開啟Bucket的訪問跟蹤狀態。Bucket開啟訪問跟蹤狀態後，如果需要修改Bucket的訪問跟蹤狀態為Disabled，請確保Bucket不存在基於LastAccessTime匹配規則的生命週期規則。
   bucket.put_bucket_access_monitor("Enabled")

   Go

   package main
   
   import (
   	"context"
   	"flag"
   	"log"
   
   	"github.com/aliyun/alibabacloud-oss-go-sdk-v2/oss"
   	"github.com/aliyun/alibabacloud-oss-go-sdk-v2/oss/credentials"
   )
   
   // 定義全域變數
   var (
   	region     string // 儲存地區
   	bucketName string // 儲存空間名稱
   )
   
   // init函數用於初始化命令列參數
   func init() {
   	flag.StringVar(&region, "region", "", "The region in which the bucket is located.")
   	flag.StringVar(&bucketName, "bucket", "", "The name of the bucket.")
   }
   
   // 主函數，啟用儲存桶的訪問跟蹤
   func main() {
   	// 解析命令列參數
   	flag.Parse()
   
   	// 檢查bucket名稱是否為空白
   	if len(bucketName) == 0 {
   		flag.PrintDefaults()
   		log.Fatalf("invalid parameters, bucket name required")
   	}
   
   	// 檢查region是否為空白
   	if len(region) == 0 {
   		flag.PrintDefaults()
   		log.Fatalf("invalid parameters, region required")
   	}
   
   	// 載入預設配置並設定憑證提供者和地區
   	cfg := oss.LoadDefaultConfig().
   		WithCredentialsProvider(credentials.NewEnvironmentVariableCredentialsProvider()).
   		WithRegion(region)
   
   	// 建立OSS用戶端
   	client := oss.NewClient(cfg)
   
   	// 建立啟用儲存空間訪問跟蹤的請求
   	request := &oss.PutBucketAccessMonitorRequest{
   		Bucket: oss.Ptr(bucketName),
   		AccessMonitorConfiguration: &oss.AccessMonitorConfiguration{
   			Status: oss.AccessMonitorStatusEnabled, // 啟用訪問跟蹤
   		},
   	}
   
   	// 執行啟用儲存空間訪問跟蹤的操作
   	putResult, err := client.PutBucketAccessMonitor(context.TODO(), request)
   	if err != nil {
   		log.Fatalf("failed to put bucket access monitor %v", err)
   	}
   
   	// 列印啟用儲存空間訪問跟蹤的結果
   	log.Printf("put bucket access monitor result: %#v\n", putResult)
   }
   

2. 為首碼data/以及首碼log/配置基於最後一次訪問時間的生命週期規則。

   Java

   import com.aliyun.oss.ClientException;
   import com.aliyun.oss.OSS;
   import com.aliyun.oss.common.auth.*;
   import com.aliyun.oss.OSSClientBuilder;
   import com.aliyun.oss.OSSException;
   import com.aliyun.oss.model.*;
   import java.util.ArrayList;
   import java.util.List;
   
   public class Lifecycle {
   
       public static void main(String[] args) throws Exception {
           // Endpoint以華東1（杭州）為例，其它Region請按實際情況填寫。
           String endpoint = "https://oss-cn-hangzhou.aliyuncs.com";
           // 從環境變數中擷取訪問憑證。運行本程式碼範例之前，請確保已設定環境變數OSS_ACCESS_KEY_ID和OSS_ACCESS_KEY_SECRET。
           EnvironmentVariableCredentialsProvider credentialsProvider = CredentialsProviderFactory.newEnvironmentVariableCredentialsProvider();
           // 填寫Bucket名稱，例如examplebucket。
           String bucketName = "examplebucket";
   
           // 建立OSSClient執行個體。
           // 當OSSClient執行個體不再使用時，調用shutdown方法以釋放資源。
           OSS ossClient = new OSSClientBuilder().build(endpoint, credentialsProvider);
   
           try {
               String ruleId1 = "rule1";
               String ruleId2 = "rule2";
               // 指定首碼為data/。
               String matchPrefix = "data/";
               // 指定首碼為log/。
               String matchPrefix2 = "log/";
   
               SetBucketLifecycleRequest request = new SetBucketLifecycleRequest(bucketName);
   
               // 在生命週期規則1中指定首碼為data/的所有檔案在距離最後一次訪問時間200天后轉為低頻訪問類型。且再次訪問首碼為data/的檔案時，這些檔案仍保留為低頻訪問類型。
               List<LifecycleRule.StorageTransition> storageTransitions = new ArrayList<LifecycleRule.StorageTransition>();
               LifecycleRule.StorageTransition storageTransition = new LifecycleRule.StorageTransition();
               storageTransition.setStorageClass(StorageClass.IA);
               storageTransition.setExpirationDays(200);
               storageTransition.setIsAccessTime(true);
               storageTransition.setReturnToStdWhenVisit(false);
               storageTransitions.add(storageTransition);
   
               LifecycleRule rule = new LifecycleRule(ruleId1, matchPrefix, LifecycleRule.RuleStatus.Enabled);
               rule.setStorageTransition(storageTransitions);
               request.AddLifecycleRule(rule);
   
               // 在生命週期規則2中指定首碼為log/的所有檔案在距離最後一次訪問時間120天后轉為低頻訪問類型。且再次訪問首碼為log/的檔案時，這些檔案仍保留為低頻訪問類型。
               List<LifecycleRule.StorageTransition> storageTransitions2 = new ArrayList<LifecycleRule.StorageTransition>();
               LifecycleRule.StorageTransition storageTransition2 = new LifecycleRule.StorageTransition();
               storageTransition2.setStorageClass(StorageClass.IA);
               storageTransition2.setExpirationDays(120);
               storageTransition2.setIsAccessTime(true);
               storageTransition2.setReturnToStdWhenVisit(false);
               storageTransitions2.add(storageTransition2);
               // 同一規則中指定首碼為log/的所有檔案在距離最後一次訪問時間250天后轉為歸檔類型。
               LifecycleRule.StorageTransition storageTransition3 = new LifecycleRule.StorageTransition();
               storageTransition3.setStorageClass(StorageClass.Archive);
               storageTransition3.setExpirationDays(250);
               storageTransition3.setIsAccessTime(true);
               storageTransition3.setReturnToStdWhenVisit(false);
               storageTransitions2.add(storageTransition3);
   
               LifecycleRule rule2 = new LifecycleRule(ruleId2, matchPrefix2, LifecycleRule.RuleStatus.Enabled);
               rule2.setStorageTransition(storageTransitions2);
               request.AddLifecycleRule(rule2);
   
               VoidResult result = ossClient.setBucketLifecycle(request);
   
               System.out.println("返回狀態代碼："+result.getResponse().getStatusCode()+" set lifecycle succeed");
           } catch (OSSException oe) {
               System.out.println("Caught an OSSException, which means your request made it to OSS, "
                       + "but was rejected with an error response for some reason.");
               System.out.println("Error Message:" + oe.getErrorMessage());
               System.out.println("Error Code:" + oe.getErrorCode());
               System.out.println("Request ID:" + oe.getRequestId());
               System.out.println("Host ID:" + oe.getHostId());
           } catch (ClientException ce) {
               System.out.println("Caught an ClientException, which means the client encountered "
                       + "a serious internal problem while trying to communicate with OSS, "
                       + "such as not being able to access the network.");
               System.out.println("Error Message:" + ce.getMessage());
           } finally {
               if (ossClient != null) {
                   ossClient.shutdown();
               }
           }
       }
   }

   Python

   # -*- coding: utf-8 -*-
   import oss2
   from oss2.credentials import EnvironmentVariableCredentialsProvider
   from oss2.models import LifecycleRule, BucketLifecycle, StorageTransition
   
   # 從環境變數中擷取訪問憑證。運行本程式碼範例之前，請確保已設定環境變數OSS_ACCESS_KEY_ID和OSS_ACCESS_KEY_SECRET。
   auth = oss2.ProviderAuth(EnvironmentVariableCredentialsProvider())
   # yourEndpoint填寫Bucket所在地區對應的Endpoint。以華東1（杭州）為例，Endpoint填寫為https://oss-cn-hangzhou.aliyuncs.com。
   # 填寫Bucket名稱，例如examplebucket。
   bucket = oss2.Bucket(auth, 'https://oss-cn-hangzhou.aliyuncs.com', 'examplebucket')
   
   # 在生命週期規則1中指定首碼為data/的所有檔案在距離最後一次訪問時間200天后轉為低頻訪問類型。且再次訪問首碼為data/的檔案時，這些檔案仍保留為低頻訪問類型。
   rule1 = LifecycleRule('rule1', 'data/', status=LifecycleRule.ENABLED)
   rule1.storage_transitions = [StorageTransition(days=200,
                                                  storage_class=oss2.BUCKET_STORAGE_CLASS_IA,
                                                  is_access_time=True,
                                                  return_to_std_when_visit=False)]
   
   # 在生命週期規則2中指定首碼為log/的所有檔案在距離最後一次訪問時間120天后轉為低頻訪問類型。且再次訪問首碼為log/的檔案時，這些檔案仍保留為低頻訪問類型。
   # 同一規則中指定首碼為log/的所有檔案在距離最後一次訪問時間250天后轉為歸檔類型。
   rule2 = LifecycleRule('rule2', 'log/', status=LifecycleRule.ENABLED)
   rule2.storage_transitions = [StorageTransition(days=120,
                                                  storage_class=oss2.BUCKET_STORAGE_CLASS_IA,
                                                  is_access_time=True,
                                                  return_to_std_when_visit=False),
                                StorageTransition(days=250,
                                                  storage_class=oss2.BUCKET_STORAGE_CLASS_ARCHIVE,
                                                  is_access_time=True,
                                                  return_to_std_when_visit=False)]
   
   lifecycle = BucketLifecycle([rule1, rule2])
   
   # 設定生命週期規則。
   result = bucket.put_bucket_lifecycle(lifecycle)
   
   print('設定生命週期成功，返回狀態為：' + str(result.status))

   Go

   package main
   
   import (
   	"context"
   	"flag"
   	"log"
   
   	"github.com/aliyun/alibabacloud-oss-go-sdk-v2/oss"
   	"github.com/aliyun/alibabacloud-oss-go-sdk-v2/oss/credentials"
   )
   
   // 定義全域變數
   var (
   	region     string // 儲存地區
   	bucketName string // 儲存空間名稱
   )
   
   // init函數用於初始化命令列參數
   func init() {
   	flag.StringVar(&region, "region", "", "The region in which the bucket is located.")
   	flag.StringVar(&bucketName, "bucket", "", "The name of the bucket.")
   }
   
   func main() {
   	// 解析命令列參數
   	flag.Parse()
   
   	// 檢查bucket名稱是否為空白
   	if len(bucketName) == 0 {
   		flag.PrintDefaults()
   		log.Fatalf("invalid parameters, bucket name required")
   	}
   
   	// 檢查region是否為空白
   	if len(region) == 0 {
   		flag.PrintDefaults()
   		log.Fatalf("invalid parameters, region required")
   	}
   
   	// 載入預設配置並設定憑證提供者和地區
   	cfg := oss.LoadDefaultConfig().
   		WithCredentialsProvider(credentials.NewEnvironmentVariableCredentialsProvider()).
   		WithRegion(region)
   
   	// 建立OSS用戶端
   	client := oss.NewClient(cfg)
   
   	// 建立設定儲存空間生命週期規則的請求
   	request := &oss.PutBucketLifecycleRequest{
   		Bucket: oss.Ptr(bucketName), // 儲存空間名稱
   		LifecycleConfiguration: &oss.LifecycleConfiguration{
   			Rules: []oss.LifecycleRule{
   				{
   					// 在生命週期規則1中指定首碼為data/的所有檔案在距離最後一次訪問時間200天后轉為低頻訪問類型。且再次訪問首碼為data/的檔案時，這些檔案仍保留為低頻訪問類型
   					ID:     oss.Ptr("rule1"),
   					Status: oss.Ptr("Enabled"),
   					Prefix: oss.Ptr("data/"),
   					Transitions: []oss.LifecycleRuleTransition{
   						{
   							Days:                 oss.Ptr(int32(200)),
   							StorageClass:         oss.StorageClassIA,
   							IsAccessTime:         oss.Ptr(true), // 設定為true，基於最後一次訪問時間策略
   							ReturnToStdWhenVisit: oss.Ptr(false),
   						},
   					},
   				},
   				{
   					// 在生命週期規則2中指定首碼為log/的所有檔案在距離最後一次訪問時間120天后轉為低頻訪問類型。且再次訪問首碼為log/的檔案時，這些檔案仍保留為低頻訪問類型
   					// 同一規則中指定首碼為log/的所有檔案在距離最後一次訪問時間250天后轉為歸檔類型。
   					ID:     oss.Ptr("rule2"),
   					Status: oss.Ptr("Enabled"),
   					Prefix: oss.Ptr("log/"),
   					Transitions: []oss.LifecycleRuleTransition{
   						{
   							Days:                 oss.Ptr(int32(120)),
   							StorageClass:         oss.StorageClassIA,
   							IsAccessTime:         oss.Ptr(true), // 設定為true，基於最後一次訪問時間策略
   							ReturnToStdWhenVisit: oss.Ptr(false),
   						},
   						{
   							Days:                 oss.Ptr(int32(250)),
   							StorageClass:         oss.StorageClassArchive,
   							IsAccessTime:         oss.Ptr(true),
   							ReturnToStdWhenVisit: oss.Ptr(false),
   						},
   					},
   				},
   			},
   		},
   	}
   
   	// 執行設定儲存空間生命週期規則的操作
   	result, err := client.PutBucketLifecycle(context.TODO(), request)
   	if err != nil {
   		log.Fatalf("failed to put bucket lifecycle %v", err)
   	}
   
   	// 列印設定儲存空間生命週期規則的結果
   	log.Printf("put bucket lifecycle result:%#v\n", result)
   }
   

如果您的程式自訂要求較高，您可以直接發起REST API請求。直接發起REST API請求需要手動編寫代碼計算簽名。更多資訊，請參見PutBucketAccessMonitor和PutBucketLifecycle。