Nodes - Replace Node User

Hizmet:

Batch Service

API Sürümü:

2025-06-01

Belirtilen Hesaplama Düğümünde kullanıcı Hesabının şifresini ve son kullanma süresini günceller.
Bu işlem, Hesabın tüm güncellenebilir özelliklerini değiştirir. Örneğin, expireTime öğesi belirtilmemişse, mevcut değer varsayılan değerle değiştirilir ve değiştirilmemiştir. Bir Compute Node'da bir kullanıcı hesabını sadece boşta veya çalışan durumdayken güncelleyebiliyorsunuz.

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

İsteğe bağlı parametrelerle:

PUT {endpoint}/pools/{poolId}/nodes/{nodeId}/users/{userName}?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ını güncellemek istediğiniz makinenin kimliği.
poolId	path	True	string	İşlem Düğümünü içeren Havuzun Kimliği.
userName	path	True	string	Güncellenecek kullanıcı Hesabı adı.
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	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.
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. Eğer atlanırsa, mevcut şifreler kaldırılır.
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). Eğer çıkarılırsa, mevcut SSH açık anahtarı kaldırılır.

Yanıtlar

Name	Tür	Description
200 OK		İstek başarılı oldu. Ü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 update user

Örnek isteği

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

Örnek yanıt

Durum kodu:

200

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ı.
BatchNodeUserUpdateOptions	Azure Batch İşlem Düğümünde RDP veya SSH erişimi için kullanıcı hesabını güncelleştirme 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.

BatchNodeUserUpdateOptions

Nesne

Azure Batch İşlem Düğümünde RDP veya SSH erişimi için kullanıcı hesabını güncelleştirme 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.
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. Eğer atlanırsa, mevcut şifreler kaldırılır.
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). Eğer çıkarılırsa, mevcut SSH açık anahtarı kaldırılır.