Permission-RessourcentypPermission resource type

Die Permission-Ressource enthält Informationen über eine Berechtigung, die einer DriveItem-Ressource erteilt wurde.The Permission resource provides information about a sharing permission granted for a DriveItem resource.

Freigabeberechtigungen können verschiedene Formen aufweisen.Sharing permissions have a number of different forms. Die Permission-Ressource stellt die verschiedenen Formen über Facets für die Ressource dar.The Permission resource represents these different forms through facets on the resource.

JSON-DarstellungJSON representation

Es folgt eine JSON-Darstellung der Ressource.Here is a JSON representation of the resource

{
  "id": "string (identifier)",
  "grantedTo": {"@odata.type": "microsoft.graph.identitySet"},
  "inheritedFrom": {"@odata.type": "microsoft.graph.itemReference"},
  "invitation": {"@odata.type": "microsoft.graph.sharingInvitation"},
  "link": {"@odata.type": "microsoft.graph.sharingLink"},
  "roles": ["string"],
  "shareId": "string"
}

EigenschaftenProperties

EigenschaftProperty TypType BeschreibungDescription
idid StringString Die eindeutige ID der Berechtigung für alle Berechtigungen für das Element. Schreibgeschützt.The unique identifier of the permission among all permissions on the item. Read-only.
grantedTograntedTo IdentitySetIdentitySet Bei Berechtigungen vom Typ „Benutzer“ detaillierte Informationen zu Benutzern und Anwendungen für diese Berechtigung. Schreibgeschützt.For user type permissions, the details of the users & applications for this permission. Read-only.
invitationinvitation SharingInvitationSharingInvitation Details zu verknüpften Einladungen zur Freigabe für diese Berechtigung. Schreibgeschützt.Details of any associated sharing invitation for this permission. Read-only.
inheritedFrominheritedFrom ItemReferenceItemReference Stellt einen Verweis auf das Vorgängerelement der aktuellen Berechtigung bereit, wenn es von einem Vorgängerelement geerbt wurde. Schreibgeschützt.Provides a reference to the ancestor of the current permission, if it is inherited from an ancestor. Read-only.
Linklink SharingLinkSharingLink Stellt Linkdetails der aktuellen Berechtigung bereit, wenn es sich um Berechtigungen vom Typ „Link“ handelt. Schreibgeschützt.Provides the link details of the current permission, if it is a link type permissions. Read-only.
Rollenroles Collection of String
Collection of String Die Art der Berechtigung z, B. read Nachfolgend finden Sie die vollständige Liste von Rollen. Schreibgeschützt.The type of permission, e.g. read. See below for the full list of roles. Read-only.
shareIdshareId StringString Ein eindeutiges Token, das verwendet werden kann, um über die Freigabe-API auf dieses freigegebene Element zuzugreifen. Schreibgeschützt.A unique token that can be used to access this shared item via the shares API. Read-only.

Die Permission-Ressource verwendet Facets zum Bereitstellen von Informationen über die Art der Berechtigung, die von Ressource dargestellt wird.The permission resource uses facets to provide information about the kind of permission represented by the resource.

Berechtigungen mit einem link-Facet stellen Freigabelinks dar, die für das Element erstellt wurden. Freigabelinks enthalten ein eindeutiges Token, mit dem alle Benutzer, die über den Link verfügen, Zugriff auf das Element haben.Permissions with a link facet represent sharing links created on the item. Sharing links contain a unique token that provides access to the item for anyone with the link.

Berechtigungen mit einem invitation-Facet stellen Berechtigungen dar, die durch Einladung bestimmter Benutzer oder Gruppen zum Zugreifen auf die Datei hinzugefügt werden.Permissions with an invitation facet represent permissions added by inviting specific users or groups to have access to the file.

RollenaufzählungRoles enumeration

RolleRole DetailsDetails
read Ermöglicht das Lesen der Metadaten und Inhalte des Elements.Provides the ability to read the metadata and contents of the item.
write Ermöglicht das Lesen und Ändern der Metadaten und Inhalte des Elements.Provides the ability to read and modify the metadata and contents of the item.
sp.owner Für SharePoint und OneDrive for Business stellt dies die Besitzerrolle dar.For SharePoint and OneDrive for Business this represents the owner role.
sp.member Für SharePoint und OneDrive for Business stellt dies die Mitgliedsrolle dar.For SharePoint and OneDrive for Business this represents the member role.

