全部產品
Search
文件中心

Object Storage Service:轉換檔儲存類型

更新時間:Dec 04, 2024

OSS支援標準、低頻訪問、歸檔、冷歸檔、深度冷歸檔多種儲存類型,您可以通過生命週期規則或者CopyObject的方式隨時轉換檔(Object)的儲存類型。

警告

對開通了OSS-HDFS服務的Bucket,建議不要修改OSS-HDFS的資料存放區目錄.dlsdata/下任意Object的儲存類型。

如果您將.dlsdata/下任意Object的儲存類型修改為低頻類型時,通過OSS-HDFS可正常訪問資料。如果您將Object儲存類型修改為歸檔、冷歸檔、深度冷歸檔後,通過OSS-HDFS無法訪問資料。如需訪問,您需要對資料進行解凍操作,解凍完成後再嘗試訪問資料。

通過生命週期規則自動轉換Object的儲存類型

基於最後一次修改時間的儲存類型轉換

  • 本地備援儲存體(LRS)本地冗餘

    本地冗餘類型檔案轉換規則如下:

    • 標準儲存(LRS)類型可轉換為低頻訪問(LRS)、Archive Storage(LRS)、冷Archive Storage(LRS)或者深度冷Archive Storage(LRS)類型。

    • 低頻訪問(LRS)類型可轉換為Archive Storage(LRS)、冷Archive Storage(LRS)類型或者深度冷Archive Storage(LRS)類型。

    • Archive Storage(LRS)類型可轉換為冷Archive Storage(LRS)類型或者深度冷Archive Storage(LRS)類型。

    • 冷Archive Storage(LRS)類型可轉換為深度冷Archive Storage(LRS)類型。

    當Bucket同時配置了轉換為低頻訪問、轉換為Archive Storage、轉換為冷Archive Storage以及轉換為深度冷Archive Storage的策略,其轉換周期必須滿足以下條件:

    轉換為低頻訪問的周期<轉換為歸檔的周期<轉換為冷歸檔的周期<轉換為深度冷歸檔的周期

  • 同城冗餘儲存(ZRS)同城

    同城冗餘類型檔案轉換規則如下:

    • 標準儲存(ZRS)類型可轉換為低頻訪問(ZRS)類型、Archive Storage(ZRS)類型、冷Archive Storage(LRS)類型和深度冷Archive Storage(LRS)類型。

    • 低頻訪問(ZRS)類型可轉換為Archive Storage(ZRS)類型、冷Archive Storage(LRS)類型和深度冷Archive Storage(LRS)類型。

    • Archive Storage(ZRS)類型可轉換為冷Archive Storage(LRS)類型和深度冷Archive Storage(LRS)類型。

    • 冷Archive Storage(LRS)類型可轉換為深度冷Archive Storage(LRS)類型。

更多資訊,請參見基於最後一次修改時間的生命週期規則

基於最後一次訪問時間的儲存類型轉換

重要

如果您需要將Object從標準儲存或低頻訪問類型轉換為歸檔、冷歸檔或深度冷Archive Storage類型,請提交工單申請轉換為歸檔、冷歸檔或深度冷歸檔類型的許可權,申請通過後您需要指定轉換的目標儲存類型。

工單申請通過後,如果您基於最後一次訪問時間策略將Object從標準儲存或低頻訪問類型轉為歸檔、冷歸檔或深度冷歸檔類型,則Bucket中歸檔、冷歸檔或深度冷歸檔類型Object的最後一次訪問時間預設為該Bucket開啟訪問跟蹤的時間。

  • 本地備援儲存體(LRS)

    1.jpg

    本地冗餘類型檔案轉換規則如下:

    • 標準儲存(LRS)類型可轉換為低頻訪問(LRS)、Archive Storage(LRS)、冷Archive Storage(LRS)或者深度冷Archive Storage(LRS)類型。

    • 標準儲存(LRS)類型轉為低頻訪問(LRS)後,還可以選擇當Object被訪問後是否自動轉回標準儲存(LRS)類型。

    • 低頻訪問(LRS)類型可轉換為Archive Storage(LRS)、冷Archive Storage(LRS)類型或者深度冷Archive Storage(LRS)類型。

    • Archive Storage(LRS)類型可轉換為冷Archive Storage(LRS)類型或者深度冷Archive Storage(LRS)類型。

    • 冷Archive Storage(LRS)類型可轉換為深度冷Archive Storage(LRS)類型。

  • 同城冗餘儲存(ZRS)

    2.jpg

    同城冗餘類型檔案轉換規則如下:

    • 標準儲存(ZRS)類型可轉換為低頻訪問(ZRS)類型、Archive Storage(ZRS)類型、冷Archive Storage(LRS)類型和深度冷Archive Storage(LRS)類型。

    • 標準儲存(ZRS)類型轉為低頻訪問(ZRS)後,還可以選擇當Object被訪問後是否自動轉回標準儲存(ZRS)類型。

    • 低頻訪問(ZRS)類型可轉換為Archive Storage(ZRS)類型、冷Archive Storage(LRS)類型和深度冷Archive Storage(LRS)類型。

    • Archive Storage(ZRS)類型可轉換為冷Archive Storage(LRS)類型和深度冷Archive Storage(LRS)類型。

    • 冷Archive Storage(LRS)類型可轉換為深度冷Archive Storage(LRS)類型。

更多資訊,請參見基於最後一次訪問時間的生命週期規則

通過生命週期規則轉換儲存類型操作方式

您可以通過多種方式設定生命週期規則。生命週期規則可用於將多個Object在指定時間內轉儲為指定儲存類型,或者將到期的Object和片段刪除。您可以結合以下樣本按需選擇通過生命週期規則將Object轉儲為指定儲存類型。

