Compartir a través de


Actualizar un usuario

 

Se aplica a: Windows Azure Pack

Actualiza un usuario.

Solicitud

Reemplace <ServiceMgmt> por la dirección del punto de conexión de la API de Service Management. Reemplace <Puerto> por 30005 para la API de inquilino o 30004 para la API de administrador. Reemplace <Puerto> por 30005 para la API de inquilino o 30004 para la API de administrador. Reemplace <UserName> por el nombre de usuario del usuario que se va a actualizar.

Método

URI de solicitud

Versión de HTTP

PUT

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

HTTP/1.1

Parámetros de identificador URI

Ninguno.

Encabezados de solicitud

En la tabla siguiente se describen los encabezados de solicitud requeridos y opcionales.

Encabezado de solicitud

Descripción

Autorización: Portador

Obligatorio. Token de portador de autorización.

x-ms-principal-id

Obligatorio. El identificador de la entidad de seguridad.

x-ms-client-request-id

Opcional. Identificador de solicitud de cliente.

x-ms-client-session-id

Opcional. Identificador de sesión de cliente.

x-ms-principal-liveid

Opcional. Identificador activo principal.

Cuerpo de la solicitud

En la tabla siguiente se describen los elementos del cuerpo de la solicitud.

Nombre del elemento

Descripción

Usuario

Nueva información para el usuario. Para obtener más información, vea User (Common object).

Response

La respuesta incluye un código de estado HTTP, un conjunto de encabezados de respuesta y un cuerpo de respuesta.

Código de estado

Una operación correcta devuelve el código de estado 200 Correcto.

Para obtener información sobre los códigos de estado, consulte Códigos de estado y error (Windows Administración de servicios de Azure Pack).

Encabezados de respuesta

La respuesta de esta operación incluye encabezados HTTP estándar. Todos los encabezados estándar se ajustan a la especificación del protocolo HTTP/1.1.

Cuerpo de la respuesta

La tabla siguiente describe los elementos clave del cuerpo de la respuesta:

Nombre del elemento

Descripción

Usuario

Usuario actualizado. Para obtener más información, vea User (Common object).

Ejemplo

En el ejemplo de código siguiente se muestra una solicitud actualizar usuario .

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

En el ejemplo de código siguiente se muestra una respuesta de actualización del usuario .

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

Consulte también

Interfaces de usuario comunes