Recuperar um usuário
Aplica-se a: Windows Azure Pack
Recupera um usuário.
Solicitação
Substitua <ServiceMgmt> pelo endereço do ponto de extremidade da API de Gerenciamento de Serviços. Substitua <a Porta> pelo 30005 para a API de locatário ou 30004 para a API de administrador. Substitua <UserName> pelo nome de usuário.
Método |
URI da solicitação |
Versão HTTP |
|---|---|---|
GET |
<https:// ServiceMgmt>:<Port>/users/<UserName> |
HTTP/1.1 |
Parâmetros de URI
Nenhum.
Cabeçalhos de solicitação
A tabela a seguir descreve os cabeçalhos de solicitação obrigatórios e opcionais.
Cabeçalho da solicitação |
Descrição |
|---|---|
Autorização: Portador |
Obrigatórios. Token de portador de autorização. |
x-ms-principal-id |
Obrigatórios. O identificador principal. |
x-ms-client-request-id |
Opcional. O identificador de solicitação do cliente. |
x-ms-client-session-id |
Opcional. O identificador da sessão do cliente. |
x-ms-principal-liveid |
Opcional. O identificador live principal. |
Corpo da solicitação
Nenhum.
Resposta
A resposta inclui um código de status HTTP, um conjunto de cabeçalhos de resposta e um corpo de resposta.
Código de status
Uma operação bem-sucedida retorna o código de status 200 (OK).
Para obter informações sobre códigos de status, consulte Status e Códigos de Erro (Windows Gerenciamento de Serviço do Azure Pack).
Cabeçalhos de resposta
A resposta para essa operação inclui cabeçalhos HTTP padrão. Todos os cabeçalhos padrão estão em conformidade com a especificação de protocolo HTTP/1.1.
Corpo da resposta
A tabela a seguir descreve os principais elementos do corpo da resposta:
Nome do elemento |
Descrição |
|---|---|
Usuário |
O usuário que foi recuperado. Para obter mais informações, consulte User (common object). |
Exemplo
O exemplo de código a seguir mostra uma solicitação 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
O exemplo de código a seguir mostra uma resposta 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
}