Получение ресурса Drive

  • Статья

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

В этой статье рассказывается, как получить свойства и связи ресурса Drive.

Drive — это контейнер верхнего уровня для файловой системы, например 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 https://graph.microsoft.com/v1.0/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 для формирования ответа.

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

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

Ответ

Каждый из этих методов возвращает ресурс 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
    }
}