使用PythonSDK解凍Archive Storage的指定版本檔案-Object Storage Service-阿里雲

在受版本控制的儲存空間（Bucket）中，Object的各個版本可以對應不同的儲存類型。RestoreObject介面預設解凍Object的目前的版本，允許通過指定versionId的方式來解凍指定版本的Object。

注意事項

本文以華東1（杭州）外網Endpoint為例。如果您希望通過與OSS同地區的其他阿里雲產品訪問OSS，請使用內網Endpoint。關於OSS支援的Region與Endpoint的對應關係，請參見地區和Endpoint。
本文以從環境變數讀取存取憑證為例。如何配置訪問憑證，請參見配置訪問憑證（Python SDK V1）。
本文以OSS網域名稱建立OSSClient為例。如果您希望通過自訂網域名、STS等方式建立OSSClient，請參見初始化（Python SDK V1）。
要解凍檔案，您必須有oss:RestoreObject許可權。具體操作，請參見為RAM使用者授予自訂的權限原則。

範例程式碼

以下代碼用於解凍檔案：

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

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

# 填充versionId欄位到param。
params = dict()
params['versionId'] = 'yourObjectVersionId'

# 填寫一個歸檔類型的Object的名稱，如果沒有請先調用put_object介面建立。
object_name = 'yourArchiveObjectName'

# 擷取指定版本的Object中繼資料。
meta = bucket.head_object(object_name, params=params)
# 判斷檔案儲存體類型是否為歸檔類型。
if meta.resp.headers['x-oss-storage-class'] == oss2.BUCKET_STORAGE_CLASS_ARCHIVE:
    # 解凍指定版本的Object。
    result = bucket.restore_object(object_name, params=params)
    # 查看執行解凍操作的Object的版本ID。
    print('restore object version id:', result.versionid)

  while True:
         meta = bucket.head_object(object_name, params=params)
         print('x-oss-restore:', meta.resp.headers['x-oss-restore'])
         # 判斷解凍狀態。
         if meta.resp.headers['x-oss-restore'] == 'ongoing-request="true"':
             time.sleep(5)
         else:
             break

Object Storage Service：解凍檔案（Python SDK V1）

注意事項

範例程式碼

相關文檔