Вывод списка удаленных элементов (объектов каталога), принадлежащих пользователю

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

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

Этот API возвращает до 1000 удаленных объектов, принадлежащих пользователю, отсортированных по идентификатору и не поддерживает разбиение на страницы.

Этот API доступен в следующих национальных облачных развертываниях.

Глобальная служба	Правительство США L4	Правительство США L5 (DOD)	Китай управляется 21Vianet
✅	✅	✅	✅

Разрешения

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

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

HTTP-запрос

POST /directory/deletedItems/getUserOwnedObjects

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

Имя	Описание
Авторизация	Bearer {token}. Обязательно. Дополнительные сведения о проверке подлинности и авторизации.

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

Текст запроса требует следующих параметров:

Параметр	Тип	Описание
userId	String	Идентификатор владельца.
type	String	Тип возвращаемых принадлежащих объектов; Group и Application в настоящее время являются единственными поддерживаемыми значениями.

Отклик

Успешные запросы возвращают 200 OK коды ответа; объект ответа содержит свойства каталога (удаленных элементов).

Пример

Запрос

Ниже показан пример запроса.

HTTP

POST https://graph.microsoft.com/beta/directory/deletedItems/getUserOwnedObjects
Content-type: application/json

{
  "userId":"55ac777c-109e-4022-b58c-470c8fcb6892",
  "type":"Group"
}

JavaScript

const options = {
	authProvider,
};

const client = Client.init(options);

const directoryObject = {
  userId: '55ac777c-109e-4022-b58c-470c8fcb6892',
  type: 'Group'
};

await client.api('/directory/deletedItems/getUserOwnedObjects')
	.version('beta')
	.post(directoryObject);

Важно!

Пакеты SDK для Microsoft Graph по умолчанию используют версию API версии 1.0 и поддерживают не все типы, свойства и API, доступные в бета-версии. Дополнительные сведения о доступе к бета-API с помощью SDK см. в статье Использование пакетов Microsoft Graph SDK с бета-API.

Подробнее о том, как добавить SDK в свой проект и создать экземпляр authProvider, см. в документации по SDK.

Отклик

Ниже показан пример отклика.

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

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

{
  "value": [
    {
      "@odata.type": "#microsoft.graph.group",
      "id": "bfa7033a-7367-4644-85f5-95aaf385cbd7",
      "deletedDateTime": "2018-04-01T12:39:16Z",
      "classification": null,
      "createdDateTime": "2017-03-22T12:39:16Z",
      "description": null,
      "displayName": "Test",
      "groupTypes": [
        "Unified"
      ],
      "mail": "Test@contoso.com",
      "mailEnabled": true,
      "mailNickname": "Test",
      "membershipRule": null,
      "membershipRuleProcessingState": null,
      "preferredDataLocation": null,
      "preferredLanguage": null,
      "proxyAddresses": [
        "SMTP:Test@contoso.com"
      ],
      "renewedDateTime": "2017-09-22T22:30:39Z",
      "securityEnabled": false,
      "theme": null,
      "visibility": "Public"
    }
  ]
}