Biztonsági másolatok lekérése biztonsági mentési helyről

Lekéri a megadott biztonsági mentési entitáshoz elérhető biztonsági másolatok listáját a megadott biztonsági mentési helyen.

Lekéri a megadott biztonsági mentési entitáshoz (alkalmazás, szolgáltatás vagy partíció) elérhető biztonsági másolatok listáját a megadott biztonsági mentési helyen (Fájlmegosztás vagy Azure Blob Storage).

Kérés

Metódus Kérés URI-ja
POST /BackupRestore/$/GetBackups?api-version=6.4&timeout={timeout}&ContinuationToken={ContinuationToken}&MaxResults={MaxResults}

Paraméterek

Név Típus Kötelező Hely
api-version sztring Igen Lekérdezés
timeout egész szám (int64) No Lekérdezés
ContinuationToken sztring No Lekérdezés
MaxResults egész szám (int64) No Lekérdezés
GetBackupByStorageQueryDescription GetBackupByStorageQueryDescription Yes Törzs

api-version

Típus: sztring
Kötelező: Igen
Alapértelmezett: 6.4

Az API verziója. Ez a paraméter kötelező, értéke pedig "6.4".

A Service Fabric REST API-verziója azon a futtatókörnyezeti verzión alapul, amelyben az API-t bevezették vagy módosították. A Service Fabric-futtatókörnyezet az API több verzióját is támogatja. Ez a verzió az API legújabb támogatott verziója. Ha egy alacsonyabb API-verziót ad át, a visszaadott válasz eltérhet az ebben a specifikációban dokumentálttól.

Emellett a futtatókörnyezet minden olyan verziót elfogad, amely a legújabb támogatott verziónál magasabb a futtatókörnyezet aktuális verziójáig. Tehát ha az API legújabb verziója 6.0, a futtatókörnyezet pedig 6.1, akkor a futtatókörnyezet elfogadja az API 6.1-es verzióját. Az API viselkedése azonban a dokumentált 6.0-s verziónak megfelelően fog változni.

timeout

Típus: egész szám (int64)
Kötelező: Nem
Alapértelmezett: 60
InclusiveMaximum: 4294967295
InclusiveMinimum: 1

A kiszolgáló időtúllépése a művelet másodpercben történő végrehajtásához. Ez az időtúllépés azt az időtartamot adja meg, amelyet az ügyfél hajlandó megvárni a kért művelet befejezéséig. A paraméter alapértelmezett értéke 60 másodperc.

ContinuationToken

Típus: sztring
Kötelező: Nem

A folytatási jogkivonat paramétere a következő eredmények lekérésére szolgál. Az API válaszában szerepel egy nem üres értékkel rendelkező folytatási jogkivonat, ha a rendszer eredményei nem férnek el egyetlen válaszban. Amikor ezt az értéket átadja a következő API-hívásnak, az API a következő eredményhalmazt adja vissza. Ha nincs további eredmény, akkor a folytatási jogkivonat nem tartalmaz értéket. Ennek a paraméternek az értéke nem lehet URL-kódolású.

MaxResults

Típus: egész szám (int64)
Kötelező: Nem
Alapértelmezett: 0
InclusiveMinimum: 0

A lapozott lekérdezések részeként visszaadandó eredmények maximális száma. Ez a paraméter határozza meg a visszaadott eredmények számának felső határát. A visszaadott eredmények kisebbek lehetnek a megadott maximális eredménynél, ha nem férnek el az üzenetben a konfigurációban meghatározott maximális üzenetméret-korlátozásoknak megfelelően. Ha ez a paraméter nulla vagy nincs megadva, a lapozott lekérdezés a lehető legtöbb eredményt tartalmazza, amely illeszkedik a visszatérési üzenetbe.

GetBackupByStorageQueryDescription

Típus: GetBackupByStorageQueryDescription
Kötelező: Igen

A biztonsági mentések számbavételéhez használandó szűrőket és biztonsági mentési tár adatait ismerteti.

Válaszok

HTTP-állapotkód Description Válaszséma
200 (OK) A sikeres művelet 200 állapotkódot és a biztonsági mentési információk lapozott listáját adja vissza.
 PagedBackupInfoList
Minden más állapotkód A részletes hibaválasz.
 FabricError

Példák

Maximális eredmények korlátozása

Ez a példa bemutatja, hogyan szerezheti be az alkalmazás biztonsági mentéseinek listáját egy megadott biztonsági mentési helyről. Egy lapon az eredmények száma legfeljebb kettő lehet a MaxResult paraméterrel.

Kérés

POST http://localhost:19080/BackupRestore/$/GetBackups?api-version=6.4&MaxResults=2
Törzs
{
  "Storage": {
    "StorageKind": "AzureBlobStore",
    "ConnectionString": "DefaultEndpointsProtocol=https;AccountName=storagesample;AccountKey=<PutYourAccountKeyHere>",
    "ContainerName": "BackupContainer"
  },
  "BackupEntity": {
    "EntityKind": "Application",
    "ApplicationName": "fabric:/CalcApp"
  }
}

200 Válasz

