Anhalten der Anwendungssicherung
Setzt die regelmäßige Sicherung für die angegebene Service Fabric-Anwendung an.
Die Anwendung, die für regelmäßige Sicherungen konfiguriert ist, wird für weitere Sicherungen angehalten, bis sie wieder fortgesetzt wird. Dieser Vorgang gilt für die gesamte Hierarchie der Anwendung. Dies bedeutet, dass alle Dienste und Partitionen unter dieser Anwendung jetzt für die Sicherung angehalten werden.
| Methode | Anforderungs-URI |
|---|---|
| POST | /Applications/{applicationId}/$/SuspendBackup?api-version=6.4&timeout={timeout} |
| Name | type | Erforderlich | Standort |
|---|---|---|---|
applicationId |
Zeichenfolge | Ja | Pfad |
api-version |
Zeichenfolge | Ja | Abfrage |
timeout |
ganze Zahl (int64) | Nein | Abfrage |
Typ: Zeichenfolge
Erforderlich: Ja
Die Identität (ID) der Anwendung. Dies ist üblicherweise der vollständige Name der Anwendung ohne das URI-Schema „fabric:“.
Ab Version 6.0 wird für hierarchische Namen das Zeichen „~“ als Trennzeichen verwendet.
Hat eine Anwendung beispielsweise den Namen „fabric://meineapp/app1“, hat die Anwendungsidentität in 6.0 und höher den Wert „meineapp~app1“ und in früheren Versionen den Wert „meineapp/app1“.
Typ: Zeichenfolge
Erforderlich: Ja
Standard:
Die Version der API. Dieser Parameter ist erforderlich, und sein Wert muss "6.4" sein.
Die Service Fabric-REST-API-Version 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.
Typ: integer (int64)
Erforderlich: Nein
Standard:
InclusiveMaximum: 4294967295
InclusiveMinimum: 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.
| HTTP-Statuscode | BESCHREIBUNG | Antwortschema |
|---|---|---|
| 202 (Akzeptiert) | Ein 202-status-Code gibt an, dass die Vorgangsanforderung akzeptiert wurde und die Anwendungssicherung angehalten wird. |
|
| Alle anderen status Codes | Die detaillierte Fehlerantwort. |
FabricError |
In diesem Beispiel wird gezeigt, wie Sie die Sicherung für eine zustandsbehaftete Anwendung anhalten, die für die regelmäßige Sicherung konfiguriert ist.
POST http://localhost:19080/Applications/CalcApp/$/SuspendBackup?api-version=6.4
Der Antworttext ist leer.