使用OSS管理主控台

  1. 登入OSS管理主控台

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

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

  4. 可選:如果您需要建立基於最後一次訪問時間策略的生命週期規則,請在生命週期頁面,開啟啟用訪問跟蹤開關。

  5. 生命週期頁面,單擊創建規則

  6. 建立生命週期規則面板,按如下說明配置生命週期規則。

    • 儲存空間未開啟版本控制

      地區

      配置項

      說明

      基礎設定

      狀態

      設定生命週期規則的狀態,可選擇啟動禁用

      • 啟動生命週期規則後,將按照配置的生命週期規則轉換資料存放區類型或刪除資料。

      • 禁用生命週期規則後,將中斷生命週期任務。

      策略

      選擇生命週期規則作用的Object。您可以選擇按首碼匹配設定到整個Bucket

      說明

      選擇按首碼匹配時,需要填寫首碼的完整路徑。例如,您希望僅作用於src/dir1下的所有檔案,則首碼需要填寫為src/dir1,僅填寫dir1則不生效。

      是否允許首碼重疊

      OSS預設會檢查各個生命週期規則的首碼是否重疊。例如,您設定了以下兩條包含重疊首碼的生命週期規則:

      • 規則1

        指定該Bucket內所有首碼為dir1/的Object在距離最後一次修改時間180天后刪除。

      • 規則2

        指定該Bucket內所有首碼為dir1/dir2/的Object在距離最後一次修改時間30天后轉低頻訪問類型,60天后刪除。

      在配置規則2時未選中該選項的情況下,因後台檢測到dir1/dir2/目錄下的Object同時匹配兩條刪除規則,因此會拒絕設定規則2,並報錯Overlap for same action type Expiration.

      在配置規則2時選中該選項的情況下,dir1/dir2/下的Object會在30天后轉低頻訪問類型,60天后刪除。dir1/下的其他Object會在180天刪除。

      說明

      如果配置了多條規則,且其中一條為基於整個Bucket的規則時,會被視為首碼重疊的情況。

      前綴

      輸入規則要匹配的Object名稱的首碼。

      • 首碼設定為img,表示匹配名稱以img開頭的所有Object,例如imgtest.png、img/example.jpg等。

      • 首碼設定為img/,表示匹配名稱以img/開頭的所有Object,例如img/example.jpg、img/test.jpg等。

      標籤

      生命週期規則僅針對擁有指定標籤Object生效。

      • 如果沒有設定首碼,只設定了標籤,且標籤的key為a,value為1。則該規則將匹配Bucket內所有標籤為a=1的Object。

      • 如果設定了首碼,首碼設定為img,同時設定了標籤,標籤的key為a,value為1,則該規則將匹配Bucket內所有名稱以img開頭,標籤為a=1的Object。

      更多資訊,請參見對象標籤

      NOT

      NOT選項用於設定生命週期規則對指定首碼和標籤的Object不生效。

      重要
      • 開啟NOT選項時,首碼和標籤必須至少存在一項,即同時設定首碼和標籤或者只設定首碼或標籤。

      • NOT語義定義標籤中的key不支援與標籤配置項中定義的key相同。

      • 開啟NOT選項後,不支援設定片段到期策略。

      文件大小

      指定生命週期規則生效的檔案大小。

      • 指定最小檔案:生命週期規則對大於該值的檔案大小生效。取值大於0 B,小於5 TB。

      • 指定最大檔案:生命週期規則對小於該值的檔案大小生效。取值大於0 B,小於等於5 TB。

      重要

      如果在同一條生命週期中,同時配置了指定最小檔案和指定最大檔案:

      • 確保指定最大檔案的值大於指定最小檔案的值。

      • 不支援配置片段執行策略。

      • 不支援配置清除刪除標記策略。

      檔案執行原則設定

      檔案時間策略

      選擇Object到期策略,可選擇指定天數指定日期不啟用。選擇不啟用時,檔案到期策略不生效。

      生命週期管理規則

      配置轉換Object儲存類型或者刪除到期Object的規則,可選擇低頻訪問Archive Storage冷Archive Storage深度冷Archive Storage資料刪除

      例如,當您將檔案時間策略設定為指定日期,並將日期設定為2023年9月24日,則最後一次修改時間在2023年9月24日之前的Object會被自動刪除,且刪除後不可恢複。

      片段執行原則設定

      碎片過期策略

      配置片段執行策略。如果選中了標籤,則無法配置該選項。您可以選擇按指定天數指定日期執行片段到期策略,也可以選擇不啟用片段到期策略。當選擇不啟用時,片段到期策略不生效。

      重要

      生命週期規則至少包含檔案到期策略或片段到期策略。

      片段規則

      根據片段到期策略選擇的到期天數或到期日期設定片段何時到期,片段到期後會被自動刪除,且刪除後不可恢複。

    • 儲存空間已開啟版本控制

      開啟版本控制後,基礎設定片段執行原則設定地區涉及的配置項,與未開啟版本控制的配置方法相同。以下表格僅介紹與未開啟版本控制相比,開啟版本控制後配置項存在的差異。

      地區

      配置項

      說明

      目前的版本檔案執行原則設定

      清理對象刪除標記

      開啟版本控制後,清除策略中增加了清理對象刪除標記選項,其他選項與未開啟版本控制時相同。

      選擇此選項後,如果當前Object僅有一個版本且為刪除標記時,則OSS將刪除到期Object的刪除標記。如果當前Object有多個版本,且Object的最新版本為刪除標記時,則OSS將保留該刪除標記。關於刪除標記的更多資訊,請參見刪除標記

      重要

      當有歷史版本存在時,該規則不會清理對象刪除標記。因此建議及時清理對象刪除標記和非必要的歷史版本,否則Bucket內因儲存過多的刪除標記,導致List效能下降。

      歷史版本檔案執行原則設定

      檔案時間策略

      設定歷史版本檔案的到期策略,可選擇指定天數不啟用。當選擇不啟用時,檔案到期策略不生效。

      生命週期管理規則

      設定一個到期天數N,歷史版本的Object會在其被轉換為歷史版本的N天后到期,並在到期的第二天執行指定操作。例如設定為30,則在2023年09月01日被轉為歷史版本的Object會在2023年10月01日被轉換為指定儲存類型或被刪除。

      重要

      您可以通過Object下一個版本的最後一次修改時間確定 Object被轉為歷史版本的時間。

  7. 單擊確定

    生命週期規則儲存成功後,您可以在策略列表中查看已設定的生命週期規則。

使用阿里雲SDK

以下僅列舉常見SDK的配置生命週期規則的程式碼範例。關於其他SDK的配置生命週期規則的程式碼範例,請參見簡介

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.common.utils.DateUtil;
import com.aliyun.oss.model.LifecycleRule;
import com.aliyun.oss.model.SetBucketLifecycleRequest;
import com.aliyun.oss.model.StorageClass;
import java.util.ArrayList;
import java.util.HashMap;
import java.util.List;
import java.util.Map;

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執行個體。
        ClientBuilderConfiguration clientBuilderConfiguration = new ClientBuilderConfiguration();
        clientBuilderConfiguration.setSignatureVersion(SignVersion.V4);        
        OSS ossClient = OSSClientBuilder.create()
        .endpoint(endpoint)
        .credentialsProvider(credentialsProvider)
        .clientConfiguration(clientBuilderConfiguration)
        .region(region)               
        .build();

        try {
            // 建立SetBucketLifecycleRequest。
            SetBucketLifecycleRequest request = new SetBucketLifecycleRequest(bucketName);

            // 設定規則ID。
            String ruleId0 = "rule0";
            // 設定檔案匹配首碼。
            String matchPrefix0 = "A0/";
            // 設定要匹配的標籤。
            Map<String, String> matchTags0 = new HashMap<String, String>();
            // 依次填寫要匹配標籤的鍵(例如owner)和值(例如John)。
            matchTags0.put("owner", "John");


            String ruleId1 = "rule1";
            String matchPrefix1 = "A1/";
            Map<String, String> matchTags1 = new HashMap<String, String>();
            matchTags1.put("type", "document");

            String ruleId2 = "rule2";
            String matchPrefix2 = "A2/";

            String ruleId3 = "rule3";
            String matchPrefix3 = "A3/";

            String ruleId4 = "rule4";
            String matchPrefix4 = "A4/";

            String ruleId5 = "rule5";
            String matchPrefix5 = "A5/";

            String ruleId6 = "rule6";
            String matchPrefix6 = "A6/";

            // 距最後修改時間3天后到期。
            LifecycleRule rule = new LifecycleRule(ruleId0, matchPrefix0, LifecycleRule.RuleStatus.Enabled, 3);
            rule.setTags(matchTags0);
            request.AddLifecycleRule(rule);

            // 指定日期之前建立的檔案到期。
            rule = new LifecycleRule(ruleId1, matchPrefix1, LifecycleRule.RuleStatus.Enabled);
            rule.setCreatedBeforeDate(DateUtil.parseIso8601Date("2022-10-12T00:00:00.000Z"));
            rule.setTags(matchTags1);
            request.AddLifecycleRule(rule);

            // 分區3天后到期。
            rule = new LifecycleRule(ruleId2, matchPrefix2, LifecycleRule.RuleStatus.Enabled);
            LifecycleRule.AbortMultipartUpload abortMultipartUpload = new LifecycleRule.AbortMultipartUpload();
            abortMultipartUpload.setExpirationDays(3);
            rule.setAbortMultipartUpload(abortMultipartUpload);
            request.AddLifecycleRule(rule);

            // 指定日期之前的分區到期。
            rule = new LifecycleRule(ruleId3, matchPrefix3, LifecycleRule.RuleStatus.Enabled);
            abortMultipartUpload = new LifecycleRule.AbortMultipartUpload();
            abortMultipartUpload.setCreatedBeforeDate(DateUtil.parseIso8601Date("2022-10-12T00:00:00.000Z"));
            rule.setAbortMultipartUpload(abortMultipartUpload);
            request.AddLifecycleRule(rule);

            // 距最後修改時間10天后轉低頻訪問儲存類型,距最後修改時間30天后轉Archive Storage類型。
            rule = new LifecycleRule(ruleId4, matchPrefix4, LifecycleRule.RuleStatus.Enabled);
            List<LifecycleRule.StorageTransition> storageTransitions = new ArrayList<LifecycleRule.StorageTransition>();
            LifecycleRule.StorageTransition storageTransition = new LifecycleRule.StorageTransition();
            storageTransition.setStorageClass(StorageClass.IA);
            storageTransition.setExpirationDays(10);
            storageTransitions.add(storageTransition);
            storageTransition = new LifecycleRule.StorageTransition();
            storageTransition.setStorageClass(StorageClass.Archive);
            storageTransition.setExpirationDays(30);
            storageTransitions.add(storageTransition);
            rule.setStorageTransition(storageTransitions);
            request.AddLifecycleRule(rule);

            // 指定最後修改日期在2022年10月12日之前的檔案轉為Archive Storage。
            rule = new LifecycleRule(ruleId5, matchPrefix5, LifecycleRule.RuleStatus.Enabled);
            storageTransitions = new ArrayList<LifecycleRule.StorageTransition>();
            storageTransition = new LifecycleRule.StorageTransition();

            storageTransition.setCreatedBeforeDate(DateUtil.parseIso8601Date("2022-10-12T00:00:00.000Z"));

            storageTransition.setStorageClass(StorageClass.Archive);
            storageTransitions.add(storageTransition);
            rule.setStorageTransition(storageTransitions);
            request.AddLifecycleRule(rule);

            // rule6針對版本控制狀態下的Bucket。
            rule = new LifecycleRule(ruleId6, matchPrefix6, LifecycleRule.RuleStatus.Enabled);
            // 設定Object相對最後修改時間365天之後自動轉為歸檔檔案。
            storageTransitions = new ArrayList<LifecycleRule.StorageTransition>();
            storageTransition = new LifecycleRule.StorageTransition();
            storageTransition.setStorageClass(StorageClass.Archive);
            storageTransition.setExpirationDays(365);
            storageTransitions.add(storageTransition);
            rule.setStorageTransition(storageTransitions);
            // 設定自動移除到期刪除標記。
            rule.setExpiredDeleteMarker(true);
            // 設定非目前的版本的object距最後修改時間10天之後轉為低頻訪問類型。
            LifecycleRule.NoncurrentVersionStorageTransition noncurrentVersionStorageTransition =
                    new LifecycleRule.NoncurrentVersionStorageTransition().withNoncurrentDays(10).withStrorageClass(StorageClass.IA);
            // 設定非目前的版本的Object距最後修改時間20天之後轉為歸檔類型。
            LifecycleRule.NoncurrentVersionStorageTransition noncurrentVersionStorageTransition2 =
                    new LifecycleRule.NoncurrentVersionStorageTransition().withNoncurrentDays(20).withStrorageClass(StorageClass.Archive);
            // 設定非目前的版本Object 30天后刪除。
            LifecycleRule.NoncurrentVersionExpiration noncurrentVersionExpiration = new LifecycleRule.NoncurrentVersionExpiration().withNoncurrentDays(30);
            List<LifecycleRule.NoncurrentVersionStorageTransition> noncurrentVersionStorageTransitions = new ArrayList<LifecycleRule.NoncurrentVersionStorageTransition>();
            noncurrentVersionStorageTransitions.add(noncurrentVersionStorageTransition2);
            rule.setStorageTransition(storageTransitions);
            rule.setNoncurrentVersionExpiration(noncurrentVersionExpiration);
            rule.setNoncurrentVersionStorageTransitions(noncurrentVersionStorageTransitions);
            request.AddLifecycleRule(rule);

            // 發起設定生命週期規則請求。
            ossClient.setBucketLifecycle(request);

            // 查看生命週期規則。
            List<LifecycleRule> listRules = ossClient.getBucketLifecycle(bucketName);
            for(LifecycleRule rules : listRules){
                System.out.println("ruleId="+rules.getId()+", matchPrefix="+rules.getPrefix());
            }
        } 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();
            }
        }
    }
}

