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

Creazione di utenti

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 Create User(s) consente di creare uno o più nuovi utenti nella directory.

La proprietà immutableId è stata aggiunta a un oggetto User per le richieste che usano la versione 2013-11-08 o successive. Quando si crea un utente con la versione 2013-11-08 o successive, è necessario specificare questa proprietà se userPrincipalName (UPN) include un dominio federato.

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. 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 della richiesta Versione HTTP

POST

https://graph.windows.net/mytenantdomain/users?api-version=2013-04-05

HTTP 1.1

 

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.

Una o più entità User con le proprietà minime specificate nell'argomento User. La password specificata deve soddisfare i requisiti di complessità delle password del tenant. Per altre informazioni sui requisiti di complessità delle password, vedere l'argomento User. L'esempio di richiesta seguente illustra le proprietà minime necessarie per creare correttamente un utente.

La richiesta di esempio seguente consente di creare un nuovo utente nella directory usando la versione 2013-04-05:

POST https://graph.windows.net/contoso.onmicrosoft.com/users?api-version=2013-04-05 HTTP/1.1
Authorization: Bearer eyJ0eX ... FWSXfwtQ
Content-Type: application/json
Host: graph.windows.net
Content-Length: 252

{
    "accountEnabled": true,
    "displayName": "Alex Wu",
    "mailNickname": "AlexW",
    "passwordProfile": { "password" : "Test1234", "forceChangePasswordNextLogin": false },
    "userPrincipalName": "Alex@contoso.onmicrosoft.com"
}


La richiesta di esempio seguente crea un nuovo utente nella directory con la versione 2013-11-08, specificando la proprietà immutableId:

POST https://graph.windows.net/contoso.onmicrosoft.com/users?api-version=2013-11-08 HTTP/1.1
Authorization: Bearer eyJ0eX ... FWSXfwtQ
Content-Type: application/json
Host: graph.windows.net
Content-Length: 293

{
    "accountEnabled": true,
    "displayName": "Alex Wu",
    "mailNickname": "AlexW",
    "passwordProfile": { "password" : "Test1234", "forceChangePasswordNextLogin": false },
    "userPrincipalName": "Alex@contoso.onmicrosoft.com"
    "immutableId": "6SNZnFLe6jOI3n68hjO5zA=="
}


Un'operazione completata correttamente restituisce il codice di stato 201 Creato.

 

Intestazione della risposta Descrizione

Location

URI dell'utente creato, che include un ID oggetto.

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.

HTTP/1.1 201 Created
Cache-Control: no-cache
Content-Length: 982
Content-Type: application/json;odata=minimalmetadata;streaming=true;charset=utf-8
Location: https://directory.windows.net/contoso.onmicrosoft.com/directoryObjects/4e971521-101a-4311-94f4-0917d7218b4e/Microsoft.WindowsAzure.ActiveDirectory.User
Server: Microsoft-IIS/7.5
ocp-aad-diagnostics-server-name: XDALV0qN1u6zqj4Uo0sPtNcrP2gqE1lnhxOWAGczrDE=
request-id: 65230a2c-0477-4fb8-9cd5-adb796f8eb29
client-request-id: ae924da9-55ea-433a-b14e-da2ef9fcd6af
x-ms-dirapi-data-contract-version: 1.0
ocp-aad-session-key: eHD4TUXUT8mNc01h-PGrQAw0kfAGmLi_T64SX_h1OGu8mTPZXTZfa6HCCDc7-r7pMultoOn3oDO0ciBl8PzNAkRHkc2BD-tUnUJI3bYWT7T3YxjW2s0dortRi6yKrCf4Qx9m67uJmCT5FhqZsgNAvw.FujkHs6N4TinxXNQi_y41v8vDIrI1DKDQXyhexHvdY8
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: Wed, 27 Mar 2013 22:59:47 GMT

{
    "odata.metadata": "https://graph.windows.net/contoso.onmicrosoft.com/$metadata#directoryObjects/Microsoft.WindowsAzure.ActiveDirectory.User/@Element",
    "odata.type": "Microsoft.WindowsAzure.ActiveDirectory.User",
    "objectType": "User",
    "objectId": "4e971521-101a-4311-94f4-0917d7218b4e",
    "accountEnabled": true,
    "assignedLicenses": [],
    "assignedPlans": [],
    "city": null,
    "country": null,
    "department": null,
    "dirSyncEnabled": null,
    "displayName": "Alex Wu",
    "facsimileTelephoneNumber": null,
    "givenName": null,
    "jobTitle": null,
    "lastDirSyncTime": null,
    "mail": null,
    "mailNickname": "AlexW",
    "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": "Alex@contoso.onmicrosoft.com"
}

Vedere anche

Concetti

User

Mostra:
© 2015 Microsoft