Update eBookInstallSummary
Статья
12/04/2023
Участники: 11
Обратная связь
В этой статье
Пространство имен: microsoft.graph
Примечание. API Microsoft Graph для Intune требует наличия активной лицензии Intune для клиента.
Обновление свойств объекта eBookInstallSummary .
Этот API доступен в следующих национальных облачных развертываниях .
Глобальная служба
Правительство США L4
Правительство США L5 (DOD)
Китай управляется 21Vianet
✅
✅
✅
✅
Разрешения
Для вызова этого API требуется одно из следующих разрешений. Дополнительные сведения, включая сведения о том, как выбрать разрешения, см. в статье Разрешения .
Тип разрешения
Разрешения (в порядке повышения привилегий)
Делегированные (рабочая или учебная учетная запись)
DeviceManagementApps.ReadWrite.All
Делегированные (личная учетная запись Майкрософт)
Не поддерживается.
Приложение
DeviceManagementApps.ReadWrite.All
HTTP-запрос
PATCH /deviceAppManagement/managedEBooks/{managedEBookId}/installSummary
Тело запроса
В теле запроса добавьте представление объекта eBookInstallSummary в формате JSON.
Ниже показаны свойства, которые необходимо указывать при создании объекта eBookInstallSummary .
Свойство
Тип
Описание
id
String
Ключ объекта.
installedDeviceCount
Int32
Количество устройств, на которых была успешно установлена эта книга.
failedDeviceCount
Int32
Количество устройств, на которых не удалось установить эту книгу.
notInstalledDeviceCount
Int32
Количество устройств, на которых не установлена эта книга.
installedUserCount
Int32
Количество пользователей, которым удалось установить эту книгу на всех своих устройствах.
failedUserCount
Int32
Количество пользователей, у которых есть одно или несколько устройств, где не удалось установить эту книгу.
notInstalledUserCount
Int32
Количество пользователей, не установивших эту книгу.
Ответ
В случае успешного выполнения этот метод возвращает код ответа 200 OK
и обновленный объект eBookInstallSummary в теле ответа.
Пример
Запрос
Ниже приведен пример запроса.
PATCH https://graph.microsoft.com/v1.0/deviceAppManagement/managedEBooks/{managedEBookId}/installSummary
Content-type: application/json
Content-length: 236
{
"@odata.type": "#microsoft.graph.eBookInstallSummary",
"installedDeviceCount": 4,
"failedDeviceCount": 1,
"notInstalledDeviceCount": 7,
"installedUserCount": 2,
"failedUserCount": 15,
"notInstalledUserCount": 5
}
// Code snippets are only available for the latest version. Current version is 5.x
// Dependencies
using Microsoft.Graph.Models;
var requestBody = new EBookInstallSummary
{
OdataType = "#microsoft.graph.eBookInstallSummary",
InstalledDeviceCount = 4,
FailedDeviceCount = 1,
NotInstalledDeviceCount = 7,
InstalledUserCount = 2,
FailedUserCount = 15,
NotInstalledUserCount = 5,
};
// 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}"].InstallSummary.PatchAsync(requestBody);
Подробнее о том, как добавить SDK в свой проект и создать экземпляр authProvider , см. в документации по SDK .
mgc device-app-management managed-ebooks install-summary patch --managed-ebook-id {managedEBook-id} --body '{\
"@odata.type": "#microsoft.graph.eBookInstallSummary",\
"installedDeviceCount": 4,\
"failedDeviceCount": 1,\
"notInstalledDeviceCount": 7,\
"installedUserCount": 2,\
"failedUserCount": 15,\
"notInstalledUserCount": 5\
}\
'
Подробнее о том, как добавить SDK в свой проект и создать экземпляр authProvider , см. в документации по SDK .
// 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.NewEBookInstallSummary()
installedDeviceCount := int32(4)
requestBody.SetInstalledDeviceCount(&installedDeviceCount)
failedDeviceCount := int32(1)
requestBody.SetFailedDeviceCount(&failedDeviceCount)
notInstalledDeviceCount := int32(7)
requestBody.SetNotInstalledDeviceCount(¬InstalledDeviceCount)
installedUserCount := int32(2)
requestBody.SetInstalledUserCount(&installedUserCount)
failedUserCount := int32(15)
requestBody.SetFailedUserCount(&failedUserCount)
notInstalledUserCount := int32(5)
requestBody.SetNotInstalledUserCount(¬InstalledUserCount)
// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=go
installSummary, err := graphClient.DeviceAppManagement().ManagedEBooks().ByManagedEBookId("managedEBook-id").InstallSummary().Patch(context.Background(), requestBody, nil)
Подробнее о том, как добавить SDK в свой проект и создать экземпляр authProvider , см. в документации по SDK .
// Code snippets are only available for the latest version. Current version is 6.x
GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);
EBookInstallSummary eBookInstallSummary = new EBookInstallSummary();
eBookInstallSummary.setOdataType("#microsoft.graph.eBookInstallSummary");
eBookInstallSummary.setInstalledDeviceCount(4);
eBookInstallSummary.setFailedDeviceCount(1);
eBookInstallSummary.setNotInstalledDeviceCount(7);
eBookInstallSummary.setInstalledUserCount(2);
eBookInstallSummary.setFailedUserCount(15);
eBookInstallSummary.setNotInstalledUserCount(5);
EBookInstallSummary result = graphClient.deviceAppManagement().managedEBooks().byManagedEBookId("{managedEBook-id}").installSummary().patch(eBookInstallSummary);
Подробнее о том, как добавить SDK в свой проект и создать экземпляр authProvider , см. в документации по SDK .
const options = {
authProvider,
};
const client = Client.init(options);
const eBookInstallSummary = {
'@odata.type': '#microsoft.graph.eBookInstallSummary',
installedDeviceCount: 4,
failedDeviceCount: 1,
notInstalledDeviceCount: 7,
installedUserCount: 2,
failedUserCount: 15,
notInstalledUserCount: 5
};
await client.api('/deviceAppManagement/managedEBooks/{managedEBookId}/installSummary')
.update(eBookInstallSummary);
Подробнее о том, как добавить SDK в свой проект и создать экземпляр authProvider , см. в документации по SDK .
<?php
use Microsoft\Graph\GraphServiceClient;
use Microsoft\Graph\Generated\Models\EBookInstallSummary;
$graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes);
$requestBody = new EBookInstallSummary();
$requestBody->setOdataType('#microsoft.graph.eBookInstallSummary');
$requestBody->setInstalledDeviceCount(4);
$requestBody->setFailedDeviceCount(1);
$requestBody->setNotInstalledDeviceCount(7);
$requestBody->setInstalledUserCount(2);
$requestBody->setFailedUserCount(15);
$requestBody->setNotInstalledUserCount(5);
$result = $graphServiceClient->deviceAppManagement()->managedEBooks()->byManagedEBookId('managedEBook-id')->installSummary()->patch($requestBody)->wait();
Подробнее о том, как добавить SDK в свой проект и создать экземпляр authProvider , см. в документации по SDK .
Import-Module Microsoft.Graph.Devices.CorporateManagement
$params = @{
"@odata.type" = "#microsoft.graph.eBookInstallSummary"
installedDeviceCount = 4
failedDeviceCount = 1
notInstalledDeviceCount = 7
installedUserCount = 2
failedUserCount = 15
notInstalledUserCount = 5
}
Update-MgDeviceAppManagementManagedEBookInstallSummary -ManagedEBookId $managedEBookId -BodyParameter $params
Подробнее о том, как добавить SDK в свой проект и создать экземпляр authProvider , см. в документации по SDK .
from msgraph import GraphServiceClient
from msgraph.generated.models.e_book_install_summary import EBookInstallSummary
graph_client = GraphServiceClient(credentials, scopes)
request_body = EBookInstallSummary(
odata_type = "#microsoft.graph.eBookInstallSummary",
installed_device_count = 4,
failed_device_count = 1,
not_installed_device_count = 7,
installed_user_count = 2,
failed_user_count = 15,
not_installed_user_count = 5,
)
result = await graph_client.device_app_management.managed_e_books.by_managed_e_book_id('managedEBook-id').install_summary.patch(request_body)
Подробнее о том, как добавить SDK в свой проект и создать экземпляр authProvider , см. в документации по SDK .
Отклик
Ниже приведен пример отклика. Примечание. Представленный здесь объект отклика может быть усечен для краткости. При фактическом вызове будут возвращены все свойства.
HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 285
{
"@odata.type": "#microsoft.graph.eBookInstallSummary",
"id": "9708ad78-ad78-9708-78ad-089778ad0897",
"installedDeviceCount": 4,
"failedDeviceCount": 1,
"notInstalledDeviceCount": 7,
"installedUserCount": 2,
"failedUserCount": 15,
"notInstalledUserCount": 5
}