Тип ресурса DriveDrive resource type

Ресурс drive — объект верхнего уровня, представляющий хранилище OneDrive пользователя или библиотеку документов в SharePoint.The drive resource is the top level object representing a user's OneDrive or a document library in SharePoint.

Для пользователей OneDrive всегда будет доступен хотя бы один диск (диск по умолчанию). Для пользователей, у которых нет лицензии на OneDrive, такой диск может быть недоступен.OneDrive users will always have at least one drive available, their default drive. Users without a OneDrive license may not have a default drive available.

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

Ниже показано представление ресурса Drive в формате JSON.Here is a JSON representation of a Drive resource.

Ресурс drive является производным от ресурса baseItem и наследует его свойства.The drive resource is derived from baseItem and inherits properties from that resource.

{
  "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"
}

СвойстваProperties

СвойствоProperty ТипType ОписаниеDescription
createdBycreatedBy identitySetidentitySet Идентификатор пользователя, устройства или приложения, создавшего элемент. Только для чтения.Identity of the user, device, or application which created the item. Read-only.
createdDateTimecreatedDateTime dateTimeOffsetdateTimeOffset Дата и время создания элемента. Только для чтения.Date and time of item creation. Read-only.
descriptiondescription StringString Предоставляет отображаемое для пользователя описание диска.Provide a user-visible description of the drive. Чтение и запись.Read-write.
driveTypedriveType СтрокаString Описывает тип диска, представленного данным ресурсом. Для личных дисков OneDrive возвращается personal. В случае дисков OneDrive для бизнеса возвращается business. В случае библиотек документов SharePoint возвращается documentLibrary. Только для чтения.Describes the type of drive represented by this resource. OneDrive personal drives will return personal. OneDrive for Business will return business. SharePoint document libraries will return documentLibrary. Read-only.
idid StringString Уникальный идентификатор диска. Только для чтения.The unique identifier of the drive. Read-only.
lastModifiedBylastModifiedBy identitySetidentitySet Идентификатор пользователя, устройства или приложения, внесшего последние изменения в элемент. Только для чтения.Identity of the user, device, and application which last modified the item. Read-only.
lastModifiedDateTimelastModifiedDateTime dateTimeOffsetdateTimeOffset Дата и время последнего изменения элемента. Только для чтения.Date and time the item was last modified. Read-only.
namename stringstring Имя элемента. Чтение и запись.The name of the item. Read-write.
ownerowner identitySetidentitySet Необязательный параметр. Учетная запись пользователя, которому принадлежит диск. Только для чтения.Optional. The user account that owns the drive. Read-only.
quotaquota quotaquota Необязательный параметр. Сведения о квоте на дисковое пространство. Только для чтения.Optional. Information about the drive's storage space quota. Read-only.
sharepointIdssharepointIds sharepointIdssharepointIds Возвращает идентификаторы, использующиеся для обеспечения совместимости с SharePoint REST. Только для чтения.Returns identifiers useful for SharePoint REST compatibility. Read-only.
systemsystem systemFacetsystemFacet Если имеется это свойство, оно указывает, что данным диском управляет система.If present, indicates that this is a system-managed drive. Только для чтения.Read-only.
webUrlwebUrl строка (url-адрес)string (url) URL-адрес для отображения ресурса в браузере. Только для чтения.URL that displays the resource in the browser. Read-only.

СвязиRelationships

СвязьRelationship ТипType ОписаниеDescription
activitiesactivities Коллекция itemActivityitemActivity collection Список последних действий, выполненных для этого объекта drive.The list of recent activities that took place under this drive.
itemsitems Коллекция DriveItemDriveItem collection Все элементы, содержащиеся на диске. Только для чтения. Допускается значение null.All items contained in the drive. Read-only. Nullable.
rootroot DriveItemDriveItem Корневая папка на диске. Только для чтения.The root folder of the drive. Read-only.
specialspecial Коллекция DriveItemDriveItem collection Коллекция общих папок, доступных в OneDrive. Только для чтения. Допускается значение null.Collection of common folders available in OneDrive. Read-only. Nullable.
списокlist ListList Для дисков в базовом списке Библиотека документов SharePoint.For drives in SharePoint, the underlying document library list. Только для чтения.Read-only. Допускается значение null.Nullable.

МетодыMethods

Стандартная задачаCommon task Метод HTTPHTTP method
Получение метаданных другого ресурса DriveGet Drive metadata of another Drive GET /drives/{drive-id}
Получение корневой папки для ресурса Drive, используемого по умолчанию для пользователяGet root folder for user's default Drive GET /drive/root
Список действий для ресурса DriveList activities under the Drive GET /drive/activities
Получение списка дочерних элементов ресурса DriveList children under the Drive GET /drive/root/children
Получение списка изменений для всех элементов в ресурсе DriveList changes for all Items in the Drive GET /drive/root/delta
Поиск элементов в ресурсе DriveSearch for Items in the Drive GET /drive/root/search
Доступ к специальной папкеAccess special folder GET /drive/special/{name}

В примерах из предыдущей таблицы используется каталог /drive, но можно использовать и другие пути.In the previous table, the examples use /drive, but other pathes are valid too.