Compute Node - Update User

Szolgáltatás:

Batch Service

API-verzió:

2023-11-01.18.0

Frissítések egy felhasználói fiók jelszavát és lejárati idejét a megadott számítási csomóponton.
Ez a művelet a Fiók összes frissíthető tulajdonságát lecseréli. Ha például a expiryTime elem nincs megadva, a rendszer az aktuális értéket az alapértelmezett értékre cseréli, és nem hagyja változatlanul. A számítási csomópont felhasználói fiókját csak akkor frissítheti, ha tétlen vagy futó állapotban van.

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

Opcionális paraméterekkel:

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

URI-paraméterek

Name	In	Kötelező	Típus	Description
batchUrl	path	True	string	Az összes Azure Batch szolgáltatáskérés alap URL-címe.
nodeId	path	True	string	Annak a gépnek az azonosítója, amelyen frissíteni szeretné a felhasználói fiókot.
poolId	path	True	string	A számítási csomópontot tartalmazó készlet azonosítója.
userName	path	True	string	A frissíteni kívánt felhasználói fiók neve.
api-version	query	True	string	Ügyfél API-verziója.
timeout	query		integer int32	A kérés feldolgozásának maximális időtartama másodpercben. Az alapértelmezett érték 30 mp.

Kérelem fejléce

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

Name	Kötelező	Típus	Description
client-request-id		string uuid	A hívó által generált kérési identitás guid formában, díszítés nélkül, például kapcsos zárójelek, például 9C4D50EE-2D56-4CD3-8152-34347DC9F2B0.
return-client-request-id		boolean	Azt jelzi, hogy a kiszolgálónak vissza kell-e adnia az ügyfél-kérelem azonosítóját a válaszban.
ocp-date		string date-time-rfc1123	A kérelem kiállításának időpontja. Az ügyfélkódtárak ezt általában az aktuális rendszeróra-időpontra állítják be; állítsa be explicit módon, ha a REST API-t közvetlenül hívja meg.

Kérelem törzse

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

Name	Típus	Description
expiryTime	string	A fiók lejáratának időpontja. Ha nincs megadva, az alapértelmezett érték az aktuális időponttól számítva 1 nap. Linux számítási csomópontok esetén a expiryTime pontossága akár egy nap is lehet.
password	string	A fiók jelszava. A jelszó szükséges a Windows számítási csomópontokhoz (amelyek a "cloudServiceConfiguration"-tal, vagy a "virtualMachineConfiguration" használatával, Windows rendszerkép-referenciával vannak létrehozva). Linux számítási csomópontok esetén a jelszó opcionálisan megadható az sshPublicKey tulajdonsággal együtt. Ha nincs megadva, a rendszer eltávolítja a meglévő jelszavakat.
sshPublicKey	string	A számítási csomópontra való távoli bejelentkezéshez használható nyilvános SSH-kulcs. A nyilvános kulcsnak kompatibilisnek kell lennie az OpenSSH-kódolással, és 64-edik alapkóddal kell lennie. Ez a tulajdonság csak Linux számítási csomópontokhoz adható meg. Ha ez egy Windows számítási csomóponthoz van megadva, a Batch szolgáltatás elutasítja a kérést; Ha közvetlenül a REST API-t hívja meg, a HTTP-állapotkód 400 (hibás kérés). Ha nincs megadva, a rendszer eltávolítja a meglévő nyilvános SSH-kulcsot.

Válaszok

Name	Típus	Description
200 OK		A Batch szolgáltatásnak küldött kérés sikeres volt. Fejlécek client-request-id: string request-id: string ETag: string Last-Modified: string DataServiceId: string
Other Status Codes	BatchError	A Batch szolgáltatás hibája.

Biztonság

azure_auth

Microsoft Entra OAuth 2.0 hitelesítési kódfolyamata

Típus: oauth2
Folyamat: implicit
Engedélyezési URL: https://login.microsoftonline.com/common/oauth2/authorize

Hatókörök

Name	Description
user_impersonation	A felhasználói fiók megszemélyesítése

Authorization

Típus: apiKey
In: header

Példák

Node update user

Mintakérelem

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

Mintaválasz

Állapotkód:

200

Definíciók

Name	Description
BatchError	A Azure Batch szolgáltatástól kapott hibaválasz.
BatchErrorDetail	A Azure Batch hibaválaszban szereplő további információk egy eleme.
ErrorMessage	Hibaüzenet érkezett egy Azure Batch hibaválaszban.
NodeUpdateUserParameter	A számítási csomópont felhasználói fiókján végrehajtott módosítások halmaza.

BatchError

A Azure Batch szolgáltatástól kapott hibaválasz.

Name	Típus	Description
code	string	A hiba azonosítója. A kódok invariánsak, és programozott módon használhatók.
message	ErrorMessage	A hibát leíró üzenet, amely alkalmas a felhasználói felületen való megjelenítésre.
values	BatchErrorDetail[]	Kulcs-érték párok gyűjteménye, amely további részleteket tartalmaz a hibáról.

BatchErrorDetail

A Azure Batch hibaválaszban szereplő további információk egy eleme.

Name	Típus	Description
key	string	Az Érték tulajdonság jelentését meghatározó azonosító.
value	string	A hibaválaszban szereplő további információk.

ErrorMessage

Hibaüzenet érkezett egy Azure Batch hibaválaszban.

Name	Típus	Description
lang	string	A hibaüzenet nyelvkódja
value	string	Az üzenet szövege.

NodeUpdateUserParameter

A számítási csomópont felhasználói fiókján végrehajtott módosítások halmaza.

Name	Típus	Description
expiryTime	string	A fiók lejáratának időpontja. Ha nincs megadva, az alapértelmezett érték az aktuális időponttól számítva 1 nap. Linux számítási csomópontok esetén a expiryTime pontossága akár egy nap is lehet.
password	string	A fiók jelszava. A jelszó szükséges a Windows számítási csomópontokhoz (amelyek a "cloudServiceConfiguration"-tal, vagy a "virtualMachineConfiguration" használatával, Windows rendszerkép-referenciával vannak létrehozva). Linux számítási csomópontok esetén a jelszó opcionálisan megadható az sshPublicKey tulajdonsággal együtt. Ha nincs megadva, a rendszer eltávolítja a meglévő jelszavakat.
sshPublicKey	string	A számítási csomópontra való távoli bejelentkezéshez használható nyilvános SSH-kulcs. A nyilvános kulcsnak kompatibilisnek kell lennie az OpenSSH-kódolással, és 64-edik alapkóddal kell lennie. Ez a tulajdonság csak Linux számítási csomópontokhoz adható meg. Ha ez egy Windows számítási csomóponthoz van megadva, a Batch szolgáltatás elutasítja a kérést; Ha közvetlenül a REST API-t hívja meg, a HTTP-állapotkód 400 (hibás kérés). Ha nincs megadva, a rendszer eltávolítja a meglévő nyilvános SSH-kulcsot.