Recuperar un usuario
Se aplica a: Windows Azure Pack
Recupera un usuario.
Solicitud
Reemplace <ServiceMgmt> por la dirección del punto de conexión de la API de Service Management. Reemplace <Port> por 30005 para la API de inquilino o 30004 para la API de administrador. Reemplace <UserName> por el nombre de usuario.
Método |
URI de solicitud |
Versión de HTTP |
|---|---|---|
GET |
<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 de la entidad de seguridad. |
Cuerpo de la solicitud
Ninguno.
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 Azure Pack Service Management).
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 |
El usuario que se recuperó. Para obtener más información, vea User (Common object) (Usuario [objeto común]). |
Ejemplo
En el ejemplo de código siguiente se muestra una solicitud Obtener usuario .
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
En el ejemplo de código siguiente se muestra una respuesta Obtener usuario .
{
"Name": "tom@tommy.com",
"Email": "Tom@tommy.com",
"State": 1,
"CreatedTime": "2013-06-19T17:09:45.387",
"SubscriptionCount": 1,
"ActivationSyncState": 0,
"LastErrorMessage": null
}