Questa pagina è stata utile?
I suggerimenti relativi al contenuto di questa pagina sono importanti. Comunicaceli.
Altri suggerimenti?
1500 caratteri rimanenti
Esporta (0) Stampa
Espandi tutto

Recupero dei membri di un gruppo

Aggiornamento: maggio 2015

Importante: è possibile che il contenuto di questo argomento non sia aggiornato. Per la documentazione di riferimento più aggiornata sull'API Graph di Azure AD, vedere la nuova documentazione interattiva sull'API Graph. Con la documentazione interattiva, è possibile provare le operazioni REST con un tenant di esempio dalla documentazione stessa. Gli aggiornamenti alla documentazione vengono apportati solo nella documentazione interattiva e questo argomento verrà rimosso in futuro.

L'operazione Get Group Members consente di ottenere i membri di un gruppo.

La richiesta può essere costruita nel modo seguente. Sostituire mytenantdomain con il dominio del tenant di Azure Active Directory, ad esempio contoso.onmicrosoft.com. Il parametro della stringa di query api-version è obbligatorio. Se "$links" è incluso nell'URI, la risposta conterrà esclusivamente i collegamenti agli oggetti directory pertinenti. Se "$links" è omesso dall'URI, verranno restituiti gli oggetti stessi. Gli esempi in questo argomento usano il dominio del tenant per l'indirizzamento del tenant. Per altre modalità di indirizzamento del tenant, vedere Indirizzamento delle entità e delle operazioni nell'API Graph.

 

Metodo HTTP URI richiesta Versione HTTP

GET

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

HTTP 1.1

noteNota
Per restituire i membri di un ruolo, specificare "roles" come set di risorse. È inoltre possibile specificare "directoryObjects" come set di risorse nell'URI della richiesta, ad esempio https://graph.windows.net/contoso.onmicrosoft.com/directoryObjects/5e624f44-d38d-4943-b07c-2bad078f52ff/$links/members?api-version=2013-04-05.

 

Intestazione della richiesta Descrizione

Autorizzazione

Obbligatorio. Token di connessione rilasciato da Azure Active Directory. Per altre informazioni, vedere Authentication Scenarios for Azure AD.

Content-Type

Obbligatorio. Tipo di supporto del contenuto nel corpo della richiesta.

Content-Length

Obbligatorio. Lunghezza della richiesta in byte.

Per questa richiesta non è necessario un corpo.

La richiesta di esempio seguente consente di ottenere i membri del gruppo specificato.

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

Un'operazione completata correttamente restituisce il codice di stato 200 OK.

 

Intestazione della risposta Descrizione

ocp-aad-diagnostics-server-name

Identificatore del server che ha eseguito l'operazione richiesta.

ocp-aad-session-key

Chiave che identifica la sessione corrente con il servizio directory.

La risposta di esempio seguente viene ricevuta quando viene inviata la richiesta di esempio illustrata in precedenza. Il gruppo contiene due membri, uno dei quali è un gruppo e l'altro un utente.

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"
        }
    ]
}

Di seguito vengono illustrate la richiesta e la risposta ottenuta quando i collegamenti vengono richiesti nell'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"
        }
    ]
}

Vedere anche

Concetti

Gruppo

Mostra:
© 2015 Microsoft