Device Group - Get

Service:

Azure Sphere Public API

API Version:

v2

Gets a DeviceGroup by ID.

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

URI Parameters

Name	In	Required	Type	Description
deviceGroupId	path	True	string uuid	The ID of the DeviceGroup.
tenantId	path	True	string uuid	The Azure Sphere tenant ID.

Responses

Name	Type	Description
200 OK	DeviceGroupV2	Success.

Examples

Get device group details

Sample request

GET https://prod.core.sphere.azure.net/v2/tenants/768c2cd6-1bf0-4521-9f53-084a331d81cb/devicegroups/8aa687eb-28bb-405d-8a85-b83cd17d1e2b

Sample response

Status code:

200

{
  "Id": "8aa687eb-28bb-405d-8a85-b83cd17d1e2b",
  "TenantId": "768c2cd6-1bf0-4521-9f53-084a331d81cb",
  "OsFeedType": 0,
  "ProductId": "258e9e1d-a16d-4459-be5d-38420a8c43ad",
  "Name": "Field Test",
  "Description": "Default test device group",
  "CurrentDeployment": null,
  "UpdatePolicy": 0,
  "AllowCrashDumpsCollection": false
}

Definitions

Name	Description
Deployment
DeviceGroupV2

Deployment

Name	Type	Description
DeployedImages	string[]	The IDs of images that are currently in this deployment.
DeploymentDateUtc	string	The DateTime that the deployment was created.
Id	string	The unique ID of the deployment.
TenantId	string	The unique ID of the tenant that owns the deployment.

DeviceGroupV2

Name	Type	Description
AllowCrashDumpsCollection	boolean	Enables crash dumps collection for a given device group
CurrentDeployment	Deployment
Description	string	The description of the device group.
Id	string	The unique ID of the device group.
Name	string	The name of the device group.
OsFeedType	enum: 0 - Retail 1 - RetailEval	The osfeed type that this device group uses for OS updates.
ProductId	string	The unique ID of the product that this device group belongs to.
TenantId	string	The unique ID of the tenant that owns the device group.
UpdatePolicy	enum: 0 - UpdateAll 1 - No3rdPartyAppUpdates	The update policy that determines which software is updated.