Hizmet Yedekleme Listesi AlınGet Service Backup List

Bu hizmetteki her bölüm için kullanılabilir yedeklerin listesini alır.Gets the list of backups available for every partition in this service.

Bu Hizmet Kumaşı hizmetindeki her bölüm için kullanılabilen yedeklerin listesini verir.Returns a list of backups available for every partition in this Service Fabric service. Sunucu, yedekleme ilkesinde yapılandırılan yedekleme deposunda bulunan tüm yedeklemeleri kaydeder.The server enumerates all the backups available in the backup store configured in the backup policy. Ayrıca, başlangıç ve bitiş tarihine göre sonucun filtrelemesine veya her bölüm için mevcut en son yedeklemenin yapılmasına da olanak tanır.It also allows filtering of the result based on start and end datetime or just fetching the latest available backup for every partition.

İstekRequest

YöntemMethod İstek URI'siRequest URI
GETGET /Services/{serviceId}/$/GetBackups?api-version=6.4&timeout={timeout}&Latest={Latest}&StartDateTimeFilter={StartDateTimeFilter}&EndDateTimeFilter={EndDateTimeFilter}&ContinuationToken={ContinuationToken}&MaxResults={MaxResults}

ParametrelerParameters

AdıName TürType GerekliRequired KonumLocation
serviceId stringstring EvetYes YolPath
api-version stringstring EvetYes SorguQuery
timeout karşıt (int64)integer (int64) HayırNo SorguQuery
Latest booleboolean HayırNo SorguQuery
StartDateTimeFilter dize (tarih-saat)string (date-time) HayırNo SorguQuery
EndDateTimeFilter dize (tarih-saat)string (date-time) HayırNo SorguQuery
ContinuationToken stringstring HayırNo SorguQuery
MaxResults karşıt (int64)integer (int64) HayırNo SorguQuery

serviceId

Türü: stringType: string
Gerekli: EvetRequired: Yes

Hizmetin kimliği.The identity of the service. Bu kimlik genellikle 'kumaş:' URI düzeni olmadan hizmetin tam adıdır.This ID is typically the full name of the service without the 'fabric:' URI scheme. Sürüm 6.0'dan başlayarak hiyerarşik adlar "~" karakteriyle sınırlandırılır.Starting from version 6.0, hierarchical names are delimited with the "~" character. Örneğin, hizmet adı "kumaş:/myapp/app1/svc1" ise, hizmet kimliği 6.0+ ve önceki sürümlerde "myapp/app1/svc1" olacaktır.For example, if the service name is "fabric:/myapp/app1/svc1", the service identity would be "myapp~app1~svc1" in 6.0+ and "myapp/app1/svc1" in previous versions.


api-version

Türü: stringType: string
Gerekli: EvetRequired: Yes
Varsayılan:6.4Default: 6.4

API sürümü.The version of the API. Bu parametre gereklidir ve değeri '6.4' olmalıdır.This parameter is required and its value must be '6.4'.

Service Fabric REST API sürümü, API'nin tanıtıldığı veya değiştirildiği çalışma zamanı sürümüne dayanır.Service Fabric REST API version is based on the runtime version in which the API was introduced or was changed. Service Fabric çalışma zamanı, API'nin birden fazla sürümünü destekler.Service Fabric runtime supports more than one version of the API. Bu sürüm, API'nin en son desteklenen sürümüdür.This version is the latest supported version of the API. Daha düşük bir API sürümü geçirilirse, döndürülen yanıt bu belirtimde belgelenenden farklı olabilir.If a lower API version is passed, the returned response may be different from the one documented in this specification.

Ayrıca çalışma zamanı, çalışma zamanının geçerli sürümüne kadar en son desteklenen sürümden daha yüksek olan tüm sürümü kabul eder.Additionally the runtime accepts any version that is higher than the latest supported version up to the current version of the runtime. Yani en son API sürümü 6.0 ve çalışma süresi 6.1 ise, çalışma zamanı bu API için sürüm 6.1 kabul eder.So if the latest API version is 6.0 and the runtime is 6.1, the runtime will accept version 6.1 for that API. Ancak API davranışı belgelenen 6.0 sürümüne göre olacaktır.However the behavior of the API will be as per the documented 6.0 version.


