OSS SDK for Pythonを使用して、アーカイブ、コールドアーカイブ、およびディープコールドアーカイブオブジェクトを復元するにはどうすればよいですか? - Object Storage Service

Archive、Cold Archive、およびDeep Cold Archiveオブジェクトは、アクセスする前に復元する必要があります。このトピックでは、アーカイブ、コールドアーカイブ、およびDeep Cold Archiveオブジェクトを復元する方法について説明します。

使用上の注意

RestoreObject操作は、アーカイブ、コールドアーカイブ、およびディープコールドアーカイブオブジェクトでのみ呼び出すことができます。
このトピックでは、中国 (杭州) リージョンのパブリックエンドポイントを使用します。 OSSと同じリージョンにある他のAlibaba CloudサービスからOSSにアクセスする場合は、内部エンドポイントを使用します。 OSSリージョンとエンドポイントの詳細については、「リージョンとエンドポイント」をご参照ください。
このトピックでは、アクセス資格情報は環境変数から取得します。アクセス資格情報の設定方法の詳細については、「アクセス資格情報の設定」をご参照ください。
このトピックでは、OSSエンドポイントを使用してOSSClientインスタンスを作成します。カスタムドメイン名またはSTS (Security Token Service) を使用してOSSClientインスタンスを作成する場合は、「初期化」をご参照ください。
オブジェクトを復元するには、oss:RestoreObject権限が必要です。詳細については、「RAMユーザーへのカスタムポリシーのアタッチ」をご参照ください。

Archive オブジェクトの復元

次のコードは、Archiveオブジェクトを復元する方法の例を示しています。

# -*-コーディング: utf-8 -*-
oss2のインポート
oss2.credentialsからEnvironmentVariableCredentialsProviderをインポート
oss2.modelsからRestoreConfigurationをインポート

# 環境変数からアクセス資格情報を取得します。 サンプルコードを実行する前に、OSS_ACCESS_KEY_IDおよびOSS_ACCESS_KEY_SECRET環境変数が設定されていることを確認してください。 
auth = oss2.ProviderAuth(EnvironmentVariableCredentialsProvider())
# バケットが配置されているリージョンのエンドポイントを指定します。 たとえば、バケットが中国 (杭州) リージョンにある場合、エンドポイントをhttps://oss-cn-hangzhou.aliyuncs.comに設定します。 
# バケットの名前を指定します。 例: examplebucket. 
bucket = oss2.Bucket(auth, 'https:// oss-cn-hangzhou.aliyuncs.com ', 'examplebucket')
# Archiveオブジェクトのフルパスを指定します。 バケット名をフルパスに含めないでください。 
objectName = 'yourArchiveObjectName'
# オブジェクトが復元された状態のままである時間を指定します。 デフォルト値は 1 です。 単位：日。 この例では、期間は2日です。 
日=2
restore_config= RestoreConfiguration(days=days)
# RestoreObjectリクエストを開始します。 
bucket.restore_object(objectName, input=restore_config)

Cold Archiveオブジェクトを復元する

次のコードは、Cold Archiveオブジェクトを復元する方法の例を示しています。

# -*-コーディング: utf-8 -*-

oss2のインポート
oss2.credentialsからEnvironmentVariableCredentialsProviderをインポート
oss2.modelsのインポートから (RestoreJobParameters、
                         RestoreConfiguration、 
                         RESTORE_TIER_EXPEDITED、  
                         RESTORE_TIER_STANDARD、 
                         RESTORE_TIER_BULK)

# 環境変数からアクセス資格情報を取得します。 サンプルコードを実行する前に、OSS_ACCESS_KEY_IDおよびOSS_ACCESS_KEY_SECRET環境変数が設定されていることを確認してください。 
auth = oss2.ProviderAuth(EnvironmentVariableCredentialsProvider())
# バケットが配置されているリージョンのエンドポイントを指定します。 たとえば、バケットが中国 (杭州) リージョンにある場合、エンドポイントをhttps://oss-cn-hangzhou.aliyuncs.comに設定します。 
# バケットの名前を指定します。 例: examplebucket. 
bucket = oss2.Bucket(auth, 'https:// oss-cn-hangzhou.aliyuncs.com ', 'examplebucket')
# Cold Archiveオブジェクトのフルパスを指定します。 バケット名をフルパスに含めないでください。 
object_name = "yourColdArchiveObjectName"

# オブジェクトが復元された状態のままである時間を指定します。 デフォルト値は 1 です。 単位：日。 この例では、期間は2日です。 
日=2

# 復元モードを指定します。 この例では、復元モードはRESTORE_TIER_STANDARDです。 
# RESTORE_TIER_EXPEDITED: オブジェクトは1時間以内に復元されます。 
# RESTORE_TIER_STANDARD: オブジェクトは2〜5時間以内に復元されます。 
# RESTORE_TIER_BULK: オブジェクトは5〜12時間以内に復元されます。 
job_parameters = RestoreJobParameters(RESTORE_TIER_STANDARD)

restore_config= RestoreConfiguration(days=days, job_parameters=job_parameters)

# RestoreObjectリクエストを開始します。 
bucket.restore_object(object_name, input=restore_config)

Deep Cold Archiveオブジェクトを復元する

次のコードは、Deep Cold Archiveオブジェクトを復元する方法の例を示しています。

# -*-コーディング: utf-8 -*-

oss2のインポート
oss2.credentialsからEnvironmentVariableCredentialsProviderをインポート
oss2.modelsのインポートから (RestoreJobParameters、 
                         RestoreConfiguration、 
                         RESTORE_TIER_EXPEDITED、  
                         RESTORE_TIER_STANDARD、 
                         RESTORE_TIER_BULK)

# 環境変数からアクセス資格情報を取得します。 サンプルコードを実行する前に、OSS_ACCESS_KEY_IDおよびOSS_ACCESS_KEY_SECRET環境変数が設定されていることを確認してください。 
auth = oss2.ProviderAuth(EnvironmentVariableCredentialsProvider())
# バケットが配置されているリージョンのエンドポイントを指定します。 たとえば、バケットが中国 (杭州) リージョンにある場合、エンドポイントをhttps://oss-cn-hangzhou.aliyuncs.comに設定します。 
# バケットの名前を指定します。 例: examplebucket. 
bucket = oss2.Bucket(auth, 'https:// oss-cn-hangzhou.aliyuncs.com ', 'examplebucket')
# Deep Cold Archiveオブジェクトのフルパスを指定します。 バケット名をフルパスに含めないでください。 
object_name = "yourDeepColdArchiveObjectName"

# オブジェクトが復元された状態のままである時間を指定します。 デフォルト値は 1 です。 単位：日。 この例では、期間は2日です。 
日=2

# 復元モードを指定します。 この例では、復元モードはRESTORE_TIER_STANDARDです。 
# RESTORE_TIER_EXPEDITED: オブジェクトは12時間以内に復元されます。 
# RESTORE_TIER_STANDARD: オブジェクトは48時間以内に復元されます。 
job_parameters = RestoreJobParameters(RESTORE_TIER_STANDARD)

restore_config= RestoreConfiguration(days=days, job_parameters=job_parameters)

# RestoreObjectリクエストを開始します。 
bucket.restore_object(object_name, input=restore_config)

参考資料

Archive、Cold Archive、およびDeep Cold Archiveオブジェクトの復元に使用される完全なサンプルコードについては、GitHubをご参照ください。
アーカイブ、コールドアーカイブ、およびディープコールドアーカイブオブジェクトを復元するために呼び出すことができるAPI操作の詳細については、「RestoreObject」をご参照ください。