Aracılığıyla paylaş

Yedekleme Bölümü

  • Makale

Bölümün durumunun yedeklerini tetikler.

Durum bilgisi olan kalıcı bölümün durumunun yedeğini oluşturur. Bölüm zaten düzenli aralıklarla yedekleniyorsa, varsayılan olarak yeni yedekleme aynı yedekleme depolama alanında oluşturulur. Ayrıca, istek gövdesinin bir parçası olarak yedekleme depolama ayrıntılarını belirterek de aynı işlemi geçersiz kılabilir. Yedekleme başlatıldıktan sonra, ilerleme durumu GetBackupProgress işlemi kullanılarak izlenebilir. İşlem zaman aşımına uğradıysa sorgu parametresinde daha büyük bir yedekleme zaman aşımı değeri belirtin.

İstek

Yöntem İstek URI'si
POST /Partitions/{partitionId}/$/Backup?BackupTimeout={BackupTimeout}&api-version=6.4&timeout={timeout}

Parametreler

Ad Tür Gerekli Konum
partitionId dize (uuid) Yes Yol
BackupTimeout tamsayı No Sorgu
api-version string Yes Sorgu
timeout integer (int64) No Sorgu
BackupPartitionDescription BackupPartitionDescription No Gövde

partitionId

Tür: dize (uuid)
Gerekli: Evet

Bölümün kimliği.

BackupTimeout

Tür: tamsayı
Gerekli: Hayır
Varsayılan: 10

Yedekleme işleminin tamamlanmasını beklemek için gereken en uzun süreyi dakika cinsinden belirtir. Bunu göndererek işlem zaman aşımı hatasıyla tamamlanır. Ancak, bazı köşe durumlarda işlem geri zaman aşımı döndürse de yedeklemenin gerçekten geçmesi olabilir. Zaman aşımı hatası durumunda, bu işlemi daha büyük bir zaman aşımı değeriyle yeniden çağırması önerilir. Aynı değer için varsayılan değer 10 dakikadır.

api-version

Tür: dize
Gerekli: Evet
Varsayılan: 6.4

API 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 belgelenenden 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 sürüm 6.1'i 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.

BackupPartitionDescription

Tür: BackupPartitionDescription
Gerekli: Hayır

Bölümü şimdi yedeklemek için parametreleri açıklar. Yoksa, yedekleme işlemi bu bölümle ilişkilendirilmiş yedekleme ilkesinden varsayılan parametreleri kullanır.

Yanıtlar

HTTP Durum Kodu Description Yanıt Şeması
202 (Kabul Edildi) 202 durum kodu, işlem isteğinin kabul edildiğine ve yedeklemenin başlatılacağını gösterir. Yedekleme işleminin durumunu almak için GetPartitionBackupProgress işlemini kullanın.
Diğer tüm durum kodları Ayrıntılı hata yanıtı.
 Doku Oluşturucu

Örnekler

Yedekleme bölümü

Bu örnekte, düzenli yedeklemeler için zaten yapılandırılmış olan bir bölümün yedeklemesinin nasıl tetiklendiği gösterilmektedir. Yeni oluşturulan yedekleme, düzenli yedeklemelerin kaydedildiği aynı konuma kaydedilir.

İstek

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

202 Yanıtı

Gövde

Yanıt gövdesi boş.

Bölümü belirli bir Azure depolama hesabına yedekleme

Bu örnekte, bir bölümün yedeklemesini şimdi tetikleme ve yedeklemeyi belirli bir Azure blob depolama hesabına kaydetme işlemi gösterilmektedir.

İstek

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

202 Yanıtı

Gövde

Yanıt gövdesi boş.

Bölümü yönetilen kimlik kullanılarak erişilen belirli bir Azure depolama konumuna yedekleme

Bu örnekte, bir bölümün yedeklemesini şimdi tetikleme ve yönetilen kimlik kullanarak yedeklemeyi belirli bir Azure blob depolama hesabına kaydetme işlemi gösterilmektedir.

İstek

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

202 Yanıtı

Gövde

Yanıt gövdesi boş.

Bölümü belirli bir şirket içi dosya paylaşımına yedekleme

Bu örnek, bir bölümün yedeklemesini şimdi tetiklemeyi ve yedeklemeyi tüm küme düğümlerinden erişilebilen belirli bir dosya paylaşımına kaydetmeyi gösterir.

İstek

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

202 Yanıtı

Gövde

Yanıt gövdesi boş.

Bölümü belirli bir Dsms Azure depolama konumuna yedekleme

Bu örnekte, bir bölümün yedeklemesini şimdi tetikleme ve yedeklemeyi belirli bir Dsms Azure blob depolama konumuna kaydetme adımları gösterilmektedir.

İstek

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

202 Yanıtı

Gövde

Yanıt gövdesi boş.