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

Перечисление deviceTemplates

  • Статья

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

Важно!

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

Получение списка объектов deviceTemplate, зарегистрированных в каталоге.

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

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

Разрешения

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

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

Важно!

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

  • Администратор облачных устройств
  • Администратор устройств Интернета вещей
  • Пользователи — владельцы объекта шаблона устройства

HTTP-запрос

GET /directory/templates/deviceTemplates

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

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

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

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

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

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

Отклик

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

Дополнительные сведения см. в статье Ответы на ошибки Microsoft Graph и типы ресурсов.

Примеры

Запрос

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

GET https://graph.microsoft.com/beta/directory/templates/deviceTemplates

Отклик

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

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

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

{
  "@odata.context": "https://graph.microsoft.com/beta/$metadata#directory/templates/deviceTemplates",
  "value": [
    {
      "id": "16f1d02a-af59-4ca7-b2ea-494a262353b9",
      "mutualTlsOauthConfigurationId": "00001111-aaaa-2222-bbbb-3333cccc4444",
      "mutualTlsOauthConfigurationTenantId": "00001111-aaaa-2222-bbbb-3333cccc4445",
      "deviceAuthority": "Lakeshore Retail",
      "manufacturer": "Tailwind Traders",
      "model": "IoT Device K1",
      "operatingSystem": "WindowsIoT"
    },
    {
      "id": "3a0698d9-fd85-4b9e-9655-e26d19013459",
      "mutualTlsOauthConfigurationId": "00001111-aaaa-2222-bbbb-3333cccc4433",
      "mutualTlsOauthConfigurationTenantId": "00001111-aaaa-2222-bbbb-3333cccc4435",
      "deviceAuthority": "Lakeshore Retail",
      "manufacturer": "Tailwind Traders",
      "model": "IoT Devices",
      "operatingSystem": null
    }
  ]
}