Laufwerk abrufenGet Drive

Wichtig

APIs unter der /beta Version in Microsoft Graph können Änderungen unterworfen werden.APIs under the /beta version in Microsoft Graph are subject to change. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt.Use of these APIs in production applications is not supported.

Dient zum Abrufen der Eigenschaften und der Beziehungen einer Drive-Ressource.Retrieve the properties and relationships of a Drive resource.

Ein Laufwerk ist der Container auf oberster Ebene für ein Dateisystem, wie z. B. OneDrive oder SharePoint-Dokumentbibliotheken.A Drive is the top-level container for a file system, such as OneDrive or SharePoint document libraries.

BerechtigungenPermissions

Eine der nachfolgenden Berechtigungen ist erforderlich, um diese API aufrufen zu können. Weitere Informationen, unter anderem zur Auswahl von Berechtigungen, finden Sie im Artikel zum Thema Berechtigungen.One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.

BerechtigungstypPermission type Berechtigungen (von der Berechtigung mit den wenigsten Rechten zu der mit den meisten Rechten)Permissions (from least to most privileged)
Delegiert (Geschäfts-, Schul- oder Unikonto)Delegated (work or school account) Files.Read, Files.ReadWrite, Files.Read.All, Files.ReadWrite.All, Sites.Read.All, Sites.ReadWrite.AllFiles.Read, Files.ReadWrite, Files.Read.All, Files.ReadWrite.All, Sites.Read.All, Sites.ReadWrite.All
Delegiert (persönliches Microsoft-Konto)Delegated (personal Microsoft account) Files.Read, Files.ReadWrite, Files.Read.All, Files.ReadWrite.AllFiles.Read, Files.ReadWrite, Files.Read.All, Files.ReadWrite.All
AnwendungApplication Files.Read.All, Files.ReadWrite.All, Sites.Read.All, Sites.ReadWrite.AllFiles.Read.All, Files.ReadWrite.All, Sites.Read.All, Sites.ReadWrite.All

Abrufen des OneDrive des aktuellen BenutzersGet current user's OneDrive

Über den me-Singleton kann auf das Laufwerk des angemeldeten Benutzers (bei der Verwendung einer delegierten Authentifizierung) zugegriffen werden.The signed in user's drive (when using delegated authentication) can be accessed from the me singleton.

Wenn das OneDrive eines Benutzers nicht bereitgestellt ist, der Benutzer jedoch über eine Lizenz für OneDrive verfügt, wird über diese Anforderung das Laufwerk des Benutzers automatisch bereitgestellt, wenn eine delegierte Authentifizierung verwendet wird.If a user's OneDrive is not provisioned but the user has a license to use OneDrive, this request will automatically provision the user's drive, when using delegated authentication.

HTTP-AnforderungHTTP request

GET /me/drive

Abrufen des OneDrive eines BenutzersGet a user's OneDrive

Damit Sie auf OneDrive oder OneDrive for Business eines Benutzers zugreifen können, muss Ihre App die drive-Beziehung in der User-Ressource anfordern.To access a user's OneDrive or OneDrive for Business, your app must request the drive relationship on the User resource.

Wenn das OneDrive eines Benutzers nicht bereitgestellt ist, der Benutzer jedoch über eine Lizenz für OneDrive verfügt, wird über diese Anforderung das Laufwerk des Benutzers automatisch bereitgestellt, wenn eine delegierte Authentifizierung verwendet wird.If a user's OneDrive is not provisioned but the user has a license to use OneDrive, this request will automatically provision the user's drive, when using delegated authentication.

HTTP-AnforderungHTTP request

GET /users/{idOrUserPrincipalName}/drive

PfadparameterPath parameters

ParameternameParameter name WertValue BeschreibungDescription
idOrUserPrincipalNameidOrUserPrincipalName stringstring Erforderlich.Required. Der Bezeichner für das Benutzerobjekt, dem OneDrive angehört.The identifier for the user object who owns the OneDrive.

Dient zum Abrufen der Dokumentbibliothek, die einer Gruppe zugeordnet ist.Get the document library associated with a group

Für den Zugriff auf die Standarddokumentbibliothek einer Gruppe fordert Ihre App die drive-Beziehung in der Gruppe an.To access a Group's default document library, your app requests the drive relationship on the Group.

HTTP-AnforderungHTTP request

GET /groups/{groupId}/drive

PfadparameterPath parameters

ParameternameParameter name WertValue BeschreibungDescription
groupIdgroupId stringstring Erforderlich.Required. Der Bezeichner für die Gruppe, die die Dokumentbibliothek besitzt.The identifier for the group which owns the document library.

Abrufen der Dokumentbibliothek für eine WebsiteGet the document library for a site

Für den Zugriff auf die Standarddokumentbibliothek einer Website fordert Ihre App die drive-Beziehung auf der Website an.To access a Site's default document library, your app requests the drive relationship on the Site.

HTTP-AnforderungHTTP request

GET /sites/{siteId}/drive

PfadparameterPath parameters

ParameternameParameter name WertValue BeschreibungDescription
siteIdsiteId stringstring Erforderlich.Required. Der Bezeichner für die Website, die die Dokumentbibliothek enthält.The identifier for the site that contains the document library.

Abrufen eines Laufwerks nach IDGet a drive by ID

Wenn Sie die eindeutige ID für ein Laufwerk besitzen, können Sie direkt über die Websitesammlung auf oberster Ebene darauf zugreifen.If you have the unique identifier for a drive, you can access it directly from the top-level drives collection.

HTTP-AnforderungHTTP request

GET /drives/{driveId}

PfadparameterPath parameters

ParameternameParameter name WertValue BeschreibungDescription
driveIddriveId stringstring Erforderlich. Dies ist der Bezeichner des angeforderten Laufwerks.Required. The identifier for the drive requested.

Optionale AbfrageparameterOptional query parameters

Diese Methode unterstützt den $Select-Abfrageparameter , um die Antwort zu Formen.These method support the $select query parameter to shape the response.

AntwortResponse

Diese Methoden geben eine Drive-Ressource für das entsprechende Laufwerk im Antworttext zurück.Each of these methods returns a Drive resource for the matching drive in the response body.

HTTP/1.1 200 OK
Content-type: application/json

{
    "id": "b!t18F8ybsHUq1z3LTz8xvZqP8zaSWjkFNhsME-Fepo75dTf9vQKfeRblBZjoSQrd7",
    "driveType": "business",
    "owner": {
        "user": {
            "id": "efee1b77-fb3b-4f65-99d6-274c11914d12",
            "displayName": "Ryan Gregg"
        }
    },
    "quota": {
        "deleted": 256938,
        "remaining": 1099447353539,
        "state": "normal",
        "total": 1099511627776
    }
}

FehlerantwortcodesError response codes

Wenn das Laufwerk nicht vorhanden ist und nicht automatisch bereitgestellt werden kann (wenn die delegierte Authentifizierung verwendet wird), wird eine HTTP 404-Antwort zurückgegeben.If the drive does not exist and cannot be provisioned automatically (when using delegated authentication) an HTTP 404 response will be returned.