Répertorier les autorisations fileStorageContainer
Espace de noms: microsoft.graph
Importante
Les API sous la version /beta
dans Microsoft Graph sont susceptibles d’être modifiées. L’utilisation de ces API dans des applications de production n’est pas prise en charge. Pour déterminer si une API est disponible dans v1.0, utilisez le sélecteur Version .
Obtenez la liste des objets d’autorisation associés à un fileStorageContainer.
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 | Non disponible. |
Déléguée (compte Microsoft personnel) | Non prise en charge. | Non prise en charge. |
Application | FileStorageContainer.Selected | Non disponible. |
Remarque
En plus des autorisations Microsoft Graph, votre application doit disposer de l’autorisation ou des autorisations nécessaires au niveau du type de conteneur pour appeler cette API. Pour plus d’informations, consultez Types de conteneurs. Pour en savoir plus sur les autorisations au niveau du type de conteneur, voir Autorisation SharePoint Embedded.
Requête HTTP
GET /storage/fileStorage/containers/{containerId}/permissions
Paramètres facultatifs de la requête
Cette méthode prend en charge les $skip
paramètres de requête , $top
, $orderBy
et $filter
OData pour vous aider à personnaliser la réponse. Pour des informations générales, consultez paramètres de la requête OData.
Par défaut, cette API répertorie uniquement les autorisations étendues au conteneur. Vous pouvez utiliser le includeAllContainerUsers=true
paramètre de requête pour inclure des entrées pour les identités qui peuvent avoir au moins une autorisation au niveau de l’élément dans le conteneur, mais qui n’ont pas d’autorisation étendue au conteneur.
En-têtes de demande
Nom | Description |
---|---|
Autorisation | Porteur {token}. Obligatoire. En savoir plus sur l’authentification et l’autorisation. |
Réponse
Si elle réussit, cette méthode renvoie un 200 OK
code de réponse et une collection d’objets d’autorisation dans le corps de la réponse.
Exemples
Demande
L’exemple suivant illustre une demande.
GET https://graph.microsoft.com/beta/storage/fileStorage/containers/b!ISJs1WRro0y0EWgkUYcktDa0mE8zSlFEqFzqRn70Zwp1CEtDEBZgQICPkRbil_5Z/permissions
Réponse
L’exemple suivant illustre la réponse.
Remarque : l’objet de réponse affiché ci-après peut être raccourci pour plus de lisibilité.
HTTP/1.1 200 OK
Content-Type: application/json
{
"@odata.context": "https://graph.microsoft.com/beta/$metadata#Collection(microsoft.graph.permission)",
"value": [
{
"@odata.type": "#microsoft.graph.permission",
"id": "cmVhZGVyX2k6MCMuZnxtZW1iZXJzaGlwfHJvcnlicjExMUBvdXRsb29rLmNvbQ",
"roles": ["principalOwner"],
"grantedToV2": {
"user": {
"id": "71392b2f-1765-406e-86af-5907d9bdb2ab",
"userPrincipalName": "jhan@contoso.com",
"displayName": "Jacob Hancock",
"email": "jhan@contoso.com"
}
}
},
{
"@odata.type": "#microsoft.graph.permission",
"id": "cHJpbmNpcGFsT3duZXJfaTowIy5mfG1lbWJlcnNoaXB8ZGxpZGRlbGwyMDIyQG91dGxvb2suY29t",
"roles": ["reader"],
"grantedToV2": {
"user": {
"id": "86503198-b81b-43fe-81ee-ad45b8848ac9",
"userPrincipalName": "mnick@contoso.com",
"displayName": "Mark Nickhols",
"email": "mnick@contoso.com"
}
}
},
{
"@odata.type": "#microsoft.graph.permission",
"id": "iZXJzaGlwfHJvcnlicjExMUBvdXRsb29rLmNvbQcJpbmNpcGFsT3duZAJfaLowIy5mfG1lbWJl",
"roles": ["writer"],
"grantedToV2": {
"user": {
"id": "0000000-b82c-23ee-51ef-ab47c8177bl0",
"userPrincipalName": "hjac@contoso.com",
"displayName": "Howard Jacobs",
"email": "hjac@contoso.com"
}
}
}
]
}