Recuperar um Utilizador
Aplica-se a: Windows Azure Pack
Recupera um utilizador.
Pedir
Substitua <o ServiceMgmt> pelo seu endereço de ponto final API de Gestão de Serviços. Substitua <o Porto> por 30005 para a API do inquilino ou 30004 para o administrador API. Substitua <o Nome> do Utilizador pelo nome de utilizador.
Método |
URI do pedido |
Versão HTTP |
---|---|---|
GET |
<https:// ServiceMgmt>:<Porta>/utilizadores/<UserName> |
HTTP/1.1 |
Parâmetros do URI
Nenhum.
Pedido cabeçalhos
A tabela seguinte descreve os cabeçalhos de pedido necessários e opcionais.
Cabeçalho do pedido |
Description |
---|---|
Autorização: Portador |
Obrigatório. Ficha do portador da autorização. |
x-ms-principal-id |
Obrigatório. O identificador principal. |
x-ms-cliente-pedido-id |
Opcional. O identificador de pedido do cliente. |
x-ms-cliente-sessão-id |
Opcional. O identificador da sessão do cliente. |
x-ms-principal-liveid |
Opcional. O principal identificador ao vivo. |
Corpo do Pedido
Nenhum.
Resposta
A resposta inclui um código de estado HTTP, um conjunto de cabeçalhos de resposta e um corpo de resposta.
Código de Estado
Uma operação bem sucedida devolve o código de estado 200 (OK).
Para obter informações sobre códigos de estado, consulte Códigos de Estado e de Erro (Windows Gestão de Serviços de Pacote Azure).
Cabeçalhos de Resposta
A resposta para esta operação inclui cabeçalhos HTTP padrão. Todos os cabeçalhos standard estão de acordo com a especificação do protocolo HTTP/1.1.
Corpo de Resposta
A tabela a seguir descreve os elementos-chave do organismo de resposta:
Nome do elemento |
Descrição |
---|---|
Utilizador |
O utilizador que foi recuperado. Para obter mais informações, consulte o Utilizador (objeto comum). |
Exemplo
O seguinte exemplo de código mostra um pedido do Utilizador Get .
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 seguinte exemplo de código mostra uma resposta do Utilizador Get .
{
"Name": "tom@tommy.com",
"Email": "Tom@tommy.com",
"State": 1,
"CreatedTime": "2013-06-19T17:09:45.387",
"SubscriptionCount": 1,
"ActivationSyncState": 0,
"LastErrorMessage": null
}