cloudPC: getFrontlineCloudPcAccessState

  • Статья

Пространство имен: microsoft.graph

Важно!

API версии /beta в Microsoft Graph могут быть изменены. Использование этих API в производственных приложениях не поддерживается. Чтобы определить, доступен ли API в версии 1.0, используйте селектор версий.

Получите frontlineCloudPcAccessState внешнего облачного компьютера.

Этот API поддерживает только лицензии общего использования. Дополнительные сведения см. в статье cloudPcProvisioningPolicy. Лицензии общего использования позволяют использовать трех пользователей на каждую лицензию, при этом один пользователь вошел в систему одновременно. Вызывающие пользователи могут получить последнюю версию frontline Cloud PC accessState и определить, доступен ли для пользователя облачный компьютер первой линии.

Если веб-клиенту необходимо подключиться к облачному компьютеру с интерфейсной линией, sharedCloudPcAccessState проверяет сценарий закладки. Если sharedCloudPcAccessState не является активным, активатором или резервным модом, веб-клиент отображает плохую закладку.

Этот API доступен в следующих национальных облачных развертываниях.

Глобальная служба Правительство США L4 Правительство США L5 (DOD) Китай управляется 21Vianet
✅ ✅ ✅ ❌

Разрешения

Выберите разрешение или разрешения, помеченные как наименее привилегированные для этого API. Используйте более привилегированное разрешение или разрешения только в том случае, если это требуется приложению. Дополнительные сведения о делегированных разрешениях и разрешениях приложений см. в разделе Типы разрешений. Дополнительные сведения об этих разрешениях см. в справочнике по разрешениям.

Тип разрешения Разрешения с наименьшими привилегиями Более высокие привилегированные разрешения
Делегированные (рабочая или учебная учетная запись) CloudPC.Read.All CloudPC.ReadWrite.All, CloudPC.ReadWrite
Делегированные (личная учетная запись Майкрософт) Не поддерживается. Не поддерживается.
Приложение CloudPC.Read.All. CloudPC.ReadWrite.All.

HTTP-запрос

Чтобы получить состояние доступа к облачному компьютеру для вошедшего пользователя с помощью делегированного разрешения, выполните следующие действия:

GET /me/cloudPCs/{cloudPCId}/getFrontlineCloudPcAccessState

Чтобы получить состояние доступа к облачному компьютеру для администратора, выполнившего вход, используя делегированное разрешение или разрешение приложения, выполните следующие действия:

GET /deviceManagement/virtualEndpoint/cloudPCs/{cloudPCId}/getFrontlineCloudPcAccessState

Заголовки запросов

Имя Описание
Авторизация Bearer {token}. Обязательно. Дополнительные сведения о проверке подлинности и авторизации.

Текст запроса

Не указывайте текст запроса для этого метода.

Отклик

В случае успешного выполнения этот метод возвращает код отклика 200 OK и объект frontlineCloudPcAccessState в теле отклика.

Если облачный компьютер был подготовлен как выделенное устройство, этот метод возвращает 400 Bad Request код ответа.

Примеры

Пример 1. Получение состояния доступа к облачному компьютеру первой линии для вошедшего пользователя

Запрос

Ниже показан пример запроса.

GET https://graph.microsoft.com/beta/me/cloudPCs/b0a9cde2-e170-4dd9-97c3-ad1d3328a711/getFrontlineCloudPcAccessState

Отклик

Ниже показан пример отклика.

HTTP/1.1 200 OK
Content-Type: application/json

{
    "@odata.context":"https://graph.microsoft.com/beta/$metadata#Edm.String",
    "value": "noLicensesAvailable"
}

Пример 2. Получение состояния доступа к облачному компьютеру с интерфейсом для администратора

Запрос

Ниже показан пример запроса.

GET https://graph.microsoft.com/beta/deviceManagement/virtualEndpoint/cloudPCs/b0a9cde2-e170-4dd9-97c3-ad1d3328a711/getFrontlineCloudPcAccessState

Отклик

Ниже приводится пример отклика.

HTTP/1.1 200 OK
Content-Type: application/json

{
    "@odata.context":"https://graph.microsoft.com/beta/$metadata#Edm.String",
    "value": "noLicensesAvailable"
}