Status des Datenverlusts

Ruft den Status eines Partitionsdatenverlustvorgangs ab, der über die StartDataLoss-API gestartet wurde.

Ruft über die OperationId den Status eines Datenverlustvorgangs ab, der mit StartDataLoss gestartet wurde.

Anforderung

Methode Anforderungs-URI
GET /Faults/Services/{serviceId}/$/GetPartitions/{partitionId}/$/GetDataLossProgress?api-version=6.0&OperationId={OperationId}&timeout={timeout}

Parameter

Name type Erforderlich Standort
serviceId Zeichenfolge Ja Path
partitionId Zeichenfolge (uuid) Ja Path
api-version Zeichenfolge Ja Abfrage
OperationId Zeichenfolge (uuid) Ja Abfrage
timeout integer (int64) Nein Abfrage

serviceId

Typ: Zeichenfolge
Erforderlich: Ja

Die Identität (ID) des Diensts. Diese ID ist in der Regel der vollständige Name des Diensts ohne das URI-Schema "fabric:". Ab Version 6.0 wird für hierarchische Namen das Zeichen „~“ als Trennzeichen verwendet. Wenn der Dienstname beispielsweise "fabric:/myapp/app1/svc1" ist, würde die Dienstidentität in 6.0+ "myapp~app1~svc1" und in früheren Versionen "myapp/app1/svc1" sein.


partitionId

Typ: string (uuid)
Erforderlich: Ja

Die Identität (ID) der Partition.


api-version

Typ: Zeichenfolge
Erforderlich: Ja
Standard: 6.0

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

Service Fabric REST-API-Version basiert auf der Laufzeitversion, in der die API eingeführt oder geändert wurde. Service Fabric Runtime unterstützt mehr als eine Version der API. Dies ist die neueste unterstützte Version der API. Wenn eine niedrigere API-Version übergeben wird, kann sich die zurückgegebene Antwort von der in dieser Spezifikation dokumentierten unterscheiden.

Darüber hinaus akzeptiert die Runtime alle Versionen, die höher als die neueste unterstützte Version bis zur aktuellen Version der Runtime sind. Wenn also die neueste API-Version 6.0, aber die Runtime 6.1 ist, akzeptiert die Runtime Version 6.1 für diese API, um das Schreiben der Clients zu vereinfachen. Das Verhalten der API wird jedoch wie in der dokumentierten Version 6.0 definiert.


OperationId

Typ: string (uuid)
Erforderlich: Ja

Eine GUID, die einen Aufruf dieser API kennzeichnet. Dies wird an die entsprechende GetProgress-API übergeben.


timeout

Typ: integer (int64)
Erforderlich: Nein
Standard: 60
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.

Antworten

HTTP-Statuscode BESCHREIBUNG Antwortschema
200 (OK) Informationen zum Fortschritt des Vorgangs zum Verlust von Partitionsdaten.
PartitionDataLossProgress
Alle anderen Statuscodes Die ausführliche Fehlerantwort.
FabricError

Beispiele

Ruft Informationen zu einem Partitionsdatenverlustvorgang ab. In diesem Fall hat der Vorgang den Status Abgeschlossen.

Dies zeigt ein Beispiel für eine mögliche Ausgabe, wenn GetDataLossProgress den Status Abgeschlossen erreicht hat. Wenn der Status den Wert Wird ausgeführt auf hat, hat nur das Feld State einen Wert.

Anforderung

GET http://localhost:19080/Faults/Services/fabric:/myapp/myservice/$/GetPartitions/1daae3f5-7fd6-42e9-b1ba-8c05f873994d/$/GetDataLossProgress?api-version=6.0&OperationId=7216486c-1ee9-4b00-99b2-92b26fcb07f5

200-Antwort

Body
{
  "State": "Completed",
  "InvokeDataLossResult": {
    "ErrorCode": "0",
    "SelectedPartition": {
      "ServiceName": "fabric:/myapp/myservice",
      "PartitionId": "1daae3f5-7fd6-42e9-b1ba-8c05f873994d"
    }
  }
}

Hier erhalten Sie Informationen zu einem Partitionsdatenverlustvorgang. In diesem Fall hat der Vorgang den Status Wird ausgeführt.

Dies zeigt ein Beispiel für die Ausgabe, wenn sich ein Datenverlustvorgang im Status Wird ausgeführt befindet. Wenn für State der Wert Wird ausgeführt angezeigt wird, hat nur das Feld State einen Wert.

Anforderung

GET http://localhost:19080/Faults/Services/fabric:/myapp/myservice/$/GetPartitions/1daae3f5-7fd6-42e9-b1ba-8c05f873994d/$/GetDataLossProgress?api-version=6.0&OperationId=7216486c-1ee9-4b00-99b2-92b26fcb07f5

200-Antwort

Body
{
  "State": "Running"
}