Экспорт (0) Печать
Развернуть все

Создание пользователей

Обновлено: Апрель 2014 г.

Операция создания пользователей позволяет создать одного или нескольких пользователей в каталоге.

Свойство immutableId было добавлено в объект User для запросов, использующих версию 2013-11-08 или более позднюю версию. При создании пользователя с версией 2013-11-08 или более новой версий это свойство необходимо указать, если UPN содержит федеративный домен.

Запрос можно составить следующим образом. Замените mytenantdomain на домен клиента Azure Active Directory, например contoso.onmicrosoft.com. Параметр строки запроса api-version является обязательным. В примерах в этом разделе для обращения используется домен клиента. Сведения о других способах адресации клиента см. в разделе Адресация сущностей и операций в Graph API.

 

Метод HTTP URI запроса Версия HTTP

POST

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

HTTP 1.1

 

Заголовок запроса Описание

Авторизация

Обязательно. Токен носителя, выданный службой Azure Access Control. Дополнительные сведения см. в разделе Azure AD Graph Authentication.

Content-Type

Обязательно. Тип мультимедиа для контента в тексте запроса.

Content-Length

Обязательно. Длина запроса в байтах.

Одна или несколько сущностей User с минимальными свойствами, описанными в разделе User. Указанный пароль должен отвечать требованиям к сложности пароля клиента. Дополнительные сведения о требованиях к сложности пароля см. в разделе User. Следующий пример запроса отображает минимальные свойства, необходимые для успешного создания пользователя.

Следующий пример запроса создает пользователя каталога с применением версии 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"
}


Следующий пример запроса создает пользователя в каталоге с применением версии 2013-11-08 с указанием свойства 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=="
}


Успешная операция возвращает код состояния 201 Создано.

 

Заголовок ответа Описание

Местоположение

URI созданного пользователя, содержащий идентификатор объекта.

ocp-aad-diagnostics-server-name

Идентификатор сервера, выполнившего запрошенную операцию.

ocp-aad-session-key

Ключ, определяющий текущий сеанс в службе каталогов.

Следующий пример ответа возвращается при отправке примера запроса, приведенного выше.

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

См. также

Основные понятия

User

Показ:
© 2014 Microsoft