PHP

<?php
if (is_file(__DIR__ . '/../autoload.php')) {
    require_once __DIR__ . '/../autoload.php';
}
if (is_file(__DIR__ . '/../vendor/autoload.php')) {
    require_once __DIR__ . '/../vendor/autoload.php';
}

use OSS\Credentials\EnvironmentVariableCredentialsProvider;
use OSS\OssClient;
use OSS\CoreOssException;
use OSS\Model\LifecycleConfig;
use OSS\Model\LifecycleRule;
use OSS\Model\LifecycleAction;

// 從環境變數中擷取訪問憑證。運行本程式碼範例之前,請確保已設定環境變數OSS_ACCESS_KEY_ID和OSS_ACCESS_KEY_SECRET。
$provider = new EnvironmentVariableCredentialsProvider();
// Endpoint以華東1(杭州)為例,其它Region請按實際情況填寫。
$endpoint = "https://oss-cn-hangzhou.aliyuncs.com";
// 填寫儲存空間名稱。
$bucket= "examplebucket";

// 設定規則ID和檔案首碼。
$ruleId0 = "rule0";
$matchPrefix0 = "A0/";
$ruleId1 = "rule1";
$matchPrefix1 = "A1/";

$lifecycleConfig = new LifecycleConfig();
$actions = array();
// 距最後修改時間3天后到期。
$actions[] = new LifecycleAction(OssClient::OSS_LIFECYCLE_EXPIRATION, OssClient::OSS_LIFECYCLE_TIMING_DAYS, 3);
$lifecycleRule = new LifecycleRule($ruleId0, $matchPrefix0, "Enabled", $actions);
$lifecycleConfig->addRule($lifecycleRule);
$actions = array();
// 指定日期之前建立的檔案到期。
$actions[] = new LifecycleAction(OssClient::OSS_LIFECYCLE_EXPIRATION, OssClient::OSS_LIFECYCLE_TIMING_DATE, '2022-10-12T00:00:00.000Z');
$lifecycleRule = new LifecycleRule($ruleId1, $matchPrefix1, "Enabled", $actions);
$lifecycleConfig->addRule($lifecycleRule);
try {
    $config = array(
        "provider" => $provider,
        "endpoint" => $endpoint,
        "signatureVersion" => OssClient::OSS_SIGNATURE_VERSION_V4,
        "region"=> "cn-hangzhou"
    );
    $ossClient = new OssClient($config);

    $ossClient->putBucketLifecycle($bucket, $lifecycleConfig);
} catch (OssException $e) {
    printf(__FUNCTION__ . ": FAILED\n");
    printf($e->getMessage() . "\n");
    return;
}
print(__FUNCTION__ . ": OK" . "\n");

Node.js

const OSS = require('ali-oss')

const client = new OSS({
  // yourregion填寫Bucket所在地區。以華東1(杭州)為例,Region填寫為oss-cn-hangzhou。
  region: 'yourregion',
  // 從環境變數中擷取訪問憑證。運行本程式碼範例之前,請確保已設定環境變數OSS_ACCESS_KEY_ID和OSS_ACCESS_KEY_SECRET。
  accessKeyId: process.env.OSS_ACCESS_KEY_ID,
  accessKeySecret: process.env.OSS_ACCESS_KEY_SECRET,
  authorizationV4: true,
  // 填寫儲存空間名稱。
  bucket: 'yourbucketname'
});

async function getBucketLifecycle () {
  try {
    const result = await client.getBucketLifecycle('Yourbucketname');
    console.log(result.rules); // 擷取生命週期規則。

    rules.forEach(rule => {
      console.log(rule.id) //  查看生命週期規則ID。 
      console.log(rule.status) // 查看生命週期規則狀態。
      console.log(rule.tags) // 查看生命週期規則標籤。
      console.log(rule.expiration.days) // 查看到期天數規則。
      console.log(rule.expiration.createdBeforeDate) // 查看到期日期規則。
      // 查看到期分區規則。
      console.log(rule.abortMultipartUpload.days || rule.abortMultipartUpload.createdBeforeDate)
      // 查看儲存類型轉換規則。
      console.log(rule.transition.days || rule.transition.createdBeforeDate) // 查看儲存類型轉換時間。
      console.log(rule.transition.storageClass) // 轉換儲存類型。
      // 查看是否自動刪除到期刪除標記。
      console.log(rule.transition.expiredObjectDeleteMarker)
      // 查看非目前的版本Object儲存類型轉換規則。
      console.log(rule.noncurrentVersionTransition.noncurrentDays) // 查看非目前的版本Object儲存類型轉換時間。
      console.log(rule.noncurrentVersionTransition.storageClass) // 查看非目前的版本Object轉換的儲存類型。
    })
  } catch (e) {
    console.log(e);
  }
}
getBucketLifecycle();

Python

# -*- coding: utf-8 -*-
import oss2
from oss2.credentials import EnvironmentVariableCredentialsProvider
import datetime
from oss2.models import (LifecycleExpiration, LifecycleRule,
                        BucketLifecycle, AbortMultipartUpload,
                        TaggingRule, Tagging, StorageTransition,
                        NoncurrentVersionStorageTransition,
                        NoncurrentVersionExpiration)

# 從環境變數中擷取訪問憑證。運行本程式碼範例之前,請確保已設定環境變數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)

