Namespace: microsoft.graph
Note: The Microsoft Graph API for Intune requires an active Intune license for the tenant.
Update the properties of a deviceConfigurationDeviceStateSummary object.
This API is available in the following national cloud deployments.
Global service |
US Government L4 |
US Government L5 (DOD) |
China operated by 21Vianet |
✅ |
✅ |
✅ |
✅ |
Permissions
One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.
Permission type |
Permissions (from least to most privileged) |
Delegated (work or school account) |
DeviceManagementConfiguration.ReadWrite.All |
Delegated (personal Microsoft account) |
Not supported. |
Application |
DeviceManagementConfiguration.ReadWrite.All |
HTTP Request
PATCH /deviceManagement/deviceConfigurationDeviceStateSummaries
Request body
In the request body, supply a JSON representation for the deviceConfigurationDeviceStateSummary object.
The following table shows the properties that are required when you create the deviceConfigurationDeviceStateSummary.
Property |
Type |
Description |
id |
String |
Key of the entity. |
unknownDeviceCount |
Int32 |
Number of unknown devices |
notApplicableDeviceCount |
Int32 |
Number of not applicable devices |
compliantDeviceCount |
Int32 |
Number of compliant devices |
remediatedDeviceCount |
Int32 |
Number of remediated devices |
nonCompliantDeviceCount |
Int32 |
Number of NonCompliant devices |
errorDeviceCount |
Int32 |
Number of error devices |
conflictDeviceCount |
Int32 |
Number of conflict devices |
Response
If successful, this method returns a 200 OK
response code and an updated deviceConfigurationDeviceStateSummary object in the response body.
Example
Request
Here is an example of the request.
PATCH https://graph.microsoft.com/v1.0/deviceManagement/deviceConfigurationDeviceStateSummaries
Content-type: application/json
Content-length: 290
{
"@odata.type": "#microsoft.graph.deviceConfigurationDeviceStateSummary",
"unknownDeviceCount": 2,
"notApplicableDeviceCount": 8,
"compliantDeviceCount": 4,
"remediatedDeviceCount": 5,
"nonCompliantDeviceCount": 7,
"errorDeviceCount": 0,
"conflictDeviceCount": 3
}
// Code snippets are only available for the latest version. Current version is 5.x
// Dependencies
using Microsoft.Graph.Models;
var requestBody = new DeviceConfigurationDeviceStateSummary
{
OdataType = "#microsoft.graph.deviceConfigurationDeviceStateSummary",
UnknownDeviceCount = 2,
NotApplicableDeviceCount = 8,
CompliantDeviceCount = 4,
RemediatedDeviceCount = 5,
NonCompliantDeviceCount = 7,
ErrorDeviceCount = 0,
ConflictDeviceCount = 3,
};
// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.DeviceManagement.DeviceConfigurationDeviceStateSummaries.PatchAsync(requestBody);
For details about how to add the SDK to your project and create an authProvider instance, see the SDK documentation.
mgc device-management device-configuration-device-state-summaries patch --body '{\
"@odata.type": "#microsoft.graph.deviceConfigurationDeviceStateSummary",\
"unknownDeviceCount": 2,\
"notApplicableDeviceCount": 8,\
"compliantDeviceCount": 4,\
"remediatedDeviceCount": 5,\
"nonCompliantDeviceCount": 7,\
"errorDeviceCount": 0,\
"conflictDeviceCount": 3\
}\
'
For details about how to add the SDK to your project and create an authProvider instance, see the SDK documentation.
// Code snippets are only available for the latest major version. Current major version is $v1.*
// Dependencies
import (
"context"
msgraphsdk "github.com/microsoftgraph/msgraph-sdk-go"
graphmodels "github.com/microsoftgraph/msgraph-sdk-go/models"
//other-imports
)
requestBody := graphmodels.NewDeviceConfigurationDeviceStateSummary()
unknownDeviceCount := int32(2)
requestBody.SetUnknownDeviceCount(&unknownDeviceCount)
notApplicableDeviceCount := int32(8)
requestBody.SetNotApplicableDeviceCount(¬ApplicableDeviceCount)
compliantDeviceCount := int32(4)
requestBody.SetCompliantDeviceCount(&compliantDeviceCount)
remediatedDeviceCount := int32(5)
requestBody.SetRemediatedDeviceCount(&remediatedDeviceCount)
nonCompliantDeviceCount := int32(7)
requestBody.SetNonCompliantDeviceCount(&nonCompliantDeviceCount)
errorDeviceCount := int32(0)
requestBody.SetErrorDeviceCount(&errorDeviceCount)
conflictDeviceCount := int32(3)
requestBody.SetConflictDeviceCount(&conflictDeviceCount)
// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=go
deviceConfigurationDeviceStateSummaries, err := graphClient.DeviceManagement().DeviceConfigurationDeviceStateSummaries().Patch(context.Background(), requestBody, nil)
For details about how to add the SDK to your project and create an authProvider instance, see the SDK documentation.
// Code snippets are only available for the latest version. Current version is 6.x
GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);
DeviceConfigurationDeviceStateSummary deviceConfigurationDeviceStateSummary = new DeviceConfigurationDeviceStateSummary();
deviceConfigurationDeviceStateSummary.setOdataType("#microsoft.graph.deviceConfigurationDeviceStateSummary");
deviceConfigurationDeviceStateSummary.setUnknownDeviceCount(2);
deviceConfigurationDeviceStateSummary.setNotApplicableDeviceCount(8);
deviceConfigurationDeviceStateSummary.setCompliantDeviceCount(4);
deviceConfigurationDeviceStateSummary.setRemediatedDeviceCount(5);
deviceConfigurationDeviceStateSummary.setNonCompliantDeviceCount(7);
deviceConfigurationDeviceStateSummary.setErrorDeviceCount(0);
deviceConfigurationDeviceStateSummary.setConflictDeviceCount(3);
DeviceConfigurationDeviceStateSummary result = graphClient.deviceManagement().deviceConfigurationDeviceStateSummaries().patch(deviceConfigurationDeviceStateSummary);
For details about how to add the SDK to your project and create an authProvider instance, see the SDK documentation.
const options = {
authProvider,
};
const client = Client.init(options);
const deviceConfigurationDeviceStateSummary = {
'@odata.type': '#microsoft.graph.deviceConfigurationDeviceStateSummary',
unknownDeviceCount: 2,
notApplicableDeviceCount: 8,
compliantDeviceCount: 4,
remediatedDeviceCount: 5,
nonCompliantDeviceCount: 7,
errorDeviceCount: 0,
conflictDeviceCount: 3
};
await client.api('/deviceManagement/deviceConfigurationDeviceStateSummaries')
.update(deviceConfigurationDeviceStateSummary);
For details about how to add the SDK to your project and create an authProvider instance, see the SDK documentation.
<?php
use Microsoft\Graph\GraphServiceClient;
use Microsoft\Graph\Generated\Models\DeviceConfigurationDeviceStateSummary;
$graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes);
$requestBody = new DeviceConfigurationDeviceStateSummary();
$requestBody->setOdataType('#microsoft.graph.deviceConfigurationDeviceStateSummary');
$requestBody->setUnknownDeviceCount(2);
$requestBody->setNotApplicableDeviceCount(8);
$requestBody->setCompliantDeviceCount(4);
$requestBody->setRemediatedDeviceCount(5);
$requestBody->setNonCompliantDeviceCount(7);
$requestBody->setErrorDeviceCount(0);
$requestBody->setConflictDeviceCount(3);
$result = $graphServiceClient->deviceManagement()->deviceConfigurationDeviceStateSummaries()->patch($requestBody)->wait();
For details about how to add the SDK to your project and create an authProvider instance, see the SDK documentation.
Import-Module Microsoft.Graph.DeviceManagement
$params = @{
"@odata.type" = "#microsoft.graph.deviceConfigurationDeviceStateSummary"
unknownDeviceCount = 2
notApplicableDeviceCount = 8
compliantDeviceCount = 4
remediatedDeviceCount = 5
nonCompliantDeviceCount = 7
errorDeviceCount = 0
conflictDeviceCount = 3
}
Update-MgDeviceManagementDeviceConfigurationDeviceStateSummary -BodyParameter $params
For details about how to add the SDK to your project and create an authProvider instance, see the SDK documentation.
# Code snippets are only available for the latest version. Current version is 1.x
from msgraph import GraphServiceClient
from msgraph.generated.models.device_configuration_device_state_summary import DeviceConfigurationDeviceStateSummary
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python
request_body = DeviceConfigurationDeviceStateSummary(
odata_type = "#microsoft.graph.deviceConfigurationDeviceStateSummary",
unknown_device_count = 2,
not_applicable_device_count = 8,
compliant_device_count = 4,
remediated_device_count = 5,
non_compliant_device_count = 7,
error_device_count = 0,
conflict_device_count = 3,
)
result = await graph_client.device_management.device_configuration_device_state_summaries.patch(request_body)
For details about how to add the SDK to your project and create an authProvider instance, see the SDK documentation.
Response
Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call.
HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 339
{
"@odata.type": "#microsoft.graph.deviceConfigurationDeviceStateSummary",
"id": "5db26f5a-6f5a-5db2-5a6f-b25d5a6fb25d",
"unknownDeviceCount": 2,
"notApplicableDeviceCount": 8,
"compliantDeviceCount": 4,
"remediatedDeviceCount": 5,
"nonCompliantDeviceCount": 7,
"errorDeviceCount": 0,
"conflictDeviceCount": 3
}