Для вызова этого API требуется одно из следующих разрешений. Дополнительные сведения, включая сведения о том, как выбрать разрешения, см. в статье Разрешения.
Тип разрешения
Разрешения (в порядке повышения привилегий)
Делегированные (рабочая или учебная учетная запись)
DeviceManagementApps.ReadWrite.All
Делегированные (личная учетная запись Майкрософт)
Не поддерживается.
Приложение
DeviceManagementApps.ReadWrite.All
HTTP-запрос
POST /deviceAppManagement/managedEBooks/{managedEBookId}/deviceStates
POST /deviceAppManagement/managedEBooks/{managedEBookId}/userStateSummary/{userInstallStateSummaryId}/deviceStates
POST https://graph.microsoft.com/v1.0/deviceAppManagement/managedEBooks/{managedEBookId}/deviceStates
Content-type: application/json
Content-length: 374
{
"@odata.type": "#microsoft.graph.deviceInstallState",
"deviceName": "Device Name value",
"deviceId": "Device Id value",
"lastSyncDateTime": "2017-01-01T00:02:49.3205976-08:00",
"installState": "installed",
"errorCode": "Error Code value",
"osVersion": "Os Version value",
"osDescription": "Os Description value",
"userName": "User Name value"
}
// Code snippets are only available for the latest version. Current version is 5.x
// Dependencies
using Microsoft.Graph.Models;
var requestBody = new DeviceInstallState
{
OdataType = "#microsoft.graph.deviceInstallState",
DeviceName = "Device Name value",
DeviceId = "Device Id value",
LastSyncDateTime = DateTimeOffset.Parse("2017-01-01T00:02:49.3205976-08:00"),
InstallState = InstallState.Installed,
ErrorCode = "Error Code value",
OsVersion = "Os Version value",
OsDescription = "Os Description value",
UserName = "User Name value",
};
// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.DeviceAppManagement.ManagedEBooks["{managedEBook-id}"].DeviceStates.PostAsync(requestBody);
// Code snippets are only available for the latest version. Current version is 6.x
GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);
DeviceInstallState deviceInstallState = new DeviceInstallState();
deviceInstallState.setOdataType("#microsoft.graph.deviceInstallState");
deviceInstallState.setDeviceName("Device Name value");
deviceInstallState.setDeviceId("Device Id value");
OffsetDateTime lastSyncDateTime = OffsetDateTime.parse("2017-01-01T00:02:49.3205976-08:00");
deviceInstallState.setLastSyncDateTime(lastSyncDateTime);
deviceInstallState.setInstallState(InstallState.Installed);
deviceInstallState.setErrorCode("Error Code value");
deviceInstallState.setOsVersion("Os Version value");
deviceInstallState.setOsDescription("Os Description value");
deviceInstallState.setUserName("User Name value");
DeviceInstallState result = graphClient.deviceAppManagement().managedEBooks().byManagedEBookId("{managedEBook-id}").deviceStates().post(deviceInstallState);
<?php
use Microsoft\Graph\GraphServiceClient;
use Microsoft\Graph\Generated\Models\DeviceInstallState;
use Microsoft\Graph\Generated\Models\InstallState;
$graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes);
$requestBody = new DeviceInstallState();
$requestBody->setOdataType('#microsoft.graph.deviceInstallState');
$requestBody->setDeviceName('Device Name value');
$requestBody->setDeviceId('Device Id value');
$requestBody->setLastSyncDateTime(new \DateTime('2017-01-01T00:02:49.3205976-08:00'));
$requestBody->setInstallState(new InstallState('installed'));
$requestBody->setErrorCode('Error Code value');
$requestBody->setOsVersion('Os Version value');
$requestBody->setOsDescription('Os Description value');
$requestBody->setUserName('User Name value');
$result = $graphServiceClient->deviceAppManagement()->managedEBooks()->byManagedEBookId('managedEBook-id')->deviceStates()->post($requestBody)->wait();
# Code snippets are only available for the latest version. Current version is 1.x
from msgraph import GraphServiceClient
from msgraph.generated.models.device_install_state import DeviceInstallState
from msgraph.generated.models.install_state import InstallState
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python
request_body = DeviceInstallState(
odata_type = "#microsoft.graph.deviceInstallState",
device_name = "Device Name value",
device_id = "Device Id value",
last_sync_date_time = "2017-01-01T00:02:49.3205976-08:00",
install_state = InstallState.Installed,
error_code = "Error Code value",
os_version = "Os Version value",
os_description = "Os Description value",
user_name = "User Name value",
)
result = await graph_client.device_app_management.managed_e_books.by_managed_e_book_id('managedEBook-id').device_states.post(request_body)
Ниже приведен пример отклика. Примечание. Представленный здесь объект отклика может быть усечен для краткости. При фактическом вызове будут возвращены все свойства.
HTTP/1.1 201 Created
Content-Type: application/json
Content-Length: 423
{
"@odata.type": "#microsoft.graph.deviceInstallState",
"id": "b9feb68f-b68f-b9fe-8fb6-feb98fb6feb9",
"deviceName": "Device Name value",
"deviceId": "Device Id value",
"lastSyncDateTime": "2017-01-01T00:02:49.3205976-08:00",
"installState": "installed",
"errorCode": "Error Code value",
"osVersion": "Os Version value",
"osDescription": "Os Description value",
"userName": "User Name value"
}