Devices - List

Service:

Azure Sphere Public API

API Version:

v2

Возвращает все устройства, которые были запрошены для указанного клиента.

GET https://prod.core.sphere.azure.net/v2/tenants/{tenantId}/devices

With optional parameters:

GET https://prod.core.sphere.azure.net/v2/tenants/{tenantId}/devices?maxPageSize={maxPageSize}

Параметры URI

Имя	В	Обязательно	Тип	Описание
tenantId	path	True	string uuid	Идентификатор клиента Azure Sphere.
maxPageSize	query		integer int32	Максимальное число результатов, которое должно быть включено в ответ.

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

Имя	Обязательно	Тип	Описание
Sphere-Continuation		string	Маркер продолжения, используемый для продолжения предыдущей страницы результатов.

Ответы

Имя	Тип	Описание
200 OK	DeviceV2ItemCollectionResponse	Microsoft.Azure.Sphere.PublicApi.Contracts.ItemCollectionResponse'1, где TItem — Microsoft.Azure.Sphere.PublicApi.Contracts.DeviceV2 Success.

Определения

Имя	Описание
DeviceV2
DeviceV2ItemCollectionResponse

DeviceV2

Имя	Тип	Описание
ChipSku	enum: 0 - MT3620AN	ChipSku, поддерживаемый этим устройством
DeviceGroupId	string	Уникальный идентификатор DeviceGroup, которому назначено это устройство. Значение будет иметь значение NULL, пока устройство не будет назначено группе устройств.
DeviceId	string	Уникальный идентификатор устройства.
LastAvailableOSVersion	string	Версия ОС, которая была доступна для установки на устройстве при запросе обновления.
LastInstalledOSVersion	string	Версия ОС, которая выполнялась на устройстве при запросе обновления.
LastOSUpdateUTC	string	Время в формате UTC, когда последний раз запрашивался вызов обновления и новая версия ОС была доступна для установки.
LastUpdateRequestUTC	string	Время в формате UTC, когда устройство запрашивало последнее обновление.
ProductId	string	Уникальный идентификатор продукта, которому назначено это устройство. Значение будет иметь значение NULL, пока устройство не будет назначено группе устройств.
TenantId	string	Уникальный идентификатор клиента as3, которому принадлежит это устройство. Значение будет пустым до утверждения устройства.

DeviceV2ItemCollectionResponse

Имя	Тип	Описание
ContinuationToken	string	Маркер продолжения, который можно использовать для получения следующего набора элементов.
Items	DeviceV2[]	Список элементов.