Microsoft 365 備份記憶體的應用程式生命週期
將第三方Microsoft 365備份記憶體應用程序上線
一旦Microsoft 365 備份記憶體應用程式同意在取用租用戶中執行，若要讓它成為取用租使用者中的Microsoft 365 備份記憶體控制器，您必須透過應用程式 (執行下列程序設計工作) ：
啟用您的應用程式成為 Microsoft 365 備份記憶體控制器。
- 如果有現有的控制器，請等候 寬限期 完成。
註冊應用程式之後，您一律可以執行 Get serviceApp API，以Microsoft 365 備份記憶體控制器來檢查應用程式的狀態：
GET /solutions/backupRestore/serviceApps/{serviceAppId}
步驟 1：將您的應用程式註冊為 Microsoft 365 備份記憶體控制器
若要將應用程式註冊為 Microsoft 365 備份記憶體控制器，您必須先執行 建立服務應用程式 API 來註冊應用程式：
POST /solutions/backupRestore/serviceApps/
如果您的應用程式已成功註冊，則其狀態為 非使用中。 傳回的標識碼是應用程式 (的服務應用程式識別碼，也就是您的應用程式標識碼) 。
步驟 2：檢查取用租使用者中是否已啟用Microsoft 365 備份服務
若要檢查取用租使用者中是否已啟用 Microsoft 365 備份服務，您的應用程式必須執行 Get backupRestoreRoot API：
GET /solutions/backupRestore/
如果傳回的狀態 已啟用，則此狀態表示有作用中Microsoft 365備份記憶體控制器，而且變更控制器會強制執行寬限期。 所有其他狀態都表示沒有作用中Microsoft 365備份記憶體控制器，而且應用程式在註冊時可以立即成為控制器。
步驟 3：將應用程式啟用為 Microsoft 365 備份記憶體控制器
若要啟用應用程式作為 Microsoft 365 備份記憶體控制器，取決於是否有現有的 Microsoft 365 備份記憶體控制器 (第一方或第三方) 。
沒有現有的 Microsoft 365 備份記憶體控制器
如果沒有現有的 Microsoft 365 備份記憶體控制器，您可以立即啟動應用程式作為控制器。 若要執行此步驟，請執行 serviceApp： activate API：
POST /solutions/backupRestore/serviceApps/{serviceAppId}/activate
如果您的應用程式已立即成功啟用，則其狀態為 作用中。
現有的 Microsoft 365 備份記憶體控制器
如果有現有的 Microsoft 365 備份記憶體控制器，則當您將應用程式啟用為控制器時，您必須指定變更生效的日期/時間。 日期/時間在未來至少需要 7 天，但不能大於 30 天。
若要啟用您的應用程式，您必須執行 serviceApp： activate API，以指定要求 JSON 主體中的有效日期/時間：
POST /solutions/backupRestore/serviceApps/{serviceAppId}/activate
注意事項
如果Microsoft 365備份記憶體控制器已有擱置中的變更，您的要求將會失敗，並出現 HTTP 403 錯誤碼。 在暫止的變更完成之前，您將無法啟用應用程式。
如果您的應用程式在未來的日期/時間已成功啟用，則其狀態為 pendingActive。
現有Microsoft 365備份記憶體控制器寬限期
如果您在啟用應用程式時有現有的 Microsoft 365 備份記憶體控制器，此步驟會強制執行 7 到 30 天的寬限期， (當您啟用應用程式) 時所指定。
在寬限期期間：
- 您的應用程式狀態為 pendingActive。
- 您的應用程式具有任何現有保護原則的唯讀存取權。 您的應用程式將無法變更或建立保護原則或執行任何還原。
- 取用租用戶備份管理員可以取消Microsoft 365備份記憶體控制器的暫止變更，並還原回原始狀態。
- 您的應用程式可以取消 Microsoft 365 備份記憶體控制器的暫止變更，並藉由執行 serviceApp： deactivate API 來還原為原始狀態：
POST /solutions/backupRestore/serviceApps/{serviceAppId}/deactivate
- 您的應用程式可以執行 Get serviceApp API，以Microsoft 365 備份記憶體控制器的身分檢查應用程式的狀態：
GET /solutions/backupRestore/serviceApps/{serviceAppId}
寬限期完成時：
- 您的應用程式處於 作用中狀態。
步驟 4：在取用租用戶中啟用您的計費原則
一旦您的應用程式狀態為作用中，您必須在使用中的租用戶中啟用您的計費原則。 執行 backupRestoreRoot：啟用 API 即可執行此步驟：
POST /solutions/backupRestore/enable
啟用計費原則之後，您的應用程式將會是取用租使用者中的Microsoft 365備份記憶體控制器，而且現在可以根據應用程式的 oAuth 許可權範圍) 來維護Microsoft 365 備份服務 (。
注意事項
您可以多次執行此 API，因為它具有等冪性。 如果您的計費原則因任何原因而變更，建議您在使用中租用戶中啟用計費原則。 例如，如果您想要變更 Azure 訂用帳戶標識碼或資源群組。
將 Microsoft 365 備份應用程式離線
另一個應用程式會啟用為 Microsoft 365 備份記憶體控制器
如果您的應用程式是作用中Microsoft 365備份記憶體控制器，則另一個應用程式 (第一方或第三方) 也可以根據現有 Microsoft 365 備份記憶體控制器 和現有Microsoft 365 備份記憶體控制器寬限期中定義的上線程式來啟動。 如果發生此事件，將不會明確通知您的應用程式。 不過，應用程式的狀態會變成 pendingInactive。 T o 取得應用程式的狀態，成為應用程式可以執行 Get serviceApp API 的 Microsoft 365 備份記憶體控制器：
GET /solutions/backupRestore/serviceApps/{serviceAppId}
在寬限期期間：
- 您的應用程式狀態為 pendingInactive。
- 您的應用程式會繼續存取現有的保護原則，並能夠根據您的 oAuth 許可權範圍) 來變更或建立保護原則，或執行任何還原 (。
- 您的應用程式會繼續負責Microsoft 365 備份計費，因此取用租使用者中的使用量。
- 使用租使用者備份管理員可以取消Microsoft 365備份記憶體控制器的暫止變更，並還原為原始狀態，讓您的應用程式還原為作用中Microsoft 365 備份記憶體控制器。
寬限期完成時：
- 您的應用程式狀態為 非使用中。
- 您的應用程式不再負責Microsoft 365備份計費，因此也不再負責使用租使用者中的隨用隨付計費。
停用應用程式作為 Microsoft 365 備份記憶體控制器
若要將應用程式停用為取用租使用者中的 Microsoft 365 備份服務，您的應用程式必須執行 serviceApp：停用 API：
POST /solutions/backupRestore/serviceApps/{serviceAppId}/deactivate
停用應用程式的結果取決於應用程式的目前狀態。
停用目前非使用中狀態
停用處於 非使用中 狀態的應用程式不會執行任何動作。
停用，目前狀態為pendingActive
停用狀態為 pendingActive 的應用程式會取消暫止的變更，成為Microsoft 365備份記憶體控制器。 成功叫用 API 之後：
- 您的應用程式狀態為 非使用中。
- 目前為 Microsoft 365 備份記憶體控制 器的應用程式具有作用中狀態。
以pendingInactive的目前狀態停用
停用狀態 為pendingInactive 的應用程式不會對Microsoft 365備份記憶體控制器的暫止變更執行任何動作。 也就是說，暫止的變更會繼續進行，直到寬限期完成為止。
停用目前作用中狀態
您無法停用狀態為 作用中的應用程式 ，而且您的要求因 HTTP 錯誤 403 程式代碼而失敗。
若要將您的應用程式停用為 Microsoft 365 備份記憶體控制器，必須啟動另一個應用程式，或是將 應用程式取消註冊 為 Microsoft 365 備份記憶體控制器。
將應用程式取消註冊為 Microsoft 365 備份記憶體控制器
若要將應用程式從取用租使用者中的 Microsoft 365 備份記憶體控制器取消註冊，您的應用程式必須執行 Delete serviceApp API：
DELETE /solutions/backupRestore/serviceApps/{serviceAppId}
取消註冊應用程式的結果取決於應用程式的目前狀態。
以目前非使用中狀態取消註冊
取消註冊處於 非使用中 狀態的應用程式，會將您的應用程式移除為可供Microsoft 365 備份記憶體控制器使用。 成功叫用 API 之後：
- 除非重新註冊) ，否則您的應用程式無法再成為 Microsoft 365 備份記憶體控制器 (。
以pendingActive的目前狀態取消註冊
取消註冊狀態為 pendingActive 的應用程式，會取消暫止的變更，成為Microsoft 365備份記憶體控制器。 成功叫用 API 之後：
- 除非重新註冊) ，否則您的應用程式無法再成為 Microsoft 365 備份記憶體控制器 (。
- 您的應用程式不再具有任何現有保護原則的唯讀存取權。
- 目前為 Microsoft 365 備份記憶體控制 器的應用程式具有作用中狀態。
以pendingInactive的目前狀態取消註冊
您無法取消註冊狀態 為pendingInactive 的應用程式，而且您的要求因 HTTP 403 錯誤碼而失敗。
若要將您的應用程式取消註冊為 Microsoft 365 備份記憶體控制器，您必須等候寬限期完成 (或取消擱置的變更，且您的應用程式已恢復為 Microsoft 365 備份記憶體控制器) 。
使用目前作用中狀態取消註冊
取消註冊狀態為 作用中的應用程式 ，會自動起始Microsoft 365備份記憶體控制器的暫止變更，並強制使用 7 天寬限期。
在成功叫用 API 之後，以及在寬限期內：
- 您的應用程式將無法存取、建立或變更任何保護原則或執行任何還原。
- 除非重新註冊) ，否則您的應用程式無法再成為 Microsoft 365 備份記憶體控制器 (。
- 您的應用程式會繼續負責Microsoft 365備份計費，因此取用租使用者中的耗用量，直到另一個應用程式啟動成為 Microsoft 365 備份記憶體控制器為止。
寬限期完成時：
- 您的應用程式仍然無法再成為Microsoft 365 備份記憶體控制器 (，除非重新註冊) 。
- 如果另一個應用程式未啟用為 Microsoft 365 備份記憶體控制器，則會起始取用租使用者中Microsoft 365 備份服務的下架。
- 您的應用程式會繼續負責Microsoft 365 備份計費，因此在取用租使用者中使用量，直到另一個應用程式啟動為 Microsoft 365 備份記憶體控制器，或直到計費期間到期 (30 天) 根據取用租使用者中Microsoft 365 備份服務的下線。
警告
如果您的應用程式在您取消註冊時是作用中Microsoft 365 備份記憶體控制器，則您可能需額外負責 37 天 (7 天加上 30 天) 使用中租使用者中的Microsoft 365 備份隨用隨付計費。
應用程式生命周期狀態
將 Microsoft 365 備份應用程式上線和離線需要應用程式經歷許多不同的狀態。 狀態變更是由下列專案起始：
- 叫用特定 API 的應用程式;
- 另一個應用程式叫用特定 API 的結果;和/或
- 等待一段時間的系統。
上圖概述可能導致其間轉換的狀態和手勢：
- 將您的應用程式註冊為 Microsoft 365 備份記憶體控制器
- 啟動您的應用程式，成為沒有現有Microsoft 365 備份記憶體控制器的 Microsoft 365 備份記憶體控制器
- 啟用您的應用程式成為具有現有Microsoft 365 備份記憶體控制器的 Microsoft 365 備份記憶體 控制器， 當您的應用程式是作用中Microsoft 365 備份記憶體控制器時，另一個應用程式會啟動為Microsoft 365 備份記憶體控制器
- 現有Microsoft 365備份記憶體控制器寬限期完成
- 停用應用程式成為目前狀態為pendingActive的 Microsoft 365 備份記憶體控制器
- 將應用程式取消註冊為目前處於非作用中狀態的 Microsoft 365 備份記憶體控制器
- 將您的應用程式取消註冊為目前狀態為pendingActive的 Microsoft 365 備份記憶體控制器
- 將應用程式取消註冊為目前作用中狀態的 Microsoft 365 備份記憶體控制器