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

Получение qrCodePinAuthenticationMethod

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

Чтение свойств объекта qrCodePinAuthenticationMethod пользователя. При этом возвращается метод проверки подлинности с ПОМОЩЬЮ ПИН-кода QR-кода, зарегистрированный для пользователя.

Примечание.

ПИН-код возвращается только во время создания или сброса. Для операций GET свойство code в объекте pin возвращает null.

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

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

Разрешения

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

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

Важно!

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

  • Глобальный читатель
  • Администратор проверки подлинности
  • Привилегированный администратор проверки подлинности

HTTP-запрос

GET /users/{id | userPrincipalName}/authentication/qrCodePinMethod

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

Этот метод не поддерживает необязательные параметры запроса для настройки ответа.

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

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

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

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

Отклик

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

Примеры

Запрос

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

GET https://graph.microsoft.com/v1.0/users/7c4999ca-a540-47ab-9ab9-8c362f5bf0fe/authentication/qrCodePinMethod

Отклик

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

Примечание: Свойство image в объектах QR-кода возвращается null для операций GET, так как закрытый ключ QR-кода не хранится на сервере.

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

{
  "@odata.type": "#microsoft.graph.qrCodePinAuthenticationMethod",
  "id": "6C2F8B36-B6F0-46FA-9548-1EBA48BEBBDE",
  "createdDateTime": "2026-01-27T12:00:00Z",
  "standardQRCode": {
    "id": "6C2F8B36-B6F0-46FA-9548-1EBA48BEBBDE",
    "image": null,
    "startDateTime": "2026-01-27T12:00:00Z",
    "expireDateTime": "2027-01-27T12:00:00Z",
    "createdDateTime": "2026-01-27T12:00:00Z",
    "lastUsedDateTime": "2026-01-30T08:15:00Z"
  },
  "temporaryQRCode": {
    "id": "8DF9D1B6-B4BD-4EF8-8E90-2CC63C549C80",
    "image": null,
    "startDateTime": "2026-01-30T08:00:00Z",
    "expireDateTime": "2026-01-30T18:00:00Z",
    "createdDateTime": "2026-01-30T08:00:00Z",
    "lastUsedDateTime": "2026-01-30T08:15:00Z"
  },
  "pin": {
    "code": null,
    "forceChangePinNextSignIn": false,
    "createdDateTime": "2026-01-27T12:00:00Z",
    "updatedDateTime": "2026-01-28T09:30:00Z"
  }
}
  • Last updated on