Получение пользователя

 

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

Извлекает пользователя.

Запрос

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

Метод

Универсальный код ресурса (URI) запроса

параметр "Версия HTTP"

GET

<https:// ServiceMgmt>:<Port>/users/<UserName>

HTTP/1.1

Параметры URI

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

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

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

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

Описание

Авторизация: носитель

Обязательный. Токен носителя авторизации.

x-ms-principal-id

Обязательный. Идентификатор участника.

x-ms-client-request-id

Необязательный элемент. Идентификатор запроса клиента.

x-ms-client-session-id

Необязательный элемент. Идентификатор сеанса клиента.

x-ms-principal-liveid

Необязательный элемент. Идентификатор основной динамической трансляции.

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

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

Ответ

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

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

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

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

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

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

Текст ответа

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

Имя элемента

Описание

Пользователь

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

Пример

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

GET https://<computer>:30004/users/tom@tommy.com HTTP/1.1
Authorization: Bearer <token>
x-ms-client-request-id: 137c6d49-4740-42c0-a8a2-db24f34d9da1-2013-06-19 20:55:55Z
x-ms-client-session-id: d7401833-b959-4ac7-adba-c8b9d5c26326
x-ms-principal-id: <computer>\Administrator
Accept-Language: en-US
x-ms-principal-liveid: <computer>\Administrator
Host: <computer>:30004

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

{
  "Name": "tom@tommy.com",
  "Email": "Tom@tommy.com",
  "State": 1,
  "CreatedTime": "2013-06-19T17:09:45.387",
  "SubscriptionCount": 1,
  "ActivationSyncState": 0,
  "LastErrorMessage": null
}

См. также:

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