Compute Node - Update User

Service:

Batch Service

API Version:

2023-11-01.18.0

Updates das Kennwort und die Ablaufzeit eines Benutzerkontos auf dem angegebenen Computeknoten.
Dieser Vorgang ersetzt alle aktualisierbaren Eigenschaften des Kontos. Wenn beispielsweise das expiryTime-Element nicht angegeben wird, wird der aktuelle Wert durch den Standardwert ersetzt und nicht unverändert gelassen. Sie können ein Benutzerkonto auf einem Computeknoten nur aktualisieren, wenn es sich im Leerlauf- oder Ausführungszustand befindet.

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

With optional parameters:

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

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
batchUrl	path	True	string	Die Basis-URL für alle Azure Batch-Dienstanforderungen.
nodeId	path	True	string	Die ID des Computers, auf dem Sie ein Benutzerkonto aktualisieren möchten.
poolId	path	True	string	Die ID des Pools, der den Computeknoten enthält.
userName	path	True	string	Der Name des zu aktualisierenden Benutzerkontos.
api-version	query	True	string	Client-API-Version.
timeout	query		integer int32	Die maximale Zeit, die der Server für die Verarbeitung der Anforderung in Sekunden aufwenden kann. Der Standardwert ist 30 Sekunden.

Anforderungsheader

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

Name	Erforderlich	Typ	Beschreibung
client-request-id		string uuid	Die vom Aufrufer generierte Anforderungsidentität in Form einer GUID ohne Dekoration wie geschweifte Klammern, z. B. 9C4D50EE-2D56-4CD3-8152-34347DC9F2B0.
return-client-request-id		boolean	Gibt an, ob der Server die Clientanforderungs-ID in der Antwort zurückgeben soll.
ocp-date		string date-time-rfc1123	Der Zeitpunkt, zu dem die Anforderung ausgestellt wurde. Clientbibliotheken legen dies in der Regel auf die aktuelle Systemuhrzeit fest. explizit festlegen, wenn Sie die REST-API direkt aufrufen.

Anforderungstext

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

Name	Typ	Beschreibung
expiryTime	string	Der Zeitpunkt, zu dem das Konto abläuft. Wenn nicht angegeben, ist der Standardwert 1 Tag ab der aktuellen Zeit. Für Linux-Computeknoten hat die expiryTime eine Genauigkeit von bis zu einem Tag.
password	string	Das Kennwort des Kontos. Das Kennwort ist für Windows-Computeknoten erforderlich (solche, die mit "cloudServiceConfiguration" erstellt oder mit "virtualMachineConfiguration" mithilfe einer Windows-Imagereferenz erstellt wurden). Für Linux-Computeknoten kann das Kennwort optional zusammen mit der sshPublicKey-Eigenschaft angegeben werden. Wenn es nicht angegeben wird, wird jedes vorhandene Kennwort entfernt.
sshPublicKey	string	Der öffentliche SSH-Schlüssel, der für die Remoteanmeldung beim Computeknoten verwendet werden kann. Der öffentliche Schlüssel sollte mit der OpenSSH-Codierung kompatibel sein und Base 64-codiert sein. Diese Eigenschaft kann nur für Linux-Computeknoten angegeben werden. Wenn dies für einen Windows-Computeknoten angegeben ist, lehnt der Batch-Dienst die Anforderung ab. Wenn Sie die REST-API direkt aufrufen, lautet der HTTP-status Code 400 (Ungültige Anforderung). Wenn er nicht angegeben wird, wird jeder vorhandene öffentliche SSH-Schlüssel entfernt.

Antworten

Name	Typ	Beschreibung
200 OK		Die Anforderung an den Batch-Dienst war erfolgreich. Headers client-request-id: string request-id: string ETag: string Last-Modified: string DataServiceId: string
Other Status Codes	BatchError	Der Fehler vom Batch-Dienst.

Sicherheit

azure_auth

Microsoft Entra OAuth 2.0-Authentifizierungscodeflow

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

Scopes

Name	Beschreibung
user_impersonation	Identitätswechsel Ihres Benutzerkontos

Authorization

Type: apiKey
In: header

Beispiele

Node update user

Sample Request

HTTP

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"
}

Sample Response

Status code:

200

Definitionen

Name	Beschreibung
BatchError	Eine Vom Azure Batch-Dienst empfangene Fehlerantwort.
BatchErrorDetail	Ein Element mit zusätzlichen Informationen, die in einer Azure Batch Fehlerantwort enthalten sind.
ErrorMessage	Eine Fehlermeldung, die in einer Azure Batch Fehlerantwort empfangen wird.
NodeUpdateUserParameter	Der Satz von Änderungen, die an einem Benutzerkonto auf einem Computeknoten vorgenommen werden sollen.

BatchError

Eine Vom Azure Batch-Dienst empfangene Fehlerantwort.

Name	Typ	Beschreibung
code	string	Ein Bezeichner für den Fehler. Codes sind unveränderlich und sollten programmgesteuert verwendet werden.
message	ErrorMessage	Eine Meldung, die den Fehler beschreibt, der für die Anzeige in einer Benutzeroberfläche geeignet sein soll.
values	BatchErrorDetail[]	Eine Sammlung von Schlüssel-Wert-Paaren, die zusätzliche Details zum Fehler enthält.

BatchErrorDetail

Ein Element mit zusätzlichen Informationen, die in einer Azure Batch Fehlerantwort enthalten sind.

Name	Typ	Beschreibung
key	string	Ein Bezeichner, der die Bedeutung der Value-Eigenschaft angibt.
value	string	Die zusätzlichen Informationen, die in der Fehlerantwort enthalten sind.

ErrorMessage

Eine Fehlermeldung, die in einer Azure Batch Fehlerantwort empfangen wird.

Name	Typ	Beschreibung
lang	string	Der Sprachcode der Fehlermeldung
value	string	Der Text der Meldung.

NodeUpdateUserParameter

Der Satz von Änderungen, die an einem Benutzerkonto auf einem Computeknoten vorgenommen werden sollen.

Name	Typ	Beschreibung
expiryTime	string	Der Zeitpunkt, zu dem das Konto abläuft. Wenn nicht angegeben, ist der Standardwert 1 Tag ab der aktuellen Zeit. Für Linux-Computeknoten hat die expiryTime eine Genauigkeit von bis zu einem Tag.
password	string	Das Kennwort des Kontos. Das Kennwort ist für Windows-Computeknoten erforderlich (solche, die mit "cloudServiceConfiguration" erstellt oder mit "virtualMachineConfiguration" mithilfe einer Windows-Imagereferenz erstellt wurden). Für Linux-Computeknoten kann das Kennwort optional zusammen mit der sshPublicKey-Eigenschaft angegeben werden. Wenn es nicht angegeben wird, wird jedes vorhandene Kennwort entfernt.
sshPublicKey	string	Der öffentliche SSH-Schlüssel, der für die Remoteanmeldung beim Computeknoten verwendet werden kann. Der öffentliche Schlüssel sollte mit der OpenSSH-Codierung kompatibel sein und Base 64-codiert sein. Diese Eigenschaft kann nur für Linux-Computeknoten angegeben werden. Wenn dies für einen Windows-Computeknoten angegeben ist, lehnt der Batch-Dienst die Anforderung ab. Wenn Sie die REST-API direkt aufrufen, lautet der HTTP-status Code 400 (Ungültige Anforderung). Wenn er nicht angegeben wird, wird jeder vorhandene öffentliche SSH-Schlüssel entfernt.