Compute Node - Update User

Serviço:

Batch Service

Versão da API:

2024-07-01.20.0

Atualiza a senha e o tempo de expiração de uma Conta de usuário no Nó de Computação especificado.
Esta operação substitui todas as propriedades atualizáveis da Conta. Por exemplo, se o elemento expiryTime não for especificado, o valor atual será substituído pelo valor padrão, não sendo modificado. Você pode atualizar uma conta de usuário em um nó de computação somente quando ela estiver no estado ocioso ou em execução.

PUT {batchUrl}/pools/{poolId}/nodes/{nodeId}/users/{userName}?api-version=2024-07-01.20.0

Com parâmetros opcionais:

PUT {batchUrl}/pools/{poolId}/nodes/{nodeId}/users/{userName}?timeout={timeout}&api-version=2024-07-01.20.0

Parâmetros do URI

Name	Em	Necessário	Tipo	Description
batchUrl	path	True	string	A URL base para todas as solicitações de serviço do Lote do Azure.
nodeId	path	True	string	O ID da máquina na qual você deseja atualizar uma conta de usuário.
poolId	path	True	string	A ID do Pool que contém o Nó de Computação.
userName	path	True	string	O nome da conta de usuário a ser atualizada.
api-version	query	True	string	Versão da API do cliente.
timeout	query		integer (int32)	O tempo máximo que o servidor pode gastar processando a solicitação, em segundos. O padrão é 30 segundos. Se o valor for maior que 30, o padrão será usado.

Cabeçalho do Pedido

Media Types: "application/json; odata=minimalmetadata"

Name	Necessário	Tipo	Description
client-request-id		string (uuid)	A identidade de solicitação gerada pelo chamador, na forma de um GUID sem decoração, como chaves encaracoladas, por exemplo, 9C4D50EE-2D56-4CD3-8152-34347DC9F2B0.
return-client-request-id		boolean	Se o servidor deve retornar o client-request-id na resposta.
ocp-date		string (date-time-rfc1123)	A hora em que o pedido foi emitido. As bibliotecas de cliente normalmente definem isso para a hora atual do relógio do sistema; defina-o explicitamente se você estiver chamando a API REST diretamente.

Corpo do Pedido

Media Types: "application/json; odata=minimalmetadata"

Name	Tipo	Description
expiryTime	string (date-time)	O momento em que a Conta deve expirar. Se omitido, o padrão é 1 dia a partir da hora atual. Para Linux Compute Nodes, o expiryTime tem uma precisão de até um dia.
password	string	A palavra-passe da Conta. A senha é necessária para nós de computação do Windows. Para Linux Compute Nodes, a senha pode opcionalmente ser especificada junto com a propriedade sshPublicKey. Se omitida, qualquer senha existente será removida.
sshPublicKey	string	A chave pública SSH que pode ser usada para login remoto no nó de computação. A chave pública deve ser compatível com a codificação OpenSSH e deve ser codificada na base 64. Esta propriedade pode ser especificada apenas para nós de computação do Linux. Se isso for especificado para um nó de computação do Windows, o serviço em lote rejeitará a solicitação; se você estiver chamando a API REST diretamente, o código de status HTTP será 400 (Solicitação incorreta). Se omitida, qualquer chave pública SSH existente é removida.

Respostas

Name	Tipo	Description
200 OK		A solicitação para o serviço de lote foi bem-sucedida. Cabeçalhos client-request-id: string request-id: string ETag: string Last-Modified: string DataServiceId: string
Other Status Codes	BatchError	O erro do serviço de lote.

Segurança

azure_auth

Fluxo de código de autenticação do Microsoft Entra OAuth 2.0

Tipo: oauth2
Fluxo: implicit
URL de Autorização: https://login.microsoftonline.com/common/oauth2/authorize

Âmbitos

Name	Description
user_impersonation	Personificar a sua conta de utilizador

Authorization

Tipo: apiKey
Em: header

Exemplos

Node update user

Pedido de amostra

HTTP

PUT account.region.batch.azure.com/pools/poolId/nodes/tvm-1695681911_1-20161121t182739z/users/userName?api-version=2024-07-01.20.0



{
  "password": "12345",
  "expiryTime": "2016-11-27T00:45:48.7320857Z"
}

Resposta da amostra

Código de estado:

200

Definições

Name	Description
BatchError	Uma resposta de erro recebida do serviço Batch do Azure.
BatchErrorDetail	Um item de informações adicionais incluído em uma resposta de erro do Lote do Azure.
ErrorMessage	Uma mensagem de erro recebida em uma resposta de erro do Lote do Azure.
NodeUpdateUserParameter	O conjunto de alterações a serem feitas em uma conta de usuário em um nó de computação.

BatchError

Object

Uma resposta de erro recebida do serviço Batch do Azure.

Name	Tipo	Description
code	string	Um identificador para o erro. Os códigos são invariantes e destinam-se a ser consumidos programaticamente.
message	ErrorMessage	Uma mensagem descrevendo o erro, destinada a ser adequada para exibição em uma interface do usuário.
values	BatchErrorDetail[]	Uma coleção de pares chave-valor contendo detalhes adicionais sobre o erro.

BatchErrorDetail

Object

Um item de informações adicionais incluído em uma resposta de erro do Lote do Azure.

Name	Tipo	Description
key	string	Um identificador que especifica o significado da propriedade Value.
value	string	As informações adicionais incluídas com a resposta de erro.

ErrorMessage

Object

Uma mensagem de erro recebida em uma resposta de erro do Lote do Azure.

Name	Tipo	Description
lang	string	O código de idioma da mensagem de erro
value	string	O texto da mensagem.

NodeUpdateUserParameter

Object

O conjunto de alterações a serem feitas em uma conta de usuário em um nó de computação.

Name	Tipo	Description
expiryTime	string (date-time)	O momento em que a Conta deve expirar. Se omitido, o padrão é 1 dia a partir da hora atual. Para Linux Compute Nodes, o expiryTime tem uma precisão de até um dia.
password	string	A palavra-passe da Conta. A senha é necessária para nós de computação do Windows. Para Linux Compute Nodes, a senha pode opcionalmente ser especificada junto com a propriedade sshPublicKey. Se omitida, qualquer senha existente será removida.
sshPublicKey	string	A chave pública SSH que pode ser usada para login remoto no nó de computação. A chave pública deve ser compatível com a codificação OpenSSH e deve ser codificada na base 64. Esta propriedade pode ser especificada apenas para nós de computação do Linux. Se isso for especificado para um nó de computação do Windows, o serviço em lote rejeitará a solicitação; se você estiver chamando a API REST diretamente, o código de status HTTP será 400 (Solicitação incorreta). Se omitida, qualquer chave pública SSH existente é removida.