# 設定Object距其最後修改時間3天后到期。
rule1 = LifecycleRule('rule1', 'tests/',
                      status=LifecycleRule.ENABLED,
                      expiration=LifecycleExpiration(days=3))

# 設定Object到期規則,指定日期之前建立的檔案到期。
rule2 = LifecycleRule('rule2', 'tests2/',
                      status=LifecycleRule.ENABLED,
expiration = LifecycleExpiration(created_before_date=datetime.date(2023, 12, 12)))

# 設定分區到期規則,分區3天后到期。
rule3 = LifecycleRule('rule3', 'tests3/',
                      status=LifecycleRule.ENABLED,
            abort_multipart_upload=AbortMultipartUpload(days=3))

# 設定分區到期規則,指定日期之前的分區到期。
rule4 = LifecycleRule('rule4', 'tests4/',
                      status=LifecycleRule.ENABLED,
                      abort_multipart_upload = AbortMultipartUpload(created_before_date=datetime.date(2022, 12, 12)))

# 設定儲存類型轉換規則,指定Object在其最後修改時間20天之後轉為低頻訪問類型,在其最後修改時間30天之後轉為歸檔類型。
rule5 = LifecycleRule('rule5', 'tests5/',
                      status=LifecycleRule.ENABLED,
                      storage_transitions=[StorageTransition(days=20,storage_class=oss2.BUCKET_STORAGE_CLASS_IA),
                            StorageTransition(days=30,storage_class=oss2.BUCKET_STORAGE_CLASS_ARCHIVE)])

# 設定匹配的標籤。
tagging_rule = TaggingRule()
tagging_rule.add('key1', 'value1')
tagging_rule.add('key2', 'value2')
tagging = Tagging(tagging_rule)

# 設定儲存類型轉換規則,指定Object在其最後修改時間超過365天后轉為ARCHIVE類型。 
# rule6與以上幾個規則不同的是它指定了匹配的標籤,同時擁有key1=value1,key2=value2兩個標籤的object才會匹配此規則。
rule6 = LifecycleRule('rule6', 'tests6/',
                      status=LifecycleRule.ENABLED,
                      storage_transitions=[StorageTransition(created_before_date=datetime.date(2022, 12, 12),storage_class=oss2.BUCKET_STORAGE_CLASS_IA)],
                      tagging = tagging)

# rule7針對版本控制狀態下的Bucket。
# 設定Object在其最後修改時間365天之後自動轉為ARCHIVE類型。
# 設定自動移除到期刪除標記。
# 設定非目前的版本Object 12天后轉為IA類型。
# 設定非目前的版本Object 20天后轉為ARCHIVE類型。
# 設定非目前的版本Object 30天后刪除。
rule7 = LifecycleRule('rule7', 'tests7/',
              status=LifecycleRule.ENABLED,
              storage_transitions=[StorageTransition(days=365, storage_class=oss2.BUCKET_STORAGE_CLASS_ARCHIVE)],
              expiration=LifecycleExpiration(expired_detete_marker=True),
              noncurrent_version_sotrage_transitions =
                    [NoncurrentVersionStorageTransition(12, oss2.BUCKET_STORAGE_CLASS_IA),
                     NoncurrentVersionStorageTransition(20, oss2.BUCKET_STORAGE_CLASS_ARCHIVE)],
              noncurrent_version_expiration = NoncurrentVersionExpiration(30))

lifecycle = BucketLifecycle([rule1, rule2, rule3, rule4, rule5, rule6, rule7])

bucket.put_bucket_lifecycle(lifecycle)

C#

using Aliyun.OSS;
using Aliyun.OSS.Common;
// 填寫Bucket所在地區對應的Endpoint。以華東1(杭州)為例,Endpoint填寫為https://oss-cn-hangzhou.aliyuncs.com。
var endpoint = "https://oss-cn-hangzhou.aliyuncs.com";
// 從環境變數中擷取訪問憑證。運行本程式碼範例之前,請確保已設定環境變數OSS_ACCESS_KEY_ID和OSS_ACCESS_KEY_SECRET。
var accessKeyId = Environment.GetEnvironmentVariable("OSS_ACCESS_KEY_ID");
var accessKeySecret = Environment.GetEnvironmentVariable("OSS_ACCESS_KEY_SECRET");
// 填寫Bucket名稱,例如examplebucket。
var bucketName = "examplebucket";
// 填寫Bucket所在地區對應的Region。以華東1(杭州)為例,Region填寫為cn-hangzhou。
const string region = "cn-hangzhou";

// 建立ClientConfiguration執行個體,按照您的需要修改預設參數。
var conf = new ClientConfiguration();

// 設定v4簽名。
conf.SignatureVersion = SignatureVersion.V4;

// 建立OssClient執行個體。
var client = new OssClient(endpoint, accessKeyId, accessKeySecret, conf);
c.SetRegion(region);
try
{
    var setBucketLifecycleRequest = new SetBucketLifecycleRequest(bucketName);
    // 建立第1條生命週期規則。
    LifecycleRule lcr1 = new LifecycleRule()
    {
        ID = "delete obsoleted files",
        Prefix = "obsoleted/",
        Status = RuleStatus.Enabled,
        ExpriationDays = 3,
        Tags = new Tag[1]
    };
    // 設定標籤。
    var tag1 = new Tag
    {
        Key = "project",
        Value = "projectone"
    };

    lcr1.Tags[0] = tag1;

    // 建立第2條生命週期規則。
    LifecycleRule lcr2 = new LifecycleRule()
    {
        ID = "delete temporary files",
        Prefix = "temporary/",
        Status = RuleStatus.Enabled,
        ExpriationDays = 20,
        Tags = new Tag[1]         
    };
    // 設定標籤。
    var tag2 = new Tag
    {
        Key = "user",
        Value = "jsmith"
    };
    lcr2.Tags[0] = tag2;

    // 設定片段在距最後修改時間30天后到期。
    lcr2.AbortMultipartUpload = new LifecycleRule.LifeCycleExpiration()
    {
        Days = 30
    };

    LifecycleRule lcr3 = new LifecycleRule();
    lcr3.ID = "only NoncurrentVersionTransition";
    lcr3.Prefix = "test1";
    lcr3.Status = RuleStatus.Enabled;
    lcr3.NoncurrentVersionTransitions = new LifecycleRule.LifeCycleNoncurrentVersionTransition[2]
    {
        // 設定非目前的版本的Object距最後修改時間90天之後轉為低頻訪問類型。
        new LifecycleRule.LifeCycleNoncurrentVersionTransition(){
            StorageClass = StorageClass.IA,
            NoncurrentDays = 90
        },
        // 設定非目前的版本的Object距最後修改時間180天之後轉為歸檔類型。
        new LifecycleRule.LifeCycleNoncurrentVersionTransition(){
            StorageClass = StorageClass.Archive,
            NoncurrentDays = 180
        }
    };
    setBucketLifecycleRequest.AddLifecycleRule(lcr1);
    setBucketLifecycleRequest.AddLifecycleRule(lcr2);
    setBucketLifecycleRequest.AddLifecycleRule(lcr3);

    // 設定生命週期規則。
    client.SetBucketLifecycle(setBucketLifecycleRequest);
    Console.WriteLine("Set bucket:{0} Lifecycle succeeded ", bucketName);
}
catch (OssException ex)
{
    Console.WriteLine("Failed with error code: {0}; Error info: {1}. \nRequestID:{2}\tHostID:{3}",
        ex.ErrorCode, ex.Message, ex.RequestId, ex.HostId);
}
catch (Exception ex)
{
    Console.WriteLine("Failed with error info: {0}", ex.Message);
}

Android-Java

PutBucketLifecycleRequest request = new PutBucketLifecycleRequest();
request.setBucketName("examplebucket");

BucketLifecycleRule rule1 = new BucketLifecycleRule();
// 設定規則ID和檔案首碼。
rule1.setIdentifier("1");
rule1.setPrefix("A");
// 設定是否執行生命週期規則。如果值為true,則OSS會定期執行該規則;如果值為false,則OSS會忽略該規則。
rule1.setStatus(true);
// 距最後修改時間200天后到期。
rule1.setDays("200");
// 30天后自動轉為Archive Storage類型(Archive)
rule1.setArchiveDays("30");
// 未完成分區3天后到期。
rule1.setMultipartDays("3");
// 15天后自動轉為低頻儲存類型(IA)。
rule1.setIADays("15");

