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