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

Перечисление владельцев deviceTemplate

  • Статья

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

Важно!

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

Получение списка владельцев объекта deviceTemplate . Владельцы могут быть представлены как субъекты-службы, пользователи или приложения.

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

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

Разрешения

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

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

Важно!

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

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

Заметка: Пользователи должны быть владельцами объекта .

HTTP-запрос

GET /directory/templates/deviceTemplates/{id}/owners

Заметка: В {id} URL-адресе запроса используется значение свойства idобъекта deviceTemplate.

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

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

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

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

Запрос

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

Отклик

В случае успешного 200 OK выполнения этот метод возвращает код отклика и коллекцию объектов directoryObject в тексте отклика со свойством @odata.type каждого объекта в коллекции, указывающим тип объекта каталога. Владельцами шаблонов устройств могут быть только субъекты-службы, пользователи или приложения .

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

Примеры

Запрос

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

GET https://graph.microsoft.com/beta/directory/templates/deviceTemplates/00f1e7a4-de6d-4070-84df-8aab629c4d1e/owners

Отклик

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

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

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

{
  "@odata.context": "https://graph.microsoft.com/beta/$metadata#directoryObjects",
  "value": [
    {
      "@odata.type": "#microsoft.graph.servicePrincipal",
      "id": "4vfaf3ac-5122-4a25-98d8-b32c091f441f",
      "accountEnabled": true,
      "alternativeNames": [],
      "createdDateTime": "2024-09-11T21:21:25Z",
      "appDisplayName": "test",
      "appId": "00001111-aaaa-2222-bbbb-3333cccc4444",
      "appOwnerOrganizationId": "0a0a0a0a-1111-bbbb-2222-3c3c3c3c3c3c",
      "appRoleAssignmentRequired": false,
      "displayName": "test",
      "isAuthorizationServiceEnabled": false,
      "notificationEmailAddresses": [],
      "publisherName": "Workplace Join Android",
      "samlSLOBindingType": "httpRedirect",
      "servicePrincipalNames": [
        "00001111-aaaa-2222-bbbb-3333cccc4444"
      ],
      "servicePrincipalType": "Application",
      "signInAudience": "AzureADMyOrg",
      "tags": [
        "HideApp",
        "WindowsAzureActiveDirectoryIntegratedApp"
      ]
    }
  ]
}