Listar proprietários de grupos

Namespace: microsoft.graph

Recupere uma lista dos proprietários do grupo. Os proprietários são um conjunto de usuários ou os diretores de serviço que têm permissão para modificar o objeto do grupo. No momento, os proprietários não estão disponíveis no Microsoft Graph para grupos que foram criados no Exchange, grupos de distribuição ou grupos sincronizados de um ambiente local.

Observação: No momento, as entidades de serviço não estão listadas como proprietários de grupo devido à distribuição em estágios das entidades de serviço para o ponto de extremidade do Microsoft Graph v 1.0.

Essa API está disponível nas seguintes implantações de nuvem nacional.

Permissões

Escolha a(s) permissão(s) marcada(s) como menos privilegiada(s) para essa API. Use uma permissão ou permissões com privilégios mais altos somente se o aplicativo exigir. Para obter detalhes sobre permissões delegadas e de aplicativo, consulte Tipos de permissão. Para saber mais sobre essas permissões, consulte a referência de permissões.

Em cenários delegados, o usuário conectado também deve receber uma função do Microsoft Entra com suporte ou uma função personalizada com a permissão de microsoft.directory/groups/owners/read função. As seguintes funções menos privilegiadas têm suporte para essa operação:

• Proprietários de grupo
• Usuários "membros"
• Usuários "convidados" - têm permissões de leitura limitadas
• Leitores de Diretório
• Escritores de diretório
• Administrador de grupos
• Administrador do usuário
• Administrador do Exchange – somente para grupos do Microsoft 365
• Administrador do SharePoint – somente para grupos do Microsoft 365
• Administrador do Teams – somente para grupos do Microsoft 365
• Administrador do Yammer – somente para grupos do Microsoft 365
• Administrador do Intune – somente para grupos de segurança

Solicitação HTTP

GET /groups/{id}/owners

Parâmetros de consulta opcionais

Esse método dá suporte aos $filterparâmetros de consulta , $count, , $top$select$search, e $expand OData para ajudar a personalizar a resposta.

• A conversão de OData está habilitada. Por exemplo, /groups/{id}/members/microsoft.graph.user recupera proprietários de grupo que são usuários.
• $search tem suporte apenas nas propriedades displayName e description .
• O uso de parâmetros de consulta com essa API, exceto para $expand, é suportado apenas com parâmetros de consulta avançados. $expand não é compatível com parâmetros de consulta avançados. Para obter mais informações, consulte Recursos avançados de consulta em objetos de diretório.

Cabeçalhos de solicitação

Corpo da solicitação

Não forneça um corpo de solicitação para esse método.

Resposta

Se bem-sucedido, este método retorna um código de resposta 200 OK e uma coleção de objetos user no corpo da resposta.

Exemplo

Solicitação

O exemplo a seguir mostra uma solicitação.

GET https://graph.microsoft.com/v1.0/groups/02bd9fd6-8f93-4758-87c3-1fb73740a315/owners

// Code snippets are only available for the latest version. Current version is 5.x

// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.Groups["{group-id}"].Owners.GetAsync();

// Code snippets are only available for the latest major version. Current major version is $v1.*

// Dependencies
import (
	  "context"
	  msgraphsdk "github.com/microsoftgraph/msgraph-sdk-go"
	  //other-imports
)


// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=go
owners, err := graphClient.Groups().ByGroupId("group-id").Owners().Get(context.Background(), nil)

// Code snippets are only available for the latest version. Current version is 6.x

GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);

DirectoryObjectCollectionResponse result = graphClient.groups().byGroupId("{group-id}").owners().get();

const options = {
	authProvider,
};

const client = Client.init(options);

let owners = await client.api('/groups/02bd9fd6-8f93-4758-87c3-1fb73740a315/owners')
	.get();

<?php
use Microsoft\Graph\GraphServiceClient;


$graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes);


$result = $graphServiceClient->groups()->byGroupId('group-id')->owners()->get()->wait();

Import-Module Microsoft.Graph.Groups

Get-MgGroupOwner -GroupId $groupId

# Code snippets are only available for the latest version. Current version is 1.x
from msgraph import GraphServiceClient
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python

result = await graph_client.groups.by_group_id('group-id').owners.get()

Resposta

O exemplo a seguir mostra a resposta.

Observação: o objeto de resposta mostrado aqui pode ser encurtado para legibilidade.

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

{
    "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#directoryObjects",
    "value": [
        {
            "@odata.type": "#microsoft.graph.user",
            "id": "4562bcc8-c436-4f95-b7c0-4f8ce89dca5e",
            "accountEnabled": true,
            "displayName": "MOD Administrator",
            "userPrincipalName": "admin@contoso.com"
        },
        {
            "@odata.type": "#microsoft.graph.user",
            "id": "f0206b06-7c5d-461c-ae24-08f68b7ef463",
            "accountEnabled": true,
            "displayName": "Megan Bowen",
            "userPrincipalName": "MeganB@contoso.com"
        },
        {
            "@odata.type": "#microsoft.graph.user",
            "id": "5c70937c-d9ea-4a47-8852-ab77630f803d",
            "accountEnabled": true,
            "displayName": "Diego Siciliani",
            "userPrincipalName": "DiegoS@contoso.com"
        }
    ]
}