Жизненный цикл приложения для хранилища резервных копий Microsoft 365

Подключение стороннего приложения хранилища резервных копий Microsoft 365

После того как приложению хранилища резервных копий Microsoft 365 будет предоставлено согласие на выполнение в потребляемом клиенте, чтобы оно стало контроллером хранилища резервных копий Microsoft 365 в потребляющих клиентах, необходимо выполнить следующие программные задачи (через приложение):

1. Зарегистрируйте приложение в качестве контроллера хранилища резервных копий Microsoft 365.

2. Проверьте, включена ли служба резервного копирования Microsoft 365 в потребляемом клиенте.

3. Активируйте приложение, чтобы стать контроллером хранилища резервных копий Microsoft 365.

   • Если контроллер уже существует, дождитесь завершения льготного периода .

4. Включите политику выставления счетов в потребляемом клиенте.

После регистрации приложения вы всегда можете проверить состояние приложения как контроллера хранилища резервных копий Microsoft 365, выполнив API get serviceApp :

GET /solutions/backupRestore/serviceApps/{serviceAppId}

Шаг 1. Регистрация приложения в качестве контроллера хранилища резервных копий Microsoft 365

Чтобы зарегистрировать приложение в качестве контроллера хранилища резервных копий Microsoft 365, сначала необходимо зарегистрировать приложение, выполнив API создания приложения службы :

POST /solutions/backupRestore/serviceApps/

Если приложение успешно зарегистрировано, оно будет неактивным. Возвращенный идентификатор — это идентификатор приложения службы (который является идентификатором приложения).

Шаг 2. Проверьте, включена ли служба резервного копирования Microsoft 365 в потребляемом клиенте

Чтобы проверить, включена ли служба резервного копирования Microsoft 365 в потребляемом клиенте, приложению необходимо выполнить API get backupRestoreRoot :

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 дней.

Чтобы активировать приложение, необходимо выполнить API serviceApp: activate , указав действующую дату и время в тексте запроса JSON:

POST /solutions/backupRestore/serviceApps/{serviceAppId}/activate

Примечание.

Если уже выполняется ожидающее изменение контроллера хранилища резервных копий Microsoft 365, запрос завершится ошибкой с кодом ошибки HTTP 403. Вы не сможете активировать приложение до тех пор, пока ожидающие изменения не будут завершены.

Если приложение было успешно активировано в течение даты и времени в будущем, оно имеет состояние pendingActive.

Существующий льготный период контроллера хранилища резервных копий Microsoft 365

Если при активации приложения существовал контроллер хранилища резервных копий Microsoft 365, этот шаг применяет льготный период от 7 до 30 дней (как указано при активации приложения).

В течение льготного периода:

• Приложение находится в состоянии pendingActive.
• Приложение имеет доступ только для чтения ко всем существующим политикам защиты. Ваше приложение не сможет изменять или создавать политики защиты или выполнять восстановление.
• Администратор резервного копирования клиента может отменить ожидающее изменение контроллера хранилища резервных копий Microsoft 365 и вернуться в исходное состояние.
• Приложение может отменить ожидающее изменение контроллера хранилища резервных копий Microsoft 365 и вернуться в исходное состояние, выполнив API serviceApp: деактивировать :

POST /solutions/backupRestore/serviceApps/{serviceAppId}/deactivate

• Приложение может проверить состояние приложения в качестве контроллера хранилища резервных копий Microsoft 365, выполнив API Get serviceApp :

GET /solutions/backupRestore/serviceApps/{serviceAppId}

По завершении льготного периода:

• Приложение имеет состояние "Активный".

Шаг 4. Включение политики выставления счетов в потребляемом клиенте

После того как приложение будет активно, необходимо включить политику выставления счетов в потребляемом клиенте. Этот шаг выполняется путем выполнения API backupRestoreRoot: enable :

POST /solutions/backupRestore/enable

После включения политики выставления счетов ваше приложение будет контроллером хранилища резервных копий Microsoft 365 в потребляемом клиенте и теперь сможет поддерживать службу резервного копирования Microsoft 365 (в рамках областей разрешений oAuth вашего приложения).

Примечание.

Этот API можно выполнить несколько раз, если он является идемпотентным. Если по какой-либо причине политика выставления счетов изменится, рекомендуется включить политику выставления счетов в потребляющих клиентах. Например, если вы хотите изменить идентификатор подписки Azure или группу ресурсов.

Отключение приложения Microsoft 365 Backup

Другое приложение активировано в качестве контроллера хранилища резервных копий Microsoft 365