timeout

Türü: integer (int64)Type: integer (int64)
Gerekli: HayırRequired: No
Varsayılan:60Default: 60
Kapsayıcı Maksimum:4294967295InclusiveMaximum: 4294967295
Dahil Minimum:1InclusiveMinimum: 1

İşlemi saniyeler içinde gerçekleştirmek için sunucu zaman.The server timeout for performing the operation in seconds. Bu zaman sonu, istemcinin istenen işlemin tamamlanmasını beklemek istediği süreyi belirtir.This timeout specifies the time duration that the client is willing to wait for the requested operation to complete. Bu parametrenin varsayılan değeri 60 saniyedir.The default value for this parameter is 60 seconds.


Latest

Tür: booleanType: boolean
Gerekli: HayırRequired: No
Varsayılan:falseDefault: false

Belirtilen zaman aralığı için bir bölüm için yalnızca en son yedeklemeyi alıp almayacağımı belirtir.Specifies whether to get only the most recent backup available for a partition for the specified time range.


StartDateTimeFilter

Türü: string (tarih-saat)Type: string (date-time)
Gerekli: HayırRequired: No

Yedeklemeleri tarih biçiminde sayısala çıkarmak için başlangıç tarihi saatini belirtin.Specify the start date time from which to enumerate backups, in datetime format. Tarih saati ISO8601 biçiminde belirtilmelidir.The date time must be specified in ISO8601 format. Bu isteğe bağlı bir parametredir.This is an optional parameter. Belirtilmemişse, başlangıçtan itibaren tüm yedeklemeler numaralandırılır.If not specified, all backups from the beginning are enumerated.


EndDateTimeFilter

Türü: string (tarih-saat)Type: string (date-time)
Gerekli: HayırRequired: No

Yedeklemeleri tarih biçiminde, yedekleri sayısala kadar olan bitiş tarih saatini belirtin.Specify the end date time till which to enumerate backups, in datetime format. Tarih saati ISO8601 biçiminde belirtilmelidir.The date time must be specified in ISO8601 format. Bu isteğe bağlı bir parametredir.This is an optional parameter. Belirtilmemişse, numaralandırma en son yedeklemeye kadar yapılır.If not specified, enumeration is done till the most recent backup.


ContinuationToken

Türü: stringType: string
Gerekli: HayırRequired: No

Devamı belirteç parametresi sonraki sonuç kümesini elde etmek için kullanılır.The continuation token parameter is used to obtain next set of results. Sistemden elde edilen sonuçlar tek bir yanıta sığmıyorsa, BOŞ olmayan bir değere sahip bir devam belirteci API'nın yanıtına dahil edilir.A continuation token with a non-empty value is included in the response of the API when the results from the system do not fit in a single response. Bu değer bir sonraki API çağrısına geçirildiğinde, API sonraki sonuç kümesini döndürür.When this value is passed to the next API call, the API returns next set of results. Başka sonuç yoksa, devam belirteci bir değer içermez.If there are no further results, then the continuation token does not contain a value. Bu parametrenin değeri URL kodlanmış olmamalıdır.The value of this parameter should not be URL encoded.


MaxResults

Türü: integer (int64)Type: integer (int64)
Gerekli: HayırRequired: No
Varsayılan:0Default: 0
Dahil Minimum:0InclusiveMinimum: 0

Sayfalı sorguların bir parçası olarak döndürülecek en fazla sonuç sayısı.The maximum number of results to be returned as part of the paged queries. Bu parametre, döndürülen sonuç sayısındaki üst sınırı tanımlar.This parameter defines the upper bound on the number of results returned. Döndürülen sonuçlar, yapılandırmada tanımlanan maksimum ileti boyutu kısıtlamalarına göre iletiye sığmazsa, belirtilen maksimum sonuçlardan daha az olabilir.The results returned can be less than the specified maximum results if they do not fit in the message as per the max message size restrictions defined in the configuration. Bu parametre sıfır veya belirtilmemişse, sayfalı sorgu, iade iletisindeki sığan mümkün olduğunca çok sonuç içerir.If this parameter is zero or not specified, the paged query includes as many results as possible that fit in the return message.

