Skapa säkerhetskopieringspolicy

  • Artikel

Skapar en säkerhetskopieringspolicy.

Skapar en säkerhetskopieringspolicy som kan associeras senare med ett Service Fabric-program, en tjänst eller en partition för regelbunden säkerhetskopiering.

Förfrågan

Metod URI för förfrågan
POST /BackupRestore/BackupPolicies/$/Create?api-version=6.4&timeout={timeout}&ValidateConnection={ValidateConnection}

Parametrar

Namn Typ Obligatorisk Location
api-version sträng Ja Söka i data
timeout heltal (int64) No Söka i data
ValidateConnection boolean No Söka i data
BackupPolicyDescription BackupPolicyDescription Yes Brödtext

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.

ValidateConnection

Typ: booleskt värde
Krävs: Nej
Standard: false

Anger om lagringsanslutningen och autentiseringsuppgifterna ska verifieras innan säkerhetskopieringsprinciperna skapas eller uppdateras.

BackupPolicyDescription

Typ: BackupPolicyDescription
Krävs: Ja

Beskriver säkerhetskopieringspolicyn.

Svar

HTTP-statuskod Description Svarsschema
201 (skapad) En lyckad åtgärd returnerar statuskoden 201 och skapar en ny säkerhetskopieringsprincip.
Alla andra statuskoder Det detaljerade felsvaret.
 FabricError

Exempel

Skapa en tidsbaserad säkerhetskopieringspolicy med Azure som säkerhetskopieringsplats

Det här exemplet visar hur du skapar en säkerhetskopieringspolicy som säkerhetskopierar två gånger varje dag kl. 09.00 och 17.00 UTC som ska tas bort efter 3 månader, med Azure Blob Store som säkerhetskopieringsplats.

Förfrågan

POST http://localhost:19080/BackupRestore/BackupPolicies/$/Create?api-version=6.4
Brödtext
{
  "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"
  }
}

Svar från 201

Brödtext

Svarstexten är tom.

Skapa en tidsbaserad säkerhetskopieringspolicy med Azure som säkerhetskopieringsplats som nås med hjälp av hanterad identitet

Det här exemplet visar hur du skapar en säkerhetskopieringspolicy som säkerhetskopierar två gånger varje dag kl. 09:00 och 17:00 UTC som ska tas bort efter 3 månader, med Azure Blob Store som säkerhetskopieringsplats med hanterad identitet.

Förfrågan

POST http://localhost:19080/BackupRestore/BackupPolicies/$/Create?api-version=6.4
Brödtext
{
  "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"
  }
}

Svar från 201

Brödtext

Svarstexten är tom.

Skapa en frekvensbaserad säkerhetskopieringspolicy med filresurs som säkerhetskopieringsplats

Det här exemplet visar hur du skapar en säkerhetskopieringspolicy som tar säkerhetskopiering var tionde minut som ska tas bort efter 20 dagar, med filresursen som säkerhetskopieringsplats.

Förfrågan

POST http://localhost:19080/BackupRestore/BackupPolicies/$/Create?api-version=6.4
Brödtext
{
  "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"
  }
}

Svar från 201

Brödtext

Svarstexten är tom.

Skapa en tidsbaserad säkerhetskopieringspolicy med Dsms Azure som säkerhetskopieringsplats

Det här exemplet visar hur du skapar en säkerhetskopieringspolicy som säkerhetskopierar två gånger varje dag kl. 09.00 och 17.00 UTC som ska tas bort efter 3 månader, med Dsms Azure Blob Store som säkerhetskopieringsplats.

Förfrågan

POST http://localhost:19080/BackupRestore/BackupPolicies/$/Create?api-version=6.4
Brödtext
{
  "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"
  }
}

Svar från 201

Brödtext

Svarstexten är tom.