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

Статья
08/24/2015

Область применения: Windows Azure Pack

Создает пользователя.

Запрос

Замените <ServiceMgmt> адресом конечной точки API управления службами. . Замените <порт> на 30005 для API клиента или 30004 для API администратора.

Метод	Универсальный код ресурса (URI) запроса	Версия HTTP
POST	<https:// ServiceMgmt>:<Port>/users	HTTP/1.1

Параметры URI

Отсутствует.

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

В следующей таблице перечислены обязательные и необязательные заголовки запросов.

Заголовок запроса	Описание
Авторизация: носитель	Обязательный. Токен носителя авторизации.
x-ms-principal-id	Обязательный. Идентификатор участника.
x-ms-client-request-id	Необязательный элемент. Идентификатор запроса клиента.
x-ms-client-session-id	Необязательный элемент. Идентификатор сеанса клиента.
x-ms-principal-liveid	Необязательный элемент. Идентификатор основной динамической трансляции.

Текст запроса

В следующей таблице описываются элементы текста запроса.

Имя элемента	Описание
Пользователь	Сведения, используемые для создания пользователя. Дополнительные сведения см. в разделе User (Common object).

Ответ

Ответ включает код состояния HTTP, набор заголовков ответа и текст ответа.

Код состояния

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

Сведения о кодах состояния см. в разделе "Коды состояния" и "Коды ошибок" (Windows управления пакетом обновления Azure).

Заголовки откликов

Ответ для этой операции включает стандартные заголовки HTTP. Все стандартные заголовки соответствуют спецификации протокола HTTP/1.1.

Текст ответа

В следующей таблице описываются ключевые элементы текста ответа.

Имя элемента	Описание
Пользователь	Созданный пользователь. Дополнительные сведения см. в разделе User (Common object).

Пример

В следующем примере кода показан запрос на создание пользователя .

POST https://<Computer>:30004/users HTTP/1.1
Authorization: Bearer <token>
x-ms-client-request-id: 1557497f-2f4c-45b1-a42d-416fff7641a2-2013-06-27 21:15:30Z
x-ms-client-session-id: 9ff600b4-0c8b-4110-9eab-4228ce92aa4d
x-ms-principal-id: <COMPUTER>\Administrator
Accept-Language: en-US
x-ms-principal-liveid: <COMPUTER>\Administrator
Content-Type: application/json; charset=utf-8
Host: <Computer>:30004
Content-Length: 160
Expect: 100-continue

{
  "Name": "aaa@bbb.com",
  "Email": "aaa@bbb.com",
  "State": 1,
  "CreatedTime": "0001-01-01T00:00:00",
  "SubscriptionCount": 0,
  "ActivationSyncState": 0,
  "LastErrorMessage": null
}

В следующем примере кода показан ответ create User .

{
  "Name": "aaa@bbb.com",
  "Email": "aaa@bbb.com",
  "State": 1,
  "CreatedTime": "2013-06-27T21:15:30.787",
  "SubscriptionCount": 0,
  "ActivationSyncState": 0,
  "LastErrorMessage": null
}

См. также:

Общие пользовательские интерфейсы

Поделиться через