Condividi tramite

Ottenere l'elenco di backup delle partizioni

  • Articolo

Ottiene l'elenco dei backup disponibili per la partizione specificata.

restituisce l'elenco dei backup disponibili per la partizione specificata. Il server enumera tutti i backup disponibili nell'archivio di backup configurato nei criteri di backup. Consente anche di filtrare il risultato in base all'ora di inizio e alla fine o semplicemente recuperando il backup disponibile più recente per la partizione.

Richiesta

Metodo URI richiesta
GET /Partitions/{partitionId}/$/GetBackups?api-version=6.4&timeout={timeout}&Latest={Latest}&StartDateTimeFilter={StartDateTimeFilter}&EndDateTimeFilter={EndDateTimeFilter}

Parametri

Nome Tipo Necessario Posizione
partitionId string (uuid) Sì Percorso
api-version string Sì Query
timeout integer (int64) No Query
Latest boolean No Query
StartDateTimeFilter string (date-time) No Query
EndDateTimeFilter string (date-time) No Query

partitionId

Tipo: string (uuid)
Obbligatorio: Sì

L'identità della partizione.

api-version

Tipo: string
Obbligatorio: Sì
Impostazione predefinita: 6.4

Versione dell'API. Questo parametro è obbligatorio e il relativo valore deve essere '6,4'.

La versione dell'API REST di Service Fabric è basata sulla versione di runtime in cui è stata introdotta o modificata l'API. Il runtime di Service Fabric supporta più versioni dell'API. Questa versione è la versione supportata più recente dell'API. Se viene passata una versione precedente dell'API, la risposta restituita può essere diversa da quella documentata in questa specifica.

Inoltre, il runtime accetta qualsiasi versione successiva alla versione supportata più recente fino alla versione corrente del runtime. Se quindi la versione più recente dell'API è 6.0 e il runtime è 6.1, il runtime accetterà la versione 6.1 per tale API. Tuttavia, il comportamento dell'API sarà in base alla versione 6.0 documentata.

timeout

Tipo: integer (int64)
Obbligatorio: No
Impostazione predefinita: 60
InclusiveMaximum: 4294967295
InclusiveMinimum: 1

Timeout del server per l'esecuzione dell'operazione in secondi. Questo timeout specifica la durata di attesa che il client è disposto a attendere il completamento dell'operazione richiesta. Il valore predefinito per questo parametro è 60 secondi.

Latest

Tipo: booleano
Obbligatorio: No
Impostazione predefinita: false

Specifica se ottenere solo il backup più recente disponibile per una partizione per l'intervallo di tempo specificato.

StartDateTimeFilter

Tipo: string (data-ora)
Obbligatorio: No

Specificare l'ora di inizio da cui enumerare i backup, in formato datetime. La data deve essere specificata in formato ISO8601. Questo parametro è facoltativo. Se non specificato, vengono enumerati tutti i backup dall'inizio.

EndDateTimeFilter

Tipo: string (data-ora)
Obbligatorio: No

Specificare l'ora di fine fino alla quale enumerare i backup, in formato datetime. La data deve essere specificata in formato ISO8601. Questo parametro è facoltativo. Se non specificato, l'enumerazione viene eseguita fino al backup più recente.

Risposte

Codice di stato HTTP Descrizione Schema di risposta
200 (OK) Un'operazione completata restituirà il codice di stato 200 e un elenco di informazioni di backup di paging.
 PagedBackupInfoList
Tutti gli altri codici di stato Risposta dettagliata all'errore.
 FabricError

Esempio

Ottenere i backup dell'applicazione entro un intervallo di tempo

In questo esempio viene illustrato come ottenere l'elenco dei backup delle partizioni in un intervallo di tempo.

Richiesta

GET http://localhost:19080/Partitions/1daae3f5-7fd6-42e9-b1ba-8c05f873994d/$/GetBackups?api-version=6.4&StartDateTimeFilter=2018-01-01T00:00:00Z&EndDateTimeFilter=2018-01-01T23:59:59Z

200 Risposta

Corpo
{
  "ContinuationToken": "",
  "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
    }
  ]
}

Ottenere il backup più recente

In questo esempio viene illustrato come ottenere il backup più recente per la partizione specificata.

Richiesta

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

200 Risposta

Corpo
{
  "ContinuationToken": "",
  "Items": [
    {
      "BackupId": "be06a49c-be67-4eb1-a602-b983605be862",
      "BackupChainId": "be06a49c-be67-4eb1-a602-b983605be862",
      "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-02 08.59.53.zip",
      "BackupType": "Full",
      "EpochOfLastBackupRecord": {
        "DataLossVersion": "131462452931584510",
        "ConfigurationVersion": "8589934592"
      },
      "LsnOfLastBackupRecord": "639",
      "CreationTimeUtc": "2018-01-02T08:59:53Z",
      "FailureError": null
    }
  ]
}

Limitare i risultati massimi

In questo esempio viene illustrato come ottenere l'elenco dei backup delle partizioni. Il numero di risultati in una pagina è limitato al massimo due usando il parametro MaxResult.

Richiesta

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

200 Risposta

Corpo
{
  "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
    }
  ]
}

Pagina con token di continuazione

In questo esempio viene illustrato come ottenere un elenco di backup delle partizioni. Il numero di risultati in una pagina è limitato a un massimo di due usando il parametro MaxResult. In questo esempio viene usato il parametro ContinuationToken. Il valore di questo parametro viene fornito dalla query precedente; in questo caso l'esempio illustrato sopra. La risposta contiene i risultati rimanenti e una continuazione vuotaToken. La continuazione vuotaToken indica che non sono disponibili risultati aggiuntivi.

Richiesta

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

Risposta 200

Corpo
{
  "ContinuationToken": "",
  "Items": [
    {
      "BackupId": "be06a49c-be67-4eb1-a602-b983605be862",
      "BackupChainId": "be06a49c-be67-4eb1-a602-b983605be862",
      "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-02 08.59.53.zip",
      "BackupType": "Full",
      "EpochOfLastBackupRecord": {
        "DataLossVersion": "131462452931584510",
        "ConfigurationVersion": "8589934592"
      },
      "LsnOfLastBackupRecord": "639",
      "CreationTimeUtc": "2018-01-02T08:59:53Z",
      "FailureError": null
    }
  ]
}