Nodes - Create Node User

Hizmet:

Batch Service

API Sürümü:

2025-06-01

Belirlenen Hesaplama Düğümü'ne bir kullanıcı hesabı ekler.
Bir Compute Node'a kullanıcı Hesabı, sadece boşta veya çalışırken ekleyebilirsiniz. Bir Compute Node'a uzaktan giriş yapamadan önce SSH ve RDP için erişim portlarını yapılandırmanız gerekir. Daha fazla bilgi için bkz. https://learn.microsoft.com/azure/batch/pool-endpoint-configuration

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

İsteğe bağlı parametrelerle:

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

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
endpoint	path	True	string (uri)	Batch hesabı uç noktası (örneğin: https://batchaccount.eastus2.batch.azure.com).
nodeId	path	True	string	Kullanıcı Hesabı oluşturmak istediğiniz makinenin kimliği.
poolId	path	True	string	İşlem Düğümünü içeren Havuzun Kimliği.
api-version	query	True	string minLength: 1	Bu işlem için kullanılacak API sürümü.
timeOut	query		integer (int32)	Sunucunun isteği işlemek için harcayabileceği en uzun süre (saniye cinsinden). Varsayılan değer 30 saniyedir. Değer 30'dan büyükse, varsayılan kullanılacaktır.".

İstek Başlığı

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

Name	Gerekli	Tür	Description
client-request-id		string	Arayan tarafından oluşturulan istek kimliği, küme ayraçları gibi süslemesi olmayan bir GUID biçiminde, örneğin 9C4D50EE-2D56-4CD3-8152-34347DC9F2B0.
return-client-request-id		boolean	Sunucunun yanıtta client-request-id döndürip döndürmeyeceği.
ocp-date		string (date-time-rfc7231)	İsteğin verildiği saat. İstemci kitaplıkları bunu genellikle geçerli sistem saat saatine ayarlar; REST API'yi doğrudan çağırıyorsanız açıkça ayarlayın.

İstek Gövdesi

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

Name	Gerekli	Tür	Description
name	True	string	Hesabın kullanıcı adı.
expiryTime		string (date-time)	Hesabın sona ermesi gereken zaman. Eğer hariç tutulursa, varsayılan zaman mevcut zamandan 1 gün sonradır. Linux Compute Node'lar için expireyTime bir güne kadar hassasiyete sahiptir.
isAdmin		boolean	Hesabın Compute Node'da yönetici olup olmaması mu konusunda. Varsayılan değer yanlıştır.
password		string (password)	Hesabın şifresi. Windows Compute Nodes için şifre gereklidir. Linux Compute Node'lar için, şifre isteğe bağlı olarak sshPublicKey özelliğiyle birlikte belirtilebilir.
sshPublicKey		string	Hesaplama düğümüne uzaktan giriş için kullanılabilen SSH açık anahtar. Açık anahtar, OpenSSH kodlamasıyla uyumlu olmalı ve 64 tabanında kodlanmış olmalıdır. Bu özellik yalnızca Linux Hesaplama Düğümleri için belirtilebilir. Eğer bu Windows Compute Node için belirtilmişse, Batch servisi isteği reddeder; REST API'yi doğrudan çağırıyorsanız, HTTP durum kodu 400'dür (Kötü İstek).

Yanıtlar

Name	Tür	Description
201 Created		İstek başarılı oldu ve sonuç olarak yeni bir kaynak oluşturuldu. Üst Bilgiler DataServiceId: string ETag: string Last-Modified: string client-request-id: string request-id: string
Other Status Codes	BatchError	Beklenmeyen bir hata yanıtı.

Güvenlik

OAuth2Auth

Tür: oauth2
Akış: implicit
Yetkilendirme URL’si: https://login.microsoftonline.com/common/oauth2/v2.0/authorize

Kapsamlar

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

Örnekler

Node create user

Örnek isteği

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

Örnek yanıt

Durum kodu:

201

Tanımlar

Name	Description
BatchError	Azure Batch hizmetinden alınan bir hata yanıtı.
BatchErrorDetail	Azure Batch hata yanıtına dahil edilen ek bilgilerden oluşan bir öğe.
BatchErrorMessage	Azure Batch hata yanıtında bir hata iletisi alındı.
BatchNodeUserCreateOptions	Azure Batch İşlem Düğümünde RDP veya SSH erişimi için kullanıcı hesabı oluşturma parametreleri.

BatchError

Nesne

Azure Batch hizmetinden alınan bir hata yanıtı.

Name	Tür	Description
code	string	Hatanın tanımlayıcısı. Kodlar sabittir ve program aracılığıyla kullanılması amaçlanmıştır.
message	BatchErrorMessage	Hatayı açıklayan ve kullanıcı arabiriminde görüntülenmeye uygun olması amaçlanan bir ileti.
values	BatchErrorDetail[]	Hata hakkında ek ayrıntılar içeren anahtar-değer çiftleri koleksiyonu.

BatchErrorDetail

Nesne

Azure Batch hata yanıtına dahil edilen ek bilgilerden oluşan bir öğe.

Name	Tür	Description
key	string	Value özelliğinin anlamını belirten tanımlayıcı.
value	string	Hata yanıtına eklenen ek bilgiler.

BatchErrorMessage

Nesne

Azure Batch hata yanıtında bir hata iletisi alındı.

Name	Tür	Description
lang	string	Hata mesajının dil kodu.
value	string	İletinin metni.

BatchNodeUserCreateOptions

Nesne

Azure Batch İşlem Düğümünde RDP veya SSH erişimi için kullanıcı hesabı oluşturma parametreleri.

Name	Tür	Description
expiryTime	string (date-time)	Hesabın sona ermesi gereken zaman. Eğer hariç tutulursa, varsayılan zaman mevcut zamandan 1 gün sonradır. Linux Compute Node'lar için expireyTime bir güne kadar hassasiyete sahiptir.
isAdmin	boolean	Hesabın Compute Node'da yönetici olup olmaması mu konusunda. Varsayılan değer yanlıştır.
name	string	Hesabın kullanıcı adı.
password	string (password)	Hesabın şifresi. Windows Compute Nodes için şifre gereklidir. Linux Compute Node'lar için, şifre isteğe bağlı olarak sshPublicKey özelliğiyle birlikte belirtilebilir.
sshPublicKey	string	Hesaplama düğümüne uzaktan giriş için kullanılabilen SSH açık anahtar. Açık anahtar, OpenSSH kodlamasıyla uyumlu olmalı ve 64 tabanında kodlanmış olmalıdır. Bu özellik yalnızca Linux Hesaplama Düğümleri için belirtilebilir. Eğer bu Windows Compute Node için belirtilmişse, Batch servisi isteği reddeder; REST API'yi doğrudan çağırıyorsanız, HTTP durum kodu 400'dür (Kötü İstek).