Esporta (0) Stampa
Espandi tutto

Creazione di utenti

Aggiornamento: aprile 2014

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 emesso da Access Control di Azure. Per altre informazioni, vedere Azure AD Graph Authentication.

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 consente di creare un nuovo utente nella directory usando la versione 2013-11-08 e 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

Posizione

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:
© 2014 Microsoft