windows-itpro-docs/windows/security/threat-protection/microsoft-defender-atp/get-machinegroups-collection.md

title, description, keywords, search.product, search.appverid, ms.prod, ms.mktglfcycl, ms.sitesec, ms.pagetype, ms.author, author, ms.localizationpriority, manager, audience, ms.collection, ms.topic, ms.date

title	description	keywords	search.product	search.appverid	ms.prod	ms.mktglfcycl	ms.sitesec	ms.pagetype	ms.author	author	ms.localizationpriority	manager	audience	ms.collection	ms.topic	ms.date
Get RBAC machine groups collection API	Retrieves a collection of RBAC machine groups.	apis, graph api, supported apis, get, RBAC, group	eADQiWindows 10XVcnh	met150	w10	deploy	library	security	leonidzh	mjcaparas	medium	dansimp	ITPro	M365-security-compliance	article	10/07/2018

Get KB collection API

Applies to:

• Microsoft Defender Advanced Threat Protection (Microsoft Defender ATP)

Retrieves a collection of RBAC machine groups.

Permissions

User needs read permissions.

HTTP request

GET /testwdatppreview/machinegroups

Request headers

Header	Value
Authorization	Bearer {token}. Required.
Content type	application/json

Request body

Empty

Response

If successful - 200 OK.

Example

Request

Here is an example of the request.

GET https://graph.microsoft.com/testwdatppreview/machinegroups
Content-type: application/json

Response

Here is an example of the response. Field id contains machine group id and equal to field rbacGroupId in machines info. Field ungrouped is true only for one group for all machines that have not been assigned to any group. This group as usual has name "UnassignedGroup".

HTTP/1.1 200 OK
Content-type: application/json
{
    "@odata.context":"https://graph.microsoft.com/testwdatppreview/$metadata#MachineGroups",
    "@odata.count":7,
    "value":[
        {
            "id":86,
            "name":"UnassignedGroup",
            "description":"",
            "ungrouped":true},
        …
}