Wiederherstellen der Partition

  • Artikel

Löst die Wiederherstellung des Zustands der Partition mithilfe der angegebenen Beschreibung der Wiederherstellungspartition aus.

Stellt den Zustand einer der zustandsbehafteten persistenten Partition mithilfe des angegebenen Sicherungspunkts wieder her. Falls die Partition bereits regelmäßig gesichert wird, wird der Sicherungspunkt standardmäßig in dem in der Sicherungsrichtlinie angegebenen Speicher gesucht. Sie können dasselbe auch überschreiben, indem Sie die Sicherungsspeicherdetails als Teil der Beschreibung der Wiederherstellungspartition im Text angeben. Nachdem die Wiederherstellung initiiert wurde, kann der Fortschritt mithilfe des Vorgangs GetRestoreProgress nachverfolgt werden. Falls für den Vorgang ein Timeout auftritt, geben Sie im Abfrageparameter einen höheren Timeoutwert für die Wiederherstellung an.

Anforderung

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

Parameter

Name type Erforderlich Standort
partitionId Zeichenfolge (uuid) Ja Pfad
RestoreTimeout integer Nein Abfrage
api-version Zeichenfolge Ja Abfrage
timeout ganze Zahl (int64) Nein Abfrage
RestorePartitionDescription RestorePartitionDescription Ja Body

partitionId

Typ: string (uuid)
Erforderlich: Ja

Die Identität (ID) der Partition.

RestoreTimeout

Typ: integer
Erforderlich: Nein
Standard:

Gibt die maximale Wartezeit in Minuten an, bis der Wiederherstellungsvorgang abgeschlossen ist. Danach wird der Vorgang mit einem Timeoutfehler zurückgegeben. In bestimmten Fällen kann es jedoch sein, dass der Wiederherstellungsvorgang durchläuft, obwohl er mit einem Timeout abgeschlossen wird. Bei einem Timeoutfehler wird empfohlen, diesen Vorgang erneut mit einem höheren Timeoutwert aufzurufen. Der Standardwert für dieselbe beträgt 10 Minuten.

api-version

Typ: Zeichenfolge
Erforderlich: Ja
Standard:

Die Version der API. Dieser Parameter ist erforderlich, und sein Wert muss "6.4" sein.

Die Rest-API-Version von Service Fabric basiert auf der Laufzeitversion, in der die API eingeführt oder geändert wurde. Die Service Fabric-Runtime unterstützt mehrere Versionen der API. Diese Version ist die neueste unterstützte Version der API. Wenn eine niedrigere API-Version übergeben wird, unterscheidet sich die zurückgegebene Antwort möglicherweise von der in dieser Spezifikation dokumentierten.

Darüber hinaus akzeptiert die Runtime jede Version, die höher als die neueste unterstützte Version bis zur aktuellen Version der Runtime ist. Wenn also die neueste API-Version 6.0 und die Runtime 6.1 ist, akzeptiert die Runtime Version 6.1 für diese API. Das Verhalten der API entspricht jedoch der dokumentierten Version 6.0.

timeout

Typ: integer (int64)
Erforderlich: Nein
Standard:
InclusiveMaximum: 4294967295
InklusiveMinimum: 1

Der Servertimeout für die Ausführung des Vorgangs in Sekunden. Dieser Timeout gibt die Zeitdauer an, die der Client bereit ist, auf den Abschluss des angeforderten Vorgangs zu warten. Der Standardwert für diesen Parameter ist 60 Sekunden.

RestorePartitionDescription

Typ: RestorePartitionDescription
Erforderlich: Ja

Beschreibt die Parameter zum Wiederherstellen der Partition.

Antworten

HTTP-Statuscode BESCHREIBUNG Antwortschema
202 (Akzeptiert) Ein 202 status Code gibt an, dass die Vorgangsanforderung akzeptiert wurde und die Wiederherstellung initiiert wird. Verwenden Sie den GetPartitionRestoreProgress-Vorgang, um die status des Wiederherstellungsvorgangs abzurufen.
Alle anderen status Codes Die detaillierte Fehlerantwort.
 FabricError

Beispiele

Auslösen der Partitionswiederherstellung

In diesem Beispiel wird gezeigt, wie Sie die Wiederherstellung einer Partition jetzt auslösen, indem Sie die sicherung angeben, die für die Wiederherstellung verwendet werden soll.

Anforderung

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

Antwort 202

Text

Der Antworttext ist leer.