全部產品
Search

搜尋本產品

    Object Storage Service：Python轉換檔儲存類型

    文件中心

    Object Storage Service：Python轉換檔儲存類型

    更新時間：Oct 25, 2024

    OSS 提供多種儲存類型，包括標準、低頻訪問、歸檔、冷歸檔和深度冷歸檔，以滿足從熱資料到冷資料的各種儲存需求。在Object Storage Service中，一旦對象被建立，其內容是不可修改的。這意味著，如果您想更改對象的儲存類型，就無法直接修改原對象，而必須建立一個新的對象。因此，轉換對象的儲存類型需要使用 Bucket.CopyObject 方法，這一操作會通過複製原對象來實現儲存類型的轉換。

    注意事項

    • 本文以華東1（杭州）外網Endpoint為例。如果您希望通過與OSS同地區的其他阿里雲產品訪問OSS，請使用內網Endpoint。關於OSS支援的Region與Endpoint的對應關係，請參見OSS訪問網域名稱、資料中心、開放連接埠。

    • 本文以從環境變數讀取存取憑證為例。如何配置訪問憑證，請參見配置訪問憑證。

    • 本文以OSS網域名稱建立OSSClient為例。如果您希望通過自訂網域名、STS等方式建立OSSClient，請參見初始化。

    • 要轉換檔儲存類型，您必須具有oss:GetObject、oss:PutObject和oss:RestoreObject許可權。具體操作，請參見為RAM使用者授權自訂的權限原則。

    範例程式碼

    重要

    當低頻訪問、歸檔、冷歸檔或者深度冷Archive Storage類型Object在儲存不足規定時間長度時轉換了儲存類型或者提前刪除時，需要收取不足規定時間長度容量費用。更多資訊，請參見Object在儲存不足規定時間長度時如何計費？。

    將標準或低頻訪問轉換為歸檔、冷歸檔或者深度冷歸檔類型

    以下代碼用於將Object的儲存類型從標準或低頻訪問轉換為歸檔、冷歸檔或者深度冷歸檔類型。 

    # -*- 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)

    將歸檔類型轉換為標準或低頻訪問類型

    以下代碼用於將Object的儲存類型從歸檔類型轉換為標準或低頻訪問類型。

    # -*- coding: utf-8 -*-
import oss2
from oss2.credentials import EnvironmentVariableCredentialsProvider
import os
import time
# 從環境變數中擷取訪問憑證。運行本程式碼範例之前，請確保已設定環境變數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'

# 擷取檔案中繼資料。
meta = bucket.head_object(object_name)

# 解凍檔案。根據解凍檔案的大小，實際解凍時間可能會有變化，請以實際解凍時間為準。
if meta.resp.headers['x-oss-storage-class'] == oss2.BUCKET_STORAGE_CLASS_ARCHIVE:
    bucket.restore_object(object_name)
    while True:
        meta = bucket.head_object(object_name)
        if meta.resp.headers['x-oss-restore'] == 'ongoing-request="true"':
            time.sleep(5)
        else:
            break

# 通過添加儲存類型Header，將Object儲存類型轉換為標準類型。
headers = {'x-oss-storage-class': oss2.BUCKET_STORAGE_CLASS_STANDARD}
# 通過添加儲存類型Header，將Object儲存類型轉換為低頻訪問類型。
# headers = {'x-oss-storage-class': oss2.BUCKET_STORAGE_CLASS_IA}

# 變更檔儲存類型。
bucket.copy_object(bucket.bucket_name, object_name, object_name, headers)

    將冷歸檔類型轉換為標準或低頻訪問類型

    以下代碼用於將Object的儲存類型從冷歸檔類型轉換為標準或低頻訪問類型。

    # -*- coding: utf-8 -*-
import oss2
from oss2.credentials import EnvironmentVariableCredentialsProvider
import os
import time
from oss2.models import RESTORE_TIER_EXPEDITED, RestoreJobParameters

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

# 擷取檔案中繼資料。
meta = bucket.head_object(object_name)

# 解凍檔案。
if meta.resp.headers['x-oss-storage-class'] == oss2.BUCKET_STORAGE_CLASS_COLD_ARCHIVE:
    # 設定解凍優先順序。RESTORE_TIER_EXPEDITED表示1小時內解凍完成。
    job_parameters = RestoreJobParameters(RESTORE_TIER_EXPEDITED)
    # days用於設定Object解凍完成後保持解凍狀態的天數。
    restore_config = oss2.models.RestoreConfiguration(days=5, job_parameters=job_parameters)
    # bucket.restore_object(object_name, input=restore_config)
    bucket.restore_object(object_name)
    while True:
        meta = bucket.head_object(object_name)
        if meta.resp.headers['x-oss-restore'] == 'ongoing-request="true"':
            time.sleep(5)
        else:
            break
# 通過添加儲存類型Header，將Object儲存類型轉換為標準類型。
headers = {'x-oss-storage-class': oss2.BUCKET_STORAGE_CLASS_STANDARD}
# 通過添加儲存類型Header，將Object儲存類型轉換為低頻訪問類型。
# headers = {'x-oss-storage-class': oss2.BUCKET_STORAGE_CLASS_IA}

# 變更檔儲存類型。
bucket.copy_object(bucket.bucket_name, object_name, object_name, headers)

    相關文檔

    關於轉換檔儲存類型的API介面說明，請參見CopyObject。