Sdílet prostřednictvím

Vytvoření zásad zálohování

  • Článek

Vytvoří zásadu zálohování.

Vytvoří zásadu zálohování, kterou je možné později přidružit k aplikaci Service Fabric, službě nebo oddílu pro pravidelné zálohování.

Žádost

Metoda Identifikátor URI žádosti
POST /BackupRestore/BackupPolicies/$/Create?api-version=6.4&timeout={timeout}&ValidateConnection={ValidateConnection}

Parametry

Název Typ Vyžadováno Umístění
api-version řetězec Ano Dotaz
timeout integer (int64) No Dotaz
ValidateConnection boolean No Dotaz
BackupPolicyDescription Popis zásady zálohování Yes Text

api-version

Typ: řetězec
Povinné: Ano
Výchozí:6.4

Verze rozhraní API. Tento parametr je povinný a jeho hodnota musí být 6,4.

Verze rozhraní REST API Service Fabric je založená na verzi modulu runtime, ve které bylo rozhraní API zavedeno nebo změněno. Modul runtime Service Fabric podporuje více než jednu verzi rozhraní API. Tato verze je nejnovější podporovanou verzí rozhraní API. Pokud se předá nižší verze rozhraní API, může se vrácená odpověď lišit od odpovědi popsané v této specifikaci.

Modul runtime navíc přijímá všechny verze, které jsou vyšší než nejnovější podporovaná verze až do aktuální verze modulu runtime. Pokud je tedy nejnovější verze rozhraní API 6.0 a modul runtime je 6.1, modul runtime pro toto rozhraní API přijme verzi 6.1. Chování rozhraní API však bude podle zdokumentované verze 6.0.

timeout

Typ: integer (int64)
Povinné: Ne
Výchozí:60
InclusiveMaximum: 4294967295
InclusiveMinimum: 1

Časový limit serveru pro provedení operace v sekundách. Tento časový limit určuje dobu, po kterou je klient ochoten čekat na dokončení požadované operace. Výchozí hodnota tohoto parametru je 60 sekund.

ValidateConnection

Typ: boolean
Povinné: Ne
Výchozí:false

Určuje, jestli se má před vytvořením nebo aktualizací zásad zálohování ověřit připojení k úložišti a přihlašovací údaje.

BackupPolicyDescription

Typ: BackupPolicyDescription
Povinné: Ano

Popisuje zásady zálohování.

Odpovědi

Stavový kód HTTP Description Schéma odpovědi
201 (vytvořeno) Úspěšná operace vrátí stavový kód 201 a vytvoří novou zásadu zálohování.
Všechny ostatní stavové kódy Podrobná chybová odpověď.
 Chyba infrastruktury

Příklady

Vytvoření zásady zálohování na základě času s Azure jako umístěním zálohy

Tento příklad ukazuje, jak vytvořit zásadu zálohování, která provádí zálohování dvakrát denně v 9:00 a v 17:00 UTC, která se po 3 měsících odstraní, přičemž úložiště objektů blob Azure je umístěním zálohy.

Žádost

POST http://localhost:19080/BackupRestore/BackupPolicies/$/Create?api-version=6.4
Text
{
  "Name": "DailyAzureBackupPolicy",
  "AutoRestoreOnDataLoss": false,
  "MaxIncrementalBackups": "3",
  "Schedule": {
    "ScheduleKind": "TimeBased",
    "ScheduleFrequencyType": "Daily",
    "RunTimes": [
      "0001-01-01T09:00:00Z",
      "0001-01-01T17:00:00Z"
    ]
  },
  "Storage": {
    "StorageKind": "AzureBlobStore",
    "FriendlyName": "Azure_storagesample",
    "ConnectionString": "DefaultEndpointsProtocol=https;AccountName=storagesample;AccountKey=<PutYourAccountKeyHere>",
    "ContainerName": "BackupContainer"
  },
  "RetentionPolicy": {
    "RetentionPolicyType": "Basic",
    "MinimumNumberOfBackups": "20",
    "RetentionDuration": "P3M"
  }
}

Odpověď 201

Text

Text odpovědi je prázdný.

