Mostrar las unidades disponibles

Recupera la lista de recursos Drive disponibles para un User, Group o Site de destino.

Permisos

Se requiere uno de los permisos siguientes para llamar a esta API. Para obtener más información, incluido cómo elegir permisos, vea Permisos.

Tipo de permiso	Permisos (de menos a más privilegiados)
Delegado (cuenta profesional o educativa)	Files.Read, Files.ReadWrite, Files.Read.All, Files.ReadWrite.All, Sites.Read.All, Sites.ReadWrite.All
Delegado (cuenta personal de Microsoft)	Files.Read, Files.ReadWrite, Files.Read.All, Files.ReadWrite.All
Aplicación	Files.Read.All, Files.ReadWrite.All, Sites.Read.All, Sites.ReadWrite.All

Enumerar las unidades de un grupo

Para enumerar las bibliotecas de documentos de un grupo, la aplicación solicita la relación drives en el grupo.

Solicitud HTTP

GET /groups/{groupId}/drives

Enumerar las unidades de un sitio

Para enumerar las bibliotecas de documentos de un sitio, la aplicación solicita la relación drives en el sitio.

GET /sites/{siteId}/drives

Enumerar las unidades de un usuario

GET /users/{userId}/drives

Enumerar las unidades del usuario actual

GET /me/drives

Parámetros de consulta opcionales

Este método admite los $expandparámetros de consulta , $select, $skipToken, $topy $orderby OData para personalizar la respuesta.

Respuesta

Si se ejecuta correctamente, este método devuelve un código de respuesta 200 OK y la colección de objetos Drive en el cuerpo de la respuesta.

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

{
  "value": [
    {
      "id": "942CAEB0-13AE-491B-85E4-7557CDC0F25F",
      "driveType": "documentLibrary",
      "name": "Shared Documents",
      "owner": {
        "user": {
          "id": "AE2A1EE9-81A7-423C-ABE4-B945F47509BB",
          "displayName": "Ryan Gregg"
        }
      }
    },
    {
      "id": "C1CD3ED9-0E98-4B0B-82D3-C8FB784B9DCC",
      "driveType": "documentLibrary",
      "name": "Contoso Project Files",
      "owner": {
        "user": {
          "id": "406B2281-18E8-4416-9857-38C531B904F1",
          "displayName": "Daron Spektor"
        }
      }
    }
  ]
}

Comentarios

La mayoría de los usuarios solo tendrán un único recurso Drive.

Puede que los grupos y los sitios tengan varios recursos Drive disponibles.

De manera predeterminada, las unidades con la faceta system están ocultas. Para obtener una lista de ellas, incluya system en su $select instrucción.