Freigeben über

Sicherungspartition

  • Artikel

Löst die Sicherung des Partitionsstatus aus.

Erstellt eine Sicherung des Zustands der zustandsbehafteten persistenten Partition. Falls die Partition bereits regelmäßig gesichert wird, wird die neue Sicherung standardmäßig im gleichen Sicherungsspeicher erstellt. Sie können dasselbe auch überschreiben, indem Sie die Sicherungsspeicherdetails als Teil des Anforderungstexts angeben. Nachdem die Sicherung initiiert wurde, kann der Fortschritt mithilfe des Vorgangs GetBackupProgress nachverfolgt werden. Falls für den Vorgang ein Timeout auftritt, geben Sie im Abfrageparameter einen höheren Wert für das Sicherungstimeout an.

Anforderung

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

Parameter

Name type Erforderlich Standort
partitionId Zeichenfolge (uuid) Ja Pfad
BackupTimeout integer Nein Abfrage
api-version Zeichenfolge Ja Abfrage
timeout ganze Zahl (int64) Nein Abfrage
BackupPartitionDescription BackupPartitionDescription Nein Text

partitionId

Typ: string (uuid)
Erforderlich: Ja

Die Identität (ID) der Partition.

BackupTimeout

Typ: integer
Erforderlich: Nein
Standard:

Gibt die maximale Zeitspanne in Minuten an, die auf den Abschluss des Sicherungsvorgangs gewartet werden soll. Danach wird der Vorgang mit einem Timeoutfehler abgeschlossen. In bestimmten Fällen kann es jedoch sein, dass die Sicherung tatsächlich durchläuft, obwohl der Vorgang das Timeout zurückgibt. 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.

BackupPartitionDescription

Typ: BackupPartitionDescription
Erforderlich: Nein

Beschreibt die Parameter, um die Partition jetzt zu sichern. Falls nicht vorhanden, verwendet der Sicherungsvorgang Standardparameter aus der aktuellen Sicherungsrichtlinie, die dieser Partition zugeordnet ist.

Antworten

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

Beispiele

Sicherungspartition

In diesem Beispiel wird gezeigt, wie Sie jetzt die Sicherung einer Partition auslösen, die bereits für regelmäßige Sicherungen konfiguriert ist. Die neu erstellte Sicherung wird an demselben Speicherort gespeichert, an dem die regelmäßigen Sicherungen gespeichert werden.

Anforderung

POST http://localhost:19080/Partitions/1daae3f5-7fd6-42e9-b1ba-8c05f873994d/$/Backup?api-version=6.4
Text
{}

Antwort 202

Text

Der Antworttext ist leer.

Sichern einer Partition in einem bestimmten Azure-Speicherkonto

In diesem Beispiel wird gezeigt, wie Sie jetzt die Sicherung einer Partition auslösen und die Sicherung in einem bestimmten Azure Blob Storage-Konto speichern.

Anforderung

POST http://localhost:19080/Partitions/1daae3f5-7fd6-42e9-b1ba-8c05f873994d/$/Backup?api-version=6.4
Text
{
  "BackupStorage": {
    "StorageKind": "AzureBlobStore",
    "ConnectionString": "DefaultEndpointsProtocol=https;AccountName=storagesample;AccountKey=<PutYourAccountKeyHere>",
    "ContainerName": "BackupContainer"
  }
}

Antwort 202

Text

Der Antworttext ist leer.

Sichern der Partition an einem bestimmten Azure-Speicherort, auf den mithilfe einer verwalteten Identität zugegriffen wird

In diesem Beispiel wird gezeigt, wie Sie jetzt die Sicherung einer Partition auslösen und die Sicherung mithilfe einer verwalteten Identität in einem bestimmten Azure Blob Storage-Konto speichern.

Anforderung

POST http://localhost:19080/Partitions/1daae3f5-7fd6-42e9-b1ba-8c05f873994d/$/Backup?api-version=6.4
Text
{
  "BackupStorage": {
    "StorageKind": "ManagedIdentityAzureBlobStore",
    "BlobServiceUri": "https://managedidentitytest.blob.core.windows.net/",
    "ContainerName": "BackupContainer",
    "ManagedIdentityType": "Cluster"
  }
}

Antwort 202

Text

Der Antworttext ist leer.

Sichern einer Partition in einer bestimmten lokalen Dateifreigabe

In diesem Beispiel wird gezeigt, wie Sie jetzt die Sicherung einer Partition auslösen und die Sicherung in einer bestimmten Dateifreigabe speichern, auf die von allen Clusterknoten aus zugegriffen werden kann.

Anforderung

POST http://localhost:19080/Partitions/1daae3f5-7fd6-42e9-b1ba-8c05f873994d/$/Backup?api-version=6.4
Text
{
  "BackupStorage": {
    "StorageKind": "FileShare",
    "Path": "\\\\myshare\\backupshare",
    "PrimaryUserName": "mydomain\\backupaccount",
    "PrimaryPassword": "abcd1234"
  }
}

Antwort 202

Text

Der Antworttext ist leer.

Sichern einer Partition an einem bestimmten Dsms-Azure-Speicherort

In diesem Beispiel wird gezeigt, wie Sie jetzt die Sicherung einer Partition auslösen und die Sicherung an einem bestimmten Azure Blob Storage-Speicherort von Dsms speichern.

Anforderung

POST http://localhost:19080/Partitions/1daae3f5-7fd6-42e9-b1ba-8c05f873994d/$/Backup?api-version=6.4
Text
{
  "BackupStorage": {
    "StorageKind": "DsmsAzureBlobStore",
    "StorageCredentialsSourceLocation": "https://sample-dsms.dsms.core.winows.net/dsms/samplecredentiallocation/storageaccounts/samplestorageac/servicefabricbackup/samplebackup",
    "ContainerName": "BackupContainer"
  }
}

Antwort 202

Text

Der Antworttext ist leer.