Type de ressource driveDrive resource type

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.The drive resource is the top level object representing a user's OneDrive or a document library in 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.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.

Représentation JSONJSON representation

Voici une représentation JSON d’une ressource Drive.Here is a JSON representation of a Drive resource.

La ressource drive est dérivée de l’élément baseItem et hérite des propriétés de cette ressource.The drive resource is derived from baseItem and inherits properties from that resource.

{
  "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ésProperties

PropriétéProperty TypeType DescriptionDescription
createdBycreatedBy identitySetidentitySet Identité de l’utilisateur, de l’appareil et de l’application qui ont créé l’élément. En lecture seule.Identity of the user, device, or application which created the item. Read-only.
createdDateTimecreatedDateTime dateTimeOffsetdateTimeOffset Date et heure de création de l’élément. En lecture seule.Date and time of item creation. Read-only.
descriptiondescription StringString Fournit une description du lecteur visible par l’utilisateur.Provide a user-visible description of the drive. En lecture-écriture.Read-write.
driveTypedriveType ChaîneString 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.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 Identificateur unique du lecteur. En lecture seule.The unique identifier of the drive. Read-only.
lastModifiedBylastModifiedBy identitySetidentitySet Identité de l’utilisateur, du périphérique et de l’application qui ont modifié l’élément en dernier. En lecture seule.Identity of the user, device, and application which last modified the item. Read-only.
lastModifiedDateTimelastModifiedDateTime dateTimeOffsetdateTimeOffset Date et heure de dernière modification de l’élément En lecture seule.Date and time the item was last modified. Read-only.
nomname stringstring Nom de l’élément. En lecture-écriture.The name of the item. Read-write.
ownerowner identitySetidentitySet Facultatif. Compte d’utilisateur qui possède le lecteur. En lecture seule.Optional. The user account that owns the drive. Read-only.
quotaquota quotaquota Facultatif. Informations sur le quota d’espace de stockage du lecteur. En lecture seule.Optional. Information about the drive's storage space quota. Read-only.
sharepointIdssharepointIds sharepointIdssharepointIds Renvoie les identificateurs utiles pour garantir la compatibilité de SharePoint REST. En lecture seule.Returns identifiers useful for SharePoint REST compatibility. Read-only.
systemsystem systemFacetsystemFacet Si la propriété est présente, elle indique qu’il s’agit d’un lecteur géré par le système.If present, indicates that this is a system-managed drive. En lecture seule.Read-only.
webUrlwebUrl chaîne (URL)string (url) URL qui affiche la ressource dans le navigateur. En lecture seule.URL that displays the resource in the browser. Read-only.

RelationsRelationships

RelationRelationship TypeType DescriptionDescription
élémentsitems Collection DriveItemDriveItem collection Tous les éléments contenus dans le lecteur. En lecture seule. Peut avoir la valeur Null.All items contained in the drive. Read-only. Nullable.
rootroot DriveItemDriveItem Dossier racine du lecteur. En lecture seule.The root folder of the drive. Read-only.
specialspecial Collection DriveItemDriveItem collection Collection de dossiers courants disponibles dans OneDrive.Collection of common folders available in OneDrive. En lecture seule.Read-only. Pouvant accepter la valeur Null.Nullable.
listelist ListList Pour les lecteurs dans SharePoint, la liste de bibliothèques de documents sous-jacente.For drives in SharePoint, the underlying document library list. En lecture seule.Read-only. Peut avoir la valeur Null.Nullable.

MéthodesMethods

Tâche couranteCommon task Méthode HTTPHTTP method
Obtenir des métadonnées Drive d’un autre DriveGet Drive metadata of another Drive GET /drives/{drive-id}
Obtenir le dossier racine pour le Drive par défaut de l’utilisateurGet root folder for user's default Drive GET /drive/root
Répertorier les enfants sous le DriveList children under the Drive GET /drive/root/children
Répertorier les changements pour tous les éléments dans le DriveList changes for all Items in the Drive GET /drive/root/delta
Rechercher des éléments dans le DriveSearch for Items in the Drive GET /drive/root/search
Accéder au dossier spécialAccess special folder 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.In the previous table, the examples use /drive, but other pathes are valid too.