Partager via

Répertorier les conteneurs

Espace de noms: microsoft.graph

Obtenez la liste des objets fileStorageContainer accessibles à un appelant. Le paramètre de filtre containerTypeId est obligatoire.

Importante

Les demandes effectuées au nom d’un utilisateur échouent si l’utilisateur n’a pas de OneDrive. Cette exigence ne s’applique pas lorsque vous appelez le point de terminaison sans contexte utilisateur (authentification d’application uniquement). Le point de terminaison retourne également uniquement les conteneurs dont l’utilisateur est un membre direct. Les conteneurs dont l’utilisateur est membre via un groupe ne sont pas retournés.

Cette API est disponible dans les déploiements de cloud national suivants.

Service global Gouvernement des États-Unis L4 Us Government L5 (DOD) Chine gérée par 21Vianet
✅ ✅ ✅ ✅

Autorisations

Choisissez l’autorisation ou les autorisations marquées comme moins privilégiées pour cette API. Utilisez une autorisation ou des autorisations privilégiées plus élevées uniquement si votre application en a besoin. Pour plus d’informations sur les autorisations déléguées et d’application, consultez Types d’autorisations. Pour en savoir plus sur ces autorisations, consultez les informations de référence sur les autorisations.

Type d’autorisation Autorisations avec privilèges minimum Autorisations privilégiées plus élevées
Déléguée (compte professionnel ou scolaire) FileStorageContainer.Selected FileStorageContainer.Manage.All
Déléguée (compte Microsoft personnel) FileStorageContainer.Selected Non disponible.
Application FileStorageContainer.Selected Non disponible.

En plus des autorisations Microsoft Graph, votre application doit également disposer de l’autorisation ou des autorisations nécessaires au niveau du type conteneur pour appeler cette API. Pour plus d’informations sur les types de conteneurs, consultez Types de conteneurs. Pour en savoir plus sur les autorisations au niveau du type conteneur, voir Autorisation incorporée SharePoint.

Requête HTTP

GET /storage/fileStorage/containers?$filter=containerTypeId eq {containerTypeId}
GET /storage/fileStorage/containers?$filter=containerTypeId eq {containerTypeId} and viewpoint/effectiveRole eq 'principalOwner'

Paramètres de requête

Cette méthode nécessite le paramètre containerTypeId . Il prend en charge le $expand paramètre de requête OData, à l’exception des propriétés drive, permissions et customProperties . Si d’autres $filter conditions sont utilisées, le point de terminaison peut retourner des pages intermédiaires avec des résultats partiels, voire aucun résultat, et l’appelant doit continuer à lire toutes les pages pour obtenir tous les résultats applicables. Pour plus d’informations, consultez paramètres de la requête OData.

En-têtes de demande

Nom Description
Autorisation Porteur {token}. Obligatoire. En savoir plus sur l’authentification et l’autorisation.

Corps de la demande

N’indiquez pas le corps de la demande pour cette méthode.

Réponse

Si elle réussit, cette méthode renvoie un 200 OK code de réponse et une collection d’objets fileStorageContainer dans le corps de la réponse. Seul un sous-ensemble limité de propriétés est retourné pour chaque fileStorageContainer.

Exemples

Demande

L’exemple suivant énumère tous les conteneurs d’un type de conteneur donné.

GET https://graph.microsoft.com/v1.0/storage/fileStorage/containers?$filter=containerTypeId eq e2756c4d-fa33-4452-9c36-2325686e1082

Réponse

L’exemple suivant illustre la réponse.

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

{
  "@odata.context": "https://graph.microsoft.com/v1.0/storage/fileStorage/containers",
  "@odata.count": 1,
  "value": [
    {
      "@odata.type": "#microsoft.graph.fileStorageContainer",
      "id": "b!ISJs1WRro0y0EWgkUYcktDa0mE8zSlFEqFzqRn70Zwp1CEtDEBZgQICPkRbil_5Z",
      "displayName": "My File Storage Container",
      "containerTypeId": "e2756c4d-fa33-4452-9c36-2325686e1082",
      "createdDateTime": "2021-11-24T15:41:52.347Z"
    }
  ]
}
  • Last updated on