Obtenir sharePointGroup

Espace de noms: microsoft.graph

Lire les propriétés et les relations d’un objet sharePointGroup .

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) Non prise en charge. Non prise en charge.
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, les applications appelant cette API doivent au moins disposer de l’autorisation EnumeratePermissions au niveau du type de conteneur sur le type de conteneur des conteneurs correspondants. 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/{fileStorageContainerId}/sharePointGroups/{sharePointGroupId}

Paramètres facultatifs de la requête

Cette méthode prend en charge les $expand paramètres de requête OData et $select pour vous aider à personnaliser la réponse. Pour des informations générales, consultez paramètres de la requête OData. Pour le $expand paramètre de requête, seule la propriété members est prise en charge. Le $select paramètre de requête peut être utilisé avec les propriétés title, id et description de l’objet sharePointGroup .

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 un objet sharePointGroup dans le corps de la réponse.

Exemples

Exemple 1 : Obtenir un sharePointGroup par ID

L’exemple suivant montre comment obtenir un sharePointGroup identifié par ZGYwZTEzYTgtOTExOS00MjdmLWEzNjktOTdjOWM3YjNlYjcyXzE0 qui est local dans un fileStorageContainer identifié par b!ISJs1WRro0y0EWgkUYcktDa0mE8zSlFEqFzqRn70Zwp1CEtDEBZgQICPkRbil_5Z.

Demande

L’exemple suivant illustre une demande.

GET https://graph.microsoft.com/v1.0/storage/fileStorage/containers/b!ISJs1WRro0y0EWgkUYcktDa0mE8zSlFEqFzqRn70Zwp1CEtDEBZgQICPkRbil_5Z/sharePointGroups/ZGYwZTEzYTgtOTExOS00MjdmLWEzNjktOTdjOWM3YjNlYjcyXzE0

Réponse

L’exemple suivant montre la réponse avec un objet JSON qui représente le sharePointGroup.

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

{
  "@odata.type": "#microsoft.graph.sharePointGroup",
  "id" : "ZGYwZTEzYTgtOTExOS00MjdmLWEzNjktOTdjOWM3YjNlYjcyXzE0",
  "title": "Sample Group",
  "description": "This is sample description",
  "principalId": "10"
}

Exemple 2 : Tentative d’obtention d’un sharePointGroup par ID

L’exemple suivant tente d’obtenir un sharePointGroup identifié par ZGYwZTEzYTgtOTExOS00MjdmLWEzNjktOTdjOWM3YjNlYjcyXzE1 qui est local à un fileStorageContainer identifié par b!ISJs1WRro0y0EWgkUYcktDa0mE8zSlFEqFzqRn70Zwp1CEtDEBZgQICPkRbil_5Z; toutefois, le groupe n’existe pas dans le conteneur.

Demande

L’exemple suivant illustre une demande.

GET https://graph.microsoft.com/v1.0/storage/fileStorage/containers/b!ISJs1WRro0y0EWgkUYcktDa0mE8zSlFEqFzqRn70Zwp1CEtDEBZgQICPkRbil_5Z/sharePointGroups/ZGYwZTEzYTgtOTExOS00MjdmLWEzNjktOTdjOWM3YjNlYjcyXzE1

Réponse

L’exemple suivant montre la réponse d’un groupe qui n’existe pas.

Remarque : l’objet de réponse affiché ci-après peut être raccourci pour plus de lisibilité.

HTTP/1.1 404 Not Found
Content-Type: application/json

{
  "error": {
    "code": "itemNotFound",
    "message": "Item not found"
  }
}
  • Last updated on