Тип ресурса 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",
}