Nodes - Create Node User

Szolgáltatás:

Batch Service

API verzió:

2025-06-01

Felhasználói fiókot ad hozzá a megadott Compute Node-hoz.
Felhasználói fiókot csak akkor adhatsz hozzá egy Compute Node-hoz, ha az tétlen vagy futó állapotban van. Mielőtt távolról bejelentkezhetnél egy Compute Node-ba, be kell állítanod az SSH és RDP hozzáférési portokat. További információért, lásd: https://learn.microsoft.com/azure/batch/pool-endpoint-configuration

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

Opcionális paraméterekkel:

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

URI paraméterek

Név	Ban	Szükséges	Típus	Leírás
endpoint	path	True	string (uri)	Batch-fiók végpontja (például: https://batchaccount.eastus2.batch.azure.com).
nodeId	path	True	string	Az a gép azonosítója, amelyen felhasználói fiókot szeretnél létrehozni.
poolId	path	True	string	A számítási csomópontot tartalmazó készlet azonosítója.
api-version	query	True	string minLength: 1	A művelethez használandó API-verzió.
timeOut	query		integer (int32)	A kiszolgáló által a kérés feldolgozásának maximális időtartama másodpercben. Az alapértelmezett érték 30 másodperc. Ha az érték nagyobb, mint 30, akkor az alapértelmezett értéket használják helyette.".

Kérés fejléce

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

Név	Szükséges	Típus	Leírás
client-request-id		string	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-rfc7231)	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 közvetlenül a REST API-t hívja meg.

Kérő Testület

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

Név	Szükséges	Típus	Leírás
name	True	string	A fiók felhasználóneve.
expiryTime		string (date-time)	Az az időpont, amikor a Számla lejár. Ha kihagyják, az alapértelmezett időpont 1 nappal a jelenlegi időponttól kezdve. Linux Compute Node-ok esetén az exparyTime akár egy napig is precíz.
isAdmin		boolean	Hogy a fióknak adminisztrátornak kell-e lennie a Compute Node-on. Az alapértelmezett érték hamis.
password		string (password)	A fiók jelszava. A jelszó szükséges Windows Compute Node-okhoz. Linux Compute Node-ok esetén a jelszó opcionálisan megadható az sshPublicKey tulajdonsággal együtt.
sshPublicKey		string	Az SSH nyilvános kulcs, amely távoli bejelentkezéshez használható a Compute Node-ba. A nyilvános kulcsnak kompatibilisnek kell lennie az OpenSSH kódolással, és alap 64-es kódolásúnak kell lennie. Ez a tulajdonság csak Linux Compute Node-okra lehet megadni. Ha ez egy Windows Compute Node esetén van megadva, akkor a Batch szolgáltatás elutasítja a kérést; ha közvetlenül a REST API-t hívod, a HTTP státuszkód 400 (Bad Request).

Válaszok

Név	Típus	Leírás
201 Created		A kérés sikeres volt, és ennek eredményeként új erőforrás jött létre. Fejlécek DataServiceId: string ETag: string Last-Modified: string client-request-id: string request-id: string
Other Status Codes	BatchError	Váratlan hibaválasz.

Biztonság

OAuth2Auth

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

Hatókörök

Név	Leírás
https://batch.core.windows.net//.default

Példák

Node create user

Mintakérés

HTTP

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



{
  "name": "userName",
  "isAdmin": false,
  "expiryTime": "2025-08-01T00:00:00Z",
  "password": "Password"
}

Mintaválasz

Állapotkód:

201

Meghatározások

Név	Leírás
BatchError	Az Azure Batch szolgáltatástól kapott hibaválasz.
BatchErrorDetail	Az Azure Batch-hibaválaszban szereplő további információk egy eleme.
BatchErrorMessage	Hibaüzenet érkezett egy Azure Batch-hibaválaszban.
BatchNodeUserCreateOptions	Az Azure Batch számítási csomóponton lévő RDP- vagy SSH-hozzáféréshez tartozó felhasználói fiók létrehozásának paraméterei.

BatchError

Tárgy

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

Név	Típus	Leírás
code	string	A hiba azonosítója. A kódok invariánsak, és programozott módon használhatók.
message	BatchErrorMessage	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, amelyek további részleteket tartalmaznak a hibáról.

BatchErrorDetail

Tárgy

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

Név	Típus	Leírás
key	string	Az Érték tulajdonság jelentését meghatározó azonosító.
value	string	A hibaválasz további információi.

BatchErrorMessage

Tárgy

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

Név	Típus	Leírás
lang	string	A hibaüzenet nyelvkódja.
value	string	Az üzenet szövege.

BatchNodeUserCreateOptions

Tárgy

Az Azure Batch számítási csomóponton lévő RDP- vagy SSH-hozzáféréshez tartozó felhasználói fiók létrehozásának paraméterei.

Név	Típus	Leírás
expiryTime	string (date-time)	Az az időpont, amikor a Számla lejár. Ha kihagyják, az alapértelmezett időpont 1 nappal a jelenlegi időponttól kezdve. Linux Compute Node-ok esetén az exparyTime akár egy napig is precíz.
isAdmin	boolean	Hogy a fióknak adminisztrátornak kell-e lennie a Compute Node-on. Az alapértelmezett érték hamis.
name	string	A fiók felhasználóneve.
password	string (password)	A fiók jelszava. A jelszó szükséges Windows Compute Node-okhoz. Linux Compute Node-ok esetén a jelszó opcionálisan megadható az sshPublicKey tulajdonsággal együtt.
sshPublicKey	string	Az SSH nyilvános kulcs, amely távoli bejelentkezéshez használható a Compute Node-ba. A nyilvános kulcsnak kompatibilisnek kell lennie az OpenSSH kódolással, és alap 64-es kódolásúnak kell lennie. Ez a tulajdonság csak Linux Compute Node-okra lehet megadni. Ha ez egy Windows Compute Node esetén van megadva, akkor a Batch szolgáltatás elutasítja a kérést; ha közvetlenül a REST API-t hívod, a HTTP státuszkód 400 (Bad Request).