BucketLifecycleRule rule2 = new BucketLifecycleRule();
rule2.setIdentifier("2");
rule2.setPrefix("B");
rule2.setStatus(true);
rule2.setDays("300");
rule2.setArchiveDays("30");
rule2.setMultipartDays("3");
rule2.setIADays("15");

ArrayList<BucketLifecycleRule> lifecycleRules = new ArrayList<BucketLifecycleRule>();
lifecycleRules.add(rule1);
lifecycleRules.add(rule2);
request.setLifecycleRules(lifecycleRules);
OSSAsyncTask task = oss.asyncPutBucketLifecycle(request, new OSSCompletedCallback<PutBucketLifecycleRequest, PutBucketLifecycleResult>() {
    @Override
    public void onSuccess(PutBucketLifecycleRequest request, PutBucketLifecycleResult result) {
        OSSLog.logInfo("code::"+result.getStatusCode());

    }

    @Override
    public void onFailure(PutBucketLifecycleRequest request, ClientException clientException, ServiceException serviceException) {
        OSSLog.logError("error: "+serviceException.getRawMessage());

    }
});

task.waitUntilFinished();

Go

package main

import (
	"fmt"
	"os"

	"github.com/aliyun/aliyun-oss-go-sdk/oss"
)

func main() {
	// 從環境變數中擷取訪問憑證。運行本程式碼範例之前,請確保已設定環境變數OSS_ACCESS_KEY_ID和OSS_ACCESS_KEY_SECRET。
	provider, err := oss.NewEnvironmentVariableCredentialsProvider()
	if err != nil {
		fmt.Println("Error:", err)
		os.Exit(-1)
	}
	// 建立OSSClient執行個體。
	// yourEndpoint填寫Bucket對應的Endpoint,以華東1(杭州)為例,填寫為https://oss-cn-hangzhou.aliyuncs.com。其它Region請按實際情況填寫。
	// yourRegion填寫Bucket所在地區,以華東1(杭州)為例,填寫為cn-hangzhou。其它Region請按實際情況填寫。
	clientOptions := []oss.ClientOption{oss.SetCredentialsProvider(&provider)}
	clientOptions = append(clientOptions, oss.Region("yourRegion"))
	// 設定簽名版本
	clientOptions = append(clientOptions, oss.AuthVersion(oss.AuthV4))
	client, err := oss.New("yourEndpoint", "", "", clientOptions...)
	if err != nil {
		fmt.Println("Error:", err)
		os.Exit(-1)
	}
	// 填寫儲存空間名稱。
	bucketName := "examplebucket"
	// 指定生命週期規則1,並在規則中指定首碼為foo的檔案在距離最後一次修改時間3天后到期。
	rule1 := oss.BuildLifecycleRuleByDays("rule1", "foo/", true, 3)

	// 在受版本控制狀態下的Object僅有刪除標記的情況下,自動刪除刪除標記。
	deleteMark := true
	expiration := oss.LifecycleExpiration{
		ExpiredObjectDeleteMarker: &deleteMark,
	}

	// 非目前的版本Object超過30天后到期刪除。
	versionExpiration := oss.LifecycleVersionExpiration{
		NoncurrentDays: 30,
	}

	// 非目前的版本Object超過10天后轉為IA儲存類型。
	versionTransition := oss.LifecycleVersionTransition{
		NoncurrentDays: 10,
		StorageClass:   "IA",
	}

	// 指定生命週期規則2。
	rule2 := oss.LifecycleRule{
		ID:                   "rule2",
		Prefix:               "yourObjectPrefix",
		Status:               "Enabled",
		Expiration:           &expiration,
		NonVersionExpiration: &versionExpiration,
		NonVersionTransitions: []oss.LifecycleVersionTransition{
			versionTransition,
		},
	}

	// 指定生命週期規則3,對標籤鍵為tag1、標籤值為value1的檔案,距檔案最後一次修改時間3天后到期。
	rule3 := oss.LifecycleRule{
		ID:     "rule3",
		Prefix: "",
		Status: "Enabled",
		Tags: []oss.Tag{
			oss.Tag{
				Key:   "tag1",
				Value: "value1",
			},
		},
		Expiration: &oss.LifecycleExpiration{Days: 3},
	}

	// 設定生命週期規則。
	rules := []oss.LifecycleRule{rule1, rule2, rule3}
	err = client.SetBucketLifecycle(bucketName, rules)
	if err != nil {
		fmt.Println("Error:", err)
		os.Exit(-1)
	}
}

C++

#include <alibabacloud/oss/OssClient.h>
using namespace AlibabaCloud::OSS;

int main(void)
{
    /*初始化OSS帳號資訊。*/
    
    /* yourEndpoint填寫Bucket所在地區對應的Endpoint。以華東1(杭州)為例,Endpoint填寫為https://oss-cn-hangzhou.aliyuncs.com。*/
    std::string Endpoint = "yourEndpoint";
    /* yourRegion填寫Bucket所在地區對應的Region。以華東1(杭州)為例,Region填寫為cn-hangzhou。*/
    std::string Region = "yourRegion";
    /*填寫Bucket名稱,例如examplebucket。*/
    std::string BucketName = "examplebucket";

    /*初始化網路等資源。*/
    InitializeSdk();

    ClientConfiguration conf;
    conf.signatureVersion = SignatureVersionType::V4;
    /* 從環境變數中擷取訪問憑證。運行本程式碼範例之前,請確保已設定環境變數OSS_ACCESS_KEY_ID和OSS_ACCESS_KEY_SECRET。*/
    auto credentialsProvider = std::make_shared<EnvironmentVariableCredentialsProvider>();
    OssClient client(Endpoint, credentialsProvider, conf);
    client.SetRegion(Region);

    SetBucketLifecycleRequest request(BucketName);
    std::string date("2022-10-12T00:00:00.000Z");

    /*設定標籤。*/
    Tagging tagging;
    tagging.addTag(Tag("key1", "value1"));
    tagging.addTag(Tag("key2", "value2"));

    /*指定生命週期規則。*/
    auto rule1 = LifecycleRule();
    rule1.setID("rule1");
    rule1.setPrefix("test1/");
    rule1.setStatus(RuleStatus::Enabled);
    rule1.setExpiration(3);
    rule1.setTags(tagging.Tags());

    /*指定到期時間。*/
    auto rule2 = LifecycleRule();
    rule2.setID("rule2");
    rule2.setPrefix("test2/");
    rule2.setStatus(RuleStatus::Disabled);
    rule2.setExpiration(date);

    /*rule3為針對版本控制狀態下的Bucket的生命週期規則。*/
    auto rule3 = LifecycleRule();
    rule3.setID("rule3");
    rule3.setPrefix("test3/");
    rule3.setStatus(RuleStatus::Disabled);

    /*設定Object距其最後修改時間365天之後自動轉為歸檔類型。*/  
    auto transition = LifeCycleTransition();  
    transition.Expiration().setDays(365);
    transition.setStorageClass(StorageClass::Archive);
    rule3.addTransition(transition);

    /*設定自動移除到期刪除標記。*/
    rule3.setExpiredObjectDeleteMarker(true);

    /*設定非目前的版本的Object距最後修改時間10天之後轉為低頻訪問類型。*/
    auto transition1 = LifeCycleTransition();  
    transition1.Expiration().setDays(10);
    transition1.setStorageClass(StorageClass::IA);

    /*設定非目前的版本的Object距最後修改時間20天之後轉為歸檔類型。*/
    auto transition2 = LifeCycleTransition();  
    transition2.Expiration().setDays(20);
    transition2.setStorageClass(StorageClass::Archive);

    /*設定Object在其成為非目前的版本30天之後刪除。*/
    auto expiration  = LifeCycleExpiration(30);
    rule3.setNoncurrentVersionExpiration(expiration);

    LifeCycleTransitionList noncurrentVersionStorageTransitions{transition1, transition2};
    rule3.setNoncurrentVersionTransitionList(noncurrentVersionStorageTransitions);

    /*設定生命週期規則。*/
    LifecycleRuleList list{rule1, rule2, rule3};
    request.setLifecycleRules(list);
    auto outcome = client.SetBucketLifecycle(request);

    if (!outcome.isSuccess()) {
        /*異常處理 */
        std::cout << "SetBucketLifecycle fail" <<
        ",code:" << outcome.error().Code() <<
        ",message:" << outcome.error().Message() <<
        ",requestId:" << outcome.error().RequestId() << std::endl;
        return -1;
    }

    /*釋放網路等資源。*/
    ShutdownSdk();
    return 0;
}

