Compartir a través de


Compute Node - Update User

Novedades la contraseña y la hora de expiración de una cuenta de usuario en el nodo de proceso especificado.
Esta operación reemplaza todas las propiedades actualizables de la cuenta. Por ejemplo, si no se especifica el elemento expiryTime, el valor actual se reemplaza por el valor predeterminado, no se deja sin modificar. Puede actualizar una cuenta de usuario en un nodo de proceso solo cuando está en estado inactivo o en ejecución.

PUT {batchUrl}/pools/{poolId}/nodes/{nodeId}/users/{userName}?api-version=2023-11-01.18.0
PUT {batchUrl}/pools/{poolId}/nodes/{nodeId}/users/{userName}?timeout={timeout}&api-version=2023-11-01.18.0

Parámetros de identificador URI

Nombre En Requerido Tipo Description
batchUrl
path True

string

Dirección URL base de todas las solicitudes de servicio de Azure Batch.

nodeId
path True

string

Identificador de la máquina en la que desea actualizar una cuenta de usuario.

poolId
path True

string

Identificador del grupo que contiene el nodo de proceso.

userName
path True

string

Nombre de la cuenta de usuario que se va a actualizar.

api-version
query True

string

Versión de la API de cliente.

timeout
query

integer

int32

Tiempo máximo que el servidor puede dedicar a procesar la solicitud, en segundos. El valor predeterminado es 30 segundos.

Encabezado de la solicitud

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

Nombre Requerido Tipo Description
client-request-id

string

uuid

La identidad de solicitud generada por el autor de la llamada, en forma de GUID sin decoración como llaves, por ejemplo, 9C4D50EE-2D56-4CD3-8152-34347DC9F2B0.

return-client-request-id

boolean

Si el servidor debe devolver el client-request-id en la respuesta.

ocp-date

string

date-time-rfc1123

Hora en que se emitió la solicitud. Las bibliotecas cliente suelen establecer esto en la hora del reloj del sistema actual; establézcalo explícitamente si llama directamente a la API REST.

Cuerpo de la solicitud

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

Nombre Tipo Description
expiryTime

string

Hora a la que debe expirar la cuenta.
Si se omite, el valor predeterminado es 1 día de la hora actual. En el caso de los nodos de proceso de Linux, expiryTime tiene una precisión hasta un día.

password

string

Contraseña de la cuenta.
La contraseña es necesaria para los nodos de proceso de Windows (los creados con "cloudServiceConfiguration" o creados con "virtualMachineConfiguration" mediante una referencia de imagen de Windows). En el caso de los nodos de proceso de Linux, la contraseña se puede especificar opcionalmente junto con la propiedad sshPublicKey. Si se omite, se quita cualquier contraseña existente.

sshPublicKey

string

Clave pública SSH que se puede usar para el inicio de sesión remoto en el nodo de proceso.
La clave pública debe ser compatible con la codificación OpenSSH y debe estar codificada en base 64. Esta propiedad solo se puede especificar para los nodos de proceso de Linux. Si se especifica para un nodo de proceso de Windows, el servicio Batch rechaza la solicitud; Si va a llamar directamente a la API REST, el código de estado HTTP es 400 (solicitud incorrecta). Si se omite, se quita cualquier clave pública SSH existente.

Respuestas

Nombre Tipo Description
200 OK

La solicitud al servicio Batch se realizó correctamente.

Encabezados

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

BatchError

Error del servicio Batch.

Seguridad

azure_auth

Microsoft Entra flujo de código de autenticación de OAuth 2.0

Tipo: oauth2
Flujo: implicit
Dirección URL de autorización: https://login.microsoftonline.com/common/oauth2/authorize

Ámbitos

Nombre Description
user_impersonation Suplantación de su cuenta de usuario

Authorization

Tipo: apiKey
En: header

Ejemplos

Node update user

Solicitud de ejemplo

PUT account.region.batch.azure.com/pools/poolId/nodes/tvm-1695681911_1-20161121t182739z/users/userName?api-version=2023-11-01.18.0



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

Respuesta de muestra

Definiciones

Nombre Description
BatchError

Respuesta de error recibida del servicio Azure Batch.

BatchErrorDetail

Elemento de información adicional incluida en una respuesta de error Azure Batch.

ErrorMessage

Mensaje de error recibido en una respuesta de error Azure Batch.

NodeUpdateUserParameter

Conjunto de cambios que se van a realizar en una cuenta de usuario en un nodo de proceso.

BatchError

Respuesta de error recibida del servicio Azure Batch.

Nombre Tipo Description
code

string

Identificador del error. Los códigos son invariables y están diseñados para consumirse mediante programación.

message

ErrorMessage

Mensaje que describe el error, diseñado para ser adecuado para su presentación en una interfaz de usuario.

values

BatchErrorDetail[]

Colección de pares clave-valor que contienen detalles adicionales sobre el error.

BatchErrorDetail

Elemento de información adicional incluida en una respuesta de error Azure Batch.

Nombre Tipo Description
key

string

Identificador que especifica el significado de la propiedad Value.

value

string

Información adicional incluida con la respuesta de error.

ErrorMessage

Mensaje de error recibido en una respuesta de error Azure Batch.

Nombre Tipo Description
lang

string

Código de idioma del mensaje de error

value

string

Texto del mensaje.

NodeUpdateUserParameter

Conjunto de cambios que se van a realizar en una cuenta de usuario en un nodo de proceso.

Nombre Tipo Description
expiryTime

string

Hora a la que debe expirar la cuenta.
Si se omite, el valor predeterminado es 1 día de la hora actual. En el caso de los nodos de proceso de Linux, expiryTime tiene una precisión hasta un día.

password

string

Contraseña de la cuenta.
La contraseña es necesaria para los nodos de proceso de Windows (los creados con "cloudServiceConfiguration" o creados con "virtualMachineConfiguration" mediante una referencia de imagen de Windows). En el caso de los nodos de proceso de Linux, la contraseña se puede especificar opcionalmente junto con la propiedad sshPublicKey. Si se omite, se quita cualquier contraseña existente.

sshPublicKey

string

Clave pública SSH que se puede usar para el inicio de sesión remoto en el nodo de proceso.
La clave pública debe ser compatible con la codificación OpenSSH y debe estar codificada en base 64. Esta propiedad solo se puede especificar para los nodos de proceso de Linux. Si se especifica para un nodo de proceso de Windows, el servicio Batch rechaza la solicitud; Si va a llamar directamente a la API REST, el código de estado HTTP es 400 (solicitud incorrecta). Si se omite, se quita cualquier clave pública SSH existente.