Share via

Вывод диска

  • Статья

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

Важно!

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

Получение свойств и связей ресурса диска .

Диск — это контейнер верхнего уровня для файловой системы, например для библиотек документов OneDrive или SharePoint.

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

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

Разрешения

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

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

HTTP-запрос

Получение текущего oneDrive пользователя

Доступ к диску пользователя, выполнившего вход (при использовании делегированной проверки подлинности), можно получить из одного экземпляра me .

Если у пользователя есть лицензия на OneDrive, но его OneDrive еще не настроен, этот запрос автоматически подготавливает диск пользователя при использовании делегированной проверки подлинности.

GET /me/drive

Получение OneDrive пользователя

Чтобы получить доступ к хранилищу OneDrive или OneDrive для бизнеса пользователя, ваше приложение должно запросить связь drive в ресурсе User.

Если у пользователя есть лицензия на OneDrive, но его OneDrive еще не настроен, этот запрос автоматически подготавливает диск пользователя при использовании делегированной проверки подлинности.

GET /users/{idOrUserPrincipalName}/drive

Параметры пути

Имя параметра Значение Описание
idOrUserPrincipalName строка Обязательный. Идентификатор объекта пользователя, которому принадлежит хранилище OneDrive.

Получение библиотеки документов, связанной с группой

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

GET /groups/{groupId}/drive

Параметры пути

Имя параметра Значение Описание
groupId строка Обязательный. Идентификатор группы, владеющей библиотекой документов.

Получение библиотеки документов для сайта

Чтобы получить доступ к библиотеке документов, используемой по умолчанию, для сайта, ваше приложение должно запросить связь drive в объекте Site.

GET /sites/{siteId}/drive

Параметры пути

Имя параметра Значение Описание
siteId строка Обязательный. Идентификатор для сайта, который содержит библиотеку документов.

Получение диска с использованием его идентификатора

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

GET /drives/{driveId}

Параметры пути

Имя параметра Значение Описание
driveId string Обязательный. Идентификатор запрошенного диска.

Необязательные параметры запросов

Эти методы поддерживают параметр запроса $select для формирования ответа.

Ответ

Каждый из этих методов возвращает ресурс Drive для соответствующего диска в тексте отклика.

Коды ответов с ошибками

Если диск не существует и не может быть подготовлен автоматически (при использовании делегированной проверки подлинности), HTTP 404 возвращается ответ.

Примеры

Запрос

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

GET /me/drive

Отклик

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

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

{
    "id": "b!t18F8ybsHUq1z3LTz8xvZqP8zaSWjkFNhsME-Fepo75dTf9vQKfeRblBZjoSQrd7",
    "driveType": "business",
    "owner": {
        "user": {
            "id": "efee1b77-fb3b-4f65-99d6-274c11914d12",
            "displayName": "Ryan Gregg"
        }
    },
    "quota": {
        "deleted": 256938,
        "remaining": 1099447353539,
        "state": "normal",
        "total": 1099511627776
    }
}