Tutorial: Herstel een seismische dataset naar een eerder tijdstip

Important

Deze functie is momenteel in preview en is op aanvraag beschikbaar voor de Standard SKU. Om dit in te schakelen, maak je een ondersteuning voor Azure-verzoek aan. Voor instructies, zie Hoe dien ik een supportverzoek in voor Azure Data Manager for Energy? Zie de Aanvullende Gebruiksvoorwaarden voor Microsoft Azure Previews voor juridische termen die van toepassing zijn op Azure-functies die in bèta, preview of anderszins nog niet algemeen beschikbaar zijn.

Gebruik de Seismic DDMS-hersteloperatie in Azure Data Manager for Energy om één seismische dataset terug te brengen naar een eerder tijdstip. De operatie herstelt zowel de datasetmetadata als de bijbehorende blobgegevens naar de status die bestond op de door u opgegeven tijdstempel. Deze operatie kan helpen om een dataset te herstellen na een onbedoelde update of verwijdering, mits er binnen de vaste bewaarperiode van 30 dagen nog een herstelbare versie beschikbaar is.

In deze handleiding leer je hoe je:

  • Kies een geldig herstelpunt
  • Start een hersteloperatie voor één enkele dataset
  • Monitor de status van de hersteloperatie
  • Begrijp herstelbeperkingen

Prerequisites

Voordat u begint, moet u ervoor zorgen dat u voldoet aan de volgende vereisten:

  • Een Azure Data Manager for Energy Standard SKU-resource met de Seismic DDMS herstelpreview ingeschakeld.
  • Een geregistreerde tenant en subproject in de Seismic DDMS-service.
  • De subproject.admin rol die is toegewezen aan uw gebruikersaccount.
  • Een bearer-token voor API-verificatie. Zie Hoe u een verificatietoken genereert.
  • De sdPath van de seismische dataset die je wilt herstellen.
  • Een herstelpunt binnen de vaste verblijfsperiode van 30 dagen. De retentieperiode is niet configureerbaar.

Herstel API-operaties

De herstelworkflow gebruikt twee API-bewerkingen:

Operatie Methode en eindpunt Purpose
Een herstelbewerking starten POST /seistore-svc/api/v3/operation/restore Start een asynchrone herstel voor de dataset die door sdPathwordt geïdentificeerd. Het verzoekordeel bevat restorePointInTime, dat de historische staat specificeert die moet worden hersteld.
Herstel status krijgen GET /seistore-svc/api/v3/operation/restore/{operation_id} Geeft de huidige status van het herstel terug. Gebruik de operatie die je operation_id bij de start terugstuurt.

Kies een herstelpunt

De restorePointInTime waarde identificeert de toestand die hersteld moet worden. Specificeer de waarde als een ISO 8601 UTC-tijdstempel, bijvoorbeeld, 2026-07-10T08:30:00.000Z.

Het herstelpunt moet aan alle volgende vereisten voldoen:

  • Het is verleden tijd.
  • Het valt binnen de vaste herstelperiode van 30 dagen.
  • Het is later dan de tijd voor het aanmaken van de dataset.

Kies een tijdstempel direct vóór de onbedoelde update of verwijdering. De herstelde toestand bevat geen datasetwijzigingen die zijn aangebracht na de geselecteerde tijdstempel.

Start een hersteloperatie

Stop voordat je het verzoek indient, schrijf- en verwijderingsoperaties op de dataset. De hersteloperatie vergrendelt de dataset terwijl de metadata en blobgegevens worden hersteld.

  1. Dien een POST-verzoek in bij het herstel-endpoint. De sdPath moeten één dataset identificeren, niet een directory:

    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. Bewaar de operation_id of statusUrl uit de 202 Accepted reactie. Je hebt een van deze waarden nodig om de operatie te monitoren:

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

Note

Een 202 Accepted antwoord betekent dat het verzoek de initiële validatie heeft doorstaan en in de wachtrij is gezet. Dat betekent niet dat het herstel succesvol is voltooid. Blijf het status-eindpunt pollen totdat de operatie een terminale toestand bereikt.

Monitor de hersteloperatie

Poll het status-eindpunt om de asynchrone herstel te volgen.

  1. Stuur een GET-verzoek met de 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>

  2. Controleer het status veld in het antwoord. De operatie kan doorlopen Enqueued en InProgress voordat deze een terminale toestand bereikt.

    {
  "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. Stop polling wanneer status een van de volgende terminalwaarden is:

    Status Beschrijving
    Succeeded De metadata van de dataset en blobdata werden hersteld op het geselecteerde tijdstip.
    Failed Het herstel is gestart, maar kon niet voltooien. Recensie errorDetails voor de zaak.
    Rejected De service kon het herstel niet starten, bijvoorbeeld omdat de dataset vergrendeld was of er geen herstelbare status beschikbaar was. Recensie errorDetails voor de zaak.

    Het volgende voorbeeld toont een afgewezen herstel:

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

Nadat de operatie is geslaagd, haal je de dataset op of download je deze en bevestig je dat de metadata en inhoud overeenkomen met de verwachte status.

Beperkingen en overwegingen

Houd rekening met de volgende beperkingen voordat je een herstel start:

  • Slechts één dataset—Elke aanvraag herstelt één dataset. Je kunt geen map specificeren, elke dataset onder een pad herstellen, of meerdere datasets in één verzoek indienen.
  • Vaste retentieperiode geldt—Je kunt niet herstellen naar een tijdstempel buiten de 30-dagen retentietermijn. De retentieperiode is niet configureerbaar en kan niet worden overschreven in het verzoek.
  • Eén herstel per datapartitie—Er kan slechts één hersteloperatie tegelijk in een datapartitie worden uitgevoerd, zelfs als een ander verzoek zich richt op een andere dataset. Een gelijktijdig verzoek geeft 409 Conflict.
  • Restore is asynchroon—Een 202 Accepted reactie is geen bevestiging van succes. Je moet het status-eindpunt pollen.
  • Schrijfopdrachten moeten worden gepauzeerd—Een actieve schrijfvergrendeling kan ervoor zorgen dat de bewerking wordt geweigerd. Werk de dataset niet bij of verwijder de dataset totdat de herstelfase een terminalstaat bereikt.
  • De huidige staat wordt vervangen—Een succesvolle herstel maakt de geselecteerde historische versie de huidige datasetstaat. Updates die na het herstelpunt zijn gemaakt, zijn niet aanwezig in de herstelde versie.
  • De beschikbaarheid van functies is beperkt—De hersteloperatie is een previewfunctie die ingeschakeld moet zijn voor een Standard SKU-instantie. Als het niet is ingeschakeld, geeft de dienst .403 Forbidden

De hulpbronnen opschonen

Deze tutorial maakt geen factureerbare Azure-bronnen. Als je een herstel hebt uitgevoerd voor testen, verifieer dan de status van de dataset voordat je schrijfoperaties hervat.

Verwante onderwerpen

  • Last updated on