Yedekleme Konumundan Yedek alma
Belirtilen yedekleme konumundaki belirtilen yedeklenen varlık için kullanılabilir yedeklemelerin listesini alır.
Belirtilen yedekleme konumundaki (Dosya Paylaşımı veya Azure Blob Depolama) belirtilen yedeklenen varlık (Uygulama, Hizmet veya Bölüm) için kullanılabilir yedeklemelerin listesini alır.
İstek
Yöntem | İstek URI'si |
---|---|
POST | /BackupRestore/$/GetBackups?api-version=6.4&timeout={timeout}&ContinuationToken={ContinuationToken}&MaxResults={MaxResults} |
Parametreler
Ad | Tür | Gerekli | Konum |
---|---|---|---|
api-version |
string | Yes | Sorgu |
timeout |
integer (int64) | No | Sorgu |
ContinuationToken |
dize | No | Sorgu |
MaxResults |
integer (int64) | No | Sorgu |
GetBackupByStorageQueryDescription |
GetBackupByStorageQueryDescription | 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.
ContinuationToken
Tür: dize
Gerekli: Hayır
Devamlılık belirteci parametresi, sonraki sonuç kümesini almak için kullanılır. Sistemden alınan sonuçlar tek bir yanıta sığmadığında API'nin yanıtına boş olmayan bir değer içeren bir devamlılık belirteci eklenir. Bu değer bir sonraki API çağrısına geçirildiğinde, API bir sonraki sonuç kümesini döndürür. Başka sonuç yoksa, devamlılık belirteci bir değer içermez. Bu parametrenin değeri URL kodlanmış olmamalıdır.
MaxResults
Tür: tamsayı (int64)
Gerekli: Hayır
Varsayılan: 0
InclusiveMinimum: 0
Disk belleğine alınan sorguların bir parçası olarak döndürülecek en fazla sonuç sayısı. Bu parametre, döndürülen sonuç sayısı üzerindeki üst sınırı tanımlar. Döndürülen sonuçlar, yapılandırmada tanımlanan maksimum ileti boyutu kısıtlamalarına göre iletiye sığmamaları durumunda belirtilen en yüksek sonuçlardan küçük olabilir. Bu parametre sıfırsa veya belirtilmezse, sayfalanan sorgu dönüş iletisine sığacak kadar çok sonuç içerir.
GetBackupByStorageQueryDescription
Tür: GetBackupByStorageQueryDescription
Gerekli: Evet
Yedeklemeleri listelemek için kullanılacak filtreleri ve yedekleme depolama ayrıntılarını açıklar.
Yanıtlar
HTTP Durum Kodu | Description | Yanıt Şeması |
---|---|---|
200 (Tamam) | Başarılı bir işlem 200 durum kodu ve disk belleğine alınmış yedekleme bilgileri listesi döndürür. |
PagedBackupInfoList |
Diğer tüm durum kodları | Ayrıntılı hata yanıtı. |
Doku Oluşturucu |
Örnekler
Maksimum sonuçları sınırla
Bu örnekte, belirtilen bir yedekleme konumundan uygulama yedeklemelerinin listesinin nasıl alınıyor olduğu gösterilmektedir. MaxResult parametresi kullanılarak sayfadaki sonuç sayısı en fazla iki ile sınırlıdır.
İstek
POST http://localhost:19080/BackupRestore/$/GetBackups?api-version=6.4&MaxResults=2
Gövde
{
"Storage": {
"StorageKind": "AzureBlobStore",
"ConnectionString": "DefaultEndpointsProtocol=https;AccountName=storagesample;AccountKey=<PutYourAccountKeyHere>",
"ContainerName": "BackupContainer"
},
"BackupEntity": {
"EntityKind": "Application",
"ApplicationName": "fabric:/CalcApp"
}
}
200 Yanıt
Gövde
{
"ContinuationToken": "fabric:/CalcApp/CalcService#1daae3f5-7fd6-42e9-b1ba-8c05f873994d#7903dc2a-228d-44b0-b7c8-a13a6c9b46bd",
"Items": [
{
"BackupId": "3a056ac9-7206-43c3-8424-6f6103003eba",
"BackupChainId": "3a056ac9-7206-43c3-8424-6f6103003eba",
"ApplicationName": "fabric:/CalcApp",
"ServiceManifestVersion": "1.0.0",
"ServiceName": "fabric:/CalcApp/CalcService",
"PartitionInformation": {
"LowKey": "-9223372036854775808",
"HighKey": "9223372036854775807",
"ServicePartitionKind": "Int64Range",
"Id": "1daae3f5-7fd6-42e9-b1ba-8c05f873994d"
},
"BackupLocation": "CalcApp\\CalcService\\1daae3f5-7fd6-42e9-b1ba-8c05f873994d\\2018-01-01 09.00.55.zip",
"BackupType": "Full",
"EpochOfLastBackupRecord": {
"DataLossVersion": "131462452931584510",
"ConfigurationVersion": "8589934592"
},
"LsnOfLastBackupRecord": "261",
"CreationTimeUtc": "2018-01-01T09:00:55Z",
"FailureError": null
},
{
"BackupId": "7903dc2a-228d-44b0-b7c8-a13a6c9b46bd",
"BackupChainId": "3a056ac9-7206-43c3-8424-6f6103003eba",
"ApplicationName": "fabric:/CalcApp",
"ServiceManifestVersion": "1.0.0",
"ServiceName": "fabric:/CalcApp/CalcService",
"PartitionInformation": {
"LowKey": "-9223372036854775808",
"HighKey": "9223372036854775807",
"ServicePartitionKind": "Int64Range",
"Id": "1daae3f5-7fd6-42e9-b1ba-8c05f873994d"
},
"BackupLocation": "CalcApp\\CalcService\\1daae3f5-7fd6-42e9-b1ba-8c05f873994d\\2018-01-01 17.01.02.zip",
"BackupType": "Incremental",
"EpochOfLastBackupRecord": {
"DataLossVersion": "131462452931584510",
"ConfigurationVersion": "8589934592"
},
"LsnOfLastBackupRecord": "446",
"CreationTimeUtc": "2018-01-01T17:01:02Z",
"FailureError": null
}
]
}
Devamlılık belirtecini kullanan sayfa
Bu örnekte uygulama yedeklemelerinin listesini alma işlemi gösterilmektedir. MaxResult parametresi kullanılarak sayfadaki sonuç sayısı en fazla iki ile sınırlıdır. Bu örnekte ContinuationToken parametresi kullanılır. Bu parametrenin değeri önceki sorgudan sağlanır; bu durumda, yukarıda gösterilen örnek. Yanıt, kalan sonuçları ve boş bir ContinuationToken içerir. Boş ContinuationToken, ek sonuçların kullanılamadığını gösterir.
İstek
POST http://localhost:19080/BackupRestore/$/GetBackups?api-version=6.4&ContinuationToken=fabric:/CalcApp/CalcService#1daae3f5-7fd6-42e9-b1ba-8c05f873994d#7903dc2a-228d-44b0-b7c8-a13a6c9b46bd&MaxResults=2
Gövde
{
"Storage": {
"StorageKind": "AzureBlobStore",
"ConnectionString": "DefaultEndpointsProtocol=https;AccountName=storagesample;AccountKey=<PutYourAccountKeyHere>",
"ContainerName": "BackupContainer"
},
"BackupEntity": {
"EntityKind": "Application",
"ApplicationName": "fabric:/CalcApp"
}
}
200 Yanıt
Gövde
{
"ContinuationToken": "",
"Items": [
{
"BackupId": "0ff4fdbe-131c-4dfb-8249-7b4029ddc014",
"BackupChainId": "0ff4fdbe-131c-4dfb-8249-7b4029ddc014",
"ApplicationName": "fabric:/CalcApp",
"ServiceManifestVersion": "1.0.0",
"ServiceName": "fabric:/CalcApp/CalcService",
"PartitionInformation": {
"LowKey": "-9223372036854775808",
"HighKey": "9223372036854775807",
"ServicePartitionKind": "Int64Range",
"Id": "81645ec7-d260-4c59-9533-8f129bde8e83"
},
"BackupLocation": "CalcApp\\CalcService\\81645ec7-d260-4c59-9533-8f129bde8e83\\2018-01-01 09.01.02.zip",
"BackupType": "Full",
"EpochOfLastBackupRecord": {
"DataLossVersion": "131462452931584510",
"ConfigurationVersion": "8589934592"
},
"LsnOfLastBackupRecord": "161",
"CreationTimeUtc": "2018-01-01T09:01:02Z",
"FailureError": null
},
{
"BackupId": "d55a2d98-258b-4a34-8fe5-2063e81af9dc",
"BackupChainId": "0ff4fdbe-131c-4dfb-8249-7b4029ddc014",
"ApplicationName": "fabric:/CalcApp",
"ServiceManifestVersion": "1.0.0",
"ServiceName": "fabric:/CalcApp/CalcService",
"PartitionInformation": {
"LowKey": "-9223372036854775808",
"HighKey": "9223372036854775807",
"ServicePartitionKind": "Int64Range",
"Id": "81645ec7-d260-4c59-9533-8f129bde8e83"
},
"BackupLocation": "CalcApp\\CalcService\\81645ec7-d260-4c59-9533-8f129bde8e83\\2018-01-01 17.00.34.zip",
"BackupType": "Incremental",
"EpochOfLastBackupRecord": {
"DataLossVersion": "131462452931584510",
"ConfigurationVersion": "8589934592"
},
"LsnOfLastBackupRecord": "246",
"CreationTimeUtc": "2018-01-01T17:00:34Z",
"FailureError": null
}
]
}