C

#include "oss_api.h"
#include "aos_http_io.h"
/* yourEndpoint填寫Bucket所在地區對應的Endpoint。以華東1(杭州)為例,Endpoint填寫為https://oss-cn-hangzhou.aliyuncs.com。*/
const char *endpoint = "yourEndpoint";
/* 填寫Bucket名稱,例如examplebucket。*/
const char *bucket_name = "examplebucket";
/* yourRegion填寫Bucket所在地區對應的Region。以華東1(杭州)為例,Region填寫為cn-hangzhou。*/
const char *region = "yourRegion";
void init_options(oss_request_options_t *options)
{
    options->config = oss_config_create(options->pool);
    /* 用char*類型的字串初始化aos_string_t類型。*/
    aos_str_set(&options->config->endpoint, endpoint);
    /* 從環境變數中擷取訪問憑證。運行本程式碼範例之前,請確保已設定環境變數OSS_ACCESS_KEY_ID和OSS_ACCESS_KEY_SECRET。*/
    aos_str_set(&options->config->access_key_id, getenv("OSS_ACCESS_KEY_ID"));
    aos_str_set(&options->config->access_key_secret, getenv("OSS_ACCESS_KEY_SECRET"));
    //需要額外配置以下兩個參數
    aos_str_set(&options->config->region, region);
    options->config->signature_version = 4;
    /* 是否使用cname網域名稱訪問OSS服務。0表示不使用。*/
    options->config->is_cname = 0;
    /* 用於設定網路相關參數,比如逾時時間等。*/
    options->ctl = aos_http_controller_create(options->pool, 0);
}
int main(int argc, char *argv[])
{
    /* 在程式入口調用aos_http_io_initialize方法來初始化網路、記憶體等全域資源。*/
    if (aos_http_io_initialize(NULL, 0) != AOSE_OK) {
        exit(1);
    }
    /* 用於記憶體管理的記憶體池(pool),等價於apr_pool_t。其實現代碼在apr庫中。*/
    aos_pool_t *pool;
    /* 重新建立一個記憶體池,第二個參數是NULL,表示沒有繼承其它記憶體池。*/
    aos_pool_create(&pool, NULL);
    /* 建立並初始化options,該參數包括endpoint、access_key_id、acces_key_secret、is_cname、curl等全域配置資訊。*/
    oss_request_options_t *oss_client_options;
    /* 在記憶體池中分配記憶體給options。*/
    oss_client_options = oss_request_options_create(pool);
    /* 初始化Client的選項oss_client_options。*/
    init_options(oss_client_options);
    /* 初始化參數。*/
    aos_string_t bucket;
    aos_table_t *resp_headers = NULL; 
    aos_status_t *resp_status = NULL; 
    aos_str_set(&bucket, bucket_name);
    aos_list_t lifecycle_rule_list;   
    aos_str_set(&bucket, bucket_name);
    aos_list_init(&lifecycle_rule_list);
    /* 指定到期天數。*/
    oss_lifecycle_rule_content_t *rule_content_days = oss_create_lifecycle_rule_content(pool);
    aos_str_set(&rule_content_days->id, "rule-1");
    /* 設定檔案首碼。*/
    aos_str_set(&rule_content_days->prefix, "dir1");
    aos_str_set(&rule_content_days->status, "Enabled");
    rule_content_days->days = 3;
    aos_list_add_tail(&rule_content_days->node, &lifecycle_rule_list);
    /* 指定到期時間。*/
    oss_lifecycle_rule_content_t *rule_content_date = oss_create_lifecycle_rule_content(pool);
    aos_str_set(&rule_content_date->id, "rule-2");
    aos_str_set(&rule_content_date->prefix, "dir2");
    aos_str_set(&rule_content_date->status, "Enabled");
    /* 到期時間格式為UTC。
    aos_str_set(&rule_content_date->date, "2023-10-11T00:00:00.000Z");
    aos_list_add_tail(&rule_content_date->node, &lifecycle_rule_list);
    /* 設定生命週期規則。*/
    resp_status = oss_put_bucket_lifecycle(oss_client_options, &bucket, &lifecycle_rule_list, &resp_headers);
    if (aos_status_is_ok(resp_status)) {
        printf("put bucket lifecycle succeeded\n");
    } else {
        printf("put bucket lifecycle failed, code:%d, error_code:%s, error_msg:%s, request_id:%s\n",
            resp_status->code, resp_status->error_code, resp_status->error_msg, resp_status->req_id);
    }
    /* 釋放記憶體池,相當於釋放了請求過程中各資源分派的記憶體。*/
    aos_pool_destroy(pool);
    /* 釋放之前分配的全域資源。*/
    aos_http_io_deinitialize();
    return 0;
}

Ruby

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名稱。
bucket = client.get_bucket('examplebucket')
# 設定生命週期規則。
bucket.lifecycle = [
  Aliyun::OSS::LifeCycleRule.new(
    :id => 'rule1', :enable => true, :prefix => 'foo/', :expiry => 3),
  Aliyun::OSS::LifeCycleRule.new(
    :id => 'rule2', :enable => false, :prefix => 'bar/', :expiry => Date.new(2016, 1, 1))
]

使用命令列工具ossutil

關於使用ossutil設定生命週期規則的具體操作, 請參見添加或修改生命週期規則

使用REST API

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

通過CopyObject介面手動轉換Object的儲存類型

您可以通過CopyObject介面,將Object覆寫為指定的儲存類型。

  • 如果將Object修改為低頻訪問、Archive Storage、冷Archive Storage、深度冷Archive Storage類型,Object會涉及最小計量空間64 KB、最短儲存周期、資料取回費用等。更多資訊,請參見注意事項

  • Archive Storage、冷Archive Storage、深度冷Archive Storage類型的Object需要解凍後才可以修改儲存類型。關於解凍Object的具體操作,請參見解凍Object。如果您已開啟歸檔直讀,則Archive Storage資料無需解凍就可以修改儲存類型。直接讀取會產生歸檔直讀資料取回容量費用,請參見歸檔直讀

說明
  • 在已開啟版本控制的Bucket中,通過CopyObject轉換Object的儲存類型時,OSS將會為新拷貝的Object自動產生唯一的版本ID,此版本ID將會在響應Header中的x-oss-version-id返回。

  • 在未開啟或者暫停版本控制的Bucket中,通過CopyObject轉換Object的儲存類型時,OSS將會為新拷貝的Object自動產生version ID為null的版本,且會覆蓋原有versionId為null的版本。如果被覆蓋的檔案類型為低頻、歸檔、冷歸檔或者深度冷歸檔,可能會涉及儲存不足規定時間長度容量費用。更多資訊,請參見Object在儲存不足規定時間長度時如何計費?

基於CopyObject轉換儲存類型規則

  • 本地冗餘(LRS)

    標準儲存(LRS)、低頻訪問(LRS)、Archive Storage(LRS)、冷Archive Storage(LRS)和深度冷Archive Storage(LRS)各儲存類型之間可任意轉換。

  • 同城冗餘(ZRS)

    標準儲存(ZRS)、低頻訪問(ZRS)和Archive Storage(ZRS)各儲存類型之間可任意轉換。

    將Archive Storage(ZRS)類型的Object轉換為標準儲存(ZRS)或低頻訪問(ZRS)類型時,需根據Object所在Bucket的設定情況採取不同操作:

    • 如果Bucket已開啟歸檔直讀功能,可以直接轉換歸檔Object的儲存類型,無需解凍。

    • 如果Bucket未開啟歸檔直讀功能,需要先解凍Archive StorageObject,才能轉換儲存類型。

通過CopyObject轉換儲存類型操作方式

使用OSS管理主控台

通過控制台修改Object儲存類型時,Object大小不能超過1 GB。超過1 GB的Object,建議通過SDK或者命令列工具ossutil。

  1. 登入OSS管理主控台

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

  3. 在左側導覽列,選擇文件管理 > 檔案清單

  4. 檔案清單頁面,選擇目標Object右側的more > 修改儲存類型

  5. 建議您開啟保留使用者自訂中繼資料開關,修改儲存類型後,Object的自訂中繼資料資訊會被保留。

  6. 選擇您希望修改的儲存類型後,單擊確定

