shared 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.
Indicates that a drive item was shared with others and includes information about how the item is shared.
If a driveItem has a non-null shared facet, the item was shared.
Properties
| Property | Type | Description |
|---|---|---|
| owner | IdentitySet | The identity of the owner of the shared item. Read-only. |
| sharedBy | identitySet | The identity of the user who shared the item. Read-only. |
| sharedDateTime | DateTimeOffset | The UTC date and time when the item was shared. Read-only. |
| scope (deprecated) | String | Indicates the scope of how the item is shared. The possible values are: anonymous, organization, or users. Read-only. |
Caution
The scope property of the shared facet is deprecated and will be removed from the service in the
future. Instead, use the /permissions endpoint on sites, lists, list items, or drive items
to better understand the shared status for a given resource.
scope property values
| Value | Description |
|---|---|
anonymous |
The item is shared by using a link that works for anyone with the link. |
organization |
The item is shared by using a link that works for anyone in the owner's organization. |
users |
The item is shared with specific users only. |
JSON representation
{
"owner": { "@odata.type": "microsoft.graph.identitySet" },
"scope": "anonymous | organization | users",
"sharedBy": { "@odata.type": "microsoft.graph.identitySet" },
"sharedDateTime": "datetime"
}