cloudPcReports: getTotalAggregatedRemoteConnectionReports
Пространство имен: microsoft.graph
Важно!
API версии /beta
в Microsoft Graph могут быть изменены. Использование этих API в производственных приложениях не поддерживается. Чтобы определить, доступен ли API в версии 1.0, используйте селектор версий.
Получите общее агрегированное использование удаленного подключения облачного компьютера за заданный период времени.
Этот API доступен в следующих национальных облачных развертываниях.
Глобальная служба | Правительство США L4 | Правительство США L5 (DOD) | Китай управляется 21Vianet |
---|---|---|---|
✅ | ✅ | ✅ | ❌ |
Разрешения
Выберите разрешение или разрешения, помеченные как наименее привилегированные для этого API. Используйте более привилегированное разрешение или разрешения только в том случае, если это требуется приложению. Дополнительные сведения о делегированных разрешениях и разрешениях приложений см. в разделе Типы разрешений. Дополнительные сведения об этих разрешениях см. в справочнике по разрешениям.
Тип разрешения | Разрешения с наименьшими привилегиями | Более высокие привилегированные разрешения |
---|---|---|
Делегированные (рабочая или учебная учетная запись) | CloudPC.Read.All | CloudPC.ReadWrite.All |
Делегированные (личная учетная запись Майкрософт) | Не поддерживается. | Не поддерживается. |
Приложение | CloudPC.Read.All | CloudPC.ReadWrite.All |
HTTP-запрос
POST /deviceManagement/virtualEndpoint/reports/getTotalAggregatedRemoteConnectionReports
Заголовки запросов
Имя | Описание |
---|---|
Авторизация | Bearer {token}. Обязательно. Дополнительные сведения о проверке подлинности и авторизации. |
Content-Type | application/json. Обязательно. |
Текст запроса
В тексте запроса укажите представление параметров в формате JSON.
В следующей таблице указаны параметры, которые можно использовать с этим действием.
Параметр | Тип | Описание |
---|---|---|
filter | String | Синтаксис фильтра OData. Поддерживаемые фильтры: and , or , lt , le , gt , ge и eq . |
select | Коллекция строк | OData выберите синтаксис. Представляет выбранные столбцы отчетов. |
search | String | Указывает строку для поиска. |
Groupby | Коллекция строк | Укажите, как группировать отчеты. Если используется, содержимое должно совпадать с параметром select. |
Orderby | Коллекция строк | Укажите способ сортировки отчетов. |
skip | Int32 | Количество записей, которые нужно пропустить. |
top | Int32 | Количество возвращаемых верхних записей. |
Отклик
В случае успешного 200 OK
выполнения это действие возвращает код ответа и поток в тексте ответа.
Примеры
Запрос
Ниже показан пример запроса.
POST https://graph.microsoft.com/beta/deviceManagement/virtualEndpoint/reports/getTotalAggregatedRemoteConnectionReports
Content-Type: application/json
Content-length: 199
{
"top": 25,
"skip": 0,
"filter": "(TotalUsageInHour ge 40 and TotalUsageInHour le 80)",
"select": [
"CloudPcId",
"ManagedDeviceName",
"UserPrincipalName",
"TotalUsageInHour",
"LastActiveTime",
"PcType",
"CreatedDate"
]
}
Отклик
Ниже показан пример отклика.
Примечание. Объект отклика, показанный здесь, может быть сокращен для удобочитаемости.
HTTP/1.1 200 OK
Content-Type: application/octet-stream
{
"TotalRowCount": 1,
"Schema": [
{
"Column": "CloudPcId",
"PropertyType": "String"
},
{
"Column": "ManagedDeviceName",
"PropertyType": "String"
},
{
"Column": "UserPrincipalName",
"PropertyType": "String"
},
{
"Column": "TotalUsageInHour",
"PropertyType": "Double"
},
{
"Column": "LastActiveTime",
"PropertyType": "DateTime"
},
{
"Column": "PcType",
"PropertyType": "String"
},
{
"Column": "CreatedDate",
"PropertyType": "DateTime"
}
],
"Values": [
[
"40f9315c-5b63-4126-9f89-b7dcb145ffff",
"CPC-DisplayName",
"connie@contoso.com",
66.36944444444444,
"2023-04-17T01:43:18",
"Cloud PC Enterprise 8vCPU/32GB/512GB",
"2022-03-30T13:48:38"
]
]
}