YanıtlarResponses

HTTP Durum KoduHTTP Status Code AçıklamaDescription Yanıt ŞemasıResponse Schema
200 (Tamam)200 (OK) Başarılı bir işlem 200 durum kodu ve yedek bilgilerin sayfalı listesini döndürecektir.A successful operation will return 200 status code and a paged list of backup information.
PagedBackupInfoListPagedBackupInfoList
Diğer tüm durum kodlarıAll other status codes Ayrıntılı hata yanıtı.The detailed error response.
Kumaş HatasıFabricError

ÖrneklerExamples

Uygulama yedeklemelerini bir zaman aralığında alınGet application backups within a time range

Bu örnek, bir zaman aralığında hizmet yedekleme listesi almak için nasıl gösterir.This example shows how to get list of service backups within a time range.

İstekRequest

GET http://localhost:19080/Services/CalcApp/CalcService/$/GetBackups?api-version=6.4&StartDateTimeFilter=2018-01-01T00:00:00Z&EndDateTimeFilter=2018-01-01T23:59:59Z

200 Yanıt200 Response

GövdeBody
{
  "ContinuationToken": "",
  "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
    },
    {
      "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
    }
  ]
}

En son yedeklemeyi alınGet latest backup

Bu örnek, bir hizmetteki her bölüm için en son yedeklemenin nasıl alındığını gösterir.This example shows how to get the latest backup for each partition within a service.

İstekRequest

GET http://localhost:19080/Services/CalcApp/CalcService/$/GetBackups?api-version=6.4&Latest=True

200 Yanıt200 Response

GövdeBody
{
  "ContinuationToken": "",
  "Items": [
    {
      "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
    },
    {
      "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
    }
  ]
}

Maksimum sonuçları sınırlandırınLimit maximum results

Bu örnek, hizmet yedekleme listesinin nasıl alınır gösteriş olduğunu gösterir.This example shows how to get list of service backups. Bir sayfadaki sonuç sayısı MaxResult parametresini kullanarak en fazla iki ile sınırlıdır.The number of results in a page are limited to maximum of two using the MaxResult parameter.

İstekRequest

GET http://localhost:19080/Services/CalcApp/CalcService/$/GetBackups?api-version=6.4&MaxResults=2

200 Yanıt200 Response

GövdeBody
{
  "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
    }
  ]
}

Sayfa devamı belirteci kullanarakPage using continuation token

Bu örnek, hizmet yedekleme listesinin nasıl alınır gösteriş olduğunu gösterir.This example shows how to get list of service backups. Bir sayfadaki sonuç sayısı MaxResult parametresini kullanarak en fazla iki ile sınırlıdır.The number of results in a page are limited to maximum of two using the MaxResult parameter. Bu örnek, ContinuationToken parametresini kullanır.This example uses the ContinuationToken parameter. Bu parametrenin değeri önceki sorgudan sağlanır; bu durumda yukarıda gösterilen örnek.The value of this parameter is provided from the previous query; in this case the example shown above. Yanıt kalan sonuçları ve boş bir ContinuationToken içerir.The response contains the remaining results and an empty ContinuationToken. Boş ContinuationToken ek sonuçlar kullanılamaz gösterir.The empty ContinuationToken indicates that additional results are not available.

İstekRequest

GET http://localhost:19080/Services/CalcApp/CalcService/$/GetBackups?api-version=6.4&ContinuationToken=fabric:/CalcApp/CalcService#1daae3f5-7fd6-42e9-b1ba-8c05f873994d#7903dc2a-228d-44b0-b7c8-a13a6c9b46bd&MaxResults=2

200 Yanıt200 Response

GövdeBody
{
  "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
    }
  ]
}