Тип ресурса drive

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

Важно!

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

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

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

Методы

Метод Тип возвращаемых данных Описание
Получение объекта drive drive Получение метаданных о диске
Получение корня диска driveItem Получение корневой папки диска
Список действий Коллекция itemActivity Получение списка действий, выполненных на диске
Список отслеживаемых элементов Коллекция driveItem Получение списка отслеживаемых объектов driveItems пользователя
Список дочерних элементов Коллекция driveItem Получение списка дочерних элементов корневой папки диска
Список изменений Коллекция driveItem Получение списка изменений для всех объектов driveItems в ресурсе Drive
Search Коллекция driveItem Поиск объектов driveItems на диске
Получение специальной папки driveItem Доступ к специальной папке по ее каноническому имени

Свойства

Свойство Тип Описание
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. Только для чтения. Это свойство не возвращается по умолчанию и должно быть выбрано с помощью $select параметра запроса.
system systemFacet Если имеется это свойство, оно указывает, что данным диском управляет система. Только для чтения.
webUrl строка (url-адрес) URL-адрес для отображения ресурса в браузере. Только для чтения.

Связи

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

Представление JSON

Ниже представлено представление ресурса Диска в формате 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",
  "following": [{"@odata.type": "microsoft.graph.driveItem"}],
  "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": "string",

}