Тип ресурса Drive

  • Статья

Ресурс Drive — объект верхнего уровня, представляющий хранилище OneDrive пользователя или библиотеку документов в SharePoint.

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

Описание в формате JSON

Ниже показано представление ресурса Drive в формате JSON.

Ресурс drive является производным от ресурса baseItem и наследует его свойства.

{
  "activities": [{"@odata.type": "microsoft.graph.itemActivity"}],
  "id": "string",
  "createdBy": { "@odata.type": "microsoft.graph.identitySet" },
  "createdDateTime": "string (timestamp)",
  "description": "string",
  "driveType": "personal | business | documentLibrary",
  "items": [ { "@odata.type": "microsoft.graph.driveItem" } ],
  "lastModifiedBy": { "@odata.type": "microsoft.graph.identitySet" },
  "lastModifiedDateTime": "string (timestamp)",
  "name": "string",
  "owner": { "@odata.type": "microsoft.graph.identitySet" },
  "quota": { "@odata.type": "microsoft.graph.quota" },
  "root": { "@odata.type": "microsoft.graph.driveItem" },
  "sharepointIds": { "@odata.type": "microsoft.graph.sharepointIds" },
  "special": [ { "@odata.type": "microsoft.graph.driveItem" }],
  "system": { "@odata.type": "microsoft.graph.systemFacet" },
  "webUrl": "url"
}

Свойства

Свойство Тип Описание
createdBy identitySet Идентификатор пользователя, устройства или приложения, создавшего элемент. Только для чтения.
createdDateTime dateTimeOffset Дата и время создания элемента. Только для чтения.
description String Предоставляет отображаемое для пользователя описание диска. Чтение и запись.
driveType Строка Описывает тип диска, представленного данным ресурсом. Для личных дисков OneDrive возвращается personal. В случае дисков OneDrive для бизнеса возвращается business. В случае библиотек документов SharePoint возвращается documentLibrary. Только для чтения.
id String Уникальный идентификатор диска. Только для чтения.
lastModifiedBy identitySet Идентификатор пользователя, устройства или приложения, внесшего последние изменения в элемент. Только для чтения.
lastModifiedDateTime dateTimeOffset Дата и время последнего изменения элемента. Только для чтения.
name string Имя элемента. Чтение и запись.
owner identitySet Необязательный параметр. Учетная запись пользователя, который является владельцем диска. Только для чтения.
quota quota Необязательный параметр. Сведения о квоте на дисковое пространство. Только для чтения.
sharepointIds sharepointIds Возвращает идентификаторы, использующиеся для обеспечения совместимости с SharePoint REST. Только для чтения.
system systemFacet Если имеется это свойство, оно указывает, что данным диском управляет система. Только для чтения.
webUrl строка (url-адрес) URL-адрес для отображения ресурса в браузере. Только для чтения.

Связи

Связь Тип Описание
activities Коллекция itemActivity Список последних действий, выполненных для этого объекта drive.
items Коллекция DriveItem Все элементы, содержащиеся на диске. Только для чтения. Допускается значение null.
root DriveItem Корневая папка на диске. Только для чтения.
special Коллекция DriveItem Коллекция общих папок, доступных в OneDrive. Только для чтения. Допускается значение null.
список Перечисление Для дисков в SharePoint, базовый список библиотек документов. Только для чтения. Допускается значение null.

Методы

Стандартная задача Метод HTTP
Получение метаданных другого ресурса Drive GET /drives/{drive-id}
Получение корневой папки для ресурса Drive по умолчанию пользователя GET /drive/root
Перечисление действий для ресурса Drive GET /drive/activities
Получение списка дочерних элементов ресурса Drive GET /drive/root/children
Получение списка изменений для всех элементов в ресурсе Drive GET /drive/root/delta
Поиск элементов в ресурсе Drive GET /drive/root/search
Доступ к специальной папке GET /drive/special/{name}

В примерах в предыдущей таблице используется каталог /drive, но можно использовать и другие пути.