アーカイブオブジェクトのリアルタイムアクセスを有効にするか、復元後にアーカイブオブジェクトにアクセスできます。 リアルタイムアクセスは、Cold ArchiveオブジェクトとDeep Cold Archiveオブジェクトではサポートされていません。 Cold ArchiveオブジェクトとDeep Cold Archiveオブジェクトは、復元後にのみアクセスできます。 ほとんどの場合、アーカイブオブジェクトの復元は完了するまでに数分かかり、コールドアーカイブオブジェクトの復元は完了するまでに数時間かかり、ディープコールドアーカイブオブジェクトの復元は完了するまでに12〜48時間かかります。 与えられた回復時間は参照用である。 復元時間は、実際のシナリオに基づいて変化し得る。 このトピックでは、RestoreObject操作を呼び出して、アーカイブ、コールドアーカイブ、およびディープコールドアーカイブオブジェクトを復元する方法について説明します。
処理中
次の復元プロセスは、アーカイブ、コールドアーカイブ、およびディープコールドアーカイブオブジェクトに適用されます。
最初は、オブジェクトは凍結状態にある。
オブジェクトを復元するための要求が送信された後、オブジェクトは復元状態に入ります。
OSSサーバーが復元タスクを完了すると、オブジェクトは復元された状態になり、アクセスできます。
復元された状態のオブジェクトに対して別の復元要求を開始して、オブジェクトの復元された状態の期間を延長できます。 オブジェクトの復元された状態の期間は、対応するストレージクラスでサポートされている最大期間を超えることはできません。
復元された状態の期間が終了すると、オブジェクトは凍結状態に戻ります。
使用上の注意
RestoreObject操作は、アーカイブ、コールドアーカイブ、およびディープコールドアーカイブオブジェクトにのみ適用されます。 この操作は、標準または低頻度アクセス (IA) オブジェクトには適用されません。
Archiveオブジェクト、Cold Archiveオブジェクト、またはDeep Cold Archiveオブジェクトに対して初めてRestoreObject操作を呼び出すと、HTTP 202のステータスコードが返されます。 復元されたオブジェクトに対してRestoreObject操作を呼び出すと、200 OKが返されます。
復元状態のオブジェクトに対するRestoreObject操作は、HTTP 409エラーコードで失敗します。 オブジェクトの復元後、オブジェクトに対して別のRestoreObject操作を正常に呼び出すことができます。
バージョン管理が有効なバケットでは、オブジェクトの異なるバージョンのストレージクラスが異なる場合があります。 既定では、オブジェクトに対してRestoreObject操作を呼び出すと、オブジェクトの現在のバージョンが復元されます。 リクエストでバージョンIDを指定して、オブジェクトの特定のバージョンを復元できます。
課金ルール
Archive、Cold Archive、およびDeep Cold Archiveオブジェクトを復元すると、データ取得料金が発生します。 詳細については、「データ処理料金」をご参照ください。
アーカイブオブジェクトは最大7日間復元された状態を維持でき、コールドアーカイブまたはディープコールドアーカイブオブジェクトは最大365日間復元された状態を維持できます。 プロセス中にデータ取得料金が再度請求されることはありません。
オブジェクトの復元された状態の期間が終了すると、オブジェクトは凍結状態に戻ります。 凍結状態に戻った後にオブジェクトを復元すると、データ取得料金が発生します。
復元中および復元後のアーカイブオブジェクトの課金ルールに基づいて、アーカイブオブジェクトに対して課金されます。
Cold ArchiveオブジェクトまたはDeep Cold Archiveオブジェクトを復元すると、一時的なアクセス用にオブジェクトの標準レプリカが生成されます。 Cold ArchiveオブジェクトまたはDeep Cold Archiveオブジェクトが凍結状態に戻るまで、標準ストレージクラスに基づくレプリカの一時ストレージに対して課金されます。 詳細については、「一時ストレージ料金」をご参照ください。
リクエスト構文
POST /ObjectName? HTTP/1.1の復元
ホスト: archive-bucket.oss-cn-hangzhou.aliyuncs.com
日付: GMT日付
権限付与: SignatureValue
リクエストヘッダー
このAPI操作に含まれるリクエストヘッダーには、共通のリクエストヘッダーのみが含まれます。 詳細については、「共通リクエストヘッダー」をご参照ください。
リクエストパラメーター
ヘッダー | データ型 | 必須 | 例 | 説明 |
RestoreRequest | Container | 必須 | N/A | RestoreObjectリクエストに関する情報を格納するコンテナー。 子ノード: DaysとJobParameters |
日 | Integer | 必須 | 2 | オブジェクトが復元された状態のままである期間。
親ノード: RestoreRequest |
JobParameters | Container | 任意 | N/A | 復元の優先度を格納するコンテナー。 このパラメーターは、Cold ArchiveオブジェクトまたはDeep Cold Archiveオブジェクトを復元する場合にのみ有効です。 JobParametersパラメーターを指定しない場合は、デフォルトの復元優先度標準が使用されます。 親ノード: RestoreRequest 子ノード: 階層 |
ティア | String | 任意 | 標準 | Cold ArchiveオブジェクトまたはDeep Cold Archiveオブジェクトの復元優先度。 デフォルト値: Standard。 有効な値:
親ノード: JobParameters |
レスポンスヘッダー
ヘッダー | データ型 | 例 | 説明 |
x-oss-object-restore-priority | String | 標準 | 復元の優先順位。 このヘッダーは、復元された状態のCold ArchiveオブジェクトまたはDeep Cold Archiveオブジェクトに対してのみ表示されます。 |
x-oss-version-id | String | CAEQNRiBgMClj7qD0BYiIDQ5Y2QyMjc3NGZkODRlMTU5M2VkY2U3MWRiNGRh **** | オブジェクトのバージョンID。 このヘッダーは、リクエストでオブジェクトのバージョンIDが指定されている場合にのみ表示されます。 |
このAPI操作に含まれるレスポンスヘッダーには、共通のレスポンスヘッダーが含まれます。 詳細については、「共通レスポンスヘッダー」をご参照ください。
例
凍結状態のアーカイブオブジェクトに対するRestoreObjectリクエストを初めて開始します。
リクエストの例
POST /oss.jpg? HTTP/1.1の復元 ホスト: oss-archive-example.oss-cn-hangzhou.aliyuncs.com 日付: 4月15日土曜日07:45:28 GMT 2017 承認: OSS e1Unnbm1rg ****:y4eyu + 4yje5ioRCr ****
レスポンスの例
HTTP/1.1 202受け入れ 日付: 4月15日土曜日07:45:28 GMT 2017 コンテンツ長: 0 接続: キープアライブ サーバー: AliyunOSS x-oss-request-id: 5374A2880232A65C23002D7 4
復元状態のアーカイブオブジェクトに対するRestoreObjectリクエストの開始
リクエストの例
POST /oss.jpg? HTTP/1.1の復元 ホスト: oss-archive-example.oss-cn-hangzhou.aliyuncs.com 日付: 4月15日土曜日07:45:29 GMT 2017 承認: OSS e1Unnbm1rg ****:21qtGJ + ykDVmdy4eyu + N ****
レスポンスの例
HTTP/1.1 409競合 日付: 4月15日土曜日07:45:29 GMT 2017 コンテンツ-長さ: 556 接続: キープアライブ サーバー: AliyunOSS x-oss-request-id: 5374A2880232A65C23002D74 <?xml version="1.0" encoding="UTF-8"?> <エラー> <Code>RestoreAlreadyInProgress</Code> <メッセージ> 復元操作が進行中です。</Message> <RequestId>58EAF141461FB42C2B000008</RequestId> <HostId>10.101.XX.XX</HostId> </エラー>
復元された状態のアーカイブオブジェクトに対するRestoreObjectリクエストの開始
リクエストの例
POST /oss.jpg? HTTP/1.1の復元 ホスト: oss-archive-example.oss-cn-hangzhou.aliyuncs.com 日付: 4月15日土曜日07:45:29 GMT 2017 承認: OSS e1Unnbm1rg ****:u6O6FMJnn + WuBwbByZxm1 + y4eyu + N **** <RestoreRequest> <日> 2</日> </RestoreRequest>
レスポンスの例
HTTP/1.1 200 Ok 日付: 4月15日 (土) 2017 07:45:30 GMT コンテンツ長: 0 接続: キープアライブ サーバー: AliyunOSS x-oss-request-id: 5374A2880232A65C23002D7 4
復元された状態のCold ArchiveオブジェクトまたはDeep Cold ArchiveオブジェクトのRestoreObjectリクエストを開始する
リクエストの例
POST /coldarchiveobject? HTTP/1.1の復元 ホスト: cold-archive-bucket.oss-cn-hangzhou.aliyuncs.com ユーザーエージェント: aliyun-sdk-go/v2.1.0 (Darwin/17.5.0/x86_64;go1.11.8)/ossutil-v1.6.12 コンテンツ-長さ: 99 承認: OSS LTAI4FjmjjhjiYK6kMaV ****:Gi1x7YHqTw + NQCJo0fKBHcYQ **** Content-Type: text/plain; charset=utf-8 日付: 4月2020日火曜日11:09:19 GMT 受け入れる-エンコーディング: gzip <RestoreRequest> <Days>2</Days> <JobParameters> <Tier> スタンダード </Tier> </JobParameters> </RestoreRequest>
レスポンスの例
HTTP/1.1 200 OK サーバー: AliyunOSS 日付: 4月2020日火曜日11:09:19 GMT コンテンツ長: 0 接続: キープアライブ x-oss-request-id: 5E9ED45F093E2F3930318EA0 x-oss-object-restore-priority: 標準 x-oss-server-time: 10
RestoreObject操作を呼び出してオブジェクトを復元するときのバージョンIDを指定します。
リクエストの例
POST /oss.jpg?restore&versionId=CAEQNRiBgMClj7qD0BYiIDQ5Y2QyMjc3NGZkODRlMTU5M2VkY2U3MWRiNGRh **** HTTP/1.1 ホスト: oss-archive-example.oss-cn-hangzhou.aliyuncs.com 日付: 4月2019日火曜日06:50:48 GMT 承認: OSS o3shiyktjw1 ****:2JND5qqlAlaA 1/kLO4kBbGTw ****
レスポンスの例
HTTP/1.1 202受け入れ 日付: 4月2019日火曜日06:50:48 GMT コンテンツ長: 0 接続: キープアライブ サーバー: AliyunOSS x-oss-version-id: CAEQNRiBgMClj7qD0BYiIDQ5Y2QyMjc3NGZkODRlMTU5M2VkY2U3MWRiNGRh **** x-oss-request-id: 5CAC40C8B7AEADE01700065 3
SDK
次のプログラミング言語のOSS SDKを使用して、RestoreObject操作を呼び出すことができます。
エラーコード
エラーコード | HTTPステータスコード | 説明 |
OperationNotSupported | 400 | オブジェクトのストレージクラスがArchive、Cold Archive、またはDeep Cold Archiveではないため、オブジェクトを復元できません。 |
NoSuchKey | 404 | 指定されたオブジェクトは存在しません。 |
RestoreAlreadyInProgress | 409 | RestoreObject操作が進行中です。 RestoreObject操作を繰り返し呼び出さないでください。 |
参考資料
復元に必要な時間と、オブジェクトが復元された状態のままである日数の詳細については、「オブジェクトの復元」をご参照ください。
ossutilを使用してオブジェクトを復元する方法の詳細については、「restore」をご参照ください。
アーカイブされたオブジェクトに常に即座にアクセスできるようにする方法の詳細については、「オブジェクトを復元された状態で永続的に作成するにはどうすればよいですか? 」をご参照ください。