Exportar (0) Imprimir
Expandir Tudo

Obter membros de grupo

Atualizado: abril de 2014

A operação Obter membros do grupo obtém os membros de um grupo.

A solicitação pode ser criada da seguinte maneira. Substitua o mytenantdomain pelo domínio do seu locatário Azure Active Directory, como contoso.onmicrosoft.com. O parâmetro de cadeia de caracteres de consulta api-version é obrigatório. Se o "$links" for incluído no URI, a resposta conterá apenas links para os objetos do diretório relevantes. Se o "$ links" for omitido do URI, os próprios objetos serão devolvidos. Os exemplos neste tópico usam o domínio de locatário para tratar o locatário. Para conhecer outras maneiras de tratar o locatário, consulte Endereçando entidades e operações da API Gráfica.

 

Método de HTTTP URI de solicitação Versão de HTTP

GET

https://graph.windows.net/mytenantdomain/groups/<objectId>/$links/members?api-version=2013-04-05

HTTP 1.1

noteObservação
Para retornar os membros a uma função, especifique "funções" como o conjunto de recursos. Você também pode especificar “directoryObjects” como o recurso definido na solicitação de URI; por exemplo, https://graph.windows.net/contoso.onmicrosoft.com/directoryObjects/5e624f44-d38d-4943-b07c-2bad078f52ff/$links/members?api-version=2013-04-05

 

Cabeçalho de solicitação Descrição

Autorização

Obrigatória. Um token de portador emitido pelo Controle de Acesso do Azure. Consulte Azure AD Graph Authentication para obter mais informações.

Content-Type

Obrigatória. O tipo de mídia do conteúdo no corpo da solicitação.

Content-Length

Obrigatória. O comprimento da solicitação em bytes.

Não existe um órgão necessário para essa solicitação.

A seguinte solicitação de exemplo recebe os membros para o grupo especificado.

GET https://graph.windows.net/contoso.onmicrosoft.com/groups/5e624f44-d38d-4943-b07c-2bad078f52ff/members?api-version=2013-04-05 HTTP/1.1
Authorization: Bearer eyJ0eX ... FWSXfwtQ
Content-Type: application/json
Host: graph.windows.net

Uma operação bem-sucedida retorna o código de status 200 OK.

 

Cabeçalho de resposta Descrição

ocp-aad-diagnostics-server-name

O identificador para o servidor que realizou a operação solicitada.

ocp-aad-session-key

A chave que identifica a sessão atual com o serviço de diretório.

A seguinte resposta de exemplo é recebida quando a solicitação de exemplo acima é enviada. O grupo contém dois membros, um dos quais é um grupo e o outro é um usuário.

HTTP/1.1 200 OK
Cache-Control: no-cache
Content-Length: 1304
Content-Type: application/json;odata=minimalmetadata;streaming=true;charset=utf-8
Server: Microsoft-IIS/7.5
ocp-aad-diagnostics-server-name: XDALV0qN1u6zqj4Uo0sPtNcrP2gqE1lnhxOWAGczrDE=
request-id: 26a7e238-a8c3-4301-bf6b-a9698d6b8a2a
client-request-id: 9e958745-8a74-4d33-8cc7-48c13f28a7ec
x-ms-dirapi-data-contract-version: 1.0
ocp-aad-session-key: k73UZDw2kpH2CGpEy3EZ6GDIcTxFw9ZX1z-CocvhjfbbjO-WETRNv5G_R42J24EQ5HvUepMB3P5Io9SuJCzg44TzE_yTh_r-IIm9MZ05cZA.1AQ8QhSZzAlRldlUmjrUFoYJL1DMlcEvjHcIlrdkgLA
X-Content-Type-Options: nosniff
DataServiceVersion: 3.0;
X-AspNet-Version: 4.0.30319
X-Powered-By: ASP.NET
X-Powered-By: ARR/2.5
X-Powered-By: ASP.NET
Date: Sat, 06 Apr 2013 00:26:15 GMT

