Återställa partition

  • Artikel

Utlöser återställning av partitionens tillstånd med hjälp av den angivna beskrivningen av återställningspartitionen.

Återställer tillståndet för en tillståndskänslig bevarad partition med den angivna säkerhetskopieringspunkten. Om partitionen redan säkerhetskopieras regelbundet söker du som standard efter säkerhetskopieringspunkten i den lagring som anges i säkerhetskopieringspolicyn. Man kan också åsidosätta samma genom att ange information om lagring av säkerhetskopior som en del av beskrivningen av återställningspartitionen i brödtexten. När återställningen har initierats kan förloppet spåras med hjälp av åtgärden GetRestoreProgress. Om tidsgränsen uppnås för åtgärden anger du ett större timeoutvärde för återställning i frågeparametern.

Förfrågan

Metod URI för förfrågan
POST /Partitions/{partitionId}/$/Restore?RestoreTimeout={RestoreTimeout}&api-version=6.4&timeout={timeout}

Parametrar

Namn Typ Obligatorisk Location
partitionId sträng (uuid) Yes Sökväg
RestoreTimeout heltal No Söka i data
api-version sträng Ja Söka i data
timeout heltal (int64) No Söka i data
RestorePartitionDescription RestorePartitionDescription Yes Brödtext

partitionId

Typ: sträng (uuid)
Krävs: Ja

Partitionens identitet.

RestoreTimeout

Typ: heltal
Krävs: Nej
Standard: 10

Anger den maximala väntetiden i minuter för att återställningen ska slutföras. Efter det returnerar åtgärden tillbaka med timeoutfel. I vissa hörn kan det dock vara så att återställningsåtgärden går igenom även om den slutförs med timeout. Vid timeout-fel rekommenderar vi att du anropar den här åtgärden igen med ett större timeout-värde. standardvärdet för samma är 10 minuter.

api-version

Typ: sträng
Krävs: Ja
Standard: 6.4

Versionen av API:et. Den här parametern krävs och dess värde måste vara "6.4".

Service Fabric REST API-versionen baseras på körningsversionen där API:et introducerades eller ändrades. Service Fabric Runtime stöder mer än en version av API:et. Den här versionen är den senaste versionen av API:et som stöds. Om en lägre API-version skickas kan det returnerade svaret skilja sig från det som dokumenteras i den här specifikationen.

Dessutom accepterar körningen alla versioner som är högre än den senaste versionen som stöds upp till den aktuella versionen av körningen. Så om den senaste API-versionen är 6.0 och körningen är 6.1 accepterar körningen version 6.1 för det API:et. Beteendet för API:et är dock enligt den dokumenterade 6.0-versionen.

timeout

Typ: heltal (int64)
Krävs: Nej
Standard: 60
InclusiveMaximum: 4294967295
InclusiveMinimum: 1

Serverns tidsgräns för att utföra åtgärden i sekunder. Den här tidsgränsen anger hur lång tid klienten är villig att vänta på att den begärda åtgärden ska slutföras. Standardvärdet för den här parametern är 60 sekunder.

RestorePartitionDescription

Typ: RestorePartitionDescription
Krävs: Ja

Beskriver parametrarna för att återställa partitionen.

Svar

HTTP-statuskod Description Svarsschema
202 (godkänd) En statuskod från 202 anger att åtgärdsbegäran accepterades och att återställningen initieras. Använd GetPartitionRestoreProgress-åtgärden för att hämta status för återställningsåtgärden.
Alla andra statuskoder Det detaljerade felsvaret.
 FabricError

Exempel

Utlösa partitionsåterställning

Det här exemplet visar hur du utlöser återställning av en partition nu genom att ange den säkerhetskopia som ska användas för återställning.

Förfrågan

POST http://localhost:19080/Partitions/1daae3f5-7fd6-42e9-b1ba-8c05f873994d/$/Restore?api-version=6.4
Brödtext
{
  "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"
}

202-svar

Brödtext

Svarstexten är tom.