SharedDriveItem resource type
Namespace: microsoft.graph
Important
APIs under the /beta
version in Microsoft Graph are subject to change. Use of these APIs in production applications is not supported. To determine whether an API is available in v1.0, use the Version selector.
The sharedDriveItem resource is returned when using the shares API to access a shared driveItem.
The sharedDriveItem resource is derived from baseItem and inherits properties from that resource.
For more information about the facets on a DriveItem, see driveItem.
Methods
Method | Return Type | Description |
---|---|---|
Use sharing links | sharedDriveItem | Access a shared item or a collection of shared items by using a shareId or sharing URL. |
Properties
Property | Type | Description |
---|---|---|
id | String | The unique identifier for the share being accessed. |
name | String | The display name of the shared item. |
owner | identitySet | Information about the owner of the shared item being referenced. |
Relationships
Relationship name | Type | Description |
---|---|---|
driveItem | driveItem | Used to access the underlying driveItem |
list | list | Used to access the underlying list |
listItem | listItem | Used to access the underlying listItem |
permission | permission | Used to access the permission representing the underlying sharing link |
site | site | Used to access the underlying site |
Alternatively, for driveItems shared from personal OneDrive accounts, the following relationships may also be used.
Relationship name | Type | Description |
---|---|---|
items | driveItem collection | All driveItems contained in the sharing root. This collection cannot be enumerated. |
JSON representation
The following JSON representation shows the resource.
{
"id": "string",
"name": "string",
"owner": { "@odata.type": "microsoft.graph.identitySet" },
"driveItem": { "@odata.type": "microsoft.graph.driveItem" },
"items": [ { "@odata.type": "microsoft.graph.driveItem" }],
"list": { "@odata.type": "microsoft.graph.list" },
"listItem": { "@odata.type": "microsoft.graph.listItem" },
"root": { "@odata.type": "microsoft.graph.driveItem" },
"site": { "@odata.type": "microsoft.graph.site" }
}