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

Ресурс driveItem представляет файл, папку или другой элемент, хранящийся на диске. Все объекты файловой системы в OneDrive и SharePoint возвращаются в виде ресурсов driveItem.The driveItem resource represents a file, folder, or other item stored in a drive. All file system objects in OneDrive and SharePoint are returned as driveItem resources.

Обратиться к ресурсу driveItem можно двумя основными способами:There are two primary ways of addressing a driveItem resource:

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

У ресурсов DriveItem есть аспекты, смоделированные как свойства, которые предоставляют данные об идентификаторах и возможностях объекта driveItem. Пример:DriveItem resources have facets modeled as properties that provide data about the driveItem's identities and capabilities. For example:

  • У папок есть аспект folder.Folders have a folder facet
  • У файлов есть аспект file.Files have a file facet.
  • У изображений помимо аспекта file есть аспект image.Images have an image facet in addition to their file facet.
  • У изображений, полученных с помощью камеры (фотографий), есть аспект photo, который определяет элемент как фотографию со свойствами времени съемки и устройства.Images taken with a camera (photos) have a photo facet that identifies the item as a photo and provides the properties of when the photo was taken and with what device.

элементы с аспектом folder выполняют роль контейнеров элементов, поэтому у них есть ссылка children, указывающая на коллекцию объектов driveItem в папке.Items with the folder facet act as containers of items and therefore have a children reference pointing to a collection of driveItems under the folder.

Представление в формате JSONJSON representation

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

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

{
  "audio": { "@odata.type": "microsoft.graph.audio" },
  "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" },
  "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"}],
  "children": [{ "@odata.type": "microsoft.graph.driveItem" }],
  "permissions": [ {"@odata.type": "microsoft.graph.permission"} ],
  "thumbnails": [ {"@odata.type": "microsoft.graph.thumbnailSet"}],
  "versions": [ {"@odata.type": "microsoft.graph.driveItemVersion"}],

  /* inherited from baseItem */
  "id": "string (identifier)",
  "createdBy": {"@odata.type": "microsoft.graph.identitySet"},
  "createdDateTime": "String (timestamp)",
  "eTag": "string",
  "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"
}

СвойстваProperties

СвойствоProperty ТипType ОписаниеDescription
audioaudio audioaudio Метаданные звукового файла, если элемент — звуковой файл. Только для чтения.Audio metadata, if the item is an audio file. Read-only.
содержимоеcontent ПотокStream Поток содержимого, если элемент представляет файл.The content stream, if the item represents a file.
createdBycreatedBy identitySetidentitySet Идентификатор пользователя, устройства или приложения, создавшего элемент. Только для чтения.Identity of the user, device, and application which created the item. Read-only.
createdDateTimecreatedDateTime DateTimeOffsetDateTimeOffset Дата и время создания элемента. Только для чтения.Date and time of item creation. Read-only.
cTagcTag StringString ETag для содержимого элемента. Такой тег сущности не изменяется, если изменяются только метаданные. Примечание. Это свойство не возвращается, если в роли элемента выступает папка. Только для чтения.An eTag for the content of the item. This eTag is not changed if only the metadata is changed. Note This property is not returned if the item is a folder. Read-only.
deleteddeleted deleteddeleted Сведения о состоянии удаления элемента. Только для чтения.Information about the deleted state of the item. Read-only.
descriptiondescription StringString Предоставляет видимое пользователю описание элемента. Чтение и запись. Только в личном хранилище OneDriveProvides a user-visible description of the item. Read-write. Only on OneDrive Personal
eTageTag StringString Тег сущности для всего элемента (метаданные и содержимое). Только для чтения.eTag for the entire item (metadata + content). Read-only.
filefile filefile Файл метаданных, если в роли элемента выступает файл. Только для чтения.File metadata, if the item is a file. Read-only.
fileSystemInfofileSystemInfo fileSystemInfofileSystemInfo Сведения о файловой системе на клиенте. Чтение и запись.File system information on client. Read-write.
folderfolder folderfolder Метаданные папки, если в роли элемента выступает папка. Только для чтения.Folder metadata, if the item is a folder. Read-only.
idid СтрокаString Уникальный идентификатор элемента на диске. Только для чтения.The unique identifier of the item within the Drive. Read-only.
изображениеimage imageimage Метаданные изображения, если в роли элемента выступает изображение. Только для чтения.Image metadata, if the item is an image. 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.
locationlocation geoCoordinatesgeoCoordinates Метаданные местоположения, если в роли элемента выступают данные о местоположении. Только для чтения.Location metadata, if the item has location data. Read-only.
отmalware отmalware Метаданные вредоносных программ, если элемент содержит вредоносную программу.Malware metadata, if the item was detected to contain malware. Только для чтения.Read-only.
namename StringString Имя элемента (имя и расширение файла). Чтение и запись.The name of the item (filename and extension). Read-write.
packagepackage packagepackage В случае наличия указывает, что этот элемент — пакет, а не папка или файл. Пакеты обрабатываются как файлы в одном контексте, и как папки — в другом. Только для чтения.If present, indicates that this item is a package instead of a folder or file. Packages are treated like files in some contexts and folders in others. Read-only.
parentReferenceparentReference itemReferenceitemReference Сведения о родительском элементе, если элемент выступает в роли родительского элемента. Чтение и запись.Parent information, if the item has a parent. Read-write.
Фотография
photo photophoto Метаданные фотографии, если в роли элемента выступает фотография. Только для чтения.Photo metadata, if the item is a photo. Read-only.
publicationpublication publicationFacetpublicationFacet Предоставляет сведения о состоянии элемента (опубликован или получен для изменения) в расположениях, поддерживающих такие действия.Provides information about the published or checked-out state of an item, in locations that support such actions. Это свойство не возвращается по умолчанию.This property is not returned by default. Только для чтения.Read-only.
remoteItemremoteItem remoteItemremoteItem Данные удаленного элемента, если элемент используется совместно на диске, но не на том, к которому получен доступ в данный момент. Только для чтения.Remote item data, if the item is shared from a drive other than the one being accessed. Read-only.
rootroot rootroot Ненулевое значение этого свойства указывает, что ресурс driveItem является самым верхним на диске.If this property is non-null, it indicates that the driveItem is the top-most driveItem in the drive.
searchResultsearchResult searchResultsearchResult Поиск метаданных, если элемент получен из результата поиска. Только для чтения.Search metadata, if the item is from a search result. Read-only.
общиеshared sharedshared Указывает, что к элементу был предоставлен общий доступ для других пользователей, и предоставляет сведения о состоянии совместного использования элемента. Только для чтения.Indicates that the item has been shared with others and provides information about the shared state of the item. Read-only.
sharepointIdssharepointIds sharepointIdssharepointIds Возвращает идентификаторы, использующиеся для обеспечения совместимости с SharePoint REST. Только для чтения.Returns identifiers useful for SharePoint REST compatibility. Read-only.
sizesize Int64Int64 Размер элемента (в байтах). Только для чтения.Size of the item in bytes. Read-only.
specialFolderspecialFolder specialFolderspecialFolder Если текущий элемент также доступен как специальная папка, возвращается этот аспект. Только для чтения.If the current item is also available as a special folder, this facet is returned. Read-only.
videovideo videovideo Метаданные видео, если в роли элемента выступает видео. Только для чтения.Video metadata, if the item is a video. Read-only.
webDavUrlwebDavUrl СтрокаString URL-адрес элемента, совместимый с WebDAV.WebDAV compatible URL for the item.
webUrlwebUrl StringString URL-адрес для отображения ресурса в браузере. Только для чтения.URL that displays the resource in the browser. Read-only.

Примечание. Свойства тегов eTag и cTag по-разному действуют на контейнеры (папки). Значение cTag изменяется при изменении содержимого или метаданных любого потомка папки. Значение eTag изменяется только при изменении свойств папки, за исключением свойств, которые являются производными от потомков (например, свойство childCount или lastModifiedDateTime).Note: The eTag and cTag properties work differently on containers (folders). The cTag value is modified when content or metadata of any descendant of the folder is changed. The eTag value is only modified when the folder's properties are changed, except for properties that are derived from descendants (like childCount or lastModifiedDateTime).

ОтношенияRelationships

ОтношениеRelationship ТипType ОписаниеDescription
activitiesactivities Коллекция itemActivityitemActivity collection Список последних действий, выполненных с элементом.The list of recent activities that took place on this item.
childrenchildren Коллекция driveItemdriveItem collection Коллекция, содержащая объекты Item для непосредственных дочерних элементов Item. Дочерние элементы есть только у элементов, представляющих папки. Только для чтения. Допускается значение null.Collection containing Item objects for the immediate children of Item. Only items representing folders have children. Read-only. Nullable.
listItemlistItem listItemlistItem Для дисков в SharePoint, связанный элемент библиотеки документов.For drives in SharePoint, the associated document library list item. Только для чтения.Read-only. Может иметь значение null.Nullable.
permissionspermissions Коллекция объектов permissionpermission collection Набор разрешений для элемента. Только для чтения. Допускается значение null.The set of permissions for the item. Read-only. Nullable.
thumbnailsthumbnails Коллекция объектов thumbnailSetthumbnailSet collection Коллекция, содержащая объекты ThumbnailSet, связанные с элементом. Дополнительные сведения см. в статье о [получении эскизов][]. Только для чтения. Допускается значение null.Collection containing ThumbnailSet objects associated with the item. For more info, see getting thumbnails. Read-only. Nullable.
versionsversions Коллекция driveItemVersiondriveItemVersion collection Список предыдущих версий элемента.The list of previous versions of the item. Дополнительные сведения см. в статье, посвященной [получению предыдущих версий][].For more info, see getting previous versions. Только для чтения.Read-only. Допускается значение null.Nullable.

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

Атрибуты экземпляра — это свойства с особым поведением. Эти свойства — временные и а) определяют поведение выполнения службы; или б) предоставляют краткосрочные значения свойств, например URL-адрес скачивания элемента, у которого истекает срок действия.Instance attributes are properties with special behaviors. These properties are temporary and either a) define behavior the service should perform or b) provide short-term property values, like a download URL for an item that expires.

Имя свойстваProperty name ТипType ОписаниеDescription
@microsoft.graph.conflictBehavior@microsoft.graph.conflictBehavior stringstring Определяет поведение для разрешения конфликтов, возникающих при создании элементов. Вы можете использовать значения fail, replace или rename. Значение по умолчанию для метода PUT: replace. Элементы никогда не возвращаются с такой заметкой. Только для записи.The conflict resolution behavior for actions that create a new item. You can use the values fail, replace, or rename. The default for PUT is replace. An item will never be returned with this annotation. Write-only.
@microsoft.graph.downloadUrl@microsoft.graph.downloadUrl stringstring URL-адрес, который можно использовать для скачивания содержимого этого файла. Проверка подлинности не является обязательным условием, если используется такой URL-адрес. Только для чтения.A URL that can be used to download this file's content. Authentication is not required with this URL. Read-only.
@microsoft.graph.sourceUrl@microsoft.graph.sourceUrl stringstring При создании запроса PUT такую заметку экземпляра можно использовать, чтобы указать службе скачать содержимое по URL-адресу и сохранить его как файл. Только для записи.When issuing a PUT request, this instance annotation can be used to instruct the service to download the contents of the URL, and store it as the file. Write-only.

Примечание. Значение @microsoft.graph.downloadUrl — это краткосрочный URL-адрес, который не сохраняется в кэше. URL-адрес будет доступен в течение короткого времени (1 час), после чего станет недействительным.Note: The @microsoft.graph.downloadUrl value is a short-lived URL and can't be cached. The URL will only be available for a short period of time (1 hour) before it is invalidated.

МетодыMethods

МетодMethod Путь RESTREST Path
Получение элементаGet item GET /drive/items/{item-id}
Действия со спискамиList activities GET /drive/items/{item-id}/activities
Список дочерних элементовList children GET /drive/items/{item-id}/children
Список версийList versions GET /drive/items/{item-id}/versions
Создание элементаCreate item POST /drive/items/{item-id}/children
Обновление элементаUpdate item PATCH /drive/items/{item-id}
Отправка содержимогоUpload content PUT /drive/items/{item-id}/content
Скачивание содержимогоDownload content GET /drive/items/{item-id}/content
Скачивание файла в определенном форматеDownload specific file format GET /drive/items/{item-id}/content?format={format}
Удаление элементаDelete item DELETE /drive/items/{item-id}
Перемещение элементаMove item PATCH /drive/items/{item-id}
Копирование элементаCopy item POST /drive/items/{item-id}/copy
Поиск элементовSearch items GET /drive/items/{item-id}/search(q='text')
Перечисление изменений на дискеList changes in a drive GET /drive/root/delta
Перечисление эскизовList thumbnails GET /drive/items/{item-id}/thumbnails
Создание ссылки совместного доступаCreate sharing link POST /drive/items/{item-id}/createLink
Добавление разрешенийAdd permissions POST /drive/items/{item-id}/invite
Список разрешенийList permissions GET /drive/items/{item-id}/permissions
Удаление разрешенияDelete permission DELETE /drive/items/{item-id}/permissions/{perm-id}
Предварительный просмотр элементаPreview item POST /drive/items/{item-id}/preview

ЗаметкиRemarks

В OneDrive для бизнеса и библиотеках документов SharePoint свойство cTag не возвращается, если у ресурса driveItem есть аспект folder.In OneDrive for Business or SharePoint document libraries, the cTag property is not returned, if the driveItem has a folder facet.