Microsoft 365 Backup Storage のアプリケーション ライフサイクル
サード パーティの Microsoft 365 Backup Storage アプリケーションをオンボードする
Microsoft 365 Backup Storage アプリケーションが従量課金テナントで実行することに同意したら、それを使用テナントの Microsoft 365 Backup Storage Controller に設定できるようにするには、(アプリケーションを介して) 次のプログラム タスクを実行する必要があります。
使用しているテナントで Microsoft 365 Backup Service が有効になっているかどうかを確認します。
アプリケーションを Microsoft 365 Backup Storage Controller としてアクティブ化します。
- 既存のコントローラーがある場合は、 猶予期間 が完了するまで待ちます。
アプリケーションが登録されたら、 Get serviceApp API を実行することで、常にアプリケーションの状態を Microsoft 365 Backup Storage Controller として確認できます。
GET /solutions/backupRestore/serviceApps/{serviceAppId}
手順 1: アプリケーションを Microsoft 365 Backup Storage コントローラーとして登録する
アプリケーションを Microsoft 365 Backup Storage Controller に登録するには、まず、 Create service App API を実行してアプリケーションを登録する必要があります。
POST /solutions/backupRestore/serviceApps/
アプリケーションが正常に登録された場合、 アプリケーションは非アクティブ状態になります。 返される ID は、アプリケーションのサービス アプリ ID (アプリケーション ID) です。
手順 2: 使用しているテナントで Microsoft 365 Backup Service が有効になっているかどうかを確認する
使用しているテナントで Microsoft 365 Backup Service が有効になっているかどうかを確認するには、アプリケーションで Get backupRestoreRoot API を実行する必要があります。
GET /solutions/backupRestore/
返された状態が 有効になっている場合、この状態は、アクティブな Microsoft 365 Backup Storage Controller があり、コントローラーを変更すると猶予期間が適用されることを示します。 その他のすべての状態は、アクティブな Microsoft 365 Backup Storage Controller が存在せず、登録時にアプリケーションがすぐにコントローラーになることができることを示します。
手順 3: アプリケーションをライセンス認証して Microsoft 365 バックアップ ストレージ コントローラーにする
Microsoft 365 バックアップ ストレージ コントローラーとしてアプリケーションをアクティブ化するには、既存の Microsoft 365 バックアップ ストレージ コントローラー (ファースト パーティまたはサード パーティ) が既に存在するかどうかによって異なります。
既存の Microsoft 365 バックアップ ストレージ コントローラーがありません
既存の Microsoft 365 Backup Storage Controller がない場合は、すぐにアプリケーションをコントローラーとしてアクティブ化できます。 この手順を実行するには、 serviceApp: activate API を実行します。
POST /solutions/backupRestore/serviceApps/{serviceAppId}/activate
アプリケーションがすぐに正常にアクティブ化された場合は、アクティブな状態 になります。
既存の Microsoft 365 バックアップ ストレージ コントローラー
既存の Microsoft 365 Backup Storage コントローラーがある場合は、アプリケーションをコントローラーとしてアクティブ化するときに、変更が有効な日時を指定する必要があります。 日付/時刻は、少なくとも 7 日後である必要がありますが、30 日を超えない必要があります。
アプリケーションをアクティブ化するには、 serviceApp: Activate API を 実行し、要求 JSON 本文で有効な日付/時刻を指定する必要があります。
POST /solutions/backupRestore/serviceApps/{serviceAppId}/activate
注:
Microsoft 365 Backup Storage Controller に対する保留中の変更が既に進行中の場合、要求は HTTP 403 エラー コードで失敗します。 保留中の変更が完了するまで、アプリケーションをアクティブ化することはできません。
アプリケーションが将来の日付/時刻に対して正常にアクティブ化された場合、アプリケーションは pendingActive の状態になります。
既存の Microsoft 365 バックアップ ストレージ コントローラーの猶予期間
アプリケーションをアクティブ化したときに既存の Microsoft 365 Backup Storage Controller が存在する場合、この手順では 7 日から 30 日間の猶予期間が適用されます (アプリケーションをアクティブ化したときに指定)。
猶予期間:
- アプリケーションの状態は pendingActive です。
- アプリケーションは、既存の保護ポリシーに対する読み取り専用アクセス権を持っています。 アプリケーションで保護ポリシーを変更または作成したり、復元を実行したりすることはできません。
- 使用しているテナント バックアップ管理者は、Microsoft 365 Backup Storage Controller の保留中の変更を取り消し、元の状態に戻すことができます。
- アプリケーションは、Microsoft 365 Backup Storage Controller の保留中の変更を取り消し、 serviceApp: deactivate API を実行して元の状態に戻すことができます。
POST /solutions/backupRestore/serviceApps/{serviceAppId}/deactivate
- アプリケーションは、 Get serviceApp API を実行することで、アプリケーションの状態を Microsoft 365 Backup Storage Controller として確認できます。
GET /solutions/backupRestore/serviceApps/{serviceAppId}
猶予期間の完了時:
- アプリケーションの状態が アクティブです。
手順 4: 使用しているテナントで課金ポリシーを有効にする
アプリケーションの状態がアクティブになったら、消費テナントで課金ポリシーを有効にする必要があります。 この手順は、 backupRestoreRoot: enable API を実行することによって実行されます。
POST /solutions/backupRestore/enable
課金ポリシーを有効にすると、アプリケーションは消費テナントの Microsoft 365 バックアップ ストレージ コントローラーになり、(アプリケーションの oAuth アクセス許可スコープに従って) Microsoft 365 Backup Service を維持できるようになります。
注:
この API はべき等であるという点で複数回実行できます。 何らかの理由で課金ポリシーが変更された場合は、消費テナントで課金ポリシーを有効にすることをお勧めします。 たとえば、Azure サブスクリプション ID またはリソース グループを変更する場合です。
Microsoft 365 Backup アプリケーションのオフボード
別のアプリケーションが Microsoft 365 バックアップ ストレージ コントローラーとしてアクティブ化される
アプリケーションがアクティブな Microsoft 365 Backup Storage Controller の場合、既存の Microsoft 365 Backup Storage Controller と既存の Microsoft 365 Backup Storage Controller猶予期間で定義されているオンボード プロセスに従って、別のアプリケーション (ファースト パーティまたはサード パーティ) をアクティブ化することもできます。 このイベントが発生した場合、アプリケーションには明示的に通知されません。 ただし、アプリケーションの状態は pendingInactive になります。 アプリケーションが Get serviceApp API を実行できる Microsoft 365 Backup Storage Controller の状態を取得します。
GET /solutions/backupRestore/serviceApps/{serviceAppId}
猶予期間:
- アプリケーションの状態が pendingInactive です。
- アプリケーションは引き続き既存の保護ポリシーにアクセスでき、保護ポリシーを変更または作成したり、復元を実行することができます (oAuth アクセス許可スコープに従います)。
- アプリケーションは引き続き Microsoft 365 Backup の課金を担当し、従量課金テナントでの使用量を引き続き担当します。
- 使用しているテナント バックアップ管理者は、Microsoft 365 Backup Storage Controller の保留中の変更を取り消し、アプリケーションがアクティブな Microsoft 365 バックアップ ストレージ コントローラーとして復元されるように元の状態に戻すことができます。
猶予期間の完了時:
- アプリケーションの状態が 非アクティブです。
- アプリケーションは Microsoft 365 Backup の課金に対して責任を負う必要がなくなり、従量課金制テナントでの従量課金制課金が行われます。
Microsoft 365 Backup Storage Controller としてアプリケーションを非アクティブ化する
アプリケーションを使用しているテナントの Microsoft 365 Backup Service から非アクティブ化するには、アプリケーションで serviceApp: deactivate API を実行する必要があります。
POST /solutions/backupRestore/serviceApps/{serviceAppId}/deactivate
アプリケーションを非アクティブ化した結果は、アプリケーションの現在の状態によって異なります。
非アクティブの現在の状態での非アクティブ化
非アクティブ状態のアプリケーションを 非アクティブ 化しても、何も実行されません。
pendingActive の現在の状態での非アクティブ化
状態が pendingActive のアプリケーションを非アクティブにすると、保留中の変更が取り消され、Microsoft 365 Backup Storage Controller になります。 API を正常に呼び出した後:
- アプリケーションの状態が 非アクティブです。
- 現在 Microsoft 365 Backup Storage Controller であるアプリケーションの状態は アクティブです。
pendingInactive の現在の状態での非アクティブ化
pendingInactive 状態のアプリケーションを非アクティブ化しても、Microsoft 365 Backup Storage Controller の保留中の変更には何も行われません。 つまり、猶予期間が完了するまで、保留中の変更は続行されます。
現在の状態がアクティブな状態での非アクティブ化
アクティブな状態のアプリケーションを非アクティブ化することはできません。要求は HTTP エラー 403 コードで失敗します。
Microsoft 365 Backup Storage Controller としてアプリケーションを非アクティブ化するには、別のアプリケーションをアクティブ化する必要があります。または、 アプリケーションを Microsoft 365 Backup Storage Controller に登録解除する必要があります。
Microsoft 365 Backup Storage Controller としてアプリケーションの登録を解除する
アプリケーションを使用しているテナントの Microsoft 365 バックアップ ストレージ コントローラーから登録を解除するには、アプリケーションで Delete serviceApp API を実行する必要があります。
DELETE /solutions/backupRestore/serviceApps/{serviceAppId}
アプリケーションの登録解除の結果は、アプリケーションの現在の状態によって異なります。
非アクティブの現在の状態での登録解除
非アクティブ状態のアプリケーションの登録を解除すると、アプリケーションは Microsoft 365 Backup Storage Controller として使用できるようになります。 API を正常に呼び出した後:
- アプリケーションを Microsoft 365 Backup Storage Controller にすることはできなくなります (再登録されていない限り)。
pendingActive の現在の状態での登録解除
状態が pendingActive のアプリケーションの登録を解除すると、保留中の変更が取り消され、Microsoft 365 Backup Storage Controller になります。 API を正常に呼び出した後:
- アプリケーションを Microsoft 365 Backup Storage Controller にすることはできなくなります (再登録されていない限り)。
- アプリケーションは、既存の保護ポリシーへの読み取り専用アクセス権を持たなくなりました。
- 現在 Microsoft 365 Backup Storage Controller であるアプリケーションの状態は アクティブです。
pendingInactive の現在の状態での登録解除
pendingInactive 状態のアプリケーションの登録を解除できず、HTTP 403 エラー コードで要求が失敗します。
Microsoft 365 Backup Storage Controller としてアプリケーションの登録を解除するには、猶予期間が完了するまで待つ必要があります (または、保留中の変更が取り消され、アプリケーションが Microsoft 365 バックアップ ストレージ コントローラーとして復帰された場合)。
現在の状態がアクティブな状態での登録解除
アクティブな状態のアプリケーションの登録を解除すると、7 日間の猶予期間が必須の Microsoft 365 Backup Storage Controller の保留中の変更が自動的に開始されます。
API の呼び出しと猶予期間の呼び出しに成功した後:
- アプリケーションは、保護ポリシーにアクセスしたり、作成したり、変更したり、復元を実行したりすることはできません。
- アプリケーションを Microsoft 365 Backup Storage Controller にすることはできません (再登録されていない限り)。
- アプリケーションは引き続き Microsoft 365 Backup の課金を担当するため、別のアプリケーションがアクティブ化されて Microsoft 365 Backup Storage Controller になるまでの消費テナントでの使用量が発生します。
猶予期間の完了時:
- アプリケーションは、Microsoft 365 Backup Storage Controller (再登録されていない限り) に使用できなくなります。
- 別のアプリケーションが Microsoft 365 Backup Storage Controller としてアクティブ化されていない場合は、使用テナント内の Microsoft 365 Backup Service のオフボードが開始されます。
- アプリケーションは引き続き Microsoft 365 バックアップの課金を担当するため、別のアプリケーションが Microsoft 365 バックアップ ストレージ コントローラーとしてアクティブ化されるまで、または課金期間が期限切れ (30 日間) になるまで、消費テナントの消費は、使用テナントの Microsoft 365 バックアップ サービスのオフボードに従って実行されます。
警告
登録解除時にアプリケーションがアクティブな Microsoft 365 Backup Storage Controller である場合、消費テナントでの Microsoft 365 Backup 従量課金に対する追加の 37 日間 (7 日+ 30 日) の責任が生じる可能性があります。
アプリケーション ライフサイクルの状態
Microsoft 365 Backup アプリケーションのオンボードとオフボードには、アプリケーションがさまざまな状態を通過する必要があります。 状態の変更は、次の方法で開始されます。
- 特定の API を呼び出すアプリケーション。
- 特定の API を呼び出す別のアプリケーションの結果。や
- 一定期間経過するまで待機しているシステム。
上の図は、状態とその間の遷移を引き起こす可能性があるジェスチャの概要を示しています。
- アプリケーションを Microsoft 365 Backup Storage Controller として登録する
- 既存の Microsoft 365 バックアップ ストレージ コントローラーを使用しない Microsoft 365 バックアップ ストレージ コントローラーにアプリケーションをアクティブ化する
- 既存の Microsoft 365 バックアップ ストレージ コントローラーを使用してアプリケーションを Microsoft 365 バックアップ ストレージ コントローラーとしてアクティブ化し、アプリケーションがアクティブな Microsoft 365 バックアップ ストレージ コントローラーである場合は、別のアプリケーションが Microsoft 365 バックアップ ストレージ コントローラーとしてアクティブ化されます
- 既存の Microsoft 365 バックアップ ストレージ コントローラーの猶予期間が完了しました
- 現在の状態が pendingActive の Microsoft 365 バックアップ ストレージ コントローラーにアプリケーションを非アクティブ化する
- 現在の状態が非アクティブである Microsoft 365 Backup Storage Controller にアプリケーションの登録を解除する
- 現在の状態が pendingActive の Microsoft 365 バックアップ ストレージ コントローラーにアプリケーションの登録を解除する
- 現在の状態がアクティブな Microsoft 365 Backup Storage Controller にアプリケーションの登録を解除する