Если приложение является активным контроллером хранилища резервных копий Microsoft 365, возможно, что другое приложение (стороннее или стороннее) также может быть активировано в соответствии с процессом подключения, определенным в разделе Существующий контроллер хранилища резервных копий Microsoft 365 и Существующий резервный контроллер хранилища Microsoft 365 Льготный период. В случае возникновения этого события приложение не будет уведомлено явным образом. Однако состояние приложения становится pendingInactive. Вы получите состояние приложения, являющегося контроллером хранилища резервных копий Microsoft 365, которое приложение может выполнить API get serviceApp :

GET /solutions/backupRestore/serviceApps/{serviceAppId}

В течение льготного периода:

• Приложение находится в состоянии pendingInactive.
• Ваше приложение по-прежнему имеет доступ к существующим политикам защиты и может изменять или создавать политики защиты или выполнять восстановление (в рамках областей разрешений oAuth).
• Ваше приложение по-прежнему отвечает за выставление счетов за Microsoft 365 Backup и, следовательно, за потребление в потребляемом клиенте.
• Администратор резервного копирования клиента может отменить ожидающее изменение контроллера хранилища резервных копий Microsoft 365 и вернуться в исходное состояние таким образом, чтобы приложение было восстановлено в качестве активного контроллера хранилища резервных копий Microsoft 365.

По завершении льготного периода:

• Приложение неактивно.
• Ваше приложение больше не отвечает за выставление счетов за microsoft 365 Backup и, следовательно, выставление счетов с оплатой по мере использования в потребляющем клиенте.

Отключение приложения в качестве контроллера хранилища резервных копий Microsoft 365

Чтобы отключить приложение от службы резервного копирования Microsoft 365 в потребляющем клиенте, приложению необходимо выполнить API serviceApp: деактивировать :

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 в потребляющем клиенте, приложению необходимо выполнить 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 Backup и, следовательно, потребление в потребляемом клиенте до тех пор, пока другое приложение не будет активировано, чтобы стать контроллером хранилища резервных копий Microsoft 365.

По завершении льготного периода:

• Ваше приложение по-прежнему недоступно, чтобы стать контроллером хранилища резервных копий Microsoft 365 (если оно не зарегистрировано повторно).
• Если другое приложение не активировано, чтобы быть контроллером хранилища резервных копий Microsoft 365, инициируется отключение службы резервного копирования Microsoft 365 в потребляющий клиент.
• Ваше приложение по-прежнему отвечает за выставление счетов за резервное копирование Microsoft 365 и, следовательно, потребление в потребляющем клиенте до тех пор, пока другое приложение не будет активировано в качестве контроллера хранилища резервных копий Microsoft 365 или до истечения периода выставления счетов (30 дней) в связи с отключением службы резервного копирования Microsoft 365 в потребляющем клиенте.

Предупреждение

Если ваше приложение является активным контроллером хранилища резервных копий Microsoft 365 при его отмене, вы потенциально несете ответственность за дополнительные 37 дней (7 дней плюс 30 дней) для выставления счетов с оплатой по мере использования Резервной копии Microsoft 365 в потребляющем клиенте.

Состояния жизненного цикла приложения

Для подключения и отключения приложения Microsoft 365 Backup требуется, чтобы приложение проходило через несколько различных состояний. Изменения состояния инициируются:

• Приложение, вызывающее определенные API;
• Следствие того, что другое приложение вызывает определенные API; и/или
• Система ожидает прохождения определенного периода времени.

На приведенной выше схеме показаны состояния и жесты, которые могут привести к переходу между ними:

1. Регистрация приложения в качестве контроллера хранилища резервных копий Microsoft 365
2. Активируйте приложение, чтобы стать контроллером хранилища резервных копий Microsoft 365 без существующего контроллера хранилища резервных копий Microsoft 365
3. Активация приложения в качестве контроллера хранилища резервных копий Microsoft 365 с существующим контроллером хранилища резервных копий Microsoft 365 , а другое приложение активируется как контроллер хранилища резервных копий Microsoft 365, если ваше приложение является активным контроллером хранилища резервных копий Microsoft 365
4. Завершается льготный период существующего контроллера хранилища резервных копий Microsoft 365
5. Деактивация приложения до контроллера хранилища резервных копий Microsoft 365 с текущим состоянием pendingActive
6. Отмена регистрации приложения как контроллера хранилища резервных копий Microsoft 365 с текущим состоянием неактивности
7. Отмените регистрацию приложения как контроллера хранилища резервных копий Microsoft 365 с текущим состоянием pendingActive
8. Отмена регистрации приложения как контроллера хранилища резервных копий Microsoft 365 с текущим состоянием активности