Использование API управления записями Microsoft Graph

API управления записями Microsoft Purview помогают организациям управлять хранением и удалением данных в соответствии с их юридическими обязательствами и нормативными требованиями, а также повышают эффективность, позволяя регулярно удалять элементы, которые больше не должны храниться.

Управление метками хранения

Многим организациям необходимо управлять своими данными в соответствии с отраслевыми правилами и внутренними политиками, снизить риски судебного разбирательства или нарушения безопасности, а также позволить своим сотрудникам эффективно и гибко обмениваться знаниями, актуальными и актуальными для них. Управление данными обычно включает в себя надлежащее хранение или удаление содержимого разных типов.

Метки хранения можно использовать для настройки параметров хранения и удаления для содержимого Microsoft 365. Например, можно задать сроки хранения с момента присвоения содержимого метки, а проверку ликвидации можно задать в качестве действия в конце периода хранения.

Кроме того, можно использовать дескрипторы плана файлов , чтобы дополнить метку хранения и улучшить управляемость и организацию содержимого Microsoft 365. Примеры дескрипторов плана файлов включают центр,ссылку и отдел.

События триггера для существующей метки

В некоторых сценариях требуется начать период хранения для определенных документов, таких как увольнение сотрудника из организации, истечение срока действия контракта или окончание финансового года.

Ресурс retentionLabel можно использовать для поддержки хранения на основе событий, задав свойство retentionTrigger как dateOfEvent и связав метку с ресурсом retentionEventType . RetentionEvent также связан с retentionEventType. При возникновении события активации в течение указанного периода хранения сохраняется только содержимое с примененной меткой хранения.

Например, в организации, когда сотрудник уходит, записи о занятости должны храниться в течение 5 лет. Используйте API retentionLabel и retentionEvent , чтобы выполнить следующие действия для каждой записи сотрудника при его запуске:

1. Примените метку retentionLabel , настроенную следующим образом:
   • Отображаемое имя "Информация о персонале"
   • Срок хранения 1827 дней (5 лет)
   • Прослушивание параметра retentionEventType с именем "Отъезд сотрудника"
2. Определите событие retentionEvent с тем же параметром retentionEventType с именем "Уход сотрудника", а в рамках коллекции eventQuery — Asset ID значением идентификатора сотрудника в качестве сведений об идентификаторе, связанных с событием.

Когда сотрудник с идентификатором 1234 покидает Contoso, информация обновляется в системе управления персоналом. Увольнение сотрудника может активировать новый экземпляр retentionEvent с типом события "Увольнение сотрудника", а в рамках свойства eventQueries — eventQuery со строкой запроса "AssetID:1234". Таким образом, сотрудник записывает элементы, используя метку хранения "Информация о персонале" и связанный с идентификатором сотрудника 1234, получает 5-летний период хранения, начиная с даты увольнения сотрудника.

Entities

API управления записями включает следующие ключевые сущности.

Имя	Тип	Вариант использования
Label	microsoft.graph.security.retentionLabel	Содержит параметры хранения и действия, которые могут применяться к элементу в конце периода.
Дескрипторы планов хранения	microsoft.graph.securty.fileplandescriptor	Представляет набор необязательных дескрипторов, которые дополняют метку хранения и повышают управляемость для организации.
Событие хранения	microsoft.graph.security.retentionEvent	Представляет триггер для хранения на основе событий, где срок хранения начинается после возникновения события.
Тип события хранения	microsoft.graph.security.retentionEventType	Представляет одну группу для событий хранения одного типа.