{
    "odata.metadata": "https://graph.windows.net/contoso.onmicrosoft.com/$metadata#directoryObjects",
    "value": [
        {
            "odata.type": "Microsoft.WindowsAzure.ActiveDirectory.Group",
            "objectType": "Group",
            "objectId": "8ab3f116-1afb-44cb-8e61-6b20cb1e353c",
            "description": null,
            "dirSyncEnabled": null,
            "displayName": "Nortwest Sales",
            "lastDirSyncTime": null,
            "mail": null,
            "mailNickname": "SalesNW",
            "mailEnabled": false,
            "provisioningErrors": [],
            "proxyAddresses": [],
            "securityEnabled": true
        },
        {
            "odata.type": "Microsoft.WindowsAzure.ActiveDirectory.User",
            "objectType": "User",
            "objectId": "fabeb27a-0481-4a80-b43e-a5c02c125874",
            "accountEnabled": true,
            "assignedLicenses": [],
            "assignedPlans": [],
            "city": null,
            "country": null,
            "department": null,
            "dirSyncEnabled": null,
            "displayName": "Isabel Martins",
            "facsimileTelephoneNumber": null,
            "givenName": null,
            "jobTitle": null,
            "lastDirSyncTime": null,
            "mail": null,
            "mailNickname": "IsabelM",
            "mobile": null,
            "otherMails": [],
            "passwordPolicies": null,
            "passwordProfile": null,
            "physicalDeliveryOfficeName": null,
            "postalCode": null,
            "preferredLanguage": null,
            "provisionedPlans": [],
            "provisioningErrors": [],
            "proxyAddresses": [],
            "state": null,
            "streetAddress": null,
            "surname": null,
            "telephoneNumber": null,
            "thumbnailPhoto@odata.mediaContentType": "image",
            "usageLocation": null,
            "userPrincipalName": "Isabel@contoso.onmicrosoft.com"
        }
    ]
}

Veja a seguir a solicitação e a resposta se os links forem solicitados no URI.

GET https://graph.windows.net/contoso.onmicrosoft.com/groups/5e624f44-d38d-4943-b07c-2bad078f52ff/$links/members?api-version=2013-04-05 HTTP/1.1
Authorization: Bearer eyJ0eX ... FWSXfwtQ
Content-Type: application/json
Host: graph.windows.net

HTTP/1.1 200 OK
Cache-Control: no-cache
Content-Length: 460
Content-Type: application/json;odata=minimalmetadata;streaming=true;charset=utf-8
Server: Microsoft-IIS/7.5
ocp-aad-diagnostics-server-name: GpZBqv1HpLKoq8DomLBjVg0qidYJApbIcc5XfQ74dc8=
request-id: 2a65430f-e92f-4e99-845d-dd22f4df3524
client-request-id: 0cf003cf-e8ba-4d47-be8c-b0e576890e6f
x-ms-dirapi-data-contract-version: 1.0
ocp-aad-session-key: cGvmGh0xujGcgaoI9hcLYG_JQF4CVwhP8dpCg3Q3FxhaTfz65iTU3D_dflwwMml0ddy8UV0X_NAlPtVIdx9g3gwWI_DYwapLK0zCkODYk88WN2DurY1fwVb5jiQyG9MnLMib_bPQkNvfphqObmoo5g.a6HzeqsSRi3mzhIhmY8_7FxXfpsNnrRW1F1dHNsJ6vo
X-Content-Type-Options: nosniff
DataServiceVersion: 3.0;
X-AspNet-Version: 4.0.30319
X-Powered-By: ASP.NET
X-Powered-By: ARR/2.5
X-Powered-By: ASP.NET
Date: Fri, 29 Mar 2013 17:56:28 GMT
{
    "odata.metadata": "https://graph.windows.net/contoso.onmicrosoft.com/$metadata#directoryObjects/$links/members",
    "value": [
        {
            "url": "https://graph.windows.net/contoso.onmicrosoft.com/directoryObjects/8ab3f116-1afb-44cb-8e61-6b20cb1e353c/Microsoft.WindowsAzure.ActiveDirectory.Group"
        },
        {
            "url": "https://graph.windows.net/contoso.onmicrosoft.com/directoryObjects/fabeb27a-0481-4a80-b43e-a5c02c125874/Microsoft.WindowsAzure.ActiveDirectory.User"
        }
    ]
}

Consulte também

Conceitos

Grupo

Mostrar:
© 2014 Microsoft