使用阿里雲SDK

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.CopyObjectRequest;
import com.aliyun.oss.model.CopyObjectResult;
import com.aliyun.oss.model.ObjectMetadata;
import com.aliyun.oss.model.StorageClass;

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與Object需提前建立好, 且Object類型為標準或低頻訪問儲存類型。
        // 填寫Bucket名稱,例如examplebucket。
        String bucketName = "examplebucket";
        // 填寫不包含Bucket名稱在內的Object完整路徑,例如exampleobject.txt。
        String objectName = "exampleobject.txt";
        // 填寫Bucket所在地區。以華東1(杭州)為例,Region填寫為cn-hangzhou。
        String region = "cn-hangzhou";

        // 建立OSSClient執行個體。
        ClientBuilderConfiguration clientBuilderConfiguration = new ClientBuilderConfiguration();
        clientBuilderConfiguration.setSignatureVersion(SignVersion.V4);        
        OSS ossClient = OSSClientBuilder.create()
        .endpoint(endpoint)
        .credentialsProvider(credentialsProvider)
        .clientConfiguration(clientBuilderConfiguration)
        .region(region)               
        .build();

        try {
            // 建立CopyObjectRequest對象。
            CopyObjectRequest request = new CopyObjectRequest(bucketName, objectName, bucketName, objectName) ;

            // 建立ObjectMetadata對象。
            ObjectMetadata objectMetadata = new ObjectMetadata();

            // 將Object儲存類型轉換為歸檔類型。
            objectMetadata.setHeader("x-oss-storage-class", StorageClass.Archive);
            // 將Object儲存類型轉換為冷歸檔類型。
            // objectMetadata.setHeader("x-oss-storage-class", StorageClass.ColdArchive);
            // 將Object儲存類型轉換為深度冷歸檔類型。
            // objectMetadata.setHeader("x-oss-storage-class", StorageClass.DeepColdArchive);
            request.setNewObjectMetadata(objectMetadata);

            // 變更檔儲存類型。
            CopyObjectResult result = ossClient.copyObject(request);
        } 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();
            }
        }
    }
}
<?php
if (is_file(__DIR__ . '/../autoload.php')) {
    require_once __DIR__ . '/../autoload.php';
}
if (is_file(__DIR__ . '/../vendor/autoload.php')) {
    require_once __DIR__ . '/../vendor/autoload.php';
}

use OSS\Credentials\EnvironmentVariableCredentialsProvider;
use OSS\OssClient;
use OSS\CoreOssException;

// 從環境變數中擷取訪問憑證。運行本程式碼範例之前,請確保已設定環境變數OSS_ACCESS_KEY_ID和OSS_ACCESS_KEY_SECRET。
$provider = new EnvironmentVariableCredentialsProvider();
// Endpoint以杭州為例,其它Region請按實際情況填寫。
$endpoint = "https://oss-cn-hangzhou.aliyuncs.com";
// 填寫Bucket名稱。
$bucket= "<yourBucketName>";
// 填寫不包含Bucket名稱在內的Object的完整路徑,例如destfolder/exampleobject.txt。
$object = "<yourObjectName>";

$config = array(
        "provider" => $provider,
        "endpoint" => $endpoint,
        "signatureVersion" => OssClient::OSS_SIGNATURE_VERSION_V4,
        "region"=> "cn-hangzhou"
    );
    $ossClient = new OssClient($config);

try {

    // 指定轉換後的檔案儲存體類型,例如指定為Archive Storage類型(Archive)。
    $copyOptions = array(
        OssClient::OSS_HEADERS => array(            
            'x-oss-storage-class' => 'Archive',
            'x-oss-metadata-directive' => 'REPLACE',
        ),
    );
    
    $ossClient->copyObject($bucket, $object, $bucket, $object, $copyOptions);

} catch (OssException $e) {
    printf(__FUNCTION__ . ": FAILED\n");
    printf($e->getMessage() . "\n");
    return;
}

print(__FUNCTION__ . ": OK" . "\n");
const OSS = require('ali-oss');

const client = new OSS({
  // yourregion填寫Bucket所在地區。以華東1(杭州)為例,Region填寫為oss-cn-hangzhou。
  region: 'yourregion',
  // 從環境變數中擷取訪問憑證。運行本程式碼範例之前,請確保已設定環境變數OSS_ACCESS_KEY_ID和OSS_ACCESS_KEY_SECRET。
  accessKeyId: process.env.OSS_ACCESS_KEY_ID,
  accessKeySecret: process.env.OSS_ACCESS_KEY_SECRET,
  authorizationV4: true,
  // yourbucketname填寫儲存空間名稱。
  bucket: 'yourbucketname'
})
const options = {
    headers:{'x-oss-storage-class':'Archive'}
}
client.copy('Objectname','Objectname',options).then((res) => {
    console.log(res);
}).catch(err => {
    console.log(err)
})
# -*- coding: utf-8 -*-
import oss2
from oss2.credentials import EnvironmentVariableCredentialsProvider
import os
# 從環境變數中擷取訪問憑證。運行本程式碼範例之前,請確保已設定環境變數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"

# yourBucketName填寫儲存空間名稱。
bucket = oss2.Bucket(auth, endpoint, "yourBucketName", region=region)

# 填寫Object的完整路徑,完整路徑中不能包含Bucket名稱,例如exampledir/exampleobject.txt。
# 需確保該Object的儲存類型為標準儲存或低頻訪問類型。
object_name = 'exampledir/exampleobject.txt'

# 通過添加儲存類型Header,將Object儲存類型轉換為歸檔類型。
headers = {'x-oss-storage-class': oss2.BUCKET_STORAGE_CLASS_ARCHIVE}
# 通過添加儲存類型Header,將Object儲存類型轉換為冷歸檔類型。
# headers = {'x-oss-storage-class': oss2.BUCKET_STORAGE_CLASS_COLD_ARCHIVE}
# 通過添加儲存類型Header,將Object儲存類型轉換為深度冷歸檔類型。
# headers = {'x-oss-storage-class': oss2.models.BUCKET_STORAGE_CLASS_DEEP_COLD_ARCHIVE}
# 變更檔儲存類型。
bucket.copy_object(bucket.bucket_name, object_name, object_name, headers)                    
package main

import (
	"log"

	"github.com/aliyun/aliyun-oss-go-sdk/oss"
)

func main() {
	// 從環境變數中擷取訪問憑證。運行本程式碼範例之前,請確保已設定環境變數OSS_ACCESS_KEY_ID和OSS_ACCESS_KEY_SECRET。
	provider, err := oss.NewEnvironmentVariableCredentialsProvider()
	if err != nil {
		log.Fatalf("Failed to create credentials provider: %v", err)
	}

	// 建立OSSClient執行個體。
	// yourEndpoint填寫Bucket對應的Endpoint,以華東1(杭州)為例,填寫為https://oss-cn-hangzhou.aliyuncs.com。其它Region請按實際情況填寫。
	// yourRegion填寫Bucket所在地區,以華東1(杭州)為例,填寫為cn-hangzhou。其它Region請按實際情況填寫。
	clientOptions := []oss.ClientOption{oss.SetCredentialsProvider(&provider)}
	clientOptions = append(clientOptions, oss.Region("yourRegion"))
	// 設定簽名版本
	clientOptions = append(clientOptions, oss.AuthVersion(oss.AuthV4))
	client, err := oss.New("yourEndpoint", "", "", clientOptions...)
	if err != nil {
		log.Fatalf("Failed to create OSS client: %v", err)
	}

	// yourBucketName填寫儲存空間名稱。
	bucketName := "yourBucketName" // 請替換為實際的Bucket名稱
	// yourObjectName填寫不包含Bucket名稱在內的Object的完整路徑。
	objectName := "yourObjectName" // 請替換為實際的物件路徑

	bucket, err := client.Bucket(bucketName)
	if err != nil {
		log.Fatalf("Failed to get bucket: %v", err)
	}

	// 變更檔儲存類型,例如修改為Archive Storage類型。
	_, err = bucket.CopyObject(objectName, objectName, oss.ObjectStorageClass(oss.StorageArchive))
	if err != nil {
		log.Fatalf("Failed to change storage class of object: %v", err)
	}

	log.Println("Storage class changed successfully.")
}
OSSCopyObjectRequest * copy = [OSSCopyObjectRequest new];
copy.sourceBucketName = @"examplebucket";
copy.sourceObjectKey = @"exampleobject.txt";
copy.bucketName = @"examplebucket";
copy.objectKey = @"exampleobject.txt";
// 將exampleobject.txt的儲存類型指定為歸檔類型Archive。
copy.objectMeta = @{@"x-oss-storage-class" : @"Archive"};

