Compute Node - Update User

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 deixado não modificado. Você pode atualizar uma conta de usuário em um nó de computação somente quando ele estiver no estado ocioso ou em execução.

PUT {batchUrl}/pools/{poolId}/nodes/{nodeId}/users/{userName}?api-version=2020-09-01.12.0
PUT {batchUrl}/pools/{poolId}/nodes/{nodeId}/users/{userName}?timeout={timeout}&api-version=2020-09-01.12.0

Parâmetros de URI

Name In Required Type Description
batchUrl
path True
  • string

A URL base para todas as solicitações de serviço do lote do Azure.

nodeId
path True
  • string

A ID do computador no 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.

Cabeçalho da solicitação

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

Name Required Type Description
client-request-id
  • string
uuid

A identidade de solicitação gerada pelo chamador, na forma de um GUID sem decoração, como chaves, por exemplo, 9C4D50EE-2D56-4CD3-8152-34347DC9F2B0.

return-client-request-id
  • boolean

Se o servidor deve retornar a ID de solicitação de cliente na resposta.

ocp-date
  • string
date-time-rfc1123

A hora em que a solicitação foi emitida. Bibliotecas de cliente normalmente definem isso para a hora atual do relógio do sistema; Defina-a explicitamente se você estiver chamando a API REST diretamente.

Corpo da solicitação

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

Name Type Description
expiryTime
  • string

A hora em que a conta deve expirar.
Se omitido, o padrão será 1 dia a partir da hora atual. Para nós de computação do Linux, o expiryTime tem uma precisão de até um dia.

password
  • string

A senha da conta.
A senha é necessária para os nós de computação do Windows (aqueles criados com ' cloudServiceConfiguration ' ou criados com ' virtualMachineConfiguration ' usando uma referência de imagem do Windows). Para nós de computação do Linux, a senha pode, opcionalmente, ser especificada junto com a propriedade sshPublicKey. Se omitido, qualquer senha existente será removida.

sshPublicKey
  • string

A chave pública SSH que pode ser usada para logon remoto no nó de computação.
A chave pública deve ser compatível com a codificação OpenSSH e deve ser codificada com base 64. Essa propriedade pode ser especificada somente para nós de computação do Linux. Se isso for especificado para um nó de computação do Windows, o serviço de lote rejeitará a solicitação; Se você estiver chamando a API REST diretamente, o código de status HTTP será 400 (solicitação inadequada). Se omitido, qualquer chave pública SSH existente será removida.

Respostas

Name Type Description
200 OK

A solicitação para o serviço de lote foi bem-sucedida.

Headers

  • client-request-id: string
  • request-id: string
  • ETag: string
  • Last-Modified: string
  • DataServiceId: string
Other Status Codes

O erro do serviço de lote.

Segurança

azure_auth

Fluxo de OAuth2 de Azure Active Directory

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name Description
user_impersonation Representar sua conta de usuário

Authorization

Type: apiKey
In: header

Exemplos

Node update user

Sample Request

PUT account.region.batch.azure.com/pools/poolId/nodes/tvm-1695681911_1-20161121t182739z/users/userName?api-version=2020-09-01.12.0
client-request-id: 00000000-0000-0000-0000-000000000000
ocp-date: Fri, 17 Feb 2017 00:00:00 GMT
{
  "password": "12345",
  "expiryTime": "2016-11-27T00:45:48.7320857Z"
}

Sample Response

Definições

BatchError

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

BatchErrorDetail

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

ErrorMessage

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

NodeUpdateUserParameter

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

BatchError

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

Name Type Description
code
  • string

Um identificador para o erro. Os códigos são invariáveis e devem ser consumidos programaticamente.

message

Uma mensagem que descreve o erro, destinada a ser adequada para exibição em uma interface do usuário.

values

Uma coleção de pares chave-valor que contém detalhes adicionais sobre o erro.

BatchErrorDetail

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

Name Type Description
key
  • string

Um identificador que especifica o significado da propriedade Value.

value
  • string

As informações adicionais incluídas na resposta de erro.

ErrorMessage

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

Name Type Description
lang
  • string

O código de idioma da mensagem de erro

value
  • string

O texto da mensagem.

NodeUpdateUserParameter

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

Name Type Description
expiryTime
  • string

A hora em que a conta deve expirar.
Se omitido, o padrão será 1 dia a partir da hora atual. Para nós de computação do Linux, o expiryTime tem uma precisão de até um dia.

password
  • string

A senha da conta.
A senha é necessária para os nós de computação do Windows (aqueles criados com ' cloudServiceConfiguration ' ou criados com ' virtualMachineConfiguration ' usando uma referência de imagem do Windows). Para nós de computação do Linux, a senha pode, opcionalmente, ser especificada junto com a propriedade sshPublicKey. Se omitido, qualquer senha existente será removida.

sshPublicKey
  • string

A chave pública SSH que pode ser usada para logon remoto no nó de computação.
A chave pública deve ser compatível com a codificação OpenSSH e deve ser codificada com base 64. Essa propriedade pode ser especificada somente para nós de computação do Linux. Se isso for especificado para um nó de computação do Windows, o serviço de lote rejeitará a solicitação; Se você estiver chamando a API REST diretamente, o código de status HTTP será 400 (solicitação inadequada). Se omitido, qualquer chave pública SSH existente será removida.