Handledning: Återställ en seismisk datamängd till en tidigare tidpunkt

Important

Denna funktion är för närvarande i förhandsvisning och finns tillgänglig på begäran för Standard SKU. För att aktivera det, skapa en Azure support-förfrågan. För instruktioner, se Hur gör jag en supportförfrågan för Azure Data Manager for Energy? Se de kompletterande användarvillkoren för Microsoft Azure Previews för juridiska termer som gäller Azure-funktioner som är i beta, förhandsvisning eller på annat sätt ännu inte släppts till allmän tillgänglighet.

Använd Seismic DDMS-återställningsoperationen i Azure Data Manager for Energy för att återställa en seismisk datamängd till en tidigare tidpunkt. Operationen återställer både datamängdens metadata och dess tillhörande blobdata till det tillstånd som fanns vid den tidsstämpel du angav. Denna operation kan hjälpa till att återställa en datamängd efter en oavsiktlig uppdatering eller borttagning, förutsatt att en återställbar version fortfarande finns tillgänglig inom den fasta 30-dagarsbevaringsperioden.

I den här tutorialen lär du dig följande:

Välj en giltig återställningspunkt
Initiera en återställningsoperation för en enskild datamängd
Övervaka återställningsoperationens status
Förstå återställningsbegränsningar

Förutsättningar

Kontrollera att du uppfyller följande krav innan du börjar:

En Azure Data Manager för Energy Standard SKU-resurs med Seismic DDMS återställningsförhandsvisning aktiverad.
En registrerad tenant och subproject i Seismic DDMS-tjänsten.
Den subproject.admin roll som tilldelats ditt användarkonto.
En ägartoken för API-autentisering. Se Så här genererar du autentiseringstoken.
Av sdPath den seismiska datamängd som du vill återställa.
En återställningspunkt inom den fasta 30-dagars lagringsperioden. Behållningstiden är inte konfigurerbar.

Återställ API-operationer

Återställningsarbetsflödet använder två API-operationer:

Operation	Metod och slutpunkt	Purpose
Starta en återställning	`POST /seistore-svc/api/v3/operation/restore`	Startar en asynkron återställning för datamängden identifierad av `sdPath`. Begäranarorganet inkluderar `restorePointInTime`, som specificerar det historiska tillståndet som ska återställas.
Få återställningsstatus	`GET /seistore-svc/api/v3/operation/restore/{operation_id}`	Återställer den aktuella statusen för återställningen. Använd operationen `operation_id` returnerad av start.

Välj en återställningspunkt

Värdet restorePointInTime identifierar det tillstånd som ska återställas. Ange värdet som en ISO 8601 UTC-tidsstämpel, till exempel, 2026-07-10T08:30:00.000Z.

Återställningspunkten måste uppfylla alla följande krav:

Det är historia.
Det ligger inom den fasta 30-dagars återställningstiden.
Det är senare än tiden för datamängdskapsskapande.

Välj en tidsstämpel omedelbart före den oavsiktliga uppdateringen eller borttagningen. Det återställda tillståndet inkluderar inga datamängdsändringar som gjorts efter den valda tidsstämpeln.

Initiera en återställningsoperation

Innan du skickar in förfrågan, stoppa skriv- och borttagningsoperationerna på datamängden. Återställningsoperationen låser datasetet medan den återställer metadata och blobdata.

Skicka in en POST-förfrågan till återställningsterminalen. De sdPath måste identifiera en datamängd, inte en katalog:

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"
}

Spara operation_id eller statusUrl från svaret 202 Accepted . Du behöver ett av dessa värden för att övervaka operationen:

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

Note

Ett 202 Accepted svar innebär att förfrågan klarade initial validering och sattes i kö. Det betyder inte att återställningen slutfördes framgångsrikt. Fortsätt polla statusändpunkten tills operationen når ett terminaltillstånd.

Övervaka återställningsoperationen

Polla statusändpunkten för att följa den asynkrona återställningen.

Skicka en GET-förfrågan med operation_id:

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

Kontrollera fältet status i svaret. Operationen kan gå igenom Enqueued och InProgress innan den når ett terminalt tillstånd.

{
  "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"
}

Sluta polla när status är ett av följande terminalvärden:

Status	Beskrivning
`Succeeded`	Datasetets metadata och blobdata återställdes till den valda tidpunkten.
`Failed`	Återställningen startade men kunde inte slutföras. Recension `errorDetails` för ändamålet.
`Rejected`	Tjänsten kunde inte starta återställningen, till exempel eftersom datamängden var låst eller inget återställbart tillstånd fanns tillgängligt. Recension `errorDetails` för ändamålet.

Följande exempel visar en avvisad återställning:

{
  "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"
}

Efter att operationen lyckats, hämta eller ladda ner datamängden och bekräfta att dess metadata och innehåll matchar det förväntade tillståndet.

Begränsningar och överväganden

Tänk på följande begränsningar innan du initierar en återställning:

Endast en datamängd – Varje begäran återställer en datamängd. Du kan inte ange en katalog, återställa varje dataset under en sökväg eller skicka in flera dataset i en och samma förfrågan.
Fast lagringsfönster gäller—Du kan inte återställa till en tidsstämpel utanför 30-dagars lagringsperioden. Behållningstiden är inte konfigurerbar och kan inte åsidosättas i begäran.
En återställning per datapartition—Endast en återställningsoperation kan köras i en datapartition åt gången, även om en annan begäran riktar sig mot en annan datamängd. En samtidig förfrågan returnerar 409 Conflict.
Återställ är asynkront—Ett 202 Accepted svar är inte en bekräftelse på framgång. Du måste polla statusändpunkten.
Skrivningar måste pausas – Ett aktivt skrivlås kan orsaka att operationen avvisas. Uppdatera eller ta inte bort datamängden förrän återställningen når ett terminaltillstånd.
Det aktuella tillståndet ersätts—En lyckad återställning gör den valda historiska versionen till det aktuella datasetstillståndet. Uppdateringar som görs efter återställningspunkten finns inte i den återställda versionen.
Tillgängligheten av funktioner är begränsad—Återställningsoperationen är en förhandsvisningsfunktion som måste aktiveras för en Standard SKU-instans. Om det inte är aktiverat returnerar 403 Forbiddentjänsten .

Rensa resurser

Den här handledningen skapar inga debiterbara Azure-resurser. Om du har återställt för testning, verifiera datamängdens tillstånd innan du återupptar skrivoperationerna.

Feedback

Var den här sidan till hjälp?

Last updated on 2026-08-14