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

Перечисление датчиковУстройства

  • Статья

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

Важно!

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

Получите список всех устройств датчиков на рабочем месте, созданных для клиента.

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

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

Разрешения

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

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

HTTP-запрос

GET /workplace/sensorDevices

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

Этот метод поддерживает $filterпараметры запроса ,$top, $selectи $skipToken OData для настройки ответа. Вы можете использовать $filter свойства deviceId, displayName, description, macAddress, manufacturer, ipV4Address, ipV6Address и tags .

Поддерживаемые шаблоны запросов

Шаблон Синтаксис Примечания
Разбивка на страницы на стороне сервера @odata.nextLink Вы получаете маркер продолжения в ответе, когда результирующий набор охватывает несколько страниц.
Filter /workplace/sensorDevices?$filter=Tags/Any(x: cast(x, 'String') eq 'Building A') Фильтрация устройств по тегам.
Filter /workplace/sensorDevices?$filter=cast(manufacturer, 'String') eq 'Contoso' Фильтрация устройств по изготовителю устройства.
Filter /workplace/sensorDevices?$filter=cast(deviceId, 'String') eq 'contoso_9D6816' Фильтрация устройств на основе предоставленного пользователем идентификатора устройства.
Ограничение страницы /workplace/sensorDevices?$top=20 Получение устройств с размером страницы 20. Размер страницы по умолчанию — 10.

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

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

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

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

Отклик

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

Примеры

Запрос

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

GET https://graph.microsoft.com/beta/workplace/sensorDevices

Отклик

Ниже приводится пример отклика.

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

{
    "@odata.context": "https://graph.microsoft.com/beta/$metadata#workplace/sensorDevices",
    "@odata.nextLink": "https://graph.microsoft.com/beta/workplace/sensorDevices?$top=1&$skiptoken=aHR0cHM6Ly9vdXRsb29rLXNkZi5vZmZpY2UuY29tL2FwaS92Mi4wL09yZ1BhcnRpdGlvbnMoJ0FwcDpQbGFjZXNEZXZpY2VzXzIxNmFlZThkLTNjYzgtNDJhYi1hYmU4LTM0ZGRhZTE1MWI3M0BkNzQ4NTRiNy0zZjFjLTRlM2MtYjJlYy1kOTZlMDY3ZWEwYTYnKS9DdXJyZW50Q29sbGVjdGlvbnMoJ0RldmljZXNDb2xsZWN0aW9uJykvSXRlbXM%2fJTI0dG9wPTEmJTI0c2tpcHRva2VuPU15WlJWa1pDVVZWR1FsRlZSWFpNZVRoMlRIazRka3g1T0haUFJVcENVVlZHUWxOR1RYWldNVnB1WWpBNVFrMUZkRlZTYmxKU1pHcENXV0V6UlRCa2VqQTU%3d",
    "value": [
        {
            "id": "ade7078f-4bf5-4239-bfde-95a7c4225df7",
            "deviceId": "contoso_9D6816",
            "displayName": "Contoso 9D6816 Device",
            "description": "Contoso 9D6816 Device",
            "macAddress": "00:0A:95:9D:68:16",
            "manufacturer": "Contoso",
            "ipV4Address": "192.168.1.100",
            "ipV6Address": "2001:db8::ff00:42:8329",
            "placeId": "acfa3bc0-2b83-425b-8910-84a0250e9671",
            "tags": [
                "Building A",
                "Floor 3",
                "Room 301",
                "Conference Room"
            ],
            "sensors": [
                {
                    "sensorId": "Occupancy",
                    "displayName": null,
                    "sensorType": "occupancy",
                    "placeId": "acfa3bc0-2b83-425b-8910-84a0250e9671"
                },
                {
                    "sensorId": "PeopleCount",
                    "displayName": null,
                    "sensorType": "peopleCount",
                    "placeId": "acfa3bc0-2b83-425b-8910-84a0250e9671"
                }
            ]
        }
    ]
}