Der am häufigsten verwendete Berechtigungstyp sind Freigabelinks. Freigabelinks geben eine eindeutige URL an, die sowohl die freigegebene Ressource als auch ein Authentifizierungstoken enthält, das Zugriff auf die Ressource gewährt. Benutzer müssen sich nicht anmelden, um auf den Inhalt zuzugreifen, der mit einem Freigabelink freigegeben wird. Benutzer können einen Link freigeben, der schreibgeschützten Zugriff oder Schreibzugriff auf den Inhalt ermöglicht.The most common type of permissions are sharing links. Sharing links provide a unique URL that includes both the resource being shared and an authentication token that provides access to the resource. Users don't need to sign-in to access the content shared with a sharing link. Users can share a link that gives read-only access to the content or writable access to the content.

Ein Anzeigelink bietet schreibgeschützten Zugriff auf ein Element.A view link provides read-only access to an item.

{
  "id": "1",
  "roles": ["read"],
  "link": {
    "type": "view",
    "webUrl": "https://onedrive.live.com/redir?resid=5D33DD65C6932946!70859&authkey=!AL7N1QAfSWcjNU8&ithint=folder%2cgif",
    "application": { "id": "1234", "displayName": "Sample Application" }
  },
  "shareId": "!LKj1lkdlals90j1nlkascl"
}

Ein Bearbeitungslink bietet Lese- und Schreibzugriff auf ein Element.An edit link provides read and write access to an item.

{
  "id": "2",
  "roles": ["write"],
  "link": {
    "type": "edit",
    "webUrl": "https://onedrive.live.com/redir?resid=5D33DD65C6932946!70859&authkey=!AL7N1QAfSWcjNU8&ithint=folder%2cgif",
    "application": { "id": "1234", "displayName": "Sample Application" }
  },
  "shareId": "!LKj1lkdlals90j1nlkascl"
}

FreigabeeinladungSharing Invitation

Außer durch die Erstellung von Freigabelinks können Benutzer auch durch eine E-Mail-Adresse eingeladen werden. In diesem Szenario erstellt die Berechtigung eine Einladung, die an die E-Mail-Adresse des Benutzers gesendet wird.In addition to creating sharing links, a user can be invited by e-mail address. In this scenario the permission creates an invitation that is sent to the user's email.

Einladung an eine E-Mail-AdresseInvitation to an email address

Wenn die Berechtigung über eine E-Mail-Adresse an einen Empfänger gesendet wurde, der nicht über ein entsprechendes Konto verfügt, kann die Eigenschaft grantedTo erst dann festgelegt werden, nachdem die Einladung eingelöst wurde; dies geschieht, wenn ein Benutzer das erste Mal auf den Link klickt und sich anmeldet.If the permission was sent via an email address to a recipient who does not have a matching account, the grantedTo property may not be set until the invitation is redeemed, which occurs the first time a user clicks the link and signs in.

{
  "id": "1",
  "roles": ["write"],
  "invitation": {
    "email": "jd@gmail.com",
    "signInRequired": true
  },
  "shareId": "FWxc1lasfdbEAGM5fI7B67aB5ZMPDMmQ11U"
}

Nachdem die Freigabeeinladung von einem Benutzer eingelöst wurde, enthält die Eigenschaft grantedTo die Informationen über das Konto, das die Berechtigungen eingelöst hat:After the sharing invitation has been redeemed by a user, the grantedTo property will contain the information about the account that redeemed the permissions:

{
  "id": "1",
  "roles": ["write"],
  "grantedTo": {
    "user": {
      "id": "5D33DD65C6932946",
      "displayName": "John Doe"
    }
  },
  "invitation": {
    "email": "jd@outlook.com",
    "signInRequired": true
  },
  "shareId": "FWxc1lasfdbEAGM5fI7B67aB5ZMPDMmQ11U"
}

MethodenMethods

MethodMethod REST-PfadREST Path
Berechtigungen auflistenList permissions GET /drive/items/{item-id}/permissions
Get permissionGet permission GET /drive/items/{item-id}/permissions/{id}
HinzufügenAdd POST /drive/items/{item-id}/invite
UpdateUpdate PATCH /drive/items/{item-id}/permissions/{id}
DeleteDelete DELETE /drive/items/{item-id}/permissions/{id}

BemerkungenRemarks

OneDrive for Business- und SharePoint-Dokumentbibliotheken geben keine inheritedFrom-Eigenschaft zurück.OneDrive for Business and SharePoint document libraries do not return the inheritedFrom property.