Anwendungslebenszyklus für Microsoft 365 Backup Storage
Onboarding einer Microsoft 365 Backup Storage-Anwendung eines Drittanbieters
Nachdem Ihre Microsoft 365 Backup Storage-Anwendung die Zustimmung zur Ausführung im Nutzungsmandanten erhalten hat, müssen Sie die folgenden programmgesteuerten Aufgaben (über Ihre Anwendung) ausführen, damit sie der Microsoft 365 Backup Storage Controller in einem nutzenden Mandanten sein kann:
Registrieren Sie Ihre Anwendung als Microsoft 365 Backup Storage Controller.
Überprüfen Sie, ob der Microsoft 365 Backup-Dienst im Nutzungsmandanten aktiviert ist.
Aktivieren Sie Ihre Anwendung als Microsoft 365 Backup Storage Controller.
- Wenn ein Controller vorhanden ist, warten Sie, bis die Karenzzeit abgeschlossen ist.
Aktivieren Sie Ihre Abrechnungsrichtlinie im Nutzen des Mandanten.
Nachdem Ihre Anwendung registriert wurde, können Sie den Status Ihrer Anwendung immer als Microsoft 365 Backup Storage Controller überprüfen, indem Sie die Get serviceApp-API ausführen:
GET /solutions/backupRestore/serviceApps/{serviceAppId}
Schritt 1: Registrieren Ihrer Anwendung als Microsoft 365 Backup Storage Controller
Um Ihre Anwendung als Microsoft 365 Backup Storage Controller zu registrieren, müssen Sie zuerst Ihre Anwendung registrieren, indem Sie die Api zum Erstellen einer Dienst-App ausführen:
POST /solutions/backupRestore/serviceApps/
Wenn Ihre Anwendung erfolgreich registriert wurde, hat sie den Status Inaktiv. Die zurückgegebene ID ist die Dienst-App-ID Ihrer Anwendung (Dies ist Ihre Anwendungs-ID).
Schritt 2: Überprüfen, ob der Microsoft 365 Backup-Dienst im Mandanten mit Nutzung aktiviert ist
Um zu überprüfen, ob der Microsoft 365-Sicherungsdienst im nutzenden Mandanten aktiviert ist, muss Ihre Anwendung die GET backupRestoreRoot-API ausführen:
GET /solutions/backupRestore/
Wenn der zurückgegebene Zustand aktiviert ist, gibt dieser Zustand an, dass es einen aktiven Microsoft 365 Backup Storage Controller gibt und dass eine Änderung des Controllers eine Toleranzperiode erzwingt. Alle anderen Zustände deuten darauf hin, dass es keinen aktiven Microsoft 365 Backup Storage Controller gibt und dass eine Anwendung bei der Registrierung sofort zum Controller werden kann.
Schritt 3: Aktivieren Ihrer Anwendung als Microsoft 365 Backup Storage Controller
Die Aktivierung Ihrer Anwendung als Microsoft 365 Backup Storage Controller hängt davon ab, ob bereits ein Microsoft 365 Backup Storage Controller vorhanden ist (entweder Erstanbieter oder Drittanbieter).
Kein Vorhandener Microsoft 365 Backup Storage Controller
Wenn kein Microsoft 365 Backup Storage Controller vorhanden ist, können Sie Ihre Anwendung sofort als Controller aktivieren. Führen Sie für diesen Schritt die API serviceApp: activate aus:
POST /solutions/backupRestore/serviceApps/{serviceAppId}/activate
Wenn Ihre Anwendung sofort erfolgreich aktiviert wurde, hat sie den Status Aktiv.
Vorhandener Microsoft 365 Backup Storage Controller
Wenn ein Microsoft 365 Backup Storage Controller vorhanden ist, müssen Sie beim Aktivieren Ihrer Anwendung als Controller ein Datum/eine Uhrzeit angeben, zu dem die Änderung wirksam ist. Das Datum/die Uhrzeit muss mindestens 7 Tage in der Zukunft, aber nicht größer als 30 Tage sein.
Um Ihre Anwendung zu aktivieren, müssen Sie die API serviceApp: activate ausführen, die das effektive Datum/die effektive Uhrzeit im JSON-Text der Anforderung angibt:
POST /solutions/backupRestore/serviceApps/{serviceAppId}/activate
Hinweis
Wenn bereits eine Änderung am Microsoft 365 Backup Storage Controller aussteht, schlägt Ihre Anforderung mit dem HTTP-Fehlercode 403 fehl. Sie können Ihre Anwendung erst aktivieren, wenn die ausstehende Änderung abgeschlossen ist.
Wenn Ihre Anwendung erfolgreich für ein Datum/eine Uhrzeit in der Zukunft aktiviert wurde, hat sie den Status pendingActive.
Vorhandene Toleranzperiode für Microsoft 365 Backup Storage Controller
Wenn beim Aktivieren der Anwendung ein Microsoft 365 Backup Storage Controller vorhanden war, erzwingt dieser Schritt eine Karenzzeit von 7 bis 30 Tagen (wie bei der Aktivierung Der Anwendung angegeben).
Während der Karenzzeit:
- Ihre Anwendung weist den Status PendingActive auf.
- Ihre Anwendung verfügt über schreibgeschützten Zugriff auf alle vorhandenen Schutzrichtlinien. Ihre Anwendung kann keine Schutzrichtlinien ändern oder erstellen oder Wiederherstellungsvorgänge ausführen.
- Der Administrator für die Nutzung der Mandantensicherung kann die ausstehende Änderung des Microsoft 365 Backup Storage Controllers abbrechen und in den ursprünglichen Zustand zurückkehren.
- Ihre Anwendung kann die ausstehende Änderung des Microsoft 365 Backup Storage Controllers abbrechen und in den ursprünglichen Zustand zurückkehren, indem sie die API serviceApp: deactivate ausführt:
POST /solutions/backupRestore/serviceApps/{serviceAppId}/deactivate
- Ihre Anwendung kann den Status Ihrer Anwendung als Microsoft 365 Backup Storage Controller überprüfen, indem sie die Get serviceApp-API ausführt:
GET /solutions/backupRestore/serviceApps/{serviceAppId}
Nach Ablauf der Karenzzeit:
- Ihre Anwendung weist den Status Aktiv auf.
Schritt 4: Aktivieren Ihrer Abrechnungsrichtlinie im Nutzen des Mandanten
Sobald Ihre Anwendung den Status Aktiv aufweist, müssen Sie Ihre Abrechnungsrichtlinie im Nutzungsmandanten aktivieren. Dieser Schritt wird ausgeführt, indem die API backupRestoreRoot: enable ausgeführt wird:
POST /solutions/backupRestore/enable
Nachdem Sie die Abrechnungsrichtlinie aktiviert haben, ist Ihre Anwendung der Microsoft 365 Backup Storage Controller im nutzenden Mandanten und kann nun den Microsoft 365 Backup Service (gemäß den oAuth-Berechtigungsbereichen Ihrer Anwendung) verwalten.
Hinweis
Sie können diese API mehrmals ausführen, da sie idempotent ist. Es wird empfohlen, die Abrechnungsrichtlinie im Nutzungsmandanten zu aktivieren, wenn sich Ihre Abrechnungsrichtlinie aus irgendeinem Grund ändert. Beispielsweise, wenn Sie die Azure-Abonnement-ID oder Ressourcengruppe ändern möchten.
Offboarding einer Microsoft 365 Backup-Anwendung
Eine andere Anwendung wird als Microsoft 365 Backup Storage Controller aktiviert.
Wenn Es sich bei Ihrer Anwendung um den aktiven Microsoft 365 Backup Storage Controller handelt, kann möglicherweise auch eine andere Anwendung (Erstanbieter oder Drittanbieter) gemäß dem onboarding-Prozess aktiviert werden, der in Existing-Microsoft 365 Backup Storage Controller und Existing Microsoft 365 Backup Storage Controller Grace Period definiert ist. Wenn dieses Ereignis eintritt, wird Ihre Anwendung nicht explizit benachrichtigt. Der Status Ihrer Anwendung lautet jedoch pendingInactive. Wenn Der Status Ihrer Anwendung der Microsoft 365 Backup Storage Controller ist, kann Ihre Anwendung die Get serviceApp-API ausführen:
GET /solutions/backupRestore/serviceApps/{serviceAppId}
Während der Karenzzeit:
- Ihre Anwendung hat den Status pendingInactive.
- Ihre Anwendung hat weiterhin Zugriff auf die vorhandenen Schutzrichtlinien und kann Schutzrichtlinien ändern oder erstellen oder Wiederherstellungen durchführen (gemäß Ihren oAuth-Berechtigungsbereichen).
- Ihre Anwendung ist weiterhin für die Abrechnung von Microsoft 365 Backup und damit für die Nutzung im Nutzungsmandanten verantwortlich.
- Der Administrator für die Nutzung der Mandantensicherung kann die ausstehende Änderung des Microsoft 365 Backup Storage Controllers abbrechen und in den ursprünglichen Zustand zurückkehren, sodass Ihre Anwendung als aktiver Microsoft 365 Backup Storage Controller wiederhergestellt wird.
Nach Ablauf der Karenzzeit:
- Ihre Anwendung weist den Status Inaktiv auf.
- Ihre Anwendung ist nicht mehr für die Abrechnung von Microsoft 365 Backup und damit für die nutzungsbasierte Abrechnung im Nutzungsmandanten verantwortlich.
Deaktivieren Ihrer Anwendung als Microsoft 365 Backup Storage Controller
Um Ihre Anwendung als Microsoft 365 Backup Service im nutzenden Mandanten zu deaktivieren, muss Ihre Anwendung die API serviceApp: deactivate ausführen:
POST /solutions/backupRestore/serviceApps/{serviceAppId}/deactivate
Das Ergebnis der Deaktivierung Ihrer Anwendung hängt vom aktuellen Status Ihrer Anwendung ab.
Deaktivieren mit dem aktuellen Status "Inaktiv"
Das Deaktivieren Ihrer Anwendung, die den Status Inaktiv aufweist, führt nicht zu einer Aktion.
Deaktivierung mit dem aktuellen Status pendingActive
Wenn Sie Ihre Anwendung mit dem Status pendingActive deaktivieren, wird Ihre ausstehende Änderung abgebrochen, um zum Microsoft 365 Backup Storage Controller zu werden. Nach erfolgreichem Aufrufen der API:
- Ihre Anwendung weist den Status Inaktiv auf.
- Die Anwendung, bei der es sich derzeit um den Microsoft 365 Backup Storage Controller handelt, weist den Status Aktiv auf.
Deaktivierung mit dem aktuellen Status "pendingInactive"
Wenn Sie Ihre Anwendung mit dem Status pendingInactive deaktivieren, hat dies keine Auswirkungen auf die ausstehende Änderung des Microsoft 365 Backup Storage Controllers. Das heißt, die ausstehende Änderung wird fortgesetzt, bis die Karenzzeit abgeschlossen ist.
Deaktivieren mit dem aktuellen Status "aktiv"
Sie können Ihre Anwendung mit dem Status aktiv nicht deaktivieren, und Ihre Anforderung schlägt mit dem HTTP-Fehler 403-Code fehl.
Um Ihre Anwendung als Microsoft 365 Backup Storage Controller zu deaktivieren, muss entweder eine andere Anwendung aktiviert werden, oder Sie können die Registrierung Ihrer Anwendung als Microsoft 365 Backup Storage Controller aufheben.
Aufheben der Registrierung Ihrer Anwendung als Microsoft 365 Backup Storage Controller
Um die Registrierung Ihrer Anwendung als Microsoft 365 Backup Storage Controller im nutzenden Mandanten aufzuheben, muss Ihre Anwendung die Delete serviceApp-API ausführen:
DELETE /solutions/backupRestore/serviceApps/{serviceAppId}
Das Ergebnis der Aufhebung der Registrierung Ihrer Anwendung hängt vom aktuellen Status Ihrer Anwendung ab.
Aufheben der Registrierung mit dem aktuellen Status "Inaktiv"
Wenn Sie die Registrierung Ihrer Anwendung aufheben, die den Status Inaktiv aufweist, wird Ihre Anwendung als der Microsoft 365 Backup Storage Controller verfügbar. Nach erfolgreichem Aufrufen der API:
- Ihre Anwendung ist nicht mehr verfügbar, um der Microsoft 365 Backup Storage Controller zu werden (es sei denn, sie wird erneut registriert).
Aufheben der Registrierung mit dem aktuellen Status pendingActive
Wenn Sie die Registrierung Ihrer Anwendung aufheben, die den Status pendingActive aufweist, wird Ihre ausstehende Änderung abgebrochen, um zum Microsoft 365 Backup Storage Controller zu werden. Nach erfolgreichem Aufrufen der API:
- Ihre Anwendung ist nicht mehr verfügbar, um der Microsoft 365 Backup Storage Controller zu werden (es sei denn, sie wird erneut registriert).
- Ihre Anwendung verfügt nicht mehr über schreibgeschützten Zugriff auf vorhandene Schutzrichtlinien.
- Die Anwendung, bei der es sich derzeit um den Microsoft 365 Backup Storage Controller handelt, weist den Status Aktiv auf.
Aufheben der Registrierung mit dem aktuellen Status "pendingInactive"
Sie können die Registrierung Ihrer Anwendung mit dem Status pendingInactive nicht aufheben, und Ihre Anforderung schlägt mit dem HTTP-Fehlercode 403 fehl.
Um die Registrierung Ihrer Anwendung als Microsoft 365 Backup Storage Controller aufzuheben, müssen Sie warten, bis die Karenzzeit abgeschlossen ist (oder wenn die ausstehende Änderung abgebrochen und Ihre Anwendung als Microsoft 365 Backup Storage Controller wiederhergestellt wird).
Aufheben der Registrierung mit dem aktuellen Status "aktiv"
Wenn Sie die Registrierung Ihrer Anwendung aufheben, deren Status aktiv ist, wird automatisch eine ausstehende Änderung des Microsoft 365 Backup Storage Controllers mit einer obligatorischen Karenzzeit von 7 Tagen initiiert.
Nach erfolgreichem Aufrufen der API und während der Karenzzeit:
- Ihre Anwendung kann nicht auf Schutzrichtlinien zugreifen, diese erstellen oder ändern oder wiederhergestellt werden.
- Ihre Anwendung ist nicht mehr verfügbar, um der Microsoft 365 Backup Storage Controller zu werden (es sei denn, sie wird erneut registriert).
- Ihre Anwendung ist weiterhin für die Abrechnung von Microsoft 365 Backup und damit für die Nutzung im Nutzungsmandanten verantwortlich, bis eine andere Anwendung als Microsoft 365 Backup Storage Controller aktiviert wird.
Nach Ablauf der Karenzzeit:
- Ihre Anwendung ist immer noch nicht mehr verfügbar, um der Microsoft 365 Backup Storage Controller zu werden (es sei denn, sie wird erneut registriert).
- Wenn keine andere Anwendung als Microsoft 365 Backup Storage Controller aktiviert ist, wird das Offboarding des Microsoft 365-Sicherungsdiensts im nutzenden Mandanten initiiert.
- Ihre Anwendung ist weiterhin für die Abrechnung von Microsoft 365 Backup und damit für die Nutzung im Nutzungsmandanten verantwortlich, bis eine andere Anwendung als Microsoft 365 Backup Storage Controller aktiviert wird oder bis der Abrechnungszeitraum (30 Tage) gemäß dem Offboarding des Microsoft 365 Backup-Diensts im nutzenden Mandanten abläuft.
Warnung
Wenn Ihre Anwendung der aktive Microsoft 365 Backup Storage Controller ist, wenn Sie die Registrierung aufheben, sind Sie möglicherweise für weitere 37 Tage (7 Tage plus 30 Tage) für die abrechnungsbasierte Bezahlung von Microsoft 365 Backup im nutzungsbasierten Mandanten verantwortlich.
Status des Anwendungslebenszyklus
Für das Onboarding und Offboarding einer Microsoft 365 Backup-Anwendung muss die Anwendung verschiedene Zustände durchlaufen. Die Zustandsänderungen werden initiiert von:
- Eine Anwendung, die bestimmte APIs aufruft;
- Die Folge, dass eine andere Anwendung bestimmte APIs aufruft; und/oder
- Das System, das auf einen bestimmten Zeitraum wartet.
Das obige Diagramm zeigt die Zustände und Gesten, die einen Übergang zwischen ihnen verursachen können:
- Registrieren Ihrer Anwendung als Microsoft 365 Backup Storage Controller
- Aktivieren Ihrer Anwendung als Microsoft 365 Backup Storage Controller ohne vorhandenen Microsoft 365 Backup Storage Controller
- Aktivieren Sie Ihre Anwendung als Microsoft 365 Backup Storage Controller mit einem vorhandenen Microsoft 365 Backup Storage Controller , und eine andere Anwendung wird als Microsoft 365 Backup Storage Controller aktiviert, wenn Ihre Anwendung der aktive Microsoft 365 Backup Storage Controller ist
- Die Karenzzeit für vorhandene Microsoft 365 Backup Storage Controller ist abgeschlossen.
- Deaktivieren Sie Ihre Anwendung als Microsoft 365 Backup Storage Controller mit dem aktuellen Status pendingActive.
- Aufheben der Registrierung Ihrer Anwendung als Microsoft 365 Backup Storage Controller mit dem aktuellen Status "Inaktiv"
- Heben Sie die Registrierung Ihrer Anwendung als Microsoft 365 Backup Storage Controller mit dem aktuellen Status pendingActive auf.
- Aufheben der Registrierung Ihrer Anwendung als Microsoft 365 Backup Storage Controller mit dem aktuellen Status "Aktiv"