Nodes - Replace Node User

Služba:: Batch Service

Verze rozhraní API:: 2025-06-01

Aktualizuje heslo a čas vypršení uživatelského účtu na určeném Compute Node.
Tato operace nahrazuje všechny aktualizovatelné vlastnosti účtu. Například pokud není specifikován prvek expiryTime, aktuální hodnota je nahrazena výchozí hodnotou, nikoli ponechána nezměněna. Uživatelský účet na Compute Node můžete aktualizovat pouze tehdy, když je v nečinnosti nebo běžícím stavu.

PUT {endpoint}/pools/{poolId}/nodes/{nodeId}/users/{userName}?api-version=2025-06-01

S volitelnými parametry:

PUT {endpoint}/pools/{poolId}/nodes/{nodeId}/users/{userName}?api-version=2025-06-01&timeOut={timeOut}

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
endpoint	path	True	string (uri)	Koncový bod účtu Batch (například: https://batchaccount.eastus2.batch.azure.com).
nodeId	path	True	string	ID zařízení, na kterém chcete aktualizovat uživatelský účet.
poolId	path	True	string	ID fondu, který obsahuje výpočetní uzel.
userName	path	True	string	Název uživatelského účtu pro aktualizaci.
api-version	query	True	string minLength: 1	Verze rozhraní API, která se má použít pro tuto operaci.
timeOut	query		integer (int32)	Maximální doba, po kterou může server strávit zpracováním požadavku v sekundách. Výchozí hodnota je 30 sekund. Pokud je hodnota větší než 30, použije se výchozí hodnota.".

Hlavička požadavku

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

Name	Typ	Description
client-request-id	string	Identita požadavku vygenerovaná volajícím ve formě identifikátoru GUID bez dekorace, jako jsou složené závorky, například 9C4D50EE-2D56-4CD3-8152-34347DC9F2B0.
return-client-request-id	boolean	Určuje, jestli má server v odpovědi vrátit ID požadavku klienta.
ocp-date	string (date-time-rfc7231)	Čas vydání žádosti. Klientské knihovny obvykle nastavily aktuální systémový čas; explicitně ji nastavte, pokud voláte přímo rozhraní REST API.

Text požadavku

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

Name	Typ	Description
expiryTime	string (date-time)	Čas, kdy by měl účet vypršet. Pokud je vynecháno, výchozí stav je 1 den od aktuálního času. U výpočetních uzlů Linuxu má expiryTime přesnost až jeden den.
password	string (password)	Heslo k účtu. Heslo je vyžadováno pro Windows Compute Nodes. Pro Linux Compute Nodes lze heslo volitelně zadat spolu s vlastností sshPublicKey. Pokud je vynecháno, jakékoli existující heslo je odstraněno.
sshPublicKey	string	Veřejný SSH klíč, který lze použít pro vzdálené přihlášení do Compute Node. Veřejný klíč by měl být kompatibilní s OpenSSH kódováním a měl by být kódován v base 64. Tato vlastnost může být specifikována pouze pro Linux Compute Nodes. Pokud je toto specifikováno pro Windows Compute Node, pak batch služba požadavek odmítne; pokud voláte přímo REST API, HTTP stavový kód je 400 (Špatný požadavek). Pokud je vynechán, jakýkoli existující veřejný SSH klíč je odstraněn.

Odpovědi

Name	Typ	Description
200 OK		Požadavek byl úspěšný. Hlavičky DataServiceId: string ETag: string Last-Modified: string client-request-id: string request-id: string
Other Status Codes	BatchError	Neočekávaná chybová odpověď

Name

Typ

Description

200 OK

Požadavek byl úspěšný.

Hlavičky

DataServiceId: string
ETag: string
Last-Modified: string
client-request-id: string
request-id: string

Other Status Codes

BatchError

Neočekávaná chybová odpověď

Zabezpečení

OAuth2Auth

Typ: oauth2
Tok: implicit
URL autorizace: https://login.microsoftonline.com/common/oauth2/v2.0/authorize

Rozsahy

Name	Description
https://batch.core.windows.net//.default

Příklady

Node update user

Ukázkový požadavek

HTTP

PUT {endpoint}/pools/poolId/nodes/tvm-1695681911_1-20161121t182739z/users/userName?api-version=2025-06-01



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

Ukázková odpověď

Stavový kód:: 200

Definice

Name	Description
BatchError	Odpověď na chybu přijatá ze služby Azure Batch
BatchErrorDetail	Položka dalších informací zahrnutých v odpovědi na chybu služby Azure Batch
BatchErrorMessage	V odpovědi na chybu služby Azure Batch se zobrazila chybová zpráva.
BatchNodeUserUpdateOptions	Parametry pro aktualizaci uživatelského účtu pro přístup RDP nebo SSH na výpočetním uzlu služby Azure Batch

BatchError

Objekt

Odpověď na chybu přijatá ze služby Azure Batch

Name	Typ	Description
code	string	Identifikátor chyby. Kódy jsou invariantní a mají být využity programově.
message	BatchErrorMessage	Zpráva popisující chybu, která má být vhodná pro zobrazení v uživatelském rozhraní.
values	BatchErrorDetail[]	Kolekce párů klíč-hodnota obsahující další podrobnosti o chybě.

BatchErrorDetail

Objekt

Položka dalších informací zahrnutých v odpovědi na chybu služby Azure Batch

Name	Typ	Description
key	string	Identifikátor určující význam vlastnosti Value.
value	string	Další informace zahrnuté v odpovědi na chybu.

BatchErrorMessage

Objekt

V odpovědi na chybu služby Azure Batch se zobrazila chybová zpráva.

Name	Typ	Description
lang	string	Jazykový kód chybové zprávy.
value	string	Text zprávy.

BatchNodeUserUpdateOptions

Objekt

Parametry pro aktualizaci uživatelského účtu pro přístup RDP nebo SSH na výpočetním uzlu služby Azure Batch

Name	Typ	Description
expiryTime	string (date-time)	Čas, kdy by měl účet vypršet. Pokud je vynecháno, výchozí stav je 1 den od aktuálního času. U výpočetních uzlů Linuxu má expiryTime přesnost až jeden den.
password	string (password)	Heslo k účtu. Heslo je vyžadováno pro Windows Compute Nodes. Pro Linux Compute Nodes lze heslo volitelně zadat spolu s vlastností sshPublicKey. Pokud je vynecháno, jakékoli existující heslo je odstraněno.
sshPublicKey	string	Veřejný SSH klíč, který lze použít pro vzdálené přihlášení do Compute Node. Veřejný klíč by měl být kompatibilní s OpenSSH kódováním a měl by být kódován v base 64. Tato vlastnost může být specifikována pouze pro Linux Compute Nodes. Pokud je toto specifikováno pro Windows Compute Node, pak batch služba požadavek odmítne; pokud voláte přímo REST API, HTTP stavový kód je 400 (Špatný požadavek). Pokud je vynechán, jakýkoli existující veřejný SSH klíč je odstraněn.