Обновление пользователя
Область применения: Windows Azure Pack
Обновляет пользователя.
Запрос
Замените <ServiceMgmt> адресом конечной точки API управления службами. Замените <порт> на 30005 для API клиента или 30004 для API администратора. Замените <порт> на 30005 для API клиента или 30004 для API администратора. Замените <UserName> именем пользователя, который требуется обновить.
Метод |
Универсальный код ресурса (URI) запроса |
параметр "Версия HTTP" |
---|---|---|
PUT |
<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 |
Необязательный элемент. Идентификатор основной динамической трансляции. |
Текст запроса
В следующей таблице описываются элементы текста запроса.
Имя элемента |
Описание |
---|---|
Пользователь |
Новые сведения для пользователя. Дополнительные сведения см. в разделе User (Common object). |
Ответ
Ответ включает код состояния HTTP, набор заголовков ответа и текст ответа.
Код состояния
Успешная операция возвращает код состояния 200 (ОК).
Сведения о кодах состояния см. в разделе "Коды состояния" и "Коды ошибок" (Windows управления пакетом обновления Azure).
Заголовки откликов
Ответ для этой операции включает стандартные заголовки HTTP. Все стандартные заголовки соответствуют спецификации протокола HTTP/1.1.
Текст ответа
В следующей таблице описываются ключевые элементы текста ответа.
Имя элемента |
Описание |
---|---|
Пользователь |
Обновленный пользователь. Дополнительные сведения см. в разделе User (Common object). |
Пример
В следующем примере кода показан запрос на обновление пользователя .
PUT https://<Computer>:30004/users/aaa@bbb.com HTTP/1.1
Authorization: Bearer <Token>
x-ms-client-request-id: 2028eab5-37c8-4e7a-84a9-558e7e33b3df-2013-06-27 21:32:23Z
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: 346
Expect: 100-continue
{
"Name": "aaa@bbb.com",
"Email": "aaa@bbb.com",
"State": 1,
"CreatedTime": "2013-06-27T21:15:30.787Z",
"SubscriptionCount": 1,
"ActivationSyncState": 0,
"LastErrorMessage": "One or more errors occurred while contacting the underlying resource providers. The operation may be partially completed. Details: The request to the underlying service has timed out."
}
В следующем примере кода показан ответ "Обновить пользователя ".
{
"Name": "aaa@bbb.com",
"Email": "aaa@bbb.com",
"State": 1,
"CreatedTime": "2013-06-27T21:15:30.787",
"SubscriptionCount": 1,
"ActivationSyncState": 0,
"LastErrorMessage": "One or more errors occurred while contacting the underlying resource providers. The operation may be partially completed. Details: The request to the underlying service has timed out."
}