Share via

Säkerhetskopieringspartition

  • Artikel

Utlöser säkerhetskopiering av partitionens tillstånd.

Skapar en säkerhetskopia av den tillståndskänsliga bevarade partitionens tillstånd. Om partitionen redan säkerhetskopieras regelbundet skapas den nya säkerhetskopian som standard på samma lagringsplats för säkerhetskopior. Man kan också åsidosätta samma genom att ange information om lagring av säkerhetskopior som en del av begärandetexten. När säkerhetskopieringen har initierats kan förloppet spåras med hjälp av åtgärden GetBackupProgress. Om tidsgränsen uppnås för åtgärden anger du ett högre tidsgränsvärde för säkerhetskopiering i frågeparametern.

Förfrågan

Metod URI för förfrågan
POST /Partitions/{partitionId}/$/Backup?BackupTimeout={BackupTimeout}&api-version=6.4&timeout={timeout}

Parametrar

Namn Typ Obligatorisk Location
partitionId sträng (uuid) Yes Sökväg
BackupTimeout heltal No Söka i data
api-version sträng Ja Söka i data
timeout heltal (int64) No Söka i data
BackupPartitionDescription BackupPartitionDescription No Brödtext

partitionId

Typ: sträng (uuid)
Krävs: Ja

Partitionens identitet.

BackupTimeout

Typ: heltal
Krävs: Nej
Standard: 10

Anger den maximala tid i minuter som säkerhetskopieringen ska slutföras. Efter det slutförs åtgärden med timeout-fel. Men i vissa hörnfall kan det vara så att även om åtgärden returnerar timeout går säkerhetskopieringen faktiskt igenom. Vid timeout-fel rekommenderar vi att du anropar den här åtgärden igen med ett större timeout-värde. Standardvärdet för samma värde är 10 minuter.

api-version

Typ: sträng
Krävs: Ja
Standard: 6.4

Versionen av API:et. Den här parametern krävs och dess värde måste vara "6.4".

Service Fabric REST API-versionen baseras på körningsversionen där API:et introducerades eller ändrades. Service Fabric Runtime stöder mer än en version av API:et. Den här versionen är den senaste versionen av API:et som stöds. Om en lägre API-version skickas kan det returnerade svaret skilja sig från det som dokumenteras i den här specifikationen.

Dessutom accepterar körningen alla versioner som är högre än den senaste versionen som stöds upp till den aktuella versionen av körningen. Så om den senaste API-versionen är 6.0 och körningen är 6.1 accepterar körningen version 6.1 för det API:et. Beteendet för API:et är dock enligt den dokumenterade 6.0-versionen.

timeout

Typ: heltal (int64)
Krävs: Nej
Standard: 60
InclusiveMaximum: 4294967295
InclusiveMinimum: 1

Serverns tidsgräns för att utföra åtgärden i sekunder. Den här tidsgränsen anger hur lång tid klienten är villig att vänta på att den begärda åtgärden ska slutföras. Standardvärdet för den här parametern är 60 sekunder.

BackupPartitionDescription

Typ: BackupPartitionDescription
Krävs: Nej

Beskriver parametrarna för att säkerhetskopiera partitionen nu. Om den inte finns använder säkerhetskopieringsåtgärden standardparametrar från den aktuella säkerhetskopieringsprincipen som är associerad med den här partitionen.

Svar

HTTP-statuskod Description Svarsschema
202 (godkänd) En statuskod från 202 anger att åtgärdsbegäran accepterades och att säkerhetskopieringen initieras. Använd Åtgärden GetPartitionBackupProgress för att hämta status för säkerhetskopieringsåtgärden.
Alla andra statuskoder Det detaljerade felsvaret.
 FabricError

Exempel

Säkerhetskopieringspartition

Det här exemplet visar hur du utlöser säkerhetskopiering av en partition nu, som redan har konfigurerats för periodiska säkerhetskopieringar. Den nyligen skapade säkerhetskopian sparas på samma plats där de periodiska säkerhetskopiorna sparas.

Förfrågan

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

202-svar

Brödtext

Svarstexten är tom.

Säkerhetskopiera partition till ett specifikt Azure-lagringskonto

Det här exemplet visar hur du utlöser säkerhetskopiering av en partition nu och sparar säkerhetskopian till ett specifikt Azure Blob Storage-konto.

Förfrågan

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

202-svar

Brödtext

Svarstexten är tom.

Säkerhetskopiera partition till en specifik Azure-lagringsplats som nås med hanterad identitet

Det här exemplet visar hur du utlöser säkerhetskopiering av en partition nu och sparar säkerhetskopian till ett specifikt Azure Blob Storage-konto med hjälp av hanterad identitet.

Förfrågan

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

202-svar

Brödtext

Svarstexten är tom.

Säkerhetskopiera partition till en specifik lokal filresurs

Det här exemplet visar hur du utlöser säkerhetskopiering av en partition nu och sparar säkerhetskopian till en specifik filresurs som är tillgänglig från alla klusternoder.

Förfrågan

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

202-svar

Brödtext

Svarstexten är tom.

Säkerhetskopiera partition till en specifik Lagringsplats för Dsms Azure

Det här exemplet visar hur du utlöser säkerhetskopiering av en partition nu och sparar säkerhetskopian på en specifik Dsms Azure Blob Storage-plats.

Förfrågan

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

202-svar

Brödtext

Svarstexten är tom.