Cykl życia aplikacji dla usługi kopia zapasowa Microsoft 365 Storage

Dołączanie aplikacji magazynu kopia zapasowa Microsoft 365 innej firmy

Po wyrażeniu zgody aplikacji usługi kopia zapasowa Microsoft 365 Storage na wykonanie w dzierżawie zużywanej, aby umożliwić jej kopia zapasowa Microsoft 365 kontrolera magazynu w dzierżawie zużywanej, należy wykonać następujące zadania programowe (za pośrednictwem aplikacji):

1. Zarejestruj aplikację jako kontroler magazynu kopia zapasowa Microsoft 365.

2. Sprawdź, czy usługa kopia zapasowa Microsoft 365 jest włączona w dzierżawie zużywanej.

3. Aktywuj aplikację, aby była kontrolerem magazynu kopia zapasowa Microsoft 365.

   • Jeśli istnieje kontroler, poczekaj na zakończenie okresu prolongaty .

4. Włącz zasady rozliczeniowe w dzierżawie zużywanej.

Po zarejestrowaniu aplikacji zawsze można sprawdzić stan aplikacji jako kontrolera magazynu kopia zapasowa Microsoft 365, wykonując polecenie Get serviceApp API:

GET /solutions/backupRestore/serviceApps/{serviceAppId}

Krok 1. Rejestrowanie aplikacji jako kontrolera magazynu kopia zapasowa Microsoft 365

Aby zarejestrować aplikację jako kontroler magazynu kopia zapasowa Microsoft 365, należy najpierw zarejestrować aplikację, wykonując interfejs API aplikacji usługi Create Service:

POST /solutions/backupRestore/serviceApps/

Jeśli aplikacja została pomyślnie zarejestrowana, ma stan nieaktywny. Zwrócony identyfikator to identyfikator aplikacji usługi aplikacji (czyli identyfikator aplikacji).

Krok 2. Sprawdzanie, czy usługa kopia zapasowa Microsoft 365 jest włączona w dzierżawie zużywanej

Aby sprawdzić, czy usługa kopia zapasowa Microsoft 365 jest włączona w dzierżawie zużywanej, aplikacja musi wykonać interfejs API Get backupRestoreRoot:

GET /solutions/backupRestore/

Jeśli zwrócony stan jest włączony, ten stan wskazuje, że istnieje aktywny kontroler magazynu kopia zapasowa Microsoft 365 i że zmiana kontrolera wymusza okres prolongaty. Wszystkie inne stany wskazują, że nie ma aktywnego kontrolera magazynu kopia zapasowa Microsoft 365 i że aplikacja może natychmiast stać się kontrolerem podczas rejestrowania.

Krok 3. Aktywowanie aplikacji na kontroler magazynu kopia zapasowa Microsoft 365

Aktywowanie aplikacji jako kontrolera magazynu kopia zapasowa Microsoft 365 zależy od tego, czy istnieje już kontroler magazynu kopia zapasowa Microsoft 365 (zarówno pierwsza firma, jak i inna firma).

Brak istniejącego kontrolera magazynu kopia zapasowa Microsoft 365

Jeśli nie ma istniejącego kontrolera magazynu kopia zapasowa Microsoft 365, możesz natychmiast aktywować aplikację jako kontroler. Aby wykonać ten krok, należy wykonać usługęApp: aktywuj interfejs API:

POST /solutions/backupRestore/serviceApps/{serviceAppId}/activate

Jeśli aplikacja została natychmiast aktywowana pomyślnie, ma stan aktywny.

Istniejący kontroler magazynu kopia zapasowa Microsoft 365

Jeśli istnieje kontroler magazynu kopia zapasowa Microsoft 365, podczas aktywowania aplikacji jako kontrolera należy określić datę/godzinę obowiązywania zmiany. Data/godzina musi być w przyszłości co najmniej 7 dni, ale nie większa niż 30 dni.

Aby aktywować aplikację, musisz wykonać usługęAplikacja: aktywuj interfejs API, określając datę/godzinę wejścia w życie w treści kodu JSON żądania:

POST /solutions/backupRestore/serviceApps/{serviceAppId}/activate

Uwaga

Jeśli istnieje już oczekująca zmiana kontrolera magazynu kopia zapasowa Microsoft 365, żądanie kończy się niepowodzeniem z kodem błędu HTTP 403. Nie będzie można aktywować aplikacji do czasu zakończenia oczekującej zmiany.

Jeśli aplikacja została pomyślnie aktywowana przez datę/godzinę w przyszłości, ma stan pendingActive.

Istniejący okres prolongaty kontrolera magazynu kopia zapasowa Microsoft 365

Jeśli po aktywowaniu aplikacji istniała kopia zapasowa Microsoft 365 kontroler magazynu, ten krok wymusza okres prolongaty od 7 do 30 dni (zgodnie z instrukcjami po aktywowaniu aplikacji).

W okresie prolongaty:

• Aplikacja ma stan pendingActive.
• Aplikacja ma dostęp tylko do odczytu do wszelkich istniejących zasad ochrony. Aplikacja nie będzie mogła zmieniać ani tworzyć zasad ochrony ani wykonywać żadnych operacji przywracania.
• Usługa Consuming Tenant Backup Administracja może anulować oczekującą zmianę kontrolera magazynu kopia zapasowa Microsoft 365 i przywrócić oryginalny stan.
• Aplikacja może anulować oczekującą zmianę kontrolera magazynu kopia zapasowa Microsoft 365 i przywrócić oryginalny stan, wykonując polecenie serviceApp: dezaktywuj interfejs API:

POST /solutions/backupRestore/serviceApps/{serviceAppId}/deactivate

• Aplikacja może sprawdzić stan aplikacji jako kontrolera magazynu kopia zapasowa Microsoft 365, wykonując polecenie Get serviceApp API:

GET /solutions/backupRestore/serviceApps/{serviceAppId}

Po zakończeniu okresu prolongaty:

• Aplikacja ma stan aktywny.

Krok 4. Włączanie zasad rozliczeniowych w dzierżawie zużywanej

Gdy aplikacja ma stan aktywnego działania, musisz włączyć zasady rozliczeniowe w dzierżawie zużywanej. Ten krok jest wykonywany przez wykonanie kopii zapasowejRestoreRoot: włącz interfejs API:

POST /solutions/backupRestore/enable

Po włączeniu zasad rozliczeń aplikacja będzie kontrolerem magazynu kopia zapasowa Microsoft 365 w dzierżawie zużywanej i będzie teraz mogła obsługiwać usługę kopia zapasowa Microsoft 365 (zgodnie z zakresami uprawnień OAuth aplikacji).

Uwaga

Ten interfejs API można wykonać wiele razy, ponieważ jest idempotentny. Zaleca się włączenie zasad rozliczeniowych w dzierżawie zużywanej, jeśli z jakiegokolwiek powodu zmienią się zasady rozliczeniowe. Jeśli na przykład chcesz zmienić identyfikator subskrypcji platformy Azure lub grupę zasobów.

Obsługa programu Graph PowerShell

Usługa Microsoft Backup Storage obsługuje program PowerShell za pośrednictwem programu Microsoft Graph. Aby uzyskać więcej informacji na temat poleceń cmdlet programu PowerShell, zobacz backupRestoreRoot resource type (Typ zasobu backupRestoreRoot).

Odłączanie aplikacji kopia zapasowa Microsoft 365

Inna aplikacja jest aktywowana jako kontroler magazynu kopia zapasowa Microsoft 365

Jeśli aplikacja jest aktywnym kontrolerem magazynu kopia zapasowa Microsoft 365, możliwe jest, że inna aplikacja (pierwsza firma lub inna firma) również może zostać aktywowana zgodnie z procesem dołączania zdefiniowanym w temacie Istniejący kontroler magazynu kopia zapasowa Microsoft 365 i Istniejący kopia zapasowa Microsoft 365 okres prolongaty kontrolera magazynu. W przypadku wystąpienia tego zdarzenia aplikacja nie będzie jawnie powiadamiana. Jednak stan aplikacji staje się oczekującyInactive.

Aby uzyskać stan aplikacji będącej kontrolerem magazynu kopia zapasowa Microsoft 365, aplikacja może wykonać interfejs API get serviceApp:

GET /solutions/backupRestore/serviceApps/{serviceAppId}

W okresie prolongaty:

• Aplikacja ma stan pendingInactive.
• Aplikacja nadal ma dostęp do istniejących zasad ochrony i może zmieniać lub tworzyć zasady ochrony lub wykonywać wszelkie operacje przywracania (zgodnie z zakresami uprawnień oAuth).
• Aplikacja nadal jest odpowiedzialna za rozliczenia kopia zapasowa Microsoft 365, a tym samym za użycie w dzierżawie zużywanej.
• Usługa Consuming Tenant Backup Administracja może anulować oczekującą zmianę kontrolera magazynu kopia zapasowa Microsoft 365 i przywrócić oryginalny stan, tak aby aplikacja została przywrócona jako aktywny kontroler magazynu kopia zapasowa Microsoft 365.

Po zakończeniu okresu prolongaty:

• Aplikacja ma stan nieaktywny.
• Twoja aplikacja nie jest już odpowiedzialna za rozliczenia kopia zapasowa Microsoft 365, a tym samym rozliczenia z płatnością zgodnie z rzeczywistym użyciem w dzierżawie zużywanej.

Dezaktywowanie aplikacji jako kontrolera magazynu kopia zapasowa Microsoft 365

Aby dezaktywować aplikację z usługi kopia zapasowa Microsoft 365 w dzierżawie zużywanej, aplikacja musi wykonać usługęApp: dezaktywuj interfejs API:

POST /solutions/backupRestore/serviceApps/{serviceAppId}/deactivate

Wynik dezaktywowania aplikacji zależy od bieżącego stanu aplikacji.

Dezaktywuj z bieżącym stanem nieaktywności

Dezaktywowanie aplikacji, która ma stan nieaktywności , nie powoduje żadnych czynności.

Dezaktywuj z bieżącym stanem oczekującejaktywności

Dezaktywowanie aplikacji, która ma stan oczekująceAktywne, anuluje oczekującą zmianę, aby stać się kontrolerem magazynu kopia zapasowa Microsoft 365.

Po pomyślnym wywołaniu interfejsu API:

• Aplikacja ma stan nieaktywny.
• Aplikacja, która jest obecnie kontrolerem magazynu kopia zapasowa Microsoft 365, ma stan aktywny.

Dezaktywuj z bieżącym stanempendingInactive

Dezaktywowanie aplikacji, która ma stan oczekująceInactive, nie spowoduje żadnych działań w przypadku oczekującej zmiany kontrolera magazynu kopia zapasowa Microsoft 365. Oznacza to, że oczekująca zmiana trwa do czasu zakończenia okresu prolongaty.

Dezaktywuj przy użyciu bieżącego stanu aktywnego

Nie można dezaktywować aplikacji, która ma stan aktywny , a żądanie kończy się niepowodzeniem z powodu błędu HTTP 403.

Aby dezaktywować aplikację jako kontroler magazynu kopia zapasowa Microsoft 365, należy aktywować inną aplikację lub wyrejestrować aplikację, aby była kontrolerem magazynu kopia zapasowa Microsoft 365.

Wyrejestrowyowanie aplikacji jako kontrolera magazynu kopia zapasowa Microsoft 365

Aby wyrejestrować aplikację z funkcji kontrolera magazynu kopia zapasowa Microsoft 365 w dzierżawie zużywanej, aplikacja musi wykonać interfejs API usługi Delete ServiceApp:

DELETE /solutions/backupRestore/serviceApps/{serviceAppId}

Wynik wyrejestrowania aplikacji zależy od bieżącego stanu aplikacji.

Wyrejestrowanie z bieżącym stanem nieaktywności

Wyrejestrowywanie aplikacji, która ma stan nieaktywności, powoduje usunięcie aplikacji jako dostępnej dla kontrolera magazynu kopia zapasowa Microsoft 365.

Po pomyślnym wywołaniu interfejsu API:

• Aplikacja nie jest już dostępna, aby stać się kontrolerem magazynu kopia zapasowa Microsoft 365 (chyba że zostanie ponownie zarejestrowana).

Wyrejestruj z bieżącym stanem oczekującej wartościActive

Wyrejestrowywanie aplikacji o stanie oczekującymActive powoduje anulowanie oczekującej zmiany, aby stać się kontrolerem magazynu kopia zapasowa Microsoft 365.

Po pomyślnym wywołaniu interfejsu API:

• Aplikacja nie jest już dostępna, aby stać się kontrolerem magazynu kopia zapasowa Microsoft 365 (chyba że zostanie ponownie zarejestrowana).
• Aplikacja nie ma już dostępu tylko do odczytu do istniejących zasad ochrony.
• Aplikacja, która jest obecnie kontrolerem magazynu kopia zapasowa Microsoft 365, ma stan aktywny.

Wyrejestruj z bieżącym stanem pendingInactive

Nie można wyrejestrować aplikacji o stanie pendingInactive , a żądanie kończy się niepowodzeniem z kodem błędu HTTP 403.

Aby wyrejestrować aplikację jako kontroler magazynu kopia zapasowa Microsoft 365, musisz poczekać na ukończenie okresu prolongaty (lub jeśli oczekująca zmiana zostanie anulowana, a aplikacja zostanie przywrócona jako kontroler magazynu kopia zapasowa Microsoft 365).

Wyrejestruj z bieżącym stanem aktywności

Wyrejestrowywanie aplikacji o stanie aktywności automatycznie inicjuje oczekującą zmianę kontrolera magazynu kopia zapasowa Microsoft 365 z obowiązkowym 7-dniowym okresem prolongaty.

Po pomyślnym wywołaniu interfejsu API i w okresie prolongaty:

• Aplikacja nie będzie mogła uzyskiwać dostępu, tworzyć ani zmieniać żadnych zasad ochrony ani wykonywać żadnych operacji przywracania.
• Aplikacja nie jest już dostępna, aby stać się kontrolerem magazynu kopia zapasowa Microsoft 365 (chyba że zostanie ponownie zarejestrowana).
• Aplikacja nadal jest odpowiedzialna za rozliczenia kopia zapasowa Microsoft 365, a tym samym zużycie w dzierżawie zużywanej, dopóki inna aplikacja nie zostanie aktywowana, aby stać się kontrolerem magazynu kopia zapasowa Microsoft 365.

Po zakończeniu okresu prolongaty:

• Aplikacja nadal nie jest już dostępna, aby stać się kontrolerem magazynu kopia zapasowa Microsoft 365 (chyba że zostanie ponownie zarejestrowana).
• Jeśli inna aplikacja nie jest aktywowana jako kontroler magazynu kopia zapasowa Microsoft 365, inicjowane jest odłączanie usługi kopia zapasowa Microsoft 365 w dzierżawie zużywanej.
• Aplikacja nadal jest odpowiedzialna za rozliczenia kopia zapasowa Microsoft 365, a zatem zużycie w dzierżawie zużywanej do momentu aktywowania innej aplikacji jako kontrolera magazynu kopia zapasowa Microsoft 365 lub do momentu wygaśnięcia okresu rozliczeniowego (30 dni) zgodnie z odłączaniem kopia zapasowa Microsoft 365 usługi w dzierżawie zużywanej.

Ostrzeżenie

Jeśli aplikacja jest aktywnym kontrolerem magazynu kopia zapasowa Microsoft 365 podczas wyrejestrowywania, potencjalnie odpowiadasz za dodatkowe 37 dni (7 dni i 30 dni) dla kopia zapasowa Microsoft 365 rozliczeń z płatnością zgodnie z rzeczywistym użyciem w dzierżawie zużywanej.

Stany cyklu życia aplikacji

Dołączanie i odłączanie aplikacji kopia zapasowa Microsoft 365 wymaga, aby aplikacja przechodziła przez wiele różnych stanów. Zmiany stanu są inicjowane przez:

• Aplikacja wywołująca określone interfejsy API;
• Konsekwencją innej aplikacji wywołującej określone interfejsy API; Lub
• System czeka przez pewien czas.

Na poprzednim diagramie przedstawiono stany i gesty, które mogą powodować przejście między nimi:

1. Rejestrowanie aplikacji jako kontrolera magazynu kopia zapasowa Microsoft 365
2. Aktywowanie aplikacji jako kontrolera magazynu kopia zapasowa Microsoft 365 bez istniejącego kontrolera magazynu kopia zapasowa Microsoft 365
3. Aktywuj aplikację tak, aby była kontrolerem magazynu kopia zapasowa Microsoft 365 przy użyciu istniejącego kontrolera magazynu kopia zapasowa Microsoft 365, a inna aplikacja jest aktywowana jako kontroler magazynu kopia zapasowa Microsoft 365, gdy aplikacja jest Aktywny kontroler magazynu kopia zapasowa Microsoft 365
4. Ukończono istniejący okres prolongaty kontrolera magazynu kopia zapasowa Microsoft 365
5. Dezaktywuj aplikację tak, aby była kontrolerem magazynu kopia zapasowa Microsoft 365 o bieżącym stanie oczekującymAktywne
6. Wyrejestruj aplikację tak, aby była kontrolerem magazynu kopia zapasowa Microsoft 365 z bieżącym stanem nieaktywności
7. Wyrejestruj aplikację tak, aby była kontrolerem magazynu kopia zapasowa Microsoft 365 z bieżącym stanem oczekującymActive
8. Wyrejestruj aplikację tak, aby była kontrolerem magazynu kopia zapasowa Microsoft 365 z bieżącym stanem aktywności