servicePrincipal: getMemberObjectsservicePrincipal: getMemberGroups

Namespace: microsoft.graphNamespace: microsoft.graph

Obtenha a lista de grupos dos quais servicePrincipal é membro.Get the list of groups that this servicePrincipal is a member of. A verificação é transitiva.The check is transitive.

PermissõesPermissions

Uma das seguintes permissões é obrigatória para chamar esta API. Para saber mais, incluindo como escolher permissões, confira Permissões.One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.

Tipo de permissãoPermission type Permissões (da com menos para a com mais privilégios)Permissions (from least to most privileged)
Delegado (conta corporativa ou de estudante)Delegated (work or school account) Directory.Read.All, Directory.ReadWrite.All, Directory.AccessAsUser.AllDirectory.Read.All, Directory.ReadWrite.All, Directory.AccessAsUser.All
Delegado (conta pessoal da Microsoft)Delegated (personal Microsoft account) Sem suporte.Not supported.
AplicativoApplication Directory.Read.All, Directory.ReadWrite.AllDirectory.Read.All, Directory.ReadWrite.All

Solicitação HTTPHTTP request

POST /servicePrincipals/{id}/getMemberGroups

Cabeçalhos de solicitaçãoRequest headers

NomeName DescriçãoDescription
AutorizaçãoAuthorization {token} de portador. Obrigatório.Bearer {token}. Required.
Content-typeContent-type application/json. Obrigatório.application/json. Required.

Corpo da solicitaçãoRequest body

Forneça um objeto JSON com os seguintes parâmetros no corpo da solicitação.In the request body, provide a JSON object with the following parameters.

ParâmetroParameter TipoType DescriçãoDescription
securityEnabledOnlysecurityEnabledOnly BooleanBoolean Defina como false. Há suporte para retornar somente os grupos de segurança habilitados apenas para usuários.Set to false. Returning only security-enabled groups is supported for users only.

RespostaResponse

Se bem-sucedido, este método retorna um código de resposta 200 OK e um objeto da coleção de cadeias de caracteres no corpo da resposta.If successful, this method returns a 200 OK response code and a String collection object in the response body.

ExemploExample

Eis um exemplo de como chamar esta API.Here is an example of how to call this API.

SolicitaçãoRequest

Este é um exemplo da solicitação.Here is an example of the request.

POST https://graph.microsoft.com/v1.0/servicePrincipals/{id}/getMemberGroups
Content-type: application/json
Content-length: 33

{
  "securityEnabledOnly": true
}

RespostaResponse

Veja a seguir um exemplo da resposta.Here is an example of the response.

Observação: o objeto response mostrado aqui pode estar truncado por motivos de concisão. Todas as propriedades serão retornadas de uma chamada real.Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call.

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

{
  "value": [
    "string-value"
  ]
}