Тип ресурса driveItem

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

Ресурс driveItem представляет файл, папку или другой элемент, хранящийся на диске.

Все объекты файловой системы в OneDrive и SharePoint возвращаются в виде ресурсов driveItem. Элементы в библиотеках документов SharePoint могут быть представлены как ресурсы listItem или driveItem.

Обратиться к ресурсу driveItem можно двумя основными способами:

• по уникальному идентификатору driveItem с помощью drive/items/{item-id};
• по пути файловой системы с помощью /drive/root:/path/to/file.

Дополнительные сведения см. в разделе об адресации driveItems.

У ресурсов driveItem есть аспекты, смоделированные как свойства, которые предоставляют данные об идентификаторах и возможностях ресурса driveItem. Пример:

• Папки имеют аспект папки
• Файлы имеют аспект файла.
• У изображений, кроме аспекта file, есть аспект image.
• У изображений, полученных с помощью камеры (фотографий), есть аспект photo, который определяет элемент как фотографию со свойствами времени и устройства съемки.

элементы с аспектом folder выполняют роль контейнеров элементов, поэтому у них есть ссылка children, указывающая на коллекцию объектов driveItem в папке.

Примечание: В библиотеках документов OneDrive для бизнеса или SharePoint свойство cTag не возвращается, если driveItem имеет аспект папки.

Методы

Свойства

Примечание: Свойства eTag и cTag работают по-разному в контейнерах (папках). Значение cTag изменяется при изменении содержимого или метаданных любого потомка папки. Значение eTag изменяется только при изменении свойств папки, за исключением свойств, производных от потомков (например , childCount или lastModifiedDateTime).

Связи

Атрибуты экземпляра

Атрибуты экземпляра — это свойства с особым поведением. Эти свойства являются временными и определяют поведение, которое должна выполнять служба, или предоставляют краткосрочные значения свойств, например URL-адрес для скачивания элемента, срок действия которого истекает.

Примечания. Параметр @microsoft.graph.conflictBehavior должен быть включен в URL-адрес, а не в текст запроса.

Значение @microsoft.graph.downloadUrl — это краткосрочный URL-адрес, который не сохраняется в кэше. ПОСЛЕ этого URL-адрес становится недействительным в течение короткого периода времени (1 час). Удаление разрешений на доступ к файлу для пользователя может не сразу сделать URL-адрес недействительным.

Использование свойства @microsoft.graph.sourceUrl для отправки файла не поддерживается в OneDrive для бизнеса, SharePoint Online и SharePoint Server 2016.

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

В следующем представлении JSON показан тип ресурса.

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

{
  "audio": { "@odata.type": "microsoft.graph.audio" },
  "bundle": { "@odata.type": "microsoft.graph.bundle" },
  "content": { "@odata.type": "Edm.Stream" },
  "cTag": "string (etag)",
  "deleted": { "@odata.type": "microsoft.graph.deleted"},
  "description": "string",
  "file": { "@odata.type": "microsoft.graph.file" },
  "fileSystemInfo": { "@odata.type": "microsoft.graph.fileSystemInfo" },
  "folder": { "@odata.type": "microsoft.graph.folder" },
  "image": { "@odata.type": "microsoft.graph.image" },
  "location": { "@odata.type": "microsoft.graph.geoCoordinates" },
  "malware": { "@odata.type": "microsoft.graph.malware" },
  "package": { "@odata.type": "microsoft.graph.package" },
  "pendingOperations": { "@odata.type": "microsoft.graph.pendingOperations" },
  "photo": { "@odata.type": "microsoft.graph.photo" },
  "publication": {"@odata.type": "microsoft.graph.publicationFacet"},
  "remoteItem": { "@odata.type": "microsoft.graph.remoteItem" },
  "root": { "@odata.type": "microsoft.graph.root" },
  "searchResult": { "@odata.type": "microsoft.graph.searchResult" },
  "shared": { "@odata.type": "microsoft.graph.shared" },
  "sharepointIds": { "@odata.type": "microsoft.graph.sharepointIds" },
  "size": 1024,
  "specialFolder": { "@odata.type": "microsoft.graph.specialFolder" },
  "video": { "@odata.type": "microsoft.graph.video" },
  "webDavUrl": "string",

  /* relationships */
  "activities": [{"@odata.type": "microsoft.graph.itemActivity"}],
  "analytics": {"@odata.type": "microsoft.graph.itemAnalytics"},
  "children": [{ "@odata.type": "microsoft.graph.driveItem" }],
  "createdByUser": { "@odata.type": "microsoft.graph.user" },
  "retentionLabel": { "@odata.type": "microsoft.graph.itemRetentionLabel" },
  "lastModifiedByUser": { "@odata.type": "microsoft.graph.user" },
  "permissions": [ {"@odata.type": "microsoft.graph.permission"} ],
  "subscriptions": [ {"@odata.type": "microsoft.graph.subscription"} ],
  "thumbnails": [ {"@odata.type": "microsoft.graph.thumbnailSet"}],
  "versions": [ {"@odata.type": "microsoft.graph.driveItemVersion"}],

  /* inherited from baseItem */
  "createdBy": {"@odata.type": "microsoft.graph.identitySet"},
  "createdDateTime": "String (timestamp)",
  "eTag": "string",
  "id": "string (identifier)",
  "lastModifiedBy": {"@odata.type": "microsoft.graph.identitySet"},
  "lastModifiedDateTime": "String (timestamp)",
  "name": "string",
  "parentReference": {"@odata.type": "microsoft.graph.itemReference"},
  "webUrl": "string",

  /* instance annotations */
  "@microsoft.graph.conflictBehavior": "string",
  "@microsoft.graph.downloadUrl": "url",
  "@microsoft.graph.sourceUrl": "url"
}