Vytvoření zásady zálohování na základě času s Azure jako umístěním zálohy, ke kterým se přistupuje pomocí spravované identity

Tento příklad ukazuje, jak vytvořit zásadu zálohování, která provádí zálohování dvakrát denně v 9:00 a v 17:00 UTC a která se po 3 měsících odstraní, přičemž úložiště objektů blob Azure je umístěním zálohy s využitím spravované identity.

Žádost

POST http://localhost:19080/BackupRestore/BackupPolicies/$/Create?api-version=6.4
Text
{
  "Name": "DailyAzureMIBackupPolicy",
  "AutoRestoreOnDataLoss": false,
  "MaxIncrementalBackups": "3",
  "Schedule": {
    "ScheduleKind": "TimeBased",
    "ScheduleFrequencyType": "Daily",
    "RunTimes": [
      "0001-01-01T09:00:00Z",
      "0001-01-01T17:00:00Z"
    ]
  },
  "Storage": {
    "StorageKind": "ManagedIdentityAzureBlobStore",
    "FriendlyName": "AzureMI_storagesample",
    "BlobServiceUri": "https://managedidentitytest.blob.core.windows.net/",
    "ContainerName": "BackupContainer",
    "ManagedIdentityType": "Cluster"
  },
  "RetentionPolicy": {
    "RetentionPolicyType": "Basic",
    "MinimumNumberOfBackups": "20",
    "RetentionDuration": "P3M"
  }
}

Odpověď 201

Text

Text odpovědi je prázdný.

Vytvoření zásady zálohování na základě četnosti se sdílenou složkou jako umístěním zálohy

Tento příklad ukazuje, jak vytvořit zásadu zálohování, která provádí zálohování každých 10 minut a která se po 20 dnech odstraní se sdílenou složkou jako umístěním zálohy.

Žádost

POST http://localhost:19080/BackupRestore/BackupPolicies/$/Create?api-version=6.4
Text
{
  "Name": "FileShare10MinBackupPolicy",
  "AutoRestoreOnDataLoss": false,
  "MaxIncrementalBackups": "3",
  "Schedule": {
    "ScheduleKind": "FrequencyBased",
    "Interval": "PT10M"
  },
  "Storage": {
    "StorageKind": "FileShare",
    "FriendlyName": "FileShare_myshare",
    "Path": "\\\\myshare\\backupshare",
    "PrimaryUserName": "backupaccount",
    "PrimaryPassword": "abcd1234"
  },
  "RetentionPolicy": {
    "RetentionPolicyType": "Basic",
    "MinimumNumberOfBackups": "20",
    "RetentionDuration": "P20D"
  }
}

Odpověď 201

Text

Text odpovědi je prázdný.

Vytvoření zásady zálohování na základě času s dsms Azure jako umístěním zálohy

Tento příklad ukazuje, jak vytvořit zásadu zálohování, která provádí zálohování dvakrát denně v 9:00 a v 17:00 UTC a která se po 3 měsících odstraní, přičemž úložiště objektů blob Azure dsms je umístěním zálohy.

Žádost

POST http://localhost:19080/BackupRestore/BackupPolicies/$/Create?api-version=6.4
Text
{
  "Name": "SampleDsmsBackupPolicy",
  "AutoRestoreOnDataLoss": false,
  "MaxIncrementalBackups": "3",
  "Schedule": {
    "ScheduleKind": "TimeBased",
    "ScheduleFrequencyType": "Daily",
    "RunTimes": [
      "0001-01-01T09:00:00Z",
      "0001-01-01T17:00:00Z"
    ]
  },
  "Storage": {
    "StorageKind": "DsmsAzureBlobStore",
    "FriendlyName": "DsmsAzure_storagesample",
    "StorageCredentialsSourceLocation": "https://sample-dsms.dsms.core.winows.net/dsms/samplecredentiallocation/storageaccounts/samplestorageac/servicefabricbackup/samplebackup",
    "ContainerName": "BackupContainer"
  },
  "RetentionPolicy": {
    "RetentionPolicyType": "Basic",
    "MinimumNumberOfBackups": "20",
    "RetentionDuration": "P3M"
  }
}

Odpověď 201

Text

Text odpovědi je prázdný.