Condividi tramite

Ripristina partizione

  • Articolo

Attiva il ripristino dello stato della partizione usando la descrizione della partizione di ripristino specificata.

Ripristina lo stato di una partizione persistente con stato usando il punto di backup specificato. Nel caso in cui la partizione sia già stata eseguita periodicamente il backup, per impostazione predefinita il punto di backup viene cercato nell'archiviazione specificata nei criteri di backup. È anche possibile eseguire l'override dello stesso specificando i dettagli dell'archiviazione di backup come parte della descrizione della partizione di ripristino nel corpo. Dopo l'avvio del ripristino, è possibile tenere traccia dello stato di avanzamento usando l'operazione GetRestoreProgress. In caso contrario, l'operazione non viene eseguita, specificare un valore di timeout di ripristino maggiore nel parametro di query.

Richiesta

Metodo URI richiesta
POST /Partitions/{partitionId}/$/Restore?RestoreTimeout={RestoreTimeout}&api-version=6.4&timeout={timeout}

Parametri

Nome Tipo Necessario Posizione
partitionId string (uuid) Sì Percorso
RestoreTimeout numero intero No Query
api-version string Sì Query
timeout integer (int64) No Query
RestorePartitionDescription RestorePartitionDescription sì Corpo

partitionId

Tipo: stringa (uuid)
Obbligatorio: Sì

L'identità della partizione.

RestoreTimeout

Tipo: integer
Obbligatorio: No
Impostazione predefinita: 10

Specifica la quantità massima di tempo di attesa, in minuti, per il completamento dell'operazione di ripristino. Successivamente, l'operazione torna indietro con l'errore di timeout. Tuttavia, in alcuni casi, potrebbe essere che l'operazione di ripristino passa anche se completa con timeout. In caso di errore di timeout, è consigliabile richiamarlo di nuovo con un valore di timeout maggiore. il valore predefinito per lo stesso è di 10 minuti.

api-version

Tipo: stringa
Obbligatorio: Sì
Impostazione predefinita: 6.4

Versione dell'API. Questo parametro è obbligatorio e il relativo valore deve essere '6.4'.

La versione dell'API REST di Service Fabric è basata sulla versione di runtime in cui è stata introdotta o modificata l'API. Il runtime di Service Fabric supporta più versioni dell'API. Questa versione è la versione più recente supportata dell'API. Se viene passata una versione api inferiore, la risposta restituita può essere diversa da quella documentata in questa specifica.

Inoltre, il runtime accetta qualsiasi versione superiore alla versione supportata più recente fino alla versione corrente del runtime. Quindi, se la versione più recente dell'API è 6.0 e il runtime è 6.1, il runtime accetterà la versione 6.1 per tale API. Tuttavia, il comportamento dell'API sarà in base alla versione 6.0 documentata.

timeout

Tipo: integer (int64)
Obbligatorio: No
Impostazione predefinita: 60
InclusiveMaximum: 4294967295
InclusiveMinimum: 1

Timeout del server per l'esecuzione dell'operazione in secondi. Questo timeout specifica la durata del tempo che il client è disposto a attendere il completamento dell'operazione richiesta. Il valore predefinito per questo parametro è 60 secondi.

RestorePartitionDescription

Tipo: RestorePartitionDescription
Obbligatorio: Sì

Descrive i parametri per ripristinare la partizione.

Risposte

Codice di stato HTTP Descrizione Schema di risposta
202 (Accettato) Un codice di stato 202 indica che la richiesta di operazione è stata accettata e il ripristino verrà avviato. Usare l'operazione GetPartitionRestoreProgress per ottenere lo stato dell'operazione di ripristino.
Tutti gli altri codici di stato Risposta dettagliata all'errore.
 FabricError

Esempio

Attivare il ripristino della partizione

In questo esempio viene illustrato come attivare il ripristino di una partizione specificando il backup da usare per il ripristino.

Richiesta

POST http://localhost:19080/Partitions/1daae3f5-7fd6-42e9-b1ba-8c05f873994d/$/Restore?api-version=6.4
Corpo
{
  "BackupId": "3a056ac9-7206-43c3-8424-6f6103003eba",
  "BackupStorage": {
    "StorageKind": "AzureBlobStore",
    "ConnectionString": "DefaultEndpointsProtocol=https;AccountName=storagesample;AccountKey=<PutYourAccountKeyHere>",
    "ContainerName": "BackupContainer"
  },
  "BackupLocation": "CalcApp\\CalcService\\1daae3f5-7fd6-42e9-b1ba-8c05f873994d\\2018-01-01 09.00.55.zip"
}

Risposta 202

Corpo

Il corpo della risposta è vuoto.