Opis okresowej konfiguracji kopii zapasowej w usłudze Azure Service Fabric

Konfigurowanie okresowej kopii zapasowej usług reliable stateful services lub Reliable Actors składa się z następujących kroków:

1. Tworzenie zasad tworzenia kopii zapasowych: w tym kroku są tworzone co najmniej jedno zasady tworzenia kopii zapasowych w zależności od wymagań.

2. Włączanie tworzenia kopii zapasowej: w tym kroku skojarzysz zasady tworzenia kopii zapasowych utworzone w kroku 1 z wymaganymi jednostkami, aplikacją, usługą lub partycją.

Tworzenie zasad kopii zapasowych

Zasady tworzenia kopii zapasowych składają się z następujących konfiguracji:

• Automatyczne przywracanie po utracie danych: określa, czy wyzwalać przywracanie automatycznie przy użyciu najnowszej dostępnej kopii zapasowej, jeśli partycja doświadcza zdarzenia utraty danych.

Uwaga

Zaleca się, aby nie ustawiać automatycznego przywracania w klastrach produkcyjnych

• Maksymalna liczba przyrostowych kopii zapasowych: definiuje maksymalną liczbę przyrostowych kopii zapasowych do wykonania między dwoma pełnymi kopiami zapasowymi. Maksymalna liczba przyrostowych kopii zapasowych określa górny limit. Pełną kopię zapasową można wykonać, zanim określona liczba przyrostowych kopii zapasowych zostanie ukończona w jednym z następujących warunków

  1. Replika nigdy nie utworzyła pełnej kopii zapasowej, ponieważ stała się podstawowa.

  2. Niektóre rekordy dziennika od czasu ostatniego utworzenia kopii zapasowej zostały obcięte.

  3. Replika przekroczyła limit MaxAccumulatedBackupLogSizeInMB.

• Harmonogram tworzenia kopii zapasowych: czas lub częstotliwość wykonywania okresowych kopii zapasowych. Można zaplanować tworzenie kopii zapasowych cyklicznie w określonym interwale lub o stałej godzinie codziennie/co tydzień.

  1. Harmonogram tworzenia kopii zapasowych oparty na częstotliwości: ten typ harmonogramu powinien być używany, jeśli konieczne jest wykonanie kopii zapasowej danych w ustalonych odstępach czasu. Żądany interwał czasu między dwoma kolejnymi kopiami zapasowymi jest definiowany przy użyciu formatu ISO8601. Harmonogram tworzenia kopii zapasowych oparty na częstotliwości obsługuje rozdzielczość interwału do minuty.

     {
         "ScheduleKind": "FrequencyBased",
         "Interval": "PT10M"
     }
     

  2. Harmonogram tworzenia kopii zapasowych oparty na czasie: ten typ harmonogramu powinien być używany, jeśli konieczne jest wykonanie kopii zapasowej danych o określonych porach dnia lub tygodnia. Typ częstotliwości harmonogramu może być dzienny lub tygodniowy.

     1. Dzienny harmonogram tworzenia kopii zapasowych oparty na czasie: ten typ harmonogramu powinien być używany, jeśli konieczne jest wykonanie kopii zapasowej danych o określonych porach dnia. Aby to określić, ustaw wartość ScheduleFrequencyType Codziennie i ustaw na RunTimes listę żądanych godzin w ciągu dnia w formacie ISO8601, data określona wraz z godziną zostanie zignorowana. Na przykład 0001-01-01T18:00:00 reprezentuje codziennie 18:00 , ignorując datę część 0001-01-01. Poniższy przykład ilustruje konfigurację wyzwalania codziennej kopii zapasowej o godzinie 9:00 i 18:00 codziennie.

        {
            "ScheduleKind": "TimeBased",
            "ScheduleFrequencyType": "Daily",
            "RunTimes": [
              "0001-01-01T09:00:00Z",
              "0001-01-01T18:00:00Z"
            ]
        }
        

     2. Tygodniowy harmonogram tworzenia kopii zapasowych oparty na czasie: ten typ harmonogramu powinien być używany, jeśli konieczne jest wykonanie kopii zapasowej danych o określonych porach dnia. Aby to określić, ustaw wartość ScheduleFrequencyType Co tydzień; ustaw wartość RunDays na listę dni w tygodniu, gdy należy wyzwolić kopię zapasową i ustawić RunTimes listę żądanego czasu w ciągu dnia w formacie ISO8601, data określona wraz z godziną zostanie zignorowana. Lista dni tygodnia, kiedy wyzwalać okresową kopię zapasową. Poniższy przykład ilustruje konfigurację wyzwalania codziennej kopii zapasowej o godzinie 9:00 i 18:00 w poniedziałek do piątku.

        {
            "ScheduleKind": "TimeBased",
            "ScheduleFrequencyType": "Weekly",
            "RunDays": [
               "Monday",
               "Tuesday",
               "Wednesday",
               "Thursday",
               "Friday"
            ],
            "RunTimes": [
              "0001-01-01T09:00:00Z",
              "0001-01-01T18:00:00Z"
            ]
        }
        

