Condividi tramite

Partizione di backup

  • Articolo

Attiva il backup dello stato della partizione.

Crea un backup dello stato della partizione persistente con stato. Nel caso in cui il backup della partizione sia già stato eseguito periodicamente, per impostazione predefinita viene creato il nuovo backup nella stessa risorsa di archiviazione di backup. È anche possibile eseguire l'override dello stesso specificando i dettagli dell'archiviazione di backup come parte del corpo della richiesta. Dopo l'avvio del backup, è possibile tenere traccia dello stato di avanzamento usando l'operazione GetBackupProgress. In caso di timeout dell'operazione, specificare un valore di timeout di backup maggiore nel parametro di query.

Richiesta

Metodo URI richiesta
POST /Partitions/{partitionId}/$/Backup?BackupTimeout={BackupTimeout}&api-version=6.4&timeout={timeout}

Parametri

Nome Tipo Necessario Posizione
partitionId string (uuid) Sì Percorso
BackupTimeout numero intero No Query
api-version string Sì Query
timeout integer (int64) No Query
BackupPartitionDescription BackupPartitionDescription No Corpo

partitionId

Tipo: string (uuid)
Obbligatorio: Sì

L'identità della partizione.

BackupTimeout

Tipo: integer
Obbligatorio: No
Impostazione predefinita: 10

Specifica la quantità massima di tempo, espressa in minuti, per attendere il completamento dell'operazione di backup. Successivamente, l'operazione viene completata con l'errore di timeout. In alcuni casi, tuttavia, potrebbe essere che, anche se l'operazione restituisce un timeout indietro, il backup passa effettivamente. In caso di errore di timeout, è consigliabile richiamare nuovamente questa operazione con un valore di timeout maggiore. Il valore predefinito per lo stesso valore è 10 minuti.

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.

BackupPartitionDescription

Tipo: BackupPartitionDescription
Obbligatorio: No

Descrive ora i parametri per eseguire il backup della partizione. Se non è presente, l'operazione di backup usa i parametri predefiniti dei criteri di backup correnti associati a questa partizione.

Risposte

Codice di stato HTTP Descrizione Schema di risposta
202 (Accettato) Un codice di stato 202 indica che la richiesta di operazione è stata accettata e che verrà avviato il backup. Usare l'operazione GetPartitionBackupProgress per ottenere lo stato dell'operazione di backup.
Tutti gli altri codici di stato Risposta dettagliata all'errore.
 FabricError

Esempio

Partizione di backup

In questo esempio viene illustrato come attivare il backup di una partizione, che è già configurato per i backup periodici. Il backup appena creato verrà salvato nella stessa posizione in cui vengono salvati i backup periodici.

Richiesta

POST http://localhost:19080/Partitions/1daae3f5-7fd6-42e9-b1ba-8c05f873994d/$/Backup?api-version=6.4
Corpo
{}

Risposta 202

Corpo

Il corpo della risposta è vuoto.

Eseguire il backup della partizione in un account di archiviazione di Azure specifico

Questo esempio illustra come attivare il backup di una partizione e salvare il backup in un account di archiviazione BLOB di Azure specifico.

Richiesta

POST http://localhost:19080/Partitions/1daae3f5-7fd6-42e9-b1ba-8c05f873994d/$/Backup?api-version=6.4
Corpo
{
  "BackupStorage": {
    "StorageKind": "AzureBlobStore",
    "ConnectionString": "DefaultEndpointsProtocol=https;AccountName=storagesample;AccountKey=<PutYourAccountKeyHere>",
    "ContainerName": "BackupContainer"
  }
}

Risposta 202

Corpo

Il corpo della risposta è vuoto.

Eseguire il backup della partizione in un percorso di archiviazione di Azure specifico a cui si accede usando l'identità gestita

Questo esempio illustra come attivare il backup di una partizione e salvare il backup in un account di archiviazione BLOB di Azure specifico usando l'identità gestita.

Richiesta

POST http://localhost:19080/Partitions/1daae3f5-7fd6-42e9-b1ba-8c05f873994d/$/Backup?api-version=6.4
Corpo
{
  "BackupStorage": {
    "StorageKind": "ManagedIdentityAzureBlobStore",
    "BlobServiceUri": "https://managedidentitytest.blob.core.windows.net/",
    "ContainerName": "BackupContainer",
    "ManagedIdentityType": "Cluster"
  }
}

Risposta 202

Corpo

Il corpo della risposta è vuoto.

Eseguire il backup della partizione in una condivisione file locale specifica

Questo esempio illustra come attivare il backup di una partizione e salvare il backup in una condivisione file specifica accessibile da tutti i nodi del cluster.

Richiesta

POST http://localhost:19080/Partitions/1daae3f5-7fd6-42e9-b1ba-8c05f873994d/$/Backup?api-version=6.4
Corpo
{
  "BackupStorage": {
    "StorageKind": "FileShare",
    "Path": "\\\\myshare\\backupshare",
    "PrimaryUserName": "mydomain\\backupaccount",
    "PrimaryPassword": "abcd1234"
  }
}

Risposta 202

Corpo

Il corpo della risposta è vuoto.

Eseguire il backup della partizione in un percorso di archiviazione di Azure Dsms specifico

Questo esempio illustra come attivare il backup di una partizione e salvare il backup in un percorso di archiviazione BLOB di Azure Dsms specifico.

Richiesta

POST http://localhost:19080/Partitions/1daae3f5-7fd6-42e9-b1ba-8c05f873994d/$/Backup?api-version=6.4
Corpo
{
  "BackupStorage": {
    "StorageKind": "DsmsAzureBlobStore",
    "StorageCredentialsSourceLocation": "https://sample-dsms.dsms.core.winows.net/dsms/samplecredentiallocation/storageaccounts/samplestorageac/servicefabricbackup/samplebackup",
    "ContainerName": "BackupContainer"
  }
}

Risposta 202

Corpo

Il corpo della risposta è vuoto.