Восстановление удаленного элемента

Пространство имен: microsoft.graph

Восстановление недавно удаленного элемента из контейнера для удаленных элементов.

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

Удаленный элемент можно восстановить в течение 30 дней. Через 30 дней элемент удаляется без возможности восстановления.

Разрешения

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

Для приложений и субъектов-служб:

Тип разрешения Разрешения (в порядке повышения привилегий)
Делегированные (рабочая или учебная учетная запись) Application.ReadWrite.All
Делегированные (личная учетная запись Майкрософт) Не поддерживается.
Для приложений Application.ReadWrite.OwnedBy, Application.ReadWrite.All

Для пользователей:

Тип разрешения Разрешения (в порядке повышения привилегий)
Делегированные (рабочая или учебная учетная запись) User.ReadWrite.All
Делегированные (личная учетная запись Майкрософт) Не поддерживается.
Для приложений User.ReadWrite.All

Для групп:

Тип разрешения Разрешения (в порядке повышения привилегий)
Делегированные (рабочая или учебная учетная запись) Group.ReadWrite.All
Делегированные (личная учетная запись Майкрософт) Не поддерживается.
Для приложений Group.ReadWrite.All

HTTP-запрос

POST /directory/deletedItems/{id}/restore

Заголовки запросов

Имя Описание
Authorization Требуется токен носителя <>
Content-Type application/json

Текст запроса

Не указывайте текст запроса для этого метода.

Отклик

В случае успеха этот метод возвращает код отклика 200 OK и объект directoryObject в тексте отклика.

Пример

Запрос

POST https://graph.microsoft.com/v1.0/directory/deletedItems/{object-id}/restore

Отклик

Примечание. Объект отклика, показанный здесь, может быть сокращен для удобочитаемости.

HTTP/1.1 200 OK
Content-type: application/json

{
  "@odata.context":"https://graph.microsoft.com/v1.0/$metadata#directoryObjects/$entity",
  "@odata.type":"#microsoft.graph.group",
  "id":"46cc6179-19d0-473e-97ad-6ff84347bbbb",
  "displayName":"SampleGroup",
  "groupTypes":["Unified"],
  "mail":"example@contoso.com",
  "mailEnabled":true,
  "mailNickname":"Example",
  "securityEnabled":false,
  "visibility":"Public"
}