Yedekleme İlkesi Oluşturma
Bir yedekleme ilkesi oluşturur.
Daha sonra düzenli yedekleme için bir Service Fabric uygulaması, hizmeti veya bölümüyle ilişkilendirilebilen bir yedekleme ilkesi oluşturur.
İstek
Yöntem | İstek URI'si |
---|---|
POST | /BackupRestore/BackupPolicies/$/Create?api-version=6.4&timeout={timeout}&ValidateConnection={ValidateConnection} |
Parametreler
Ad | Tür | Gerekli | Konum |
---|---|---|---|
api-version |
string | Yes | Sorgu |
timeout |
integer (int64) | No | Sorgu |
ValidateConnection |
boolean | No | Sorgu |
BackupPolicyDescription |
BackupPolicyDescription | Yes | Gövde |
api-version
Tür: dize
Gerekli: Evet
Varsayılan: 6.4
API'nin sürümü. Bu parametre gereklidir ve değeri '6.4' olmalıdır.
Service Fabric REST API sürümü, API'nin tanıtıldığı veya değiştirildiği çalışma zamanı sürümünü temel alır. Service Fabric çalışma zamanı API'nin birden fazla sürümünü destekler. Bu sürüm, API'nin desteklenen en son sürümüdür. Daha düşük bir API sürümü geçirilirse, döndürülen yanıt bu belirtimde belgelenen yanıttan farklı olabilir.
Ayrıca çalışma zamanı, çalışma zamanının geçerli sürümüne kadar desteklenen en son sürümden daha yüksek olan tüm sürümleri kabul eder. Dolayısıyla en son API sürümü 6.0 ve çalışma zamanı 6.1 ise çalışma zamanı bu API için 6.1 sürümünü kabul eder. Ancak API'nin davranışı, belgelenen 6.0 sürümüne göre olacaktır.
timeout
Tür: tamsayı (int64)
Gerekli: Hayır
Varsayılan: 60
InclusiveMaximum: 4294967295
InclusiveMinimum: 1
İşlemi saniyeler içinde gerçekleştirmek için sunucu zaman aşımı. Bu zaman aşımı, istemcinin istenen işlemin tamamlanmasını beklemeye istekli olduğu süreyi belirtir. Bu parametre için varsayılan değer 60 saniyedir.
ValidateConnection
Tür: boole
Gerekli: Hayır
Varsayılan: false
Yedekleme ilkelerini oluşturmadan veya güncelleştirmeden önce depolama bağlantısının ve kimlik bilgilerinin doğrulanıp doğrulanmayacağını belirtir.
BackupPolicyDescription
Tür: BackupPolicyDescription
Gerekli: Evet
Yedekleme ilkesini açıklar.
Yanıtlar
HTTP Durum Kodu | Description | Yanıt Şeması |
---|---|---|
201 (Oluşturuldu) | Başarılı bir işlem 201 durum kodunu döndürür ve yeni bir yedekleme ilkesi oluşturur. |
|
Diğer tüm durum kodları | Ayrıntılı hata yanıtı. |
Doku Oluşturucu |
Örnekler
Yedekleme konumu olarak Azure ile zamana dayalı yedekleme ilkesi oluşturma
Bu örnekte, her gün 09:00 ve 17:00 UTC'de iki kez yedekleme alan ve 3 ay sonra silinecek ve yedekleme konumu Azure blob deposu olan bir yedekleme ilkesinin nasıl oluşturulacağı gösterilmektedir.
İstek
POST http://localhost:19080/BackupRestore/BackupPolicies/$/Create?api-version=6.4
Gövde
{
"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"
}
}
201 Yanıtı
Gövde
Yanıt gövdesi boş.
Yönetilen kimlik kullanılarak erişilen yedekleme konumu olarak Azure ile zamana dayalı yedekleme ilkesi oluşturma
Bu örnekte, yönetilen kimlik kullanılarak yedekleme konumu Olarak Azure blob deposu ile 09:00 ve 17:00 UTC'de her gün iki kez yedekleme alan ve 3 ay sonra silinecek bir yedekleme ilkesinin nasıl oluşturulacağı gösterilmektedir.
İstek
POST http://localhost:19080/BackupRestore/BackupPolicies/$/Create?api-version=6.4
Gövde
{
"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"
}
}
201 Yanıtı
Gövde
Yanıt gövdesi boş.
Dosya paylaşımını yedekleme konumu olarak içeren sıklık tabanlı yedekleme ilkesi oluşturma
Bu örnekte, her 10 dakikada bir yedek alan ve 20 gün sonra silinecek ve yedekleme konumu olarak dosya paylaşımı olan bir yedekleme ilkesinin nasıl oluşturulacağı gösterilmektedir.
İstek
POST http://localhost:19080/BackupRestore/BackupPolicies/$/Create?api-version=6.4
Gövde
{
"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"
}
}
201 Yanıtı
Gövde
Yanıt gövdesi boş.
Dsms Azure ile yedekleme konumu olarak zamana dayalı yedekleme ilkesi oluşturma
Bu örnekte, 09:00 ve 17:00 UTC'de her gün iki kez yedekleme alan ve 3 ay sonra silinecek ve yedekleme konumu Dsms Azure blob deposu olan bir yedekleme ilkesinin nasıl oluşturulacağı gösterilmektedir.
İstek
POST http://localhost:19080/BackupRestore/BackupPolicies/$/Create?api-version=6.4
Gövde
{
"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"
}
}
201 Yanıtı
Gövde
Yanıt gövdesi boş.