Återställa partition
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.