Поделиться через

Вывод списка ключей восстановления

  • Статья

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

Важно!

API версии /beta в Microsoft Graph могут быть изменены. Использование этих API в производственных приложениях не поддерживается. Чтобы определить, доступен ли API в версии 1.0, используйте селектор версий.

Получите список объектов bitlockerRecoveryKey и их свойств.

Эта операция не возвращает свойство ключа . Сведения о том, как считывать свойство ключа , см. в разделе Get bitlockerRecoveryKey.

Этот API можно использовать для программной итерации по списку ключей восстановления в клиенте и идентификации устройств с включенным BitLocker. Дополнительные сведения см. в примере кода PowerShell в процессе восстановления BitLocker.

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

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

Разрешения

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

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

Важно!

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

  • Администратор облачных устройств
  • Администратор службы поддержки
  • администратор службы Intune;
  • Администратор безопасности
  • Читатель безопасности
  • Глобальный читатель

HTTP-запрос

Чтобы получить список ключей BitLocker в клиенте, выполните следующие действия:

GET /informationProtection/bitlocker/recoveryKeys

Чтобы получить список ключей BitLocker в клиенте, отфильтрованном по идентификатору устройства, выполните следующие действия:

GET /informationProtection/bitlocker/recoveryKeys?$filter=deviceId eq '{deviceId}'

Необязательные параметры запросов

Этот метод поддерживает $filter параметр запроса OData для фильтрации результатов по идентификатору устройства , на который недавно был создан ключ. Этот метод не поддерживает $top фильтр. Дополнительные сведения см . в разделе Пример 2. Общие сведения см. в статье Параметры запроса OData.

Ответ также может содержать odata.nextLink, который можно использовать для страницы в результирующем наборе. Дополнительные сведения см. в разделе Разбиение данных Microsoft Graph на разбиение по страницам.

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

Имя Описание
Авторизация Bearer {token}. Обязательно. Дополнительные сведения о проверке подлинности и авторизации.
User-Agent Идентификатор вызывающего приложения. Это значение содержит сведения об используемой операционной системе и браузере. Обязательно.
ocp-client-name Имя клиентского приложения, выполняющего вызов API. Этот заголовок используется для отладки. Необязательный параметр.
ocp-client-version Версия клиентского приложения, выполняющего вызов API. Этот заголовок используется для отладки. Необязательный параметр.

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

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

Отклик

В случае успешного 200 OK выполнения этот метод возвращает код отклика и коллекцию объектов bitlockerRecoveryKey в теле отклика.

Примеры

Пример 1. Получение списка ключей BitLocker в клиенте

Запрос

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

GET https://graph.microsoft.com/beta/informationProtection/bitlocker/recoveryKeys
User-Agent: Dsreg/10.0 (Windows 10.0.19043.1466)
ocp-client-name: My Friendly Client
ocp-client-version: 1.2

Отклик

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

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

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

{
  "value": [
    {
      "@odata.type": "#microsoft.graph.bitlockerRecoveryKey",
      "id": "b465e4e8-e4e8-b465-e8e4-65b4e8e465b4",
      "createdDateTime": "2020-06-15T13:45:30.0000000Z",
      "volumeType": 1,
      "deviceId": "2ef04ef1-23b0-2e00-a3a5-ab345e567ab6"
    },
    {
      "@odata.type": "#microsoft.graph.bitlockerRecoveryKey",
      "id": "6a30ed7b-247b-4d26-86b5-2f405e55ea42",
      "createdDateTime": "2020-06-15T13:45:30.0000000Z",
      "volumeType": 1,
      "deviceId": "1ab40ab2-32a8-4b00-b6b5-ba724e407de9"
    }
  ]
}

Пример 2. Получение списка ключей BitLocker, отфильтрованных по deviceId

Запрос

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

GET https://graph.microsoft.com/beta/informationProtection/bitlocker/recoveryKeys?$filter=deviceId eq '1ab40ab2-32a8-4b00-b6b5-ba724e407de9'
User-Agent: Dsreg/10.0 (Windows 10.0.19043.1466)
ocp-client-name: My Friendly Client
ocp-client-version: 1.2

Отклик

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

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

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

{
  "value": [
    {
      "@odata.type": "#microsoft.graph.bitlockerRecoveryKey",
      "id": "b465e4e8-e4e8-b465-e8e4-65b4e8e465b4",
      "createdDateTime": "2020-06-15T13:45:30.0000000Z",
      "volumeType": 1,
      "deviceId": "1ab40ab2-32a8-4b00-b6b5-ba724e407de9"
    }
  ]
}