Partilhar via


Atualizar um Utilizador

 

Aplica-se a: Windows Azure Pack

Atualizações 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 Porto> por 30005 para a API do inquilino, ou 30004 para o administrador API. Substitua <o Nome do Utilizador> pelo nome de utilizador do utilizador que deverá ser atualizado.

Método

URI do pedido

Versão HTTP

PUT

<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

A tabela seguinte descreve os elementos do corpo de pedido.

Nome do elemento

Descrição

Utilizador

A nova informação para o utilizador. Para obter mais informações, consulte o Utilizador (objeto comum).

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 atualizado. Para obter mais informações, consulte o Utilizador (objeto comum).

Exemplo

O seguinte exemplo de código mostra um pedido do Utilizador de Atualização .

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 seguinte exemplo de código mostra uma resposta do utilizador 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."
}

Consulte também

Interfaces comuns de utilizador