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 租户 ID。
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 的唯一 ID。在将设备分配给设备组之前，该值将为 null。
DeviceId	string	设备的唯一 ID。
LastAvailableOSVersion	string	请求更新时可在设备上安装的 OS 版本。
LastInstalledOSVersion	string	请求更新时在设备上运行的 OS 版本。
LastOSUpdateUTC	string	世界时协调 (UTC) 上次请求更新调用的时间，并且有新版本的 OS 可供安装的时间。
LastUpdateRequestUTC	string	世界时协调 (UTC) 设备上次请求更新调用的时间。
ProductId	string	此设备分配到的产品的唯一 ID。 在将设备分配给设备组之前，该值将为 null。
TenantId	string	拥有此设备的 as3 租户的唯一 ID。 在声明 device 之前，该值为空。

DeviceV2ItemCollectionResponse

名称	类型	说明
ContinuationToken	string	可用于获取下一组项的继续标记。
Items	DeviceV2[]	项列表。