Voortgang van partitieback-up ophalen

  • Artikel

Hiermee haalt u details op voor de meest recente back-up die voor deze partitie is geactiveerd.

Retourneert informatie over de status van de meest recente back-up, samen met details of reden van fout in geval van voltooiing.

Aanvraag

Methode Aanvraag-URI
GET /Partitions/{partitionId}/$/GetBackupProgress?api-version=6.4&timeout={timeout}

Parameters

Naam Type Vereist Locatie
partitionId tekenreeks (uuid) Ja Pad
api-version tekenreeks Ja Query’s uitvoeren
timeout geheel getal (int64) Nee Query’s uitvoeren

partitionId

Type: tekenreeks (uuid)
Vereist: Ja

De identiteit van de partitie.

api-version

Type: tekenreeks
Vereist: Ja
Standaardinstelling: 6.4

De versie van de API. Deze parameter is vereist en de waarde moet '6.4' zijn.

Service Fabric REST API-versie is gebaseerd op de runtimeversie waarin de API is geïntroduceerd of gewijzigd. Service Fabric-runtime ondersteunt meer dan één versie van de API. Deze versie is de meest recente ondersteunde versie van de API. Als een lagere API-versie wordt doorgegeven, kan het geretourneerde antwoord afwijken van het antwoord dat in deze specificatie wordt beschreven.

Daarnaast accepteert de runtime elke versie die hoger is dan de meest recente ondersteunde versie tot de huidige versie van de runtime. Dus als de nieuwste API-versie 6.0 is en de runtime 6.1 is, accepteert de runtime versie 6.1 voor die API. Het gedrag van de API is echter volgens de gedocumenteerde versie 6.0.

timeout

Type: geheel getal (int64)
Vereist: Nee
Standaardinstelling: 60
InclusiveMaximum: 4294967295
InclusiefMinimum: 1

De time-out van de server voor het uitvoeren van de bewerking in seconden. Deze time-out geeft de tijdsduur aan die de client bereid is te wachten totdat de aangevraagde bewerking is voltooid. De standaardwaarde voor deze parameter is 60 seconden.

Antwoorden

HTTP-statuscode Beschrijving Antwoordschema
200 (OK) Een geslaagde bewerking retourneert 200 statuscode en details van de back-upvoortgang.
 BackupProgressInfo
Alle andere statuscodes Het gedetailleerde foutantwoord.
 FabricError

Voorbeelden

Voortgang van back-upbewerking ophalen

Hier ziet u een voorbeeld van mogelijke uitvoer wanneer GetPartitionBackupProgress een BackupState of Success heeft bereikt. Als de BackupState de waarde BackupInProgress heeft, heeft alleen het veld BackupState een waarde.

Aanvraag

GET http://localhost:19080/Partitions/1daae3f5-7fd6-42e9-b1ba-8c05f873994d/$/GetBackupProgress?api-version=6.4

200-antwoord

Hoofdtekst
{
  "BackupState": "Success",
  "TimeStampUtc": "2018-01-01T09:00:55Z",
  "BackupId": "3a056ac9-7206-43c3-8424-6f6103003eba",
  "BackupLocation": "CalcApp\\CalcService\\1daae3f5-7fd6-42e9-b1ba-8c05f873994d\\2018-01-01 09.00.55.zip",
  "EpochOfLastBackupRecord": {
    "DataLossVersion": "131462452931584510",
    "ConfigurationVersion": "8589934592"
  },
  "LsnOfLastBackupRecord": "261",
  "FailureError": null
}