OSSTask * task = [client copyObject:copy];
[task continueWithBlock:^id(OSSTask *task) {
    if (!task.error) {
        NSLog(@"copy object success!");
    } else {
        NSLog(@"copy object failed, error: %@" , task.error);
    }
    return nil;
}];
// 實現同步阻塞等待任務完成。
// [task waitUntilFinished];  
#include <iostream>
#include <alibabacloud/oss/OssClient.h>

using namespace AlibabaCloud::OSS;

int main(void)
{  
            
    /* yourEndpoint填寫Bucket所在地區對應的Endpoint。以華東1(杭州)為例,Endpoint填寫為https://oss-cn-hangzhou.aliyuncs.com。*/
    std::string Endpoint = "yourEndpoint";
    /* yourRegion填寫Bucket所在地區對應的Region。以華東1(杭州)為例,Region填寫為cn-hangzhou。*/
    std::string Region = "yourRegion";
    /* 填寫Bucket名稱,例如examplebucket。*/
    std::string BucketName = "examplebucket";
    /* 填寫Object完整路徑,完整路徑中不能包含Bucket名稱,例如exampledir/exampleobject.txt。*/
    std::string ObjectName = "exampledir/exampleobject.txt";
  
    /* 初始化網路等資源。*/
    InitializeSdk();
    ClientConfiguration conf;
    conf.signatureVersion = SignatureVersionType::V4;
    /* 從環境變數中擷取訪問憑證。運行本程式碼範例之前,請確保已設定環境變數OSS_ACCESS_KEY_ID和OSS_ACCESS_KEY_SECRET。*/
    auto credentialsProvider = std::make_shared<EnvironmentVariableCredentialsProvider>();
    OssClient client(Endpoint, credentialsProvider, conf);
    client.SetRegion(Region);
    
    /* 設定修改後的檔案儲存體類型,例如將修改後的檔案儲存體類型設定為歸檔類型。*/
    ObjectMetaData objectMeta;
    objectMeta.addHeader("x-oss-storage-class", "Archive");
    
    std::string SourceBucketName = BucketName;
    std::string SourceObjectName = ObjectName;
    
    CopyObjectRequest request(SourceBucketName, ObjectName, objectMeta);
    request.setCopySource(SourceBucketName, SourceObjectName);
    
    /* 修改為上述指定的檔案儲存體類型。*/
    auto outcome = client.CopyObject(request);
    if (!outcome.isSuccess()) {
        /* 異常處理。*/
        std::cout << "CopyObject fail" <<
        ",code:" << outcome.error().Code() <<
        ",message:" << outcome.error().Message() <<
        ",requestId:" << outcome.error().RequestId() << std::endl;
        return -1;
    }
    
    /* 釋放網路等資源。*/
    ShutdownSdk();
    return 0;
}

使用命令列工具ossutil

關於使用ossutil轉換Object儲存類型的具體步驟, 請參見修改檔案儲存體類型

使用REST API

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

注意事項

當Object被轉換為低頻訪問、Archive Storage、冷Archive Storage或者深度冷Archive Storage類型後,需注意以下事項:

最小計量空間

對於小於64 KB的Object,會按照64 KB計算空間大小。

最低儲存時間長度

低頻訪問類型的Object需至少儲存30天,Archive Storage類型的Object需至少儲存60天,冷Archive Storage類型的Object需至少儲存180天,深度冷Archive Storage類型的Object需至少儲存180天。如果儲存未滿指定周期,會對應收取儲存不足規定時間長度容量費用。更多資訊,請參見儲存費用

  • 通過生命週期自動轉換Object儲存類型

    • 將Object儲存類型轉換為低頻、歸檔類型時,不會重新計算Object的儲存時間。

      例如,a.txt作為標準儲存類型已在OSS中儲存了10天,通過生命週期轉換為低頻訪問類型,則繼續儲存20天即可滿足最低儲存時間長度30天的要求。

    • 將Object儲存類型轉換為冷歸檔或者深度冷歸檔類型時,會重新計算Object的儲存時間。

      • 樣本1:a.txt作為標準儲存類型或者低頻訪問類型已在OSS中儲存了10天,通過生命週期規則轉換為冷歸檔或者深度冷歸檔類型,需繼續儲存180天才滿足最低儲存時間長度180天的要求。

      • 樣本2:a.txt作為冷歸檔類型已在OSS中儲存了30天,通過生命週期規則轉換為深度冷歸檔,將收取冷Archive Storage不足規定時間長度180天的費用。此外,轉為深度冷歸檔後,需繼續儲存180天后才滿足最低儲存時間長度180天的要求。

  • 通過CopyObject手動轉換Object儲存類型

    通過CopyObject手動轉換Object為任意儲存類型時,會重新計算Object的儲存時間。

    例如,a.txt作為標準儲存類型已在OSS中儲存了10天,通過CopyObject手動將Object轉換為低頻訪問類型,需繼續儲存30天才滿足最低儲存時間長度30天的要求。

說明

如果您在低頻訪問、歸檔、冷歸檔或者深度冷歸檔類型的Object儲存未滿規定時間長度前,進行重新命名或者通過上傳同名檔案進行覆寫等操作,會產生儲存不足規定時間長度容量費用。例如,您在低頻訪問類型Object儲存29天后執行了重新命名操作,OSS將重新計算Object的最後修改時間,即您需要繼續儲存30天才能滿足低頻訪問最低儲存時間長度的要求。

解凍時間

Archive Storage、冷Archive Storage和深度冷Archive Storage類型Object恢複為可讀取狀態需要一定的解凍時間,如果業務情境需要即時讀取Object時,不建議將Object轉換成Archive Storage、冷Archive Storage或深度冷Archive Storage類型。

請求費用

轉換儲存類型的方式

Object源儲存類型

請求費用

通過生命週期規則

標準、低頻訪問、歸檔、冷歸檔

按照Object的源儲存類型收取Put類請求費用,計量到當前Bucket。

通過CopyObject

Archive Storage

  • 已開啟歸檔直讀

    • 按Object源儲存類型收取Get類請求費用,計量到源Bucket。

    • 按Object的目標儲存類型收取Put類請求費用,計量到目標Bucket。

  • 未開啟歸檔直讀

    按Object源儲存類型收取Put類請求費用,計量到目標Bucket。

標準、低頻訪問、冷歸檔、深度冷歸檔

按Object源儲存類型收取Put類請求費用,計量到目標Bucket。

在已開啟歸檔直讀的情況下,通過CopyObject將Archive Storage類型的源Object轉換為其他儲存類型時,無需提前解凍,不會產生Archive Storage資料取回容量費用,但會產生歸檔直讀資料取回容量費用。

在未開啟歸檔直讀的情況下,通過CopyObject將Archive Storage類型的源Object轉換為其他儲存類型時,需提前解凍,會產生Archive Storage資料取回容量費用,不會產生歸檔直讀資料取回容量費用。

更多資訊,請參見資料處理費用

資料取回費用

訪問低頻訪問類型的Object時,會根據實際訪問量額外收取資料取回費用。解凍Archive Storage、冷Archive Storage和深度冷Archive Storage類型的Object會額外收取資料解凍費用。開啟歸檔直讀後,直接存取Archive Storage資料的Object會額外收取歸檔直讀費用。這些費用與流出流量費用是兩個獨立計費項目。如果Object每月平均訪問頻率高於1次,Object轉換成低頻訪問、Archive Storage、冷Archive Storage或深度冷Archive Storage類型後的使用成本可能高於標準儲存類型。

臨時儲存費用

冷Archive Storage和深度冷Archive Storage類型Object在資料解凍時會產生一份標準儲存類型的Object副本用於訪問。該Object在解凍時間結束前會以標準儲存的儲存費率計算臨時儲存費用。

常見問題

基於最後一次修改時間的生命週期規則是否支援將Object從低頻訪問類型轉換為標準類型?

不支援。您可以通過以下方式將Object從低頻訪問類型轉為標準類型: