Type de ressource drive

La ressource de lecteur est l’objet de niveau supérieur qui représente une bibliothèque de documents ou OneDrive d’un utilisateur dans SharePoint.

Les utilisateurs de OneDrive auront toujours au moins un lecteur disponible, leur lecteur par défaut. Les utilisateurs sans licence OneDrive peuvent ne pas avoir de lecteur par défaut disponible.

Représentation JSON

Voici une représentation JSON d’une ressource Drive.

La ressource drive est dérivée de l’élément baseItem et hérite des propriétés de cette ressource.

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

Propriétés

Propriété	Type	Description
createdBy	identitySet	Identité de l’utilisateur, de l’appareil et de l’application qui ont créé l’élément. En lecture seule.
createdDateTime	dateTimeOffset	Date et heure de création de l’élément. En lecture seule.
description	String	Fournit une description du lecteur visible par l’utilisateur. En lecture-écriture.
driveType	Chaîne	Décrit le type de lecteur représenté par cette ressource. Les lecteurs personnels OneDrive renverront personal. OneDrive Entreprise renverra business. Les bibliothèques de documents SharePoint renverront documentLibrary. En lecture seule.
id	String	Identificateur unique du lecteur. En lecture seule.
lastModifiedBy	identitySet	Identité de l’utilisateur, du périphérique et de l’application qui ont modifié l’élément en dernier. En lecture seule.
lastModifiedDateTime	dateTimeOffset	Date et heure de la dernière modification de l’élément. En lecture seule.
name	string	Nom de l’élément. En lecture-écriture.
owner	identitySet	Facultatif. Compte d’utilisateur qui possède le lecteur. En lecture seule.
quota	quota	Facultatif. Informations sur le quota d’espace de stockage du lecteur. En lecture seule.
sharepointIds	sharepointIds	Renvoie les identificateurs utiles pour garantir la compatibilité de SharePoint REST. En lecture seule.
system	systemFacet	Si la propriété est présente, elle indique qu’il s’agit d’un lecteur géré par le système. En lecture seule.
webUrl	chaîne (URL)	URL qui affiche la ressource dans le navigateur. En lecture seule.

Relations

Relation	Type	Description
activities	Collection itemActivity	Liste des activités récentes qui ont eu lieu sur ce lecteur.
éléments	Collection DriveItem	Tous les éléments contenus dans le lecteur. En lecture seule. Peut avoir la valeur Null.
root	DriveItem	Dossier racine du lecteur. En lecture seule.
special	Collection DriveItem	Collection de dossiers courants disponibles dans OneDrive. En lecture seule. Pouvant accepter la valeur Null.
liste	List	Pour les lecteurs dans SharePoint, la liste de bibliothèques de documents sous-jacente. En lecture seule. Pouvant accepter la valeur Null.

Méthodes

Tâche courante	Méthode HTTP
Obtenir des métadonnées Drive d’un autre Drive	GET /drives/{drive-id}
Obtenir le dossier racine pour le Drive par défaut de l’utilisateur	GET /drive/root
Répertorier les activités sur le lecteur	GET /drive/activities
Répertorier les enfants sous le Drive	GET /drive/root/children
Répertorier les changements pour tous les éléments dans le Drive	GET /drive/root/delta
Rechercher des éléments dans le Drive	GET /drive/root/search
Accéder au dossier spécial	GET /drive/special/{name}

Dans le tableau précédent, les exemples utilisent le chemin d’accès /drive, mais les autres sont tout aussi valides.