Atualizar um usuário
Aplica-se a: Windows Azure Pack
Atualiza um usuário.
Solicitação
Substitua <ServiceMgmt> pelo endereço do ponto de extremidade da API de Gerenciamento de Serviços. Substitua <a Porta> por 30005 para a API de locatário ou 30004 para a API de administrador. Substitua <a porta> por 30005 para a API de locatário ou 30004 para a API de administrador. Substitua <UserName> pelo nome de usuário do usuário a ser atualizado.
Método |
URI da solicitação |
Versão HTTP |
|---|---|---|
PUT |
<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 de sessão do cliente. |
x-ms-principal-liveid |
Opcional. O principal identificador ao vivo. |
Corpo da solicitação
A tabela a seguir descreve os elementos do corpo da solicitação.
Nome do elemento |
Descrição |
|---|---|
Usuário |
As novas informações para o usuário. Para obter mais informações, consulte Usuário (objeto Comum). |
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ços 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 do 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 atualizado. Para obter mais informações, consulte Usuário (objeto Comum). |
Exemplo
O exemplo de código a seguir mostra uma solicitação atualizar usuário .
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."
}
O exemplo de código a seguir mostra uma resposta do Usuário de Atualização .
{
"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."
}