Tipo de recurso driveItem

Espacio de nombres: microsoft.graph

Representa un archivo, carpeta u otro elemento almacenado en una unidad.

Todos los objetos del sistema de archivos en OneDrive y SharePoint se devuelven como recursos de driveItem. Los elementos de las bibliotecas de documentos de SharePoint se pueden representar como recursos listItem o driveItem.

Hay dos maneras principales de abordar un recurso driveItem:

• Con el identificador único driveItem utilizando drive/items/{item-id}
• Con la ruta de acceso del sistema de archivos mediante /drive/root:/path/to/file

Para más información, vea direccionamiento de driveItems.

Los recursos de DriveItem tienen facetas modeladas como propiedades que proporcionan datos sobre las identidades y funcionalidades de driveItem. Por ejemplo:

• Las carpetas tienen una faceta de carpeta
• Files have a file facet.
• Las imágenes tienen una faceta image además de la faceta file.
• Las imágenes tomadas con una cámara (fotos) tienen una faceta photo que identifica el elemento como una foto. Asimismo, facilita las propiedades que indican cuándo se tomó la foto y con qué dispositivo.

Los elementos con una faceta folder actúan como contenedores de elementos y, por lo tanto, tienen una referencia children que indica una colección de driveItems dentro de la carpeta.

Nota: En las bibliotecas de documentos de OneDrive para la Empresa o SharePoint, la propiedad cTag no se devuelve si el elemento de unidad tiene una faceta de carpeta.

Métodos

Propiedades

Nota: Las propiedades eTag y cTag funcionan de forma diferente en los contenedores (carpetas). El valor de cTag se modifica cuando se cambia el contenido o los metadatos de cualquier descendiente de la carpeta. El valor de eTag solo se modifica cuando se cambian las propiedades de la carpeta, excepto las propiedades que derivan de descendientes (como childCount o lastModifiedDateTime).

Relaciones

Atributos de instancia

Los atributos de instancia son propiedades con comportamientos especiales. Estas propiedades son temporales y definen el comportamiento que el servicio debe realizar o proporcionan valores de propiedad a corto plazo, como una dirección URL de descarga para un elemento que expira.

Notas: el parámetro@microsoft.graph.conflictBehavior debe agregarse a la dirección URL en lugar del cuerpo de la solicitud.

El valor @microsoft.graph.downloadUrl es una dirección URL de corta duración y no puede almacenarse en caché. La dirección URL se invalida después durante un breve período de tiempo (1 hora). Es posible que al quitar permisos de archivo de un usuario no se invalide inmediatamente la dirección URL.

El uso de la propiedad para la carga de archivos @microsoft.graph.sourceUrlno es admitido en OneDrive para la Empresa, SharePoint Online y SharePoint Server 2016.

Representación JSON

La siguiente representación JSON muestra el tipo de recurso.

El recurso driveItem deriva de baseItem y hereda las propiedades de ese recurso.

{
  "audio": { "@odata.type": "microsoft.graph.audio" },
  "bundle": { "@odata.type": "microsoft.graph.bundle" },
  "content": { "@odata.type": "Edm.Stream" },
  "contentStream": { "@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" },
  "lockInfo": { "@odata.type": "microsoft.graph.lockInfo" },
  "malware": { "@odata.type": "microsoft.graph.malware" },
  "media": { "@odata.type": "microsoft.graph.media" },
  "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,
  "source": { "@odata.type": "microsoft.graph.driveItemSource" },
  "specialFolder": { "@odata.type": "microsoft.graph.specialFolder" },
  "video": { "@odata.type": "microsoft.graph.video" },
  "viewpoint": { "@odata.type": "microsoft.graph.driveItemViewpoint" },
  "webDavUrl": "string",

  /* relationships */
  "activities": [{"@odata.type": "microsoft.graph.itemActivity"}],
  "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 */
  "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"
}