Törzs
{
  "ContinuationToken": "fabric:/CalcApp/CalcService#1daae3f5-7fd6-42e9-b1ba-8c05f873994d#7903dc2a-228d-44b0-b7c8-a13a6c9b46bd",
  "Items": [
    {
      "BackupId": "3a056ac9-7206-43c3-8424-6f6103003eba",
      "BackupChainId": "3a056ac9-7206-43c3-8424-6f6103003eba",
      "ApplicationName": "fabric:/CalcApp",
      "ServiceManifestVersion": "1.0.0",
      "ServiceName": "fabric:/CalcApp/CalcService",
      "PartitionInformation": {
        "LowKey": "-9223372036854775808",
        "HighKey": "9223372036854775807",
        "ServicePartitionKind": "Int64Range",
        "Id": "1daae3f5-7fd6-42e9-b1ba-8c05f873994d"
      },
      "BackupLocation": "CalcApp\\CalcService\\1daae3f5-7fd6-42e9-b1ba-8c05f873994d\\2018-01-01 09.00.55.zip",
      "BackupType": "Full",
      "EpochOfLastBackupRecord": {
        "DataLossVersion": "131462452931584510",
        "ConfigurationVersion": "8589934592"
      },
      "LsnOfLastBackupRecord": "261",
      "CreationTimeUtc": "2018-01-01T09:00:55Z",
      "FailureError": null
    },
    {
      "BackupId": "7903dc2a-228d-44b0-b7c8-a13a6c9b46bd",
      "BackupChainId": "3a056ac9-7206-43c3-8424-6f6103003eba",
      "ApplicationName": "fabric:/CalcApp",
      "ServiceManifestVersion": "1.0.0",
      "ServiceName": "fabric:/CalcApp/CalcService",
      "PartitionInformation": {
        "LowKey": "-9223372036854775808",
        "HighKey": "9223372036854775807",
        "ServicePartitionKind": "Int64Range",
        "Id": "1daae3f5-7fd6-42e9-b1ba-8c05f873994d"
      },
      "BackupLocation": "CalcApp\\CalcService\\1daae3f5-7fd6-42e9-b1ba-8c05f873994d\\2018-01-01 17.01.02.zip",
      "BackupType": "Incremental",
      "EpochOfLastBackupRecord": {
        "DataLossVersion": "131462452931584510",
        "ConfigurationVersion": "8589934592"
      },
      "LsnOfLastBackupRecord": "446",
      "CreationTimeUtc": "2018-01-01T17:01:02Z",
      "FailureError": null
    }
  ]
}

Oldal folytatási jogkivonattal

Ez a példa bemutatja, hogyan szerezheti be az alkalmazás biztonsági másolatainak listáját. Egy lapon az eredmények száma legfeljebb kettő lehet a MaxResult paraméterrel. Ez a példa a ContinuationToken paramétert használja. Ennek a paraméternek az értéke az előző lekérdezésből származik; ebben az esetben a fenti példa. A válasz tartalmazza a fennmaradó eredményeket és egy üres ContinuationToken értéket. Az üres ContinuationToken azt jelzi, hogy további eredmények nem érhetők el.

Kérés

POST http://localhost:19080/BackupRestore/$/GetBackups?api-version=6.4&ContinuationToken=fabric:/CalcApp/CalcService#1daae3f5-7fd6-42e9-b1ba-8c05f873994d#7903dc2a-228d-44b0-b7c8-a13a6c9b46bd&MaxResults=2
Törzs
{
  "Storage": {
    "StorageKind": "AzureBlobStore",
    "ConnectionString": "DefaultEndpointsProtocol=https;AccountName=storagesample;AccountKey=<PutYourAccountKeyHere>",
    "ContainerName": "BackupContainer"
  },
  "BackupEntity": {
    "EntityKind": "Application",
    "ApplicationName": "fabric:/CalcApp"
  }
}

200 Válasz

Törzs
{
  "ContinuationToken": "",
  "Items": [
    {
      "BackupId": "0ff4fdbe-131c-4dfb-8249-7b4029ddc014",
      "BackupChainId": "0ff4fdbe-131c-4dfb-8249-7b4029ddc014",
      "ApplicationName": "fabric:/CalcApp",
      "ServiceManifestVersion": "1.0.0",
      "ServiceName": "fabric:/CalcApp/CalcService",
      "PartitionInformation": {
        "LowKey": "-9223372036854775808",
        "HighKey": "9223372036854775807",
        "ServicePartitionKind": "Int64Range",
        "Id": "81645ec7-d260-4c59-9533-8f129bde8e83"
      },
      "BackupLocation": "CalcApp\\CalcService\\81645ec7-d260-4c59-9533-8f129bde8e83\\2018-01-01 09.01.02.zip",
      "BackupType": "Full",
      "EpochOfLastBackupRecord": {
        "DataLossVersion": "131462452931584510",
        "ConfigurationVersion": "8589934592"
      },
      "LsnOfLastBackupRecord": "161",
      "CreationTimeUtc": "2018-01-01T09:01:02Z",
      "FailureError": null
    },
    {
      "BackupId": "d55a2d98-258b-4a34-8fe5-2063e81af9dc",
      "BackupChainId": "0ff4fdbe-131c-4dfb-8249-7b4029ddc014",
      "ApplicationName": "fabric:/CalcApp",
      "ServiceManifestVersion": "1.0.0",
      "ServiceName": "fabric:/CalcApp/CalcService",
      "PartitionInformation": {
        "LowKey": "-9223372036854775808",
        "HighKey": "9223372036854775807",
        "ServicePartitionKind": "Int64Range",
        "Id": "81645ec7-d260-4c59-9533-8f129bde8e83"
      },
      "BackupLocation": "CalcApp\\CalcService\\81645ec7-d260-4c59-9533-8f129bde8e83\\2018-01-01 17.00.34.zip",
      "BackupType": "Incremental",
      "EpochOfLastBackupRecord": {
        "DataLossVersion": "131462452931584510",
        "ConfigurationVersion": "8589934592"
      },
      "LsnOfLastBackupRecord": "246",
      "CreationTimeUtc": "2018-01-01T17:00:34Z",
      "FailureError": null
    }
  ]
}
  • Last updated on