• Magazyn kopii zapasowych: określa lokalizację przekazywania kopii zapasowych. Magazyn może być magazynem obiektów blob platformy Azure lub udziałem plików.

  1. Magazyn obiektów blob platformy Azure z tożsamością zarządzaną: ten typ magazynu należy wybrać, gdy konieczne jest przechowywanie wygenerowanych kopii zapasowych na platformie Azure. Zarówno autonomiczne , jak i oparte na chmurze klastry mogą używać tego typu magazynu. Opis tego typu magazynu wymaga identyfikatora BlobServiceUri i nazwy kontenera, w którym należy przekazać kopie zapasowe. Jeśli kontener o określonej nazwie nie jest dostępny, zostanie utworzony podczas przekazywania kopii zapasowej. Zastąp account-name ciąg nazwą konta magazynu.

     {
         "StorageKind": "ManagedIdentityAzureBlobStore",
         "FriendlyName": "AzureMI_storagesample",
         "BlobServiceUri": "https://<account-name>.blob.core.windows.net",
         "ContainerName": "backup-container",
         "ManagedIdentityType": "VMSS",
         "ManagedIdentityClientId": "<Client-Id of User-Assigned MI>" 
     }
     

     [UWAGA] Użyj opcjonalnego parametru ManagedIdentityClientId z identyfikatorem klienta tożsamości zarządzanej przypisanej przez użytkownika w przypadku wielu tożsamości zarządzanych przypisanych przez użytkownika przypisanych do zasobu lub przypisanych zarówno do interfejsu SAMI i UAMI, jak i musimy użyć funkcji UAMI jako domyślnej, w przeciwnym razie nie ma potrzeby tego parametru.

     Wykonaj kroki przypisywania tożsamości zarządzanej w zasobie platformy Azure:

     1. Włączanie tożsamości zarządzanej przypisanej przez system lub przypisanej przez użytkownika w zestawie skalowania maszyn wirtualnych Konfigurowanie tożsamości zarządzanych w zestawie skalowania maszyn wirtualnych

     2. Przypisywanie roli do tożsamości zarządzanej usługi VMSS do konta magazynu Przypisywanie ról platformy Azure przy użyciu witryny Azure Portal — Kontrola dostępu oparta na rolach platformy Azure

        1. Rola współautora danych obiektu blob usługi Storage co najmniej

     Aby uzyskać więcej informacji na temat tożsamości zarządzanej

  2. Magazyn obiektów blob platformy Azure z funkcją ConnectionString: ten typ magazynu należy wybrać, gdy konieczne jest przechowywanie wygenerowanych kopii zapasowych na platformie Azure. Zarówno autonomiczne , jak i oparte na chmurze klastry mogą używać tego typu magazynu. Opis tego typu magazynu wymaga parametry połączenia i nazwy kontenera, w którym należy przekazać kopie zapasowe. Jeśli kontener o określonej nazwie jest niedostępny, zostanie utworzony podczas przekazywania kopii zapasowej.

     {
         "StorageKind": "AzureBlobStore",
         "FriendlyName": "Azure_storagesample",
         "ConnectionString": "<Put your Azure blob store connection string here>",
         "ContainerName": "backup-container"
     }
     

     Uwaga

     Usługa przywracania kopii zapasowych nie działa z połączeniem usługi Azure Storage w wersji 1 nie jest zalecana w środowisku produkcyjnym, ponieważ bezpośredni dostęp do zasobu bez uwierzytelniania użytkownika

  3. Udział plików: ten typ magazynu należy wybrać dla klastrów autonomicznych , gdy konieczne jest przechowywanie kopii zapasowych danych w środowisku lokalnym. Opis tego typu magazynu wymaga ścieżki udziału plików, w której należy przekazać kopie zapasowe. Dostęp do udziału plików można skonfigurować przy użyciu jednej z następujących opcji

     1. Zintegrowane uwierzytelnianie systemu Windows, w którym dostęp do udziału plików jest udostępniany wszystkim komputerom należącym do klastra usługi Service Fabric. W takim przypadku ustaw następujące pola, aby skonfigurować magazyn kopii zapasowych oparty na udziale plików.

        {
            "StorageKind": "FileShare",
            "FriendlyName": "Sample_FileShare",
            "Path": "\\\\StorageServer\\BackupStore"
        }
        

     2. Ochrona udziału plików przy użyciu nazwy użytkownika i hasła, gdzie dostęp do udziału plików jest udostępniany określonym użytkownikom. Specyfikacja magazynu udziału plików zapewnia również możliwość określenia pomocniczej nazwy użytkownika i pomocniczego hasła w celu zapewnienia poświadczeń rezerwowych w przypadku niepowodzenia uwierzytelniania przy użyciu podstawowej nazwy użytkownika i hasła podstawowego. W takim przypadku ustaw następujące pola, aby skonfigurować magazyn kopii zapasowych oparty na udziale plików.

        {
            "StorageKind": "FileShare",
            "FriendlyName": "Sample_FileShare",
            "Path": "\\\\StorageServer\\BackupStore",
            "PrimaryUserName": "backupaccount",
            "PrimaryPassword": "<Password for backupaccount>",
            "SecondaryUserName": "backupaccount2",
            "SecondaryPassword": "<Password for backupaccount2>"
        }
        

Uwaga

Upewnij się, że niezawodność magazynu spełnia lub przekracza wymagania dotyczące niezawodności danych kopii zapasowej.

• Zasady przechowywania: określa zasady przechowywania kopii zapasowych w skonfigurowanym magazynie. Obsługiwane są tylko podstawowe zasady przechowywania.

  1. Podstawowe zasady przechowywania: te zasady przechowywania umożliwiają zapewnienie optymalnego wykorzystania magazynu przez usunięcie plików kopii zapasowych, które nie są już wymagane. RetentionDuration Można określić, aby ustawić przedział czasu, dla którego kopie zapasowe są wymagane do przechowywania w magazynie. MinimumNumberOfBackups jest opcjonalnym parametrem, który można określić, aby upewnić się, że określona liczba kopii zapasowych jest zawsze zachowywana niezależnie od RetentionDuration. Poniższy przykład ilustruje konfigurację przechowywania kopii zapasowych przez 10 dni i nie zezwala na użycie liczby kopii zapasowych poniżej 20.

     {
         "RetentionPolicyType": "Basic",
         "RetentionDuration": "P10D",
         "MinimumNumberOfBackups": 20
     }
     

Włączanie okresowej kopii zapasowej

Po zdefiniowaniu zasad tworzenia kopii zapasowych w celu spełnienia wymagań dotyczących kopii zapasowej danych zasady tworzenia kopii zapasowych powinny być odpowiednio skojarzone z aplikacją lub usługą albo partycją.

Uwaga

Przed włączeniem kopii zapasowej upewnij się, że nie ma żadnych uaktualnień aplikacji

Hierarchiczne propagowanie zasad kopii zapasowych

W usłudze Service Fabric relacja między aplikacją, usługą i partycjami jest hierarchiczna, jak wyjaśniono w artykule Model aplikacji. Zasady tworzenia kopii zapasowych mogą być skojarzone z aplikacją, usługą lub partycją w hierarchii. Zasady tworzenia kopii zapasowych propagują hierarchicznie do następnego poziomu. Zakładając, że istnieje tylko jedna zasada tworzenia kopii zapasowych i skojarzona z aplikacją, wszystkie partycje stanowe należące do wszystkich niezawodnych usług stanowych i Reliable Actors aplikacji są tworzone kopie zapasowe przy użyciu zasad tworzenia kopii zapasowych. Lub jeśli zasady tworzenia kopii zapasowych są skojarzone z usługą Reliable stateful, wszystkie jej partycje są tworzone przy użyciu zasad tworzenia kopii zapasowych.

Zastępowanie zasad kopii zapasowych

Może istnieć scenariusz, w którym tworzenie kopii zapasowych danych z tym samym harmonogramem tworzenia kopii zapasowych jest wymagane dla wszystkich usług aplikacji, z wyjątkiem określonych usług, w których konieczne jest utworzenie kopii zapasowej danych przy użyciu harmonogramu wyższej częstotliwości lub utworzenie kopii zapasowej na innym koncie magazynu lub udziałie plików. Aby rozwiązać takie scenariusze, usługa przywracania kopii zapasowych udostępnia funkcję zastąpienia propagowanych zasad w zakresie usług i partycji. Gdy zasady tworzenia kopii zapasowych są skojarzone z usługą lub partycją, zastępuje propagowane zasady kopii zapasowej, jeśli istnieją.

Przykład

W tym przykładzie użyto konfiguracji z dwiema aplikacjami, MyApp_A i MyApp_B. MyApp_A aplikacji zawiera dwie niezawodne usługi stanowe, SvcA1 i SvcA3 oraz jedną usługę Reliable ActorA2. SvcA1 zawiera trzy partycje, podczas gdy aktorA2 i SvcA3 zawierają dwie partycje. MyApp_B aplikacji zawiera trzy niezawodne usługi stanowe, SvcB1, SvcB2 i SvcB3. _SvcB1 i SvcB2 zawierają dwie partycje, a SvcB3 zawiera trzy partycje.

Załóżmy, że wymagania dotyczące tworzenia kopii zapasowych danych tych aplikacji są następujące

1. MyApp_A

   1. Utwórz codzienną kopię zapasową danych dla wszystkich partycji wszystkich usług Reliable Stateful i Reliable Actors należących do aplikacji. Przekazywanie danych kopii zapasowej do lokalizacji BackupStore1.

   2. Jedna z usług, SvcA3, wymaga tworzenia kopii zapasowej danych co godzinę.

   3. Rozmiar danych w SvcA1_P2 partycji jest większy niż oczekiwano , a dane kopii zapasowej powinny być przechowywane w innej lokalizacji magazynu BackupStore2.

2. MyApp_B

   1. Utwórz kopię zapasową danych w każdą niedzielę o godzinie 8:00 dla wszystkich partycji usługi SvcB1 . Przekazywanie danych kopii zapasowej do lokalizacji BackupStore1.

   2. Utwórz kopię zapasową danych codziennie o godzinie 8:00 dla SvcB2_P1 partycji. Przekazywanie danych kopii zapasowej do lokalizacji BackupStore1.

Aby spełnić te wymagania dotyczące tworzenia kopii zapasowych danych, zasady tworzenia kopii zapasowych BP_1 do BP_5 są tworzone, a tworzenie kopii zapasowych jest włączone w następujący sposób.

1. MyApp_A

   1. Utwórz zasady tworzenia kopii zapasowych, BP_1 z harmonogramem tworzenia kopii zapasowych opartym na częstotliwości, gdzie częstotliwość jest ustawiona na 24 godziny. i magazyn kopii zapasowych skonfigurowany do używania lokalizacji magazynu BackupStore1. Włącz te zasady dla MyApp_A aplikacji przy użyciu interfejsu API włączania kopii zapasowej aplikacji. Ta akcja umożliwia tworzenie kopii zapasowych danych przy użyciu zasad tworzenia kopii zapasowych BP_1 dla wszystkich partycji usług Reliable Stateful Services i Reliable Actors należących do MyApp_A aplikacji.

   2. Utwórz zasady tworzenia kopii zapasowych, BP_2 z harmonogramem tworzenia kopii zapasowych opartym na częstotliwości, gdzie częstotliwość jest ustawiona na 1 godz. i magazyn kopii zapasowych skonfigurowany do używania lokalizacji magazynu BackupStore1. Włącz te zasady dla usługi SvcA3 przy użyciu interfejsu API włączania kopii zapasowej usługi. Ta akcja zastępuje propagowane zasady BP_1 przez jawnie włączone zasady tworzenia kopii zapasowych BP_2 dla wszystkich partycji usługi SvcA3 prowadzących do tworzenia kopii zapasowych danych przy użyciu zasad tworzenia kopii zapasowych BP_2 dla tych partycji.

   3. Utwórz zasady tworzenia kopii zapasowych, BP_3 z harmonogramem tworzenia kopii zapasowych opartym na częstotliwości, gdzie częstotliwość jest ustawiona na 24 godziny. i magazyn kopii zapasowych skonfigurowany do używania lokalizacji magazynu BackupStore2. Włącz te zasady dla SvcA1_P2 partycji przy użyciu interfejsu API włączania kopii zapasowej partycji. Ta akcja zastępuje propagowane zasady BP_1 przez jawnie włączone zasady tworzenia kopii zapasowych BP_3 dla SvcA1_P2 partycji.

2. MyApp_B

   1. Utwórz zasady tworzenia kopii zapasowych, BP_4 z harmonogramem tworzenia kopii zapasowych opartym na czasie, w którym typ częstotliwości harmonogramu jest ustawiony na co tydzień, dni uruchamiania są ustawione na niedzielę, a czasy uruchamiania są ustawione na 8:00. Magazyn kopii zapasowych skonfigurowany do używania lokalizacji magazynu BackupStore1. Włącz te zasady dla usługi SvcB1 przy użyciu interfejsu API włączania kopii zapasowej usługi. Ta akcja umożliwia tworzenie kopii zapasowej danych przy użyciu zasad tworzenia kopii zapasowych BP_4 dla wszystkich partycji usługi SvcB1.

   2. Utwórz zasady tworzenia kopii zapasowych, BP_5 z harmonogramem tworzenia kopii zapasowych opartym na czasie, w którym typ częstotliwości harmonogramu jest ustawiony na codziennie, a czasy uruchamiania mają wartość 8:00. Magazyn kopii zapasowych skonfigurowany do używania lokalizacji magazynu BackupStore1. Włącz te zasady dla SvcB2_P1 partycji przy użyciu interfejsu API włączania kopii zapasowej partycji. Ta akcja umożliwia tworzenie kopii zapasowej danych przy użyciu zasad tworzenia kopii zapasowych BP_5 dla SvcB2_P1 partycji.

Na poniższym diagramie przedstawiono jawnie włączone zasady tworzenia kopii zapasowych i propagowane zasady tworzenia kopii zapasowych.

Wyłączanie kopii zapasowej

Zasady tworzenia kopii zapasowych można wyłączyć, gdy nie ma potrzeby tworzenia kopii zapasowych danych. Zasady tworzenia kopii zapasowych włączone w aplikacji można wyłączyć tylko w tej samej aplikacji przy użyciu wyłączania interfejsu API tworzenia kopii zapasowej aplikacji, zasady tworzenia kopii zapasowych włączone w usłudze w tej samej usłudze przy użyciu wyłączania interfejsu API tworzenia kopii zapasowych usługi, a zasady tworzenia kopii zapasowych włączone na partycji można wyłączyć w tej samej partycji przy użyciu interfejsu API wyłącz tworzenie kopii zapasowych partycji.

• Wyłączenie zasad tworzenia kopii zapasowych dla aplikacji powoduje zatrzymanie wszystkich okresowych kopii zapasowych danych w wyniku propagacji zasad kopii zapasowej do partycji usługi Reliable Stateful lub partycji Reliable Actor.

• Wyłączenie zasad tworzenia kopii zapasowych dla usługi powoduje zatrzymanie wszystkich okresowych kopii zapasowych danych w wyniku propagacji tych zasad kopii zapasowych do partycji usługi.

• Wyłączenie zasad tworzenia kopii zapasowych partycji powoduje zatrzymanie wszystkich okresowych kopii zapasowych danych z powodu zasad tworzenia kopii zapasowych na partycji.

• Podczas wyłączania kopii zapasowej dla jednostki (aplikacji/usługi/partycji) można ustawić wartość true, CleanBackup aby usunąć wszystkie kopie zapasowe w skonfigurowanym magazynie.

  {
      "CleanBackup": true 
  }
  

Uwaga

Przed wyłączeniem kopii zapasowej upewnij się, że nie ma żadnych uaktualnień aplikacji

Wstrzymywanie i wznawianie tworzenia kopii zapasowe

Niektóre sytuacje mogą wymagać tymczasowego zawieszenia okresowej kopii zapasowej danych. W takich sytuacjach, w zależności od wymagania, wstrzymywanie interfejsu API kopii zapasowej może być używane w aplikacji, usłudze lub partycji. Okresowe zawieszenie kopii zapasowej jest przechodnie przez poddrzewo hierarchii aplikacji od momentu jej zastosowania.

• Po zastosowaniu zawieszenia w aplikacji przy użyciu interfejsu API wstrzymania tworzenia kopii zapasowej aplikacji wszystkie usługi i partycje w ramach tej aplikacji są zawieszone na potrzeby okresowej kopii zapasowej danych.

• Po zastosowaniu zawieszenia w usłudze przy użyciu interfejsu API wstrzymania kopii zapasowej usługi wszystkie partycje w ramach tej usługi są zawieszone na potrzeby okresowej kopii zapasowej danych.

• Gdy zawieszenie jest stosowane w partycji przy użyciu interfejsu API wstrzymania kopii zapasowej partycji, zawiesza partycje w ramach tej usługi są zawieszone na potrzeby okresowej kopii zapasowej danych.

Po zakończeniu konieczności zawieszenia można przywrócić okresową kopię zapasową danych przy użyciu odpowiedniego interfejsu API tworzenia kopii zapasowej wznawiania. Okresowa kopia zapasowa musi zostać wznowiona w tej samej aplikacji, usłudze lub partycji , w której została zawieszona.

• Jeśli zawieszenie zostało zastosowane w aplikacji, należy wznowić korzystanie z interfejsu API wznawiania tworzenia kopii zapasowej aplikacji.

• Jeśli zawieszenie zostało zastosowane w usłudze, należy wznowić korzystanie z interfejsu API wznawiania tworzenia kopii zapasowej usługi.

• Jeśli zawieszenie zostało zastosowane w partycji, należy wznowić korzystanie z interfejsu API wznawiania tworzenia kopii zapasowej partycji.

Różnica między wstrzymaniem i wyłączeniem kopii zapasowych

Wyłącz kopię zapasową należy używać, gdy kopie zapasowe nie są już wymagane dla określonej aplikacji, usługi lub partycji. Można wywołać wyłączenie żądania kopii zapasowej wraz z czystym parametrem kopii zapasowych, co oznaczałoby również, że wszystkie istniejące kopie zapasowe są również usuwane. Jednak wstrzymanie ma być używane w scenariuszach, w których chcesz tymczasowo wyłączyć kopie zapasowe, takie jak gdy dysk lokalny staje się pełny lub przekazywanie kopii zapasowej kończy się niepowodzeniem z powodu znanego problemu z siecią itp.

Mimo że wyłączenie można wywołać tylko na poziomie, który został wcześniej włączony dla kopii zapasowej jawnie, jednak zawieszenie można stosować na dowolnym poziomie, który jest obecnie włączony do tworzenia kopii zapasowej bezpośrednio lub za pośrednictwem dziedziczenia/ hierarchii. Jeśli na przykład kopia zapasowa jest włączona na poziomie aplikacji, można wywołać funkcję wyłącz tylko na poziomie aplikacji, jednak wstrzymanie można wywołać w aplikacji, dowolnej usłudze lub partycji w ramach tej aplikacji.

Automatyczne przywracanie po utracie danych

Partycja usługi może utracić dane z powodu nieoczekiwanych awarii. Na przykład dysk dla dwóch z trzech replik partycji (w tym repliki podstawowej) jest uszkodzony lub czyszczony.

Gdy usługa Service Fabric wykryje, że partycja znajduje się w utracie OnDataLossAsync danych, wywołuje metodę interfejsu na partycji i oczekuje, że partycja podejmie wymaganą akcję, aby wyjść z utraty danych. W takiej sytuacji, jeśli obowiązujące zasady tworzenia kopii zapasowych w partycji mają AutoRestoreOnDataLoss ustawioną flagę , true przywracanie zostanie wyzwolone automatycznie przy użyciu najnowszej dostępnej kopii zapasowej dla tej partycji.

Uwaga

Zaleca się, aby nie ustawiać automatycznego przywracania w klastrach produkcyjnych

Pobieranie konfiguracji kopii zapasowej

Oddzielne interfejsy API są udostępniane w celu uzyskania informacji o konfiguracji kopii zapasowej w zakresie aplikacji, usługi i partycji . Pobierz informacje o konfiguracji kopii zapasowej aplikacji, uzyskaj informacje o konfiguracji kopii zapasowej usługi i uzyskaj informacje o konfiguracji kopii zapasowej partycji są odpowiednio tymi interfejsami API. Głównie te interfejsy API zwracają odpowiednie zasady tworzenia kopii zapasowych, zakres, w którym są stosowane zasady tworzenia kopii zapasowych i szczegóły zawieszenia kopii zapasowych. Poniżej przedstawiono krótki opis zwracanych wyników tych interfejsów API.

• Informacje o konfiguracji kopii zapasowej aplikacji: zawierają szczegółowe informacje o zasadach tworzenia kopii zapasowych stosowanych w aplikacji oraz wszystkich zastąpionych zasadach w usługach i partycjach należących do aplikacji. Zawiera również informacje o zawieszeniu aplikacji i jej usług oraz partycji.

• Informacje o konfiguracji kopii zapasowej usługi: zawiera szczegółowe informacje dotyczące obowiązujących zasad tworzenia kopii zapasowych w usłudze oraz zakres, w którym zastosowano te zasady i wszystkie zastąpione zasady w jego partycjach. Zawiera również informacje o zawieszeniu usługi i jej partycjach.

• Informacje o konfiguracji kopii zapasowej partycji: zawiera szczegółowe informacje o obowiązujących zasadach tworzenia kopii zapasowych na partycji i zakresie, w którym zastosowano te zasady. Zawiera również informacje o zawieszeniu partycji.

Wyświetlanie listy dostępnych kopii zapasowych

Dostępne kopie zapasowe można wyświetlić przy użyciu interfejsu API pobierania listy kopii zapasowych. Wynik wywołania interfejsu API obejmuje elementy informacji o kopii zapasowej powiązane ze wszystkimi kopiami zapasowymi dostępnymi w magazynie kopii zapasowych, które są skonfigurowane w odpowiednich zasadach kopii zapasowych. Różne warianty tego interfejsu API są udostępniane do wyświetlania listy dostępnych kopii zapasowych należących do aplikacji, usługi lub partycji. Te interfejsy API obsługują pobieranie najnowszej dostępnej kopii zapasowej wszystkich odpowiednich partycji lub filtrowanie kopii zapasowych na podstawie daty rozpoczęcia i daty zakończenia.

Te interfejsy API obsługują również stronicowanie wyników, gdy parametr MaxResults jest ustawiony na niezerowo dodatnią liczbę całkowitą, a następnie interfejs API zwraca maksymalne elementy informacji kopii zapasowej MaxResults . W przypadku, gdy jest dostępnych więcej elementów informacji kopii zapasowej niż wartość MaxResults , zwracany jest token kontynuacji. Prawidłowy parametr tokenu kontynuacji może służyć do uzyskania następnego zestawu wyników. Gdy prawidłowa wartość tokenu kontynuacji jest przekazywana do następnego wywołania interfejsu API, interfejs API zwraca następny zestaw wyników. W odpowiedzi nie jest uwzględniany żaden token kontynuacji, gdy zostaną zwrócone wszystkie dostępne wyniki.

Poniżej przedstawiono krótkie informacje o obsługiwanych wariantach.

• Pobieranie listy kopii zapasowych aplikacji: zwraca listę kopii zapasowych dostępnych dla każdej partycji należącej do danej aplikacji usługi Service Fabric.

• Pobieranie listy kopii zapasowych usługi: zwraca listę kopii zapasowych dostępnych dla każdej partycji należącej do danej usługi Service Fabric.

• Pobieranie listy kopii zapasowych partycji: zwraca listę kopii zapasowych dostępnych dla określonej partycji.

Następne kroki

• Dokumentacja interfejsu API REST przywracania kopii zapasowych