OSS提供標準、低頻訪問、歸檔、冷歸檔和深度冷歸檔多種存儲類型,全面覆蓋從熱到冷的各種數據存儲場景。本文主要介紹如何轉換文件(Object)的存儲類型。
注意事項
本文以華東1(杭州)外網Endpoint為例。如果您希望通過與OSS同地域的其他阿里云產品訪問OSS,請使用內網Endpoint。關于OSS支持的Region與Endpoint的對應關系,請參見訪問域名和數據中心。
本文以從環境變量讀取訪問憑證為例。如何配置訪問憑證,請參見配置訪問憑證。
本文以OSS域名新建OSSClient為例。如果您希望通過自定義域名、STS等方式新建OSSClient,請參見初始化。
要轉換文件存儲類型,您必須具有
oss:GetObject
、oss:PutObject
和oss:RestoreObject
權限。具體操作,請參見為RAM用戶授權自定義的權限策略。
示例代碼
重要
當低頻訪問、歸檔、冷歸檔或者深度冷歸檔存儲類型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.ProviderAuth(EnvironmentVariableCredentialsProvider())
# Endpoint以杭州為例,其它Region請按實際情況填寫。
# 填寫Bucket名稱,例如examplebucket。
bucket = oss2.Bucket(auth, 'https://oss-cn-hangzhou.aliyuncs.com', 'examplebucket')
# 填寫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.ProviderAuth(EnvironmentVariableCredentialsProvider())
# Endpoint以杭州為例,其它Region請按實際情況填寫。
# 填寫Bucket名稱,例如examplebucket。
bucket = oss2.Bucket(auth, 'https://oss-cn-hangzhou.aliyuncs.com', 'examplebucket')
# 填寫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.ProviderAuth(EnvironmentVariableCredentialsProvider())
# Endpoint以杭州為例,其它Region請按實際情況填寫。
# 填寫Bucket名稱,例如examplebucket。
bucket = oss2.Bucket(auth, 'https://oss-cn-hangzhou.aliyuncs.com', 'examplebucket')
# 填寫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。
文檔內容是否對您有幫助?