チュートリアル:地震データセットを過去の時点に復元する

Azure Data Manager for Energyの地震DDMS復元操作を使って、1つの地震データセットを以前の時点に復元します。 この操作は、データセットのメタデータとそれに関連するブロブデータを、指定されたタイムスタンプ時点で存在した状態に復元します。 この操作は、固定された30日間の保持期間内に復元可能なバージョンがまだ利用可能な場合、意図しない更新や削除後のデータセットの復元に役立ちます。

このチュートリアルでは、以下の内容を学習します。

前提条件

開始する前に、以下の前提条件を満たしていることを確認してください。

• Seismic DDMSの復元プレビューが有効化されたAzure Data Manager for Energy StandardのSKUリソースです。
• Seismic DDMS サービスに登録された tenant および subproject 。
• ユーザー アカウントに割り当てられている subproject.admin ロール。
• API 認証のベアラー トークン。 認証トークンを生成する方法を参照してください。
• 復元したい地震データセットの sdPath 。
• 固定された30日間の保持期間内に復元ポイントを設置します。 保持期間は設定できません。

API操作の復元

復元ワークフローは2つのAPI操作を使用します。

復元ポイントを選択してください

restorePointInTime値は復元すべき状態を示します。 例えば、ISO 8601 UTCのタイムスタンプとして値を指定してください。 2026-07-10T08:30:00.000Z。

復元ポイントは以下のすべての要件を満たす必要があります:

• 過去のことだ。
• 定められた30日間の復旧保持期間内です。
• データセット作成時間より遅いです。

意図しない更新や削除の直前のタイムスタンプを選びましょう。 復元状態には、選択したタイムスタンプ以降に行われたデータセットの変更は含まれません。

復元作業を開始してください

リクエストを提出する前に、データセットの書き込みと削除操作を停止してください。 復元操作はメタデータとブロブデータを復元しながらデータセットをロックします。

1. 復元エンドポイントにPOSTリクエストを送信してください。 sdPathはディレクトリではなく、1つのデータセットを特定しなければなりません。

   POST <instance>.energy.azure.com/seistore-svc/api/v3/operation/restore
   Authorization: Bearer <access_token>
   data-partition-id: <data_partition_id>
   Content-Type: application/json
   
   {
     "sdPath": "sd://<tenant>/<subproject>/<path>/<dataset_name>",
     "restorePointInTime": "2026-07-10T08:30:00.000Z"
   }
   

2. 202 Acceptedの回答からは、operation_idやstatusUrlを保存してください。 操作を監視するには、以下の値のいずれかが必要です:

   {
     "operation_id": "c3d282e6-e7d1-40d8-8ac2-edc15b6d174c",
     "statusUrl": "/seistore-svc/api/v3/operation/restore/c3d282e6-e7d1-40d8-8ac2-edc15b6d174c"
   }
   

復元操作を監視してください

非同期復元を追跡するためにステータスエンドポイントをポーリングします。

1. operation_idを添えてGETリクエストを送信してください:

   GET <instance>.energy.azure.com/seistore-svc/api/v3/operation/restore/<operation_id>
   Authorization: Bearer <access_token>
   data-partition-id: <data_partition_id>
   

2. 応答の status フィールドを確認します。 操作は終端状態に達する前に Enqueued と InProgress を通過することができます。

   {
     "operationId": "c3d282e6-e7d1-40d8-8ac2-edc15b6d174c",
     "status": "InProgress",
     "sdPath": "sd://opendes/test-subproject/surveys/dataset1",
     "restorePointInTime": "2026-07-10T08:30:00.000Z",
     "tenant": "opendes",
     "subproject": "test-subproject",
     "createdBy": "00000000-0000-0000-0000-000000000000",
     "startedAt": "2026-07-15T10:00:00.000Z",
     "lastUpdatedAt": "2026-07-15T10:00:05.000Z"
   }
   

3. statusが以下のいずれかの終端値であればポーリングを停止してください:

   地位	説明
   Succeeded	データセットのメタデータとブロブデータは選択した時点に復元されました。
   Failed	復元は始まりましたが完了しませんでした。 目的のために復習 errorDetails 。
   Rejected	例えば、データがロックされているか復元可能な状態が存在しなかったため、サービスは復元を開始できませんでした。 目的のために復習 errorDetails 。

   以下の例は、却下された復元を示しています:

   {
     "operationId": "c3d282e6-e7d1-40d8-8ac2-edc15b6d174c",
     "status": "Rejected",
     "sdPath": "sd://opendes/test-subproject/surveys/dataset1",
     "restorePointInTime": "2026-07-10T08:30:00.000Z",
     "createdBy": "00000000-0000-0000-0000-000000000000",
     "errorDetails": "Restore rejected: the dataset is currently locked by another in-progress write operation. Wait for that operation to finish and release the lock, then retry this restore.",
     "lastUpdatedAt": "2026-07-15T10:00:07.000Z",
     "completedAt": "2026-07-15T10:00:07.000Z"
   }
   

操作が成功したら、データセットを取得するかダウンロードし、メタデータと内容が期待される状態に合致しているか確認します。

制限事項と考慮事項

復元を開始する前に以下の制限を考慮してください。

• 単一データセットのみ—各リクエストで1つのデータセットが復元されます。 ディレクトリを指定したり、パス内のすべてのデータセットを復元したり、複数のデータセットを1回のリクエストで提出したりすることはできません。
• 固定保持期間が適用されます—30日間の保持期間を超えてタイムスタンプに復元することはできません。 保持期間は設定できず、リクエスト内で上書きすることもできません。
• データパーティションごとに1つの復元—別のデータセットを対象とするリクエストであっても、データパーティション内で同時に1つの復元操作のみが実行可能です。 同時要求は 409 Conflictを返します。
• リストアは非同期です。 202 Accepted 応答が成功の確認にはなりません。 ステータスエンドポイントをポーリングしなければなりません。
• 書き込みは一時停止が必要です—アクティブな書き込みロックは操作を拒否することがあります。 復元がターミナル状態になるまでは、データセットを更新または削除しないでください。
• 現在の状態が置き換えられます—復元が成功すると、選択した過去バージョンが現在のデータセットの状態になります。 復元ポイント後に行われたアップデートは、復元されたバージョンには含まれていません。
• 機能の利用可能性が限られている—復元操作はプレビュー機能であり、標準SKUインスタンスで有効化する必要があります。 有効になっていなければ、サービスは 403 Forbiddenに戻されます。

リソースをクリーンアップする

このチュートリアルは請求可能なAzureリソースを作成していません。 テストのために復元を行った場合は、書き込みを再開する前にデータセットの状態を確認してください。

関連するコンテンツ

• チュートリアル: Seismic DDMS API を使用して地震データを操作する
• 地震データセットのストレージ層を変更する
• 認証トークンの生成方法
• Seismic DDMS API リファレンス