Ciclo di vita dell'applicazione per l'archiviazione Backup di Microsoft 365
Eseguire l'onboarding di un'applicazione di archiviazione Backup di Microsoft 365 di terze parti
Dopo che all'applicazione di archiviazione Backup di Microsoft 365 viene dato il consenso per l'esecuzione nel tenant di utilizzo, per consentire che sia il controller di archiviazione Backup di Microsoft 365 in un tenant di utilizzo, è necessario eseguire le attività programmatiche seguenti (tramite l'applicazione):
Registrare l'applicazione come controller di archiviazione Backup di Microsoft 365.
Controllare se il servizio Backup di Microsoft 365 è abilitato nel tenant di utilizzo.
Attivare l'applicazione in modo che sia il controller di archiviazione Backup di Microsoft 365.
- Se è presente un controller esistente, attendere il completamento del periodo di tolleranza.
Dopo aver registrato l'applicazione, è sempre possibile controllare lo stato dell'applicazione come controller di archiviazione Backup di Microsoft 365 eseguendo l'API Get serviceApp:
GET /solutions/backupRestore/serviceApps/{serviceAppId}
Passaggio 1: Registrare l'applicazione come controller di archiviazione Backup di Microsoft 365
Per registrare l'applicazione come controller di archiviazione Backup di Microsoft 365, è prima di tutto necessario registrare l'applicazione eseguendo l'API Crea app del servizio:
POST /solutions/backupRestore/serviceApps/
Se l'applicazione è stata registrata correttamente, ha uno stato di inattivo. L'ID restituito è l'ID dell'app di servizio dell'applicazione ,ovvero l'ID applicazione.
Passaggio 2: Verificare se il servizio Backup di Microsoft 365 è abilitato nel tenant di utilizzo
Per verificare se il servizio Backup di Microsoft 365 è abilitato nel tenant di utilizzo, l'applicazione deve eseguire l'API Get backupRestoreRoot:
GET /solutions/backupRestore/
Se lo stato restituito è abilitato, questo stato indica che esiste un controller di archiviazione Backup di Microsoft 365 attivo e che la modifica del controller impone un periodo di tolleranza. Tutti gli altri stati indicano che non esiste alcun controller di archiviazione Backup di Microsoft 365 attivo e che un'applicazione può diventare immediatamente controller durante la registrazione.
Passaggio 3: Attivare l'applicazione come controller di archiviazione Backup di Microsoft 365
Per attivare l'applicazione come controller di archiviazione Backup di Microsoft 365 dipende dal fatto che sia già presente o meno un controller di archiviazione Backup di Microsoft 365 esistente (di prima parte o di terze parti).
Nessun controller di archiviazione Backup di Microsoft 365 esistente
Se non esiste alcun controller di archiviazione Backup di Microsoft 365 esistente, è possibile attivare immediatamente l'applicazione come controller. Per eseguire questo passaggio, eseguire l'API serviceApp: activate :
POST /solutions/backupRestore/serviceApps/{serviceAppId}/activate
Se l'applicazione è stata immediatamente attivata correttamente, ha uno stato attivo.
Controller di archiviazione Backup di Microsoft 365 esistente
Se è presente un controller di archiviazione Backup di Microsoft 365 esistente, quando si attiva l'applicazione come controller è necessario specificare una data/ora in cui la modifica è effettiva. La data/ora deve essere di almeno 7 giorni in futuro, ma non superiore a 30 giorni.
Per attivare l'applicazione, è necessario eseguire l'API serviceApp: activate specificando la data/ora effettiva nel corpo JSON della richiesta:
POST /solutions/backupRestore/serviceApps/{serviceAppId}/activate
Nota
Se è già stata apportata una modifica in sospeso al controller di archiviazione Backup di Microsoft 365 già in corso, la richiesta avrà esito negativo con un codice di errore HTTP 403. Non sarà possibile attivare l'applicazione fino al completamento della modifica in sospeso.
Se l'applicazione è stata attivata correttamente per una data/ora in futuro, ha lo stato pendingActive.
Periodo di tolleranza del controller di archiviazione Backup di Microsoft 365 esistente
Se era presente un controller di archiviazione Backup di Microsoft 365 esistente quando è stata attivata l'applicazione, questo passaggio applica un periodo di tolleranza compreso tra 7 e 30 giorni (come specificato quando è stata attivata l'applicazione).
Durante il periodo di tolleranza:
- Lo stato dell'applicazione è pendingActive.
- L'applicazione ha accesso in sola lettura a tutti i criteri di protezione esistenti. L'applicazione non sarà in grado di modificare o creare criteri di protezione o di eseguire ripristini.
- Il Amministrazione Backup tenant di utilizzo può annullare la modifica in sospeso del controller di archiviazione Backup di Microsoft 365 e ripristinare lo stato originale.
- L'applicazione può annullare la modifica in sospeso del controller di archiviazione Backup di Microsoft 365 e ripristinare lo stato originale eseguendo l'API serviceApp: deactivate:
POST /solutions/backupRestore/serviceApps/{serviceAppId}/deactivate
- L'applicazione può controllare lo stato dell'applicazione come controller di archiviazione Backup di Microsoft 365 eseguendo l'API Get serviceApp:
GET /solutions/backupRestore/serviceApps/{serviceAppId}
Al termine del periodo di tolleranza:
- Lo stato dell'applicazione è attivo.
Passaggio 4: Abilitare i criteri di fatturazione nel tenant di utilizzo
Dopo che lo stato dell'applicazione è attivo, è necessario abilitare i criteri di fatturazione nel tenant di utilizzo. Questo passaggio viene eseguito eseguendo backupRestoreRoot: abilitare l'API:
POST /solutions/backupRestore/enable
Dopo aver abilitato i criteri di fatturazione, l'applicazione sarà il controller di archiviazione Backup di Microsoft 365 nel tenant di utilizzo e sarà ora in grado di gestire il servizio Backup di Microsoft 365 (in base agli ambiti di autorizzazione oAuth dell'applicazione).
Nota
È possibile eseguire questa API più volte in quanto è idempotente. È consigliabile abilitare i criteri di fatturazione nel tenant di utilizzo se, per qualsiasi motivo, i criteri di fatturazione vengono modificati. Ad esempio, se si vuole modificare l'ID sottoscrizione o il gruppo di risorse di Azure.
Offboarding di un'applicazione Backup di Microsoft 365
Un'altra applicazione è attivata come controller di archiviazione Backup di Microsoft 365
Se l'applicazione è il controller di archiviazione Backup di Microsoft 365 attivo, è possibile che anche un'altra applicazione (di prima parte o di terze parti) possa essere attivata in base al processo di onboarding definito in Controller di archiviazione Backup di Microsoft 365 esistente e Backup di Microsoft 365 Periodo di tolleranza del controller di archiviazione. Se si verifica questo evento, l'applicazione non riceverà una notifica esplicita. Tuttavia, lo stato dell'applicazione diventa pendingInactive. T o ottenere lo stato dell'applicazione come controller di archiviazione Backup di Microsoft 365 l'applicazione può eseguire l'API Get serviceApp:
GET /solutions/backupRestore/serviceApps/{serviceAppId}
Durante il periodo di tolleranza:
- Lo stato dell'applicazione è pendingInactive.
- L'applicazione continua ad avere accesso ai criteri di protezione esistenti ed è in grado di modificare o creare criteri di protezione o di eseguire eventuali ripristini (in base agli ambiti di autorizzazione oAuth).
- L'applicazione continua a essere responsabile della fatturazione Backup di Microsoft 365 e quindi del consumo nel tenant di consumo.
- Il Amministrazione Backup tenant in uso può annullare la modifica in sospeso del controller di archiviazione Backup di Microsoft 365 e ripristinare lo stato originale in modo che l'applicazione venga ripristinata come controller di archiviazione Backup di Microsoft 365 attivo.
Al termine del periodo di tolleranza:
- Lo stato dell'applicazione è inattivo.
- L'applicazione non è più responsabile della fatturazione Backup di Microsoft 365 e quindi della fatturazione con pagamento in base al consumo nel tenant di consumo.
Disattivare l'applicazione come controller di archiviazione Backup di Microsoft 365
Per disattivare l'applicazione dal servizio Backup di Microsoft 365 nel tenant di utilizzo, l'applicazione deve eseguire l'API serviceApp: deactivate:
POST /solutions/backupRestore/serviceApps/{serviceAppId}/deactivate
Il risultato della disattivazione dell'applicazione dipende dallo stato corrente dell'applicazione.
Disattivazione con stato corrente di inattivo
La disattivazione dell'applicazione con stato inattivo non comporta alcuna operazione.
Disattivazione con stato corrente di pendingActive
La disattivazione dell'applicazione con stato in sospesoAttivo annulla la modifica in sospeso per diventare il controller di archiviazione Backup di Microsoft 365. Dopo aver richiamato correttamente l'API:
- Lo stato dell'applicazione è inattivo.
- L'applicazione attualmente Backup di Microsoft 365 Storage Controller ha lo stato attivo.
Disattivazione con stato corrente di pendingInactive
La disattivazione dell'applicazione con stato pendingInactive non comporta alcuna operazione per la modifica in sospeso del controller di archiviazione Backup di Microsoft 365. Ovvero, la modifica in sospeso continua fino al completamento del periodo di tolleranza.
Disattivazione con stato corrente attivo
Non è possibile disattivare l'applicazione con stato attivo e la richiesta ha esito negativo con un codice 403 di errore HTTP.
Per disattivare l'applicazione come controller di archiviazione Backup di Microsoft 365, è necessario attivare un'altra applicazione oppure annullare la registrazione dell'applicazione come controller di archiviazione Backup di Microsoft 365.
Annullare la registrazione dell'applicazione come controller di archiviazione Backup di Microsoft 365
Per annullare la registrazione dell'applicazione dal controller di archiviazione Backup di Microsoft 365 nel tenant di utilizzo, l'applicazione deve eseguire l'API Delete serviceApp:
DELETE /solutions/backupRestore/serviceApps/{serviceAppId}
Il risultato dell'annullamento della registrazione dell'applicazione dipende dallo stato corrente dell'applicazione.
Annullamento della registrazione con stato corrente di inattivo
L'annullamento della registrazione dell'applicazione con stato inattivo rimuove l'applicazione come disponibile come controller di archiviazione Backup di Microsoft 365. Dopo aver richiamato correttamente l'API:
- L'applicazione non è più disponibile per diventare il controller di archiviazione Backup di Microsoft 365 (a meno che non venga registrata di nuovo).
Annullamento della registrazione con stato corrente di pendingActive
L'annullamento della registrazione dell'applicazione con stato pendingActive annulla la modifica in sospeso per diventare il controller di archiviazione Backup di Microsoft 365. Dopo aver richiamato correttamente l'API:
- L'applicazione non è più disponibile per diventare il controller di archiviazione Backup di Microsoft 365 (a meno che non venga registrata di nuovo).
- L'applicazione non ha più accesso in sola lettura ai criteri di protezione esistenti.
- L'applicazione attualmente Backup di Microsoft 365 Storage Controller ha lo stato attivo.
Annullamento della registrazione con stato corrente di pendingInactive
Non è possibile annullare la registrazione dell'applicazione con stato pendingInactive e la richiesta ha esito negativo con codice di errore HTTP 403.
Per annullare la registrazione dell'applicazione come controller di archiviazione Backup di Microsoft 365, è necessario attendere il completamento del periodo di tolleranza oppure se la modifica in sospeso viene annullata e l'applicazione viene ripristinata come controller di archiviazione Backup di Microsoft 365.
Annullamento della registrazione con stato corrente attivo
L'annullamento della registrazione dell'applicazione con stato attivo avvia automaticamente una modifica in sospeso del controller di archiviazione Backup di Microsoft 365 con un periodo di tolleranza obbligatorio di 7 giorni.
Dopo aver richiamato correttamente l'API e durante il periodo di tolleranza:
- L'applicazione non sarà in grado di accedere, creare o modificare criteri di protezione o eseguire ripristini.
- L'applicazione non è più disponibile per diventare il controller di archiviazione Backup di Microsoft 365 (a meno che non venga registrata di nuovo).
- L'applicazione continua a essere responsabile della fatturazione Backup di Microsoft 365 e quindi dell'utilizzo nel tenant di consumo fino a quando non viene attivata un'altra applicazione per diventare il controller di archiviazione Backup di Microsoft 365.
Al termine del periodo di tolleranza:
- L'applicazione non è ancora disponibile per diventare il controller di archiviazione Backup di Microsoft 365 (a meno che non venga registrata di nuovo).
- Se un'altra applicazione non viene attivata come controller di archiviazione Backup di Microsoft 365, viene avviato l'offboarding del servizio Backup di Microsoft 365 nel tenant di utilizzo.
- L'applicazione continua a essere responsabile della fatturazione Backup di Microsoft 365 e quindi del consumo nel tenant di utilizzo fino a quando un'altra applicazione non viene attivata come controller di archiviazione Backup di Microsoft 365 o fino alla scadenza del periodo di fatturazione (30 giorni) in base all'offboarding del Backup di Microsoft 365 servizio nel tenant di utilizzo.
Avviso
Se l'applicazione è il controller di archiviazione Backup di Microsoft 365 attivo quando si annulla la registrazione, si è potenzialmente responsabili di altri 37 giorni (7 giorni più 30 giorni) per la fatturazione Backup di Microsoft 365 con pagamento in base al consumo nel tenant di consumo.
Stati del ciclo di vita dell'applicazione
L'onboarding e l'offboarding di un'applicazione Backup di Microsoft 365 richiede che l'applicazione attraversi diversi stati. Le modifiche dello stato vengono avviate da:
- Un'applicazione che richiama API specifiche;
- La conseguenza di un'altra applicazione che richiama API specifiche; O
- Il sistema in attesa di un periodo di tempo.
Il diagramma precedente descrive gli stati e i movimenti che possono causare una transizione tra di essi:
- Registrare l'applicazione come controller di archiviazione Backup di Microsoft 365
- Attivare l'applicazione come controller di archiviazione Backup di Microsoft 365 senza controller di archiviazione Backup di Microsoft 365 esistente
- Attivare l'applicazione in modo che sia il controller di archiviazione Backup di Microsoft 365 con un controller di archiviazione Backup di Microsoft 365 esistente e un'altra applicazione è attivata come controller di archiviazione Backup di Microsoft 365 quando l'applicazione è attiva controller di archiviazione Backup di Microsoft 365
- Il periodo di tolleranza del controller di archiviazione Backup di Microsoft 365 esistente viene completato
- Disattivare l'applicazione in modo che sia il controller di archiviazione Backup di Microsoft 365 con stato corrente in sospesoAttivo
- Annullare la registrazione dell'applicazione come controller di archiviazione Backup di Microsoft 365 con stato corrente di inattivo
- Annullare la registrazione dell'applicazione come controller di archiviazione Backup di Microsoft 365 con stato corrente in sospesoAttivo
- Annullare la registrazione dell'applicazione come controller di archiviazione Backup di Microsoft 365 con stato corrente attivo