Microsoft 365 Backup Storage のアプリケーション ライフサイクル (プレビュー)

注:

この機能は現在プレビュー段階であり、変更される可能性があります。

サード パーティの Microsoft 365 Backup Storage アプリケーションをオンボードする

Microsoft 365 Backup Storage アプリケーションが従量課金テナントで実行することに同意したら、それを従量課金テナントの Microsoft 365 Backup Storage Controller に設定するには、次のプログラム タスクを (アプリケーション経由で) 実行する必要があります。

  1. アプリケーションを Microsoft 365 Backup Storage Controller として登録します

  2. 使用しているテナントで Microsoft 365 Backup Service が有効になっているかどうかを確認します

  3. アプリケーションを Microsoft 365 Backup Storage Controller としてアクティブ化します

    • 既存のコントローラーがある場合は、 猶予期間 が完了するまで待ちます。
  4. 使用しているテナントで課金ポリシーを有効にします

アプリケーションが登録されたら、 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 Backup Storage Controller としてアプリケーションをアクティブ化すると、すべてのテナント バックアップ管理者に電子メールで通知されます。

既存の 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}

猶予期間の完了時:

  • アプリケーションの状態が アクティブです

注:

Microsoft 365 Backup Storage Controller に対して行われた状態の変更は、すべてのテナント バックアップ管理者に電子メールで通知されます。 これには、次のイベントが含まれます。

  • Microsoft 365 バックアップ ストレージ コントローラーとしてのサービス アプリのアクティブ化
  • Microsoft 365 Backup Storage Controller への保留中の変更を取り消す
  • Microsoft 365 バックアップ ストレージ コントローラーとしてのサービス アプリの非アクティブ化
  • 猶予期間の完了

手順 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 であるアプリケーションの状態は アクティブです

注:

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 としてアプリケーションの登録を解除すると、すべてのテナント バックアップ管理者に電子メールで通知されます。

非アクティブの現在の状態での登録解除

非アクティブ状態のアプリケーションの登録を解除すると、アプリケーションは 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 日